Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Retensi data
## Ikhtisar
Amazon Bedrock memberi Anda kontrol eksplisit atas apakah permintaan dan output Anda dipertahankan dari permintaan inferensi Anda. Anda dapat mengonfigurasi penyimpanan data di tingkat akun atau proyek, dan pengaturan diberlakukan secara konsisten di seluruh API Pesan, Penyelesaian Obrolan, dan Respons.
Konfigurasi retensi data Anda adalah milik Anda untuk dikelola. Jika akun atau project Anda dikonfigurasi untuk penyimpanan data nol (`data_retention_mode: none`) dan Anda memanggil model yang memerlukan retensi, Amazon Bedrock akan memblokir permintaan tersebut dan mengembalikan kesalahan — Anda selalu mengontrol kebijakan retensi Anda.
**penting**
Tidak ada perubahan retensi data pada model yang dirilis sebelum Claude Fable 5. AWS berkomitmen untuk memastikan bahwa Anda memegang kendali penuh atas kapan dan dengan siapa data Anda disimpan dan dibagikan.
## Mode retensi data
Retensi data dikendalikan oleh **mode** daripada on/off sakelar sederhana:
| **Modus** | **Perilaku** |
| --- | --- |
| default | Default berarti kebijakan retensi data model berlaku. Tidak ada perubahan pada perilaku retensi model sebelumnya; jika ZDR diterapkan sebelumnya, maka ZDR masih berlaku. Retensi aktual tergantung pada model — lihat persyaratan model untuk spesifik. AWS dapat menyimpan data untuk tujuan keselamatan dan pencegahan penyalahgunaan. Penyedia model tidak menerimanya. Pada Responses API, `store` default ke `true` dan dapat disetel ke salah satu nilai.Pengaturan `store=false` tidak menjamin nol retensi data. Beberapa model mungkin masih menyimpan data untuk tinjauan keamanan bahkan ketika `store=false` — dalam hal ini, data disimpan tetapi tidak dapat diambil oleh pelanggan melalui. `GET /v1/responses/{id}` Jika Anda memerlukan jaminan retensi nol, atur `data_retention_mode` ke`none`. |
| provider\_data\_share | Mode ini memungkinkan Amazon Bedrock untuk menyimpan dan membagikan data inferensi Anda dengan penyedia model sesuai kebutuhan mereka. Diperlukan untuk akses ke model tertentu. Lihat [Deteksi penyalahgunaan Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/abuse-detection.html) dan [Ketentuan Layanan AWS](https://aws.amazon.com/service-terms/). |
| none | Retensi data nol. Tidak ada data permintaan atau respons yang ditulis ke penyimpanan tahan lama oleh AWS atau dibagikan dengan penyedia model. Pada Responses API, store default ke false dan store=true ditolak. Mode latar belakang tidak tersedia. Permintaan Penyelesaian Obrolan dan Pesan tidak pernah dipertahankan. |
| inherit | Tidak ada pendapat dalam lingkup ini — tunduk pada cakupan yang lebih luas. Ini adalah default untuk akun dan proyek baru. |
**penting**
Mengkonfigurasi akun atau proyek Anda `provider_data_share` *tidak* berarti semua model akan mulai berbagi data dengan penyedia mereka. Mode terkonfigurasi Anda menetapkan apa yang Anda izinkan — setiap model secara independen menyatakan mode mana yang didukungnya. `allowed_modes` Sebagian besar model saat ini tidak memerlukan atau meminta`provider_data_share`. Interaksi bekerja sebagai berikut:
Jika model `allowed_modes` termasuk`none`, kami tidak akan bertahan apa pun.
Jika model `allowed_modes` termasuk `default` tetapi tidak`none`, AWS simpan data — penyedia model tidak menerimanya.
Jika hanya mode yang diizinkan model`provider_data_share`, data akan dibagikan dengan penyedia — tetapi hanya jika mode efektif Anda mengizinkannya. Jika mode efektif Anda `none` atau`default`, model akan muncul sebagai tidak tersedia.
## Bagaimana mode retensi Anda ditentukan
Retensi data dikonfigurasi pada dua cakupan, dengan default model sendiri sebagai fallback:
+ **Proyek** (paling spesifik) - diatur melalui `POST /v1/organization/projects/{project_id}`
+ **Akun** — diatur melalui `PUT /v1/data_retention`
+ **Model default** (paling tidak spesifik, hanya-baca) - default bawaan model
Mode efektif untuk setiap permintaan ditentukan dengan mengambil ruang lingkup pertama yang nilainya tidak`inherit`:
```
effective mode = first non-inherit value of (project → account → model default)
```
Misalnya, jika proyek Anda disetel ke `inherit` dan akun Anda disetel ke`none`, mode efektif adalah `none` untuk semua model yang dipanggil dari proyek tersebut.
## Mengkonfigurasi retensi data
### Tetapkan retensi data seluruh akun
```
curl -X PUT https://bedrock-mantle.us-east-1.api.aws/v1/data_retention \
-H "x-api-key: $BEDROCK_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "mode": "provider_data_share" }'
```
**Tanggapan:**
```
{
"mode": "provider_data_share",
"updated_at": 1733529600
}
```
**Pesawat Kontrol Batuan Dasar:**
```
curl -X PUT https://bedrock.us-east-1.amazonaws.com/data-retention \
-H "Authorization: Bearer $AWS_BEARER_TOKEN_BEDROCK" \
-H "Content-Type: application/json" \
-d '{ "mode": "provider_data_share" }'
```
**Tanggapan:**
```
{
"mode": "provider_data_share",
"updated_at": "2026-06-07T20:19:44.723Z"
}
```
### Tetapkan retensi data tingkat proyek
```
curl https://bedrock-mantle.us-east-1.api.aws/v1/organization/projects/proj_abc123 \
-H "x-api-key: $BEDROCK_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "data_retention": { "mode": "provider_data_share" } }'
```
### Periksa konfigurasi Anda saat ini
```
# Account level
curl https://bedrock-mantle.us-east-1.api.aws/v1/data_retention \
-H "x-api-key: $BEDROCK_API_KEY"
# Project level
curl https://bedrock-mantle.us-east-1.api.aws/v1/organization/projects/proj_abc123 \
-H "x-api-key: $BEDROCK_API_KEY"
```
**Pesawat Kontrol Batuan Dasar:**
```
# Account level
curl https://bedrock.us-east-1.amazonaws.com/data-retention \
-H "Authorization: Bearer $AWS_BEARER_TOKEN_BEDROCK"
```
### Periksa mode efektif model dan mode yang diizinkan
```
curl https://bedrock-mantle.us-east-1.api.aws/v1/models/anthropic.claude-fable-5 \
-H "x-api-key: $BEDROCK_API_KEY"
```
**Tanggapan:**
```
{
"id": "anthropic.claude-fable-5",
"created": 1733443200,
"owned_by": "system",
"status": "available",
"data_retention": {
"mode": "provider_data_share",
"source": "account",
"allowed_modes": ["provider_data_share"]
}
}
```
## Ketersediaan model dan retensi data
Setiap model menentukan mode retensi mana yang diizinkan melalui. `allowed_modes` Jika mode efektif Anda tidak ada dalam model`allowed_modes`, model akan muncul seperti `status: "unavailable"` dalam daftar model dan permintaan untuk itu akan diblokir.
**Contoh:** Claude Fable 5 dan Claude Mythos 5 memerlukan berbagi data penyedia (). `allowed_modes: ["provider_data_share"]` Pelanggan harus secara eksplisit mengatur mode retensi data mereka `provider_data_share` sebelum mereka dapat menggunakan model ini. Jika mode efektif Anda `none` atau`default`, model ini tidak akan tersedia.
Dengan pengaturan`provider_data_share`, Anda secara eksplisit mengakui menginstruksikan kami untuk menyimpan dan berbagi data dengan penyedia model sesuai kebutuhan mereka. Diperlukan untuk akses ke model tertentu. Lihat [halaman Deteksi Penyalahgunaan](https://docs.aws.amazon.com/bedrock/latest/userguide/abuse-detection.html) dan [Ketentuan Layanan AWS](https://aws.amazon.com/service-terms/).
**catatan**
Saat diluncurkan, tidak ada UI konsol untuk mengonfigurasi retensi data. Pelanggan harus menggunakan API (lihat “Mengonfigurasi retensi data” di atas) atau SDK Batuan Dasar.
**Respons ketika model tidak tersedia karena kebijakan retensi:**
```
{
"id": "anthropic.claude-fable-5",
"created": 1733443200,
"owned_by": "system",
"status": "unavailable",
"status_reason": "This model is not available under data retention mode 'default'.",
"data_retention": {
"mode": "default",
"source": "account",
"allowed_modes": ["provider_data_share"]
}
}
```
### Cara ikut serta
Untuk mengaktifkan Claude Fable 5 dan Claude Mythos 5 untuk akun Anda:
```
curl https://bedrock-mantle.us-east-1.api.aws/v1/data_retention \
-H "x-api-key: $BEDROCK_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "mode": "provider_data_share" }'
```
Atau di tingkat proyek (jika Anda ingin membatasi berbagi data penyedia ke proyek tertentu):
```
curl https://bedrock-mantle.us-east-1.api.aws/v1/organization/projects/proj_abc123 \
-H "x-api-key: $BEDROCK_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "data_retention": { "mode": "provider_data_share" } }'
```
**Mixed-model proyek**
Menyetel proyek ke `provider_data_share` tidak berarti semua lalu lintas model dalam proyek itu dibagikan dengan penyedia model. Setiap model `allowed_modes` menentukan apa yang sebenarnya terjadi pada data Anda:
Model yang `allowed_modes` `["provider_data_share"]` (misalnya, Claude Fable 5) — data disimpan dan dibagikan dengan penyedia.
Model yang `allowed_modes` `["default", "provider_data_share"]` (misalnya, Claude Opus 4.8) — data disimpan oleh AWS saja. Model menerima `provider_data_share` sebagai mode yang valid tetapi tidak memerlukan data untuk meninggalkan batas AWS.
Ketika permintaan Claude Fable 5 ditolak oleh pengklasifikasi keamanan dan kredit fallback ditebus pada Claude Opus 4.8, pemanggilan mundur mengikuti aturan penanganan data Opus 4.8, bukan Fable 5. Tanggapan Opus 4.8 tidak dipertahankan atau dibagikan dengan Antropik.
## Akses penyimpanan data nol (ZDR)
Beberapa model memerlukan retensi data untuk tujuan keamanan dan pencegahan penyalahgunaan. Jika organisasi Anda tidak memerlukan retensi data untuk alasan kepatuhan dan Anda memerlukan akses ke model ini, hubungi manajer AWS akun Anda untuk mendiskusikan kelayakan. Akses ZDR dievaluasi berdasarkan per-akun, per model dalam koordinasi dengan penyedia model.
Akun yang disetujui untuk ZDR pada model tertentu akan `"none"` dimasukkan dalam model itu. `allowed_modes`
## Menegakkan kebijakan retensi dengan IAM
Anda dapat menerapkan kebijakan penyimpanan data di seluruh organisasi menggunakan kebijakan IAM atau Kebijakan Kontrol Layanan (SCP). Tindakan tulis menerbitkan kunci `bedrock-mantle:DataRetentionMode` kondisi yang memungkinkan Anda membatasi mode mana yang dapat disetel.
**Contoh SCP — tidak memerlukan retensi data di seluruh organisasi:**
```
{
"Effect": "Deny",
"Action": [
"bedrock-mantle:PutAccountDataRetention",
"bedrock-mantle:CreateProject",
"bedrock-mantle:UpdateProject"
],
"Condition": {
"StringNotEquals": {
"bedrock-mantle:DataRetentionMode": "none"
}
}
}
```
**Pesawat Kontrol Batuan Dasar:**
```
{
"Effect": "Deny",
"Action": [
"bedrock:PutAccountDataRetention"
],
"Condition": {
"StringNotEquals": {
"bedrock:DataRetentionMode": "none"
}
}
}
```
Ini mencegah siapa pun di organisasi untuk mengatur retensi data ke apa pun selain`none`, memastikan tidak ada data inferensi yang disimpan.
## Data apa yang disimpan dan untuk berapa lama
Untuk model yang membutuhkan `provider_data_share` (saat ini Claude Mythos 5 dan Claude Fable 5): permintaan dan penyelesaian pengguna dibagikan dengan Anthropic dan dipertahankan hingga 30 hari untuk tujuan kepercayaan dan keselamatan.
Untuk model dalam `default` mode: data dapat disimpan untuk tujuan deteksi penyalahgunaan — lihat deteksi penyalahgunaan [Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/abuse-detection.html) untuk detail retensi yang diperlukan. Untuk retensi di luar deteksi penyalahgunaan (misalnya, Responses API dengan`store=true`), lihat dokumentasi dan persyaratan model.
Jika inferensi lintas wilayah diaktifkan untuk model ini, input dan output yang dipertahankan disimpan di wilayah tujuan (yaitu, wilayah tempat permintaan inferensi Anda diproses).
Lihat [Ketentuan Layanan Antropik](https://aws.amazon.com/legal/bedrock/third-party-models/) untuk detail penanganan data khusus model.
## Referensi tindakan IAM
| **Rute** | **Tindakan IAM** |
| --- | --- |
| GET /v1/models | bedrock-mantle:ListModels |
| GET /v1/models/{model} | bedrock-mantle:GetModel |
| GET /v1/data\_retention | bedrock-mantle:GetAccountDataRetention |
| PUT /v1/data\_retention | bedrock-mantle:PutAccountDataRetention |
| GET /v1/organization/projects/{project\_id} | bedrock-mantle:GetProject |
| POST /v1/organization/projects/{project\_id} | bedrock-mantle:UpdateProject |
| **Rute** | **Tindakan IAM** |
| --- | --- |
| GET /data-retention | bedrock:GetAccountDataRetention |
| PUT /data-retention | bedrock:PutAccountDataRetention |