Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Tindakan, sumber daya, dan kunci kondisi untuk Amazon Bedrock Agentcore
Amazon Bedrock Agentcore (awalan layanan:bedrock-agentcore
) menyediakan kunci konteks sumber daya, tindakan, dan kondisi khusus layanan berikut untuk digunakan dalam kebijakan izin IAM.
Referensi:
-
Pelajari cara mengonfigurasi layanan ini.
-
Lihat daftar Operasi API yang tersedia untuk layanan ini.
-
Pelajari cara mengamankan layanan ini dan sumber dayanya dengan menggunakan kebijakan izin IAM.
Topik
Tindakan yang ditentukan oleh Amazon Bedrock Agentcore
Anda dapat menyebutkan tindakan berikut dalam elemen Action
pernyataan kebijakan IAM. Gunakan kebijakan untuk memberikan izin untuk melaksanakan operasi dalam AWS. Saat Anda menggunakan sebuah tindakan dalam sebuah kebijakan, Anda biasanya mengizinkan atau menolak akses ke operasi API atau perintah CLI dengan nama yang sama. Namun, dalam beberapa kasus, satu tindakan tunggal mengontrol akses ke lebih dari satu operasi. Atau, beberapa operasi memerlukan beberapa tindakan yang berbeda.
Kolom tingkat akses pada tabel Tindakan menjelaskan cara tindakan diklasifikasikan (Daftar, Baca, Manajemen izin, atau Penandaan). Klasifikasi ini dapat membantu Anda memahami tingkat akses yang diberikan tindakan saat Anda menggunakannya dalam kebijakan. Untuk informasi selengkapnya tentang tingkat akses, lihat Tingkat akses dalam ringkasan kebijakan.
Kolom tipe sumber daya pada tabel Tindakan menunjukkan apakah setiap tindakan mendukung izin tingkat sumber daya. Jika tidak ada nilai untuk kolom ini, Anda harus menentukan semua sumber daya (“*”) yang berlaku kebijakan dalam Resource
elemen pernyataan kebijakan Anda. Jika kolom mencantumkan jenis sumber daya, maka Anda dapat menyebutkan ARN dengan jenis tersebut dalam sebuah pernyataan dengan tindakan tersebut. Jika tindakan memiliki satu atau lebih sumber daya yang diperlukan, pemanggil harus memiliki izin untuk menggunakan tindakan dengan sumber daya tersebut. Sumber daya yang diperlukan ditunjukkan dalam tabel dengan tanda bintang (*). Jika Anda membatasi akses sumber daya dengan Resource
elemen dalam kebijakan IAM, Anda harus menyertakan ARN atau pola untuk setiap jenis sumber daya yang diperlukan. Beberapa tindakan mendukung berbagai jenis sumber daya. Jika jenis sumber daya opsional (tidak ditunjukkan sesuai kebutuhan), maka Anda dapat memilih untuk menggunakan salah satu jenis sumber daya opsional.
Kolom Condition keys pada tabel Actions menyertakan kunci yang dapat Anda tentukan dalam Condition
elemen pernyataan kebijakan. Untuk informasi selengkapnya tentang kunci kondisi yang terkait dengan sumber daya untuk layanan, lihat kolom Kunci kondisi pada tabel Jenis sumber daya.
Kolom Tindakan tergantung pada tabel Tindakan menunjukkan izin tambahan yang mungkin diperlukan untuk berhasil memanggil tindakan. Izin ini mungkin diperlukan selain izin untuk tindakan itu sendiri. Saat tindakan menentukan tindakan dependen, dependensi tersebut mungkin berlaku untuk sumber daya tambahan yang ditentukan untuk tindakan tersebut, bukan hanya sumber daya pertama yang tercantum dalam tabel.
catatan
Kunci kondisi sumber daya tercantum dalam tabel Jenis sumber daya. Anda dapat menemukan tautan ke jenis sumber daya yang berlaku untuk tindakan di kolom Jenis sumber daya (*wajib) pada tabel Tindakan. Jenis sumber daya dalam tabel Jenis sumber daya menyertakan kolom Kunci kondisi, yang merupakan kunci kondisi sumber daya yang berlaku untuk tindakan dalam tabel Tindakan.
Untuk detail tentang kolom dalam tabel berikut, lihat tabel Tindakan.
Tindakan | Deskripsi | Tingkat akses | Jenis sumber daya (*diperlukan) | Kunci syarat | Tindakan bergantung |
---|---|---|---|---|---|
AllowVendedLogDeliveryForResource[hanya izin] | Memberikan izin untuk mengonfigurasi telemetri yang dijual untuk sumber daya | Manajemen izin | |||
ConnectBrowserAutomationStream | Memberikan izin untuk terhubung ke aliran otomatisasi browser | Baca | |||
ConnectBrowserLiveViewStream | Memberikan izin untuk terhubung ke streaming tampilan langsung browser | Baca | |||
CreateAgentRuntime | Memberikan izin untuk membuat runtime agen baru | Tulis |
iam:PassRole |
||
CreateAgentRuntimeEndpoint | Memberikan izin untuk membuat titik akhir runtime agen baru | Tulis | |||
CreateApiKeyCredentialProvider | Memberikan izin untuk membuat Penyedia Kredenal Kunci API baru | Tulis | |||
CreateBrowser | Memberikan izin untuk membuat browser kustom baru | Tulis | |||
CreateCodeInterpreter | Memberikan izin untuk membuat penerjemah kode kustom baru | Tulis | |||
CreateEvent | Memberikan izin untuk membuat Acara | Tulis | |||
CreateGateway | Memberikan izin untuk membuat gateway baru | Tulis |
iam:PassRole |
||
CreateGatewayTarget | Memberikan izin untuk membuat target baru di gateway yang ada | Tulis | |||
CreateMemory | Memberikan izin untuk membuat sumber daya Memori | Tulis |
iam:PassRole |
||
CreateOauth2CredentialProvider | Memberikan izin untuk membuat Penyedia Kredenal baru untuk mengakses sumber daya eksternal dengan protokol OAuth2 | Tulis | |||
CreateWorkloadIdentity | Memberikan izin untuk membuat Identitas Beban Kerja baru | Tulis | |||
DeleteAgentRuntime | Memberikan izin untuk menghapus runtime agen | Tulis | |||
DeleteAgentRuntimeEndpoint | Memberikan izin untuk menghapus titik akhir runtime agen | Tulis | |||
DeleteApiKeyCredentialProvider | Memberikan izin untuk menghapus Penyedia Kredenal Kunci API terdaftar | Tulis | |||
DeleteBrowser | Memberikan izin untuk menghapus browser khusus | Tulis | |||
DeleteCodeInterpreter | Memberikan izin untuk menghapus penerjemah kode kustom | Tulis | |||
DeleteEvent | Memberikan izin untuk menghapus Acara | Tulis | |||
DeleteGateway | Memberikan izin untuk menghapus gateway yang ada | Tulis | |||
DeleteGatewayTarget | Memberikan izin untuk menghapus target gateway yang ada | Tulis | |||
DeleteMemory | Memberikan izin untuk menghapus sumber daya Memori | Tulis | |||
DeleteMemoryRecord | Memberikan izin untuk menghapus Rekaman Memori | Tulis | |||
DeleteOauth2CredentialProvider | Memberikan izin untuk menghapus Penyedia OAuth2 Kredenal terdaftar | Tulis | |||
DeleteWorkloadIdentity | Memberikan izin untuk menghapus Identitas Beban Kerja terdaftar | Tulis | |||
GetAgentRuntime | Memberikan izin untuk mendapatkan detail runtime agen | Baca | |||
GetAgentRuntimeEndpoint | Memberikan izin untuk mendapatkan detail titik akhir runtime agen | Baca | |||
GetApiKeyCredentialProvider | Memberikan izin untuk mengambil Penyedia Kredenal Kunci API terdaftar dengan namanya | Baca | |||
GetBrowser | Memberikan izin untuk mendapatkan detail browser | Baca | |||
GetBrowserSession | Memberikan izin untuk mendapatkan detail sesi browser | Baca | |||
GetCodeInterpreter | Memberikan izin untuk mendapatkan detail penerjemah kode | Baca | |||
GetCodeInterpreterSession | Memberikan izin untuk mendapatkan detail sesi penerjemah kode | Baca | |||
GetEvent | Memberikan izin untuk mengambil Acara | Baca | |||
GetGateway | Memberikan izin untuk mengambil gateway yang ada | Baca | |||
GetGatewayTarget | Memberikan izin untuk mengambil target gateway yang ada | Baca | |||
GetMemory | Memberikan izin untuk mengambil detail untuk sumber daya Memori | Baca | |||
GetMemoryRecord | Memberikan izin untuk mengambil Rekaman Memori | Baca | |||
GetOauth2CredentialProvider | Memberikan izin untuk mengambil Penyedia OAuth2 Kredenal terdaftar dengan namanya | Baca | |||
GetResourceApiKey | Memberikan izin untuk mengambil Kunci API yang terkait dengan Penyedia Kredenal Kunci Api | Baca | |||
GetResourceOauth2Token | Memberikan izin untuk mengambil token akses dengan aliran OAuth2 2LO atau 3LO untuk mengakses sumber daya eksternal | Baca | |||
GetTokenVault | Memberikan izin untuk mengambil konfigurasi saat ini TokenVault, termasuk pengaturan enkripsi | Baca | |||
GetWorkloadAccessToken | Memberikan izin untuk mengambil token akses Beban Kerja untuk beban kerja agen yang tidak bertindak atas nama pengguna | Tulis | |||
GetWorkloadAccessTokenForJWT | Memberikan izin untuk mengambil token akses Beban Kerja untuk beban kerja agen yang bertindak atas nama pengguna dengan token JWT | Tulis | |||
GetWorkloadAccessTokenForUserId | Memberikan izin untuk mengambil token akses Beban Kerja untuk beban kerja agen yang bertindak atas nama pengguna dengan User Id | Tulis | |||
GetWorkloadIdentity | Memberikan izin untuk mengambil detail untuk identitas Beban Kerja tertentu, termasuk namanya dan pengembalian yang diizinkan OAuth2 URLs | Baca | |||
InvokeAgentRuntime | Memberikan izin untuk memanggil titik akhir runtime agen | Tulis | |||
InvokeCodeInterpreter | Memberikan izin untuk memanggil sesi penerjemah kode | Tulis | |||
ListActors | Memberikan izin untuk mendaftar Aktor | Daftar | |||
ListAgentRuntimeEndpoints | Memberikan izin untuk membuat daftar titik akhir runtime agen | Daftar | |||
ListAgentRuntimeVersions | Memberikan izin untuk membuat daftar versi runtime agen | Daftar | |||
ListAgentRuntimes | Memberikan izin untuk membuat daftar runtime agen | Daftar | |||
ListApiKeyCredentialProviders | Memberikan izin untuk mencantumkan semua Penyedia Kredensi Kunci API di Token Vault | Baca | |||
ListBrowserSessions | Memberikan izin untuk membuat daftar sesi browser | Daftar | |||
ListBrowsers | Memberikan izin untuk membuat daftar browser | Daftar | |||
ListCodeInterpreterSessions | Memberikan izin untuk membuat daftar sesi penerjemah kode | Daftar | |||
ListCodeInterpreters | Memberikan izin untuk membuat daftar penerjemah kode | Daftar | |||
ListEvents | Memberikan izin untuk membuat daftar acara | Daftar | |||
ListGatewayTargets | Memberikan izin untuk mencantumkan target gateway yang ada | Daftar | |||
ListGateways | Memberikan izin untuk membuat daftar gateway yang ada | Daftar | |||
ListMemories | Memberikan izin untuk membuat daftar sumber daya memori | Daftar | |||
ListMemoryRecords | Memberikan izin untuk membuat daftar catatan memori | Daftar | |||
ListOauth2CredentialProviders | Memberikan izin untuk mencantumkan semua Penyedia OAuth2 Kredensi di Token Vault | Baca | |||
ListSessions | Memberikan izin untuk membuat daftar sesi | Daftar | |||
ListWorkloadIdentities | Memberikan izin untuk mencantumkan semua Identitas Beban Kerja di pemanggil Akun AWS | Baca | |||
RetrieveMemoryRecords | Memberikan izin untuk mengambil catatan memori melalui kueri sematik | Daftar | |||
SetTokenVaultCMK | Memberikan izin untuk mengaitkan Customer Managed Key (CMK) atau Service Managed Key dengan yang spesifik TokenVault | Baca | |||
StartBrowserSession | Memberikan izin untuk memulai sesi browser baru | Tulis | |||
StartCodeInterpreterSession | Memberikan izin untuk memulai sesi penerjemah kode baru | Tulis | |||
StopBrowserSession | Memberikan izin untuk menghentikan sesi browser | Tulis | |||
StopCodeInterpreterSession | Memberikan izin untuk menghentikan sesi penerjemah kode | Tulis | |||
SynchronizeGatewayTargets[hanya izin] | Memberikan izin untuk mengaktifkan pencarian di gateway | Manajemen izin | |||
UpdateAgentRuntime | Memberikan izin untuk memperbarui runtime agen | Tulis |
iam:PassRole |
||
UpdateAgentRuntimeEndpoint | Memberikan izin untuk memperbarui titik akhir runtime agen | Tulis | |||
UpdateApiKeyCredentialProvider | Memberikan izin untuk memperbarui Penyedia Kredenal Kunci API yang ada | Tulis | |||
UpdateBrowserStream | Memberikan izin untuk memperbarui status aliran sesi browser | Tulis | |||
UpdateGateway | Memberikan izin untuk memperbarui gateway yang ada | Tulis |
iam:PassRole |
||
UpdateGatewayTarget | Memberikan izin untuk memperbarui target gateway yang ada | Tulis | |||
UpdateMemory | Memberikan izin untuk memperbarui sumber daya Memori | Tulis |
iam:PassRole |
||
UpdateOauth2CredentialProvider | Memberikan izin untuk memperbarui Penyedia OAuth2 Kredenal yang ada | Tulis | |||
UpdateWorkloadIdentity | Memberikan izin untuk memperbarui metadata Identitas Beban Kerja yang ada | Tulis | |||
Jenis sumber daya yang ditentukan oleh Amazon Bedrock Agentcore
Jenis sumber daya berikut ditentukan oleh layanan ini dan dapat digunakan dalam elemen Resource
pernyataan kebijakan izin IAM. Setiap tindakan dalam Tabel tindakan mengidentifikasi jenis sumber daya yang dapat ditentukan dengan tindakan tersebut. Jenis sumber daya juga dapat menentukan kunci kondisi mana yang dapat Anda sertakan dalam kebijakan. Tombol ini ditampilkan di kolom terakhir dari tabel Jenis sumber daya. Untuk detail tentang kolom dalam tabel berikut, lihat Tabel tipe sumber daya.
Jenis sumber daya | ARN | Kunci syarat |
---|---|---|
memory |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:memory/${MemoryId}
|
|
gateway |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:gateway/${GatewayId}
|
|
workload-identity |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:workload-identity-directory/${DirectoryId}/workload-identity/${WorkloadIdentityName}
|
|
oauth2credentialprovider |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:token-vault/${TokenVaultId}/oauth2credentialprovider/${Name}
|
|
apikeycredentialprovider |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:token-vault/${TokenVaultId}/apikeycredentialprovider/${Name}
|
|
runtime |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:runtime/${RuntimeId}
|
|
runtime-endpoint |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:runtime/${RuntimeId}/runtime-endpoint/${Name}
|
|
code-interpreter-custom |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:code-interpreter-custom/${CodeInterpreterId}
|
|
code-interpreter |
arn:${Partition}:bedrock-agentcore:${Region}:aws:code-interpreter/${CodeInterpreterId}
|
|
browser-custom |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:browser-custom/${BrowserId}
|
|
browser |
arn:${Partition}:bedrock-agentcore:${Region}:aws:browser/${BrowserId}
|
|
workload-identity-directory |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:workload-identity-directory/${DirectoryId}
|
|
token-vault |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:token-vault/${TokenVaultId}
|
Kunci kondisi untuk Amazon Bedrock Agentcore
Amazon Bedrock Agentcore mendefinisikan kunci kondisi berikut yang dapat digunakan dalam Condition
elemen kebijakan IAM. Anda dapat menggunakan kunci ini untuk menyempurnakan syarat lebih lanjut saat pernyataan kebijakan berlaku. Untuk detail tentang kolom dalam tabel berikut, lihat Tabel tombol kondisi.
Untuk melihat kunci kondisi global yang tersedia untuk semua layanan, lihat kunci konteks kondisi AWS global.
Kunci syarat | Deskripsi | Tipe |
---|---|---|
bedrock-agentcore:actorId | Memfilter akses oleh Actor Id | String |
bedrock-agentcore:namespace | Memfilter akses dengan namespace | String |
bedrock-agentcore:sessionId | Memfilter akses berdasarkan Session Id | String |
bedrock-agentcore:strategyId | Memfilter akses dengan Memory Strategy Id | String |