Tindakan, sumber daya, dan kunci kondisi untuk Amazon Q

Amazon Q (awalan layanan:q) 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 Q
Jenis sumber daya yang ditentukan oleh Amazon Q
Kunci kondisi untuk Amazon Q

Tindakan yang ditentukan oleh Amazon Q

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 dependen 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
AssociateConnectorResource[hanya izin]	Memberikan izin untuk mengaitkan AWS sumber daya dengan konektor Amazon Q	Tulis
AssociateLoginDomain[hanya izin]	Memberikan izin untuk mengaitkan domain login dengan Profil Pengembang Amazon Q	Tulis	profile*
BatchDescribeGroups[hanya izin]	Memberikan izin untuk mendeskripsikan beberapa grup untuk Profil Pengembang Amazon Q	Baca	profile*
BatchDescribeUsers[hanya izin]	Memberikan izin untuk mendeskripsikan beberapa pengguna untuk Profil Pengembang Amazon Q	Baca	profile*
BatchGetGroups[hanya izin]	Memberikan izin untuk mendapatkan beberapa grup untuk Profil Pengembang Amazon Q	Baca	profile*
BatchGetUsers[hanya izin]	Memberikan izin untuk mendapatkan beberapa pengguna untuk Profil Pengembang Amazon Q	Baca	profile*
CreateArtifact[hanya izin]	Memberikan izin untuk membuat artefak dengan Amazon Q	Tulis
CreateAssignment[hanya izin]	Memberikan izin untuk membuat penetapan pengguna atau grup untuk Profil Pengembang Amazon Q	Tulis	profile*
CreateAssignment[hanya izin]		Tulis		identitystore:UserId identitystore:GroupId
CreateAuthGrant[hanya izin]	Memberikan izin untuk membuat pengguna OAuth di Amazon Q	Tulis			kms:Decrypt kms:GenerateDataKeyWithoutPlaintext kms:ReEncryptFrom kms:ReEncryptTo
CreateOAuthAppConnection[hanya izin]	Memberikan izin untuk mendaftarkan aplikasi OAuth di Amazon Q	Tulis			kms:Decrypt kms:GenerateDataKeyWithoutPlaintext kms:ReEncryptFrom kms:ReEncryptTo
CreatePlugin[hanya izin]	Memberikan izin untuk membuat dan mengonfigurasi plugin pihak ketiga di Amazon Q	Tulis	plugin*
CreatePlugin[hanya izin]		Tulis		aws:TagKeys aws:RequestTag/${TagKey}
CreateScimAccessToken[hanya izin]	Memberikan izin untuk membuat token akses SCIM untuk Profil Pengembang Amazon Q	Tulis	profile*
DeleteAssignment[hanya izin]	Memberikan izin untuk menghapus penetapan pengguna atau grup untuk Profil Pengembang Amazon Q	Tulis	profile*
DeleteAssignment[hanya izin]		Tulis		identitystore:UserId identitystore:GroupId
DeleteConversation[hanya izin]	Memberikan izin untuk menghapus percakapan dengan Amazon Q	Tulis
DeleteOAuthAppConnection[hanya izin]	Memberikan izin untuk menghapus aplikasi OAuth di Amazon Q	Tulis			kms:Decrypt kms:GenerateDataKeyWithoutPlaintext kms:ReEncryptFrom kms:ReEncryptTo
DeletePlugin[hanya izin]	Memberikan izin untuk menghapus plugin yang dikonfigurasi di Amazon Q	Tulis	plugin*
DeletePlugin[hanya izin]		Tulis		aws:ResourceTag/${TagKey}
DeleteScimAccessToken[hanya izin]	Memberikan izin untuk menghapus token akses SCIM untuk Profil Pengembang Amazon Q	Tulis	profile*
DisassociateLoginDomain[hanya izin]	Memberikan izin untuk memisahkan domain login dari Profil Pengembang Amazon Q	Tulis	profile*
GenerateCodeFromCommands[hanya izin]	Memberikan izin untuk menghasilkan kode dari perintah CLI di Amazon Q	Baca
GenerateCodeRecommendations[hanya izin]	Memberikan izin untuk menghasilkan rekomendasi kode di Amazon Q	Baca
GetArtifact[hanya izin]	Memberikan izin untuk melihat artefak Amazon Q	Baca
GetArtifactActionResult[hanya izin]	Memberikan izin untuk melihat hasil tindakan dalam artefak Amazon Q	Baca			cloudformation:GetResource cloudformation:GetResourceRequestStatus cloudformation:ListResourceRequests
GetConnector[hanya izin]	Memberikan izin untuk melihat informasi tentang konektor Amazon Q tertentu	Baca
GetConversation[hanya izin]	Memberikan izin untuk mendapatkan pesan individual yang terkait dengan percakapan tertentu dengan Amazon Q	Baca
GetIdentityMetadata[hanya izin]	Memberikan izin ke Amazon Q untuk mendapatkan metadata identitas	Baca
GetPlugin[hanya izin]	Memberikan izin untuk melihat informasi tentang plugin Amazon Q tertentu yang dikonfigurasi	Baca	plugin*
GetPlugin[hanya izin]		Baca		aws:ResourceTag/${TagKey}
GetTroubleshootingResults[hanya izin]	Memberikan izin untuk mendapatkan hasil pemecahan masalah dengan Amazon Q	Baca
ListConversations[hanya izin]	Memberikan izin untuk membuat daftar percakapan individual yang terkait dengan pengguna Amazon Q tertentu	Baca
ListDashboardMetrics[hanya izin]	Memberikan izin untuk membaca metrik untuk mengisi dasbor Amazon Q	Daftar
ListGroups[hanya izin]	Memberikan izin untuk membuat daftar grup untuk Profil Pengembang Amazon Q	Daftar	profile*
ListLoginDomains[hanya izin]	Memberikan izin untuk mencantumkan domain login untuk Profil Pengembang Amazon Q	Daftar	profile*
ListPluginProviders[hanya izin]	Memberikan izin untuk membuat daftar plugin yang tersedia di Amazon Q	Daftar
ListPlugins[hanya izin]	Memberikan izin untuk membuat daftar plugin yang dikonfigurasi di Amazon Q	Daftar	plugin*
ListScimAccessTokens[hanya izin]	Memberikan izin untuk mencantumkan token akses SCIM untuk Profil Pengembang Amazon Q	Daftar	profile*
ListTagsForResource[hanya izin]	Memberikan izin untuk mencantumkan semua tag yang terkait dengan sumber daya Amazon Q	Daftar	plugin
ListTagsForResource[hanya izin]		Daftar		aws:ResourceTag/${TagKey}
ListUsers[hanya izin]	Memberikan izin untuk mencantumkan pengguna untuk Profil Pengembang Amazon Q	Daftar	profile*
PassRequest[hanya izin]	Memberikan izin untuk mengizinkan Amazon Q melakukan tindakan atas nama Anda	Tulis
PerformArtifactAction[hanya izin]	Memberikan izin untuk melakukan tindakan dalam artefak Amazon Q	Tulis			cloudformation:CancelResourceRequest cloudformation:CreateResource cloudformation:GetResource cloudformation:GetResourceRequestStatus cloudformation:ListResourceRequests cloudformation:UpdateResource iam:AttachRolePolicy iam:CreatePolicy iam:CreateRole iam:PutRolePolicy
RejectConnector[hanya izin]	Memberikan izin untuk menolak permintaan koneksi untuk konektor Amazon Q	Tulis
SendEvent[hanya izin]	Memberikan izin untuk memicu tindakan Amazon Q asinkron	Tulis			kms:Decrypt kms:GenerateDataKeyWithoutPlaintext kms:ReEncryptFrom kms:ReEncryptTo
SendMessage[hanya izin]	Memberikan izin untuk mengirim pesan ke Amazon Q	Tulis
StartConversation[hanya izin]	Memberikan izin untuk memulai percakapan dengan Amazon Q	Tulis
StartTroubleshootingAnalysis[hanya izin]	Memberikan izin untuk memulai analisis pemecahan masalah dengan Amazon Q	Tulis
StartTroubleshootingResolutionExplanation[hanya izin]	Memberikan izin untuk memulai penjelasan resolusi pemecahan masalah dengan Amazon Q	Tulis
TagResource[hanya izin]	Memberikan izin untuk mengaitkan tag dengan sumber daya Amazon Q	Penandaan	plugin
			profile
				aws:ResourceTag/${TagKey} aws:TagKeys aws:RequestTag/${TagKey}
UntagResource[hanya izin]	Memberikan izin untuk menghapus tag yang terkait dengan sumber daya Amazon Q	Penandaan	plugin
			profile
				aws:ResourceTag/${TagKey} aws:TagKeys
UpdateAssignment[hanya izin]	Memberikan izin untuk memperbarui penetapan pengguna atau grup untuk Profil Pengembang Amazon Q	Tulis	profile*
UpdateAssignment[hanya izin]		Tulis		identitystore:UserId identitystore:GroupId
UpdateAuthGrant[hanya izin]	Memberikan izin untuk memperbarui pengguna OAuth di Amazon Q	Tulis			kms:Decrypt kms:GenerateDataKeyWithoutPlaintext kms:ReEncryptFrom kms:ReEncryptTo
UpdateConversation[hanya izin]	Memberikan izin untuk memperbarui percakapan dengan Amazon Q	Tulis
UpdateOAuthAppConnection[hanya izin]	Memberikan izin untuk memperbarui aplikasi OAuth di Amazon Q	Tulis			kms:Decrypt kms:GenerateDataKeyWithoutPlaintext kms:ReEncryptFrom kms:ReEncryptTo
UpdatePlugin[hanya izin]	Memberikan izin untuk memperbarui plugin pihak ketiga di Amazon Q	Tulis	plugin*
UpdatePlugin[hanya izin]		Tulis		aws:TagKeys aws:RequestTag/${TagKey}
UpdateTroubleshootingCommandResult[hanya izin]	Memberikan izin untuk memperbarui hasil perintah pemecahan masalah dengan Amazon Q	Tulis
UsePlugin[hanya izin]	Memberikan izin untuk menggunakan plugin Amazon Q	Tulis	plugin*
VerifyOAuthAppConnection[hanya izin]	Memberikan izin untuk memverifikasi aplikasi OAuth di Amazon Q	Tulis			kms:Decrypt kms:GenerateDataKeyWithoutPlaintext kms:ReEncryptFrom kms:ReEncryptTo

Jenis sumber daya yang ditentukan oleh Amazon Q

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-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
profile	`arn:${Partition}:codewhisperer:${Region}:${Account}:profile/${Identifier}`	aws:ResourceTag/${TagKey}
plugin	`arn:${Partition}:qdeveloper:${Region}:${Account}:plugin/${Identifier}`	aws:ResourceTag/${TagKey}

Kunci kondisi untuk Amazon Q

Amazon Q 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	Jenis
aws:RequestTag/${TagKey}	Filter akses berdasarkan tanda yang diberikan dalam permintaan	String
aws:ResourceTag/${TagKey}	Memfilter akses dengan tag yang terkait dengan sumber daya Amazon Q	String
aws:TagKeys	Filter akses berdasarkan kunci tanda yang diberikan dalam permintaan	ArrayOfString
identitystore:GroupId	Memfilter akses dengan ID Grup Pusat Identitas IAM	ArrayOfString
identitystore:UserId	Memfilter akses dengan ID Pengguna Pusat Identitas IAM	ArrayOfString

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

AWS Konsol Pesanan Pembelian

Amazon Q Bisnis