View a markdown version of this page

Retensi data - Amazon Bedrock

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Retensi data

Gambaran umum

Amazon Bedrock memberi Anda kontrol eksplisit atas apakah prompt dan output Anda dipertahankan dari permintaan inferensi Anda. Anda dapat mengonfigurasi retensi data di tingkat akun atau proyek, dan pengaturan diterapkan secara konsisten di seluruh API Pesan, Penyelesaian Obrolan, dan Tanggapan.

Konfigurasi penyimpanan data Anda adalah milik Anda untuk dikelola. Jika akun atau proyek Anda dikonfigurasi untuk retensi data nol (data_retention_mode: none) dan Anda memanggil model yang memerlukan retensi, Amazon Bedrock akan memblokir permintaan dan mengembalikan kesalahan — Anda selalu mengontrol kebijakan retensi Anda.

penting

Tidak ada perubahan retensi data untuk model Claude yang dirilis sebelum Claude Fable 5. Kami berkomitmen untuk memastikan Anda memegang kendali penuh atas kapan dan dengan siapa data Anda disimpan dan dibagikan. Untuk daftar lengkap model yang memerlukan retensi data, lihat deteksi penyalahgunaan Amazon Bedrock.

Mode retensi data

Retensi data dikendalikan oleh mode daripada sakelar on/off sederhana:

Modus Perilaku
default

Default berarti kebijakan penyimpanan 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 ketentuan model untuk spesifikasinya. 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.

catatan

Peng store=false aturan tidak menjamin retensi data nol. 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, setel data_retention_mode kenone.

provider_data_share Mode ini memungkinkan Amazon Bedrock menyimpan dan membagikan data inferensi Anda dengan penyedia model sesuai kebutuhan mereka. Diperlukan untuk akses ke model tertentu. Lihat deteksi penyalahgunaan Amazon Bedrock dan Ket entuan Layanan AWS.
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 ke ruang lingkup 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 yang dikonfigurasi mengatur apa yang Anda izinkan — setiap model secara independen menyatakan mode mana yang didukungnyaallowed_modes. Sebagian besar model saat ini tidak memerlukan atau memintaprovider_data_share. Interaksi bekerja sebagai berikut:

  • Jika model allowed_modes termasuknone, kami tidak akan mempertahankan apa pun.

  • Jika model allowed_modes termasuk default tetapi tidaknone, AWS menyimpan data — penyedia model tidak menerimanya.

  • Jika satu-satunya mode model yang diizinkan adalahprovider_data_share, data akan dibagikan dengan penyedia - tetapi hanya jika mode efektif Anda mengizinkannya. Jika mode efektif Anda adalah none ataudefault, 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 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 permintaan apa pun ditentukan dengan mengambil ruang lingkup pertama yang nilainya tidakinherit:

effective mode = first non-inherit value of (project → account → model default)

Misalnya, jika proyek Anda disetel ke inherit dan akun Anda disetel kenone, mode efektif adalah none untuk semua model yang dipanggil dari proyek itu.

Mengkonfigurasi retensi data

Mengatur retensi data di 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 }

Bidang Kontrol Batu 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" }

Mengatur 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"

Bidang Kontrol Batu 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 diizinkanallowed_modes. Jika mode efektif Anda tidak ada dalam modelallowed_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 penyimpanan data mereka provider_data_share sebelum mereka dapat memanggil model ini. Jika mode efektif Anda adalah none ataudefault, model ini tidak akan tersedia.

Dengan mengaturprovider_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 Det eksi Penyalahgunaan dan Ketentuan Layanan AWS.

catatan

Saat diluncurkan, tidak ada UI konsol untuk mengonfigurasi retensi data. Pelanggan harus menggunakan API (lihat “Mengkonfigurasi retensi data” di atas) atau Bedrock SDK.

Tanggapan saat 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"] } }

Bagaimana 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 tersebut dibagikan dengan penyedia model. Setiap model allowed_modes menentukan apa yang sebenarnya terjadi pada data Anda:

  • Model allowed_modes yang ["provider_data_share"] (misalnya, Claude Fable 5) —berbagi penyedia adalah satu-satunya perilaku yang diizinkan. Data disimpan dan dibagikan dengan penyedia pada setiap permintaan.

  • Model allowed_modes yang ["none", "default", "provider_data_share"] (misalnya, Claude Opus 4.8) - provider_data_share diterima sebagai mode yang valid tetapi data tidak diperlukan untuk meninggalkan AWS batas.

  • Ketika permintaan Claude Fable 5 ditolak oleh pengklasifikasi keamanan dan kredit fallback ditebus pada Claude Opus 4.8, pemanggilan fallback mengikuti aturan penanganan data Opus 4.8, bukan aturan untuk Fable 5. Respons Opus 4.8 tidak dipertahankan atau dibagikan dengan Anthropic, meskipun permintaan Fable 5 yang berasal seharusnya demikian.

Akses retensi data nol (ZDR)

Beberapa model memerlukan penyimpanan data untuk tujuan keselamatan dan pencegahan penyalahgunaan. Jika organisasi Anda tidak memerlukan penyimpanan 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 terlihat "none" disertakan dalam model ituallowed_modes.

Model Claude antropis

Kelayakan ZDR untuk model Claude dikelola oleh Anthropic. Hubungi perwakilan akun Anthropic Anda untuk mendapatkan dukungan.

Menegakkan kebijakan retensi dengan IAM

Anda dapat menerapkan kebijakan retensi 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 diatur.

Contoh SCP - memerlukan retensi data nol di seluruh organisasi:

{ "Effect": "Deny", "Action": [ "bedrock-mantle:PutAccountDataRetention", "bedrock-mantle:CreateProject", "bedrock-mantle:UpdateProject" ], "Condition": { "StringNotEquals": { "bedrock-mantle:DataRetentionMode": "none" } } }

Bidang Kontrol Batu Dasar:

{ "Effect": "Deny", "Action": [ "bedrock:PutAccountDataRetention" ], "Condition": { "StringNotEquals": { "bedrock:DataRetentionMode": "none" } } }

Ini mencegah siapa pun di organisasi mengatur retensi data ke apa pun selainnone, memastikan tidak ada data inferensi yang pernah 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): petunjuk dan penyelesaian pengguna dibagikan dengan Anthropic dan disimpan hingga 30 hari untuk tujuan kepercayaan dan keamanan.

Untuk model dalam default mode: data dapat disimpan untuk tujuan deteksi penyalahgunaan — lihat deteksi penyalahgunaan Amazon Bedrock untuk detail retensi yang diperlukan. Untuk retensi di luar deteksi penyalahgunaan (misalnya, Responses API withstore=true), lihat dokumentasi dan ketentuan 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 Ket entuan Layanan Anthropic untuk detail penanganan data khusus model.

Referensi tindakan IAM

Rute Tindakan IAM
GET /v1/modelsbedrock-mantle:ListModels
GET /v1/models/{model}bedrock-mantle:GetModel
GET /v1/data_retentionbedrock-mantle:GetAccountDataRetention
PUT /v1/data_retentionbedrock-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-retentionbedrock:GetAccountDataRetention
PUT /data-retentionbedrock:PutAccountDataRetention