Tindakan, sumber daya, dan kunci kondisi untuk Amazon Rekognition

Amazon Rekognition (awalan layananrekognition:) 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.

Tindakan yang ditentukan oleh Amazon Rekognition

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 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.

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
AssociateFaces	Memberikan izin untuk mengaitkan beberapa wajah individu dengan satu pengguna	Tulis	collection*
CompareFaces	Memberikan izin untuk membandingkan wajah di gambar input sumber dengan setiap wajah terdeteksi pada gambar input target	Baca
CopyProjectVersion	Memberikan izin untuk menyalin versi model yang ada ke versi model baru	Tulis	project*
			projectversion*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateCollection	Memberikan izin untuk membuat koleksi di Wilayah AWS	Tulis	collection*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateDataset	Memberikan izin untuk membuat kumpulan data Label Kustom Amazon Rekognition baru	Tulis	project*
CreateFaceLivenessSession	Memberikan izin untuk membuat sesi keaktifan wajah	Tulis
CreateProject	Memberikan izin untuk membuat proyek Label Kustom Rekognition Amazon	Tulis	project*
CreateProjectVersion	Memberikan izin untuk memulai pelatihan versi baru dari model	Tulis	project*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateStreamProcessor	Memberikan izin untuk membuat prosesor aliran Amazon Rekognition	Tulis	collection*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateUser	Memberikan izin untuk membuat pengguna baru dalam koleksi menggunakan ID pengguna unik yang Anda berikan	Tulis	collection*
DeleteCollection	Memberikan izin untuk menghapus koleksi yang ditentukan	Tulis	collection*
DeleteDataset	Memberikan izin untuk menghapus kumpulan data Label Kustom Amazon Rekognition yang ada	Tulis	dataset*
DeleteFaces	Memberikan izin untuk menghapus wajah dari koleksi	Tulis	collection*
DeleteProject	Memberikan izin untuk menghapus proyek	Tulis	project*
DeleteProjectPolicy	Memberikan izin untuk menghapus kebijakan sumber daya yang dilampirkan ke proyek	Tulis	project*
DeleteProjectVersion	Memberikan izin untuk menghapus model	Tulis	projectversion*
DeleteStreamProcessor	Memberikan izin untuk menghapus prosesor aliran yang ditentukan	Tulis	streamprocessor*
DeleteUser	Memberikan izin untuk menghapus pengguna dari koleksi berdasarkan ID pengguna yang disediakan	Tulis	collection*
DescribeCollection	Memberikan izin untuk membaca detail tentang koleksi	Baca	collection*
DescribeDataset	Memberikan izin untuk mendeskripsikan kumpulan data Label Kustom Rekognition Amazon	Baca	dataset*
DescribeProjectVersions	Memberikan izin untuk membuat daftar versi model dalam proyek Label Kustom Rekognition Amazon	Baca	project*
DescribeProjects	Memberikan izin untuk mencantumkan proyek Label Kustom Amazon Rekognition	Baca
DescribeStreamProcessor	Memberikan izin untuk mendapatkan informasi tentang prosesor aliran yang ditentukan	Baca	streamprocessor*
DetectCustomLabels	Memberikan izin untuk mendeteksi label kustom dalam gambar yang disediakan	Baca	projectversion*
DetectFaces	Memberikan izin untuk mendeteksi wajah manusia dalam gambar yang disediakan sebagai masukan	Baca
DetectLabels	Memberikan izin untuk mendeteksi contoh label dunia nyata dalam gambar yang disediakan sebagai input	Baca
DetectModerationLabels	Memberikan izin untuk mendeteksi label moderasi dalam gambar input	Baca	projectversion
DetectProtectiveEquipment	Memberikan izin untuk mendeteksi Alat Pelindung Diri pada gambar input	Baca
DetectText	Memberikan izin untuk mendeteksi teks dalam gambar input dan mengubahnya menjadi teks yang dapat dibaca mesin	Baca
DisassociateFaces	Memberikan izin untuk menghapus asosiasi antara ID pengguna dan ID wajah	Tulis	collection*
DistributeDatasetEntries	Memberikan izin untuk mendistribusikan entri dalam kumpulan data pelatihan di seluruh kumpulan data pelatihan dan kumpulan data pengujian untuk proyek	Tulis	dataset*
GetCelebrityInfo	Memberikan izin untuk membaca nama, dan informasi tambahan, dari seorang selebriti	Baca
GetCelebrityRecognition	Memberikan izin untuk membaca hasil pengakuan selebriti yang ditemukan dalam video yang disimpan oleh pekerjaan pengakuan selebriti asinkron	Baca
GetContentModeration	Memberikan izin untuk membaca hasil analisis moderasi konten yang ditemukan dalam video yang disimpan oleh pekerjaan moderasi konten asinkron	Baca
GetFaceDetection	Memberikan izin untuk membaca hasil deteksi wajah yang ditemukan dalam video yang disimpan oleh pekerjaan deteksi wajah asinkron	Baca
GetFaceLivenessSessionResults	Memberikan izin untuk mendapatkan hasil sesi face liveness	Baca
GetFaceSearch	Memberikan izin untuk membaca wajah koleksi yang cocok yang ditemukan dalam video yang disimpan oleh pekerjaan pencarian wajah asinkron	Baca
GetLabelDetection	Memberikan izin untuk membaca hasil yang terdeteksi label yang ditemukan dalam video yang disimpan oleh pekerjaan deteksi label asinkron	Baca
GetMediaAnalysisJob	Memberikan izin untuk membaca referensi ke hasil pekerjaan di S3 dan informasi tambahan tentang pekerjaan analisis media	Baca
GetPersonTracking	Memberikan izin untuk membaca daftar orang yang terdeteksi dalam video yang disimpan oleh pekerjaan pelacakan orang asinkron	Baca
GetSegmentDetection	Memberikan izin untuk mendapatkan segmen vdeo yang ditemukan dalam video yang disimpan oleh pekerjaan deteksi segmen asinkron	Baca
GetTextDetection	Memberikan izin untuk mendapatkan teks yang ditemukan dalam video yang disimpan oleh pekerjaan deteksi teks asinkron	Baca
IndexFaces	Memberikan izin untuk memperbarui koleksi yang ada dengan wajah yang terdeteksi di gambar input	Tulis	collection*
ListCollections	Memberikan izin untuk membaca ID koleksi di akun Anda	Baca
ListDatasetEntries	Memberikan izin untuk mencantumkan entri kumpulan data dalam kumpulan data Label Kustom Rekognition Amazon yang ada	Baca	dataset*
ListDatasetLabels	Memberikan izin untuk mencantumkan label dalam kumpulan data	Baca	dataset*
ListFaces	Memberikan izin untuk membaca metadata untuk wajah dalam koleksi khusus	Baca	collection*
ListMediaAnalysisJobs	Memberikan izin untuk membaca daftar pekerjaan analisis media	Baca
ListProjectPolicies	Memberikan izin untuk membuat daftar kebijakan sumber daya yang dilampirkan ke proyek	Baca	project*
ListStreamProcessors	Memberikan izin untuk mendapatkan daftar prosesor streaming Anda	Daftar	streamprocessor*
ListTagsForResource	Memberikan izin untuk mengembalikan daftar tag yang terkait dengan sumber daya	Baca	projectversion*
ListUsers	Memberikan izin untuk daftar UserIds dan UserStatus	Baca	collection*
PutProjectPolicy	Memberikan izin untuk melampirkan kebijakan sumber daya ke proyek	Tulis	project*
RecognizeCelebrities	Memberikan izin untuk mendeteksi selebriti di gambar input	Baca
SearchFaces	Memberikan izin untuk mencari koleksi spesifik untuk ID wajah yang disediakan	Baca	collection*
SearchFacesByImage	Memberikan izin untuk mencari koleksi spesifik untuk wajah terbesar dalam gambar input	Baca	collection*
SearchUsers	Memberikan izin untuk mencari koleksi spesifik untuk hasil kecocokan pengguna dengan ID wajah atau ID pengguna yang diberikan	Baca	collection*
SearchUsersByImage	Memberikan izin untuk mencari koleksi spesifik untuk hasil kecocokan pengguna dengan menggunakan wajah terbesar di gambar input	Baca	collection*
StartCelebrityRecognition	Memberikan izin untuk memulai pengakuan asinkron selebriti dalam video yang disimpan	Tulis
StartContentModeration	Memberikan izin untuk memulai deteksi asinkron konten dewasa eksplisit atau sugestif dalam video yang disimpan	Tulis
StartFaceDetection	Memberikan izin untuk memulai deteksi wajah asinkron dalam video yang disimpan	Tulis
StartFaceLivenessSession	Memberikan izin untuk memulai streaming video untuk sesi keaktifan wajah	Tulis
StartFaceSearch	Memberikan izin untuk memulai pencarian asinkron untuk wajah dalam koleksi yang cocok dengan wajah orang yang terdeteksi dalam video yang disimpan	Tulis	collection*
StartLabelDetection	Memberikan izin untuk memulai deteksi label asinkron dalam video yang disimpan	Tulis
StartMediaAnalysisJob	Memberikan izin untuk memulai pekerjaan analisis media	Tulis	projectversion
StartPersonTracking	Memberikan izin untuk memulai pelacakan asinkron orang dalam video yang disimpan	Tulis
StartProjectVersion	Memberikan izin untuk mulai menjalankan versi model	Tulis	projectversion*
StartSegmentDetection	Memberikan izin untuk memulai deteksi asinkron segmen dalam video yang disimpan	Tulis
StartStreamProcessor	Memberikan izin untuk mulai menjalankan prosesor aliran	Tulis	streamprocessor*
StartTextDetection	Memberikan izin untuk memulai deteksi teks asinkron dalam video yang disimpan	Tulis
StopProjectVersion	Memberikan izin untuk menghentikan versi model yang sedang berjalan	Tulis	projectversion*
StopStreamProcessor	Memberikan izin untuk menghentikan prosesor aliran yang sedang berjalan	Tulis	streamprocessor*
TagResource	Memberikan izin untuk menambahkan satu atau beberapa tag ke sumber daya	Penandaan	collection
			projectversion
			streamprocessor
				aws:RequestTag/${TagKey} aws:TagKeys
UntagResource	Memberikan izin untuk menghapus satu atau beberapa tag dari sumber daya	Penandaan	collection
			projectversion
			streamprocessor
				aws:TagKeys
UpdateDatasetEntries	Memberikan izin untuk menambah atau memperbarui satu atau beberapa JSON Lines (entri) dalam kumpulan data	Tulis	dataset*
UpdateStreamProcessor	Memberikan izin untuk memodifikasi properti untuk prosesor aliran	Tulis	streamprocessor*

Jenis sumber daya yang ditentukan oleh Amazon Rekognition

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
collection	arn:${Partition}:rekognition:${Region}:${Account}:collection/${CollectionId}	aws:ResourceTag/${TagKey}
streamprocessor	arn:${Partition}:rekognition:${Region}:${Account}:streamprocessor/${StreamprocessorId}	aws:ResourceTag/${TagKey}
project	arn:${Partition}:rekognition:${Region}:${Account}:project/${ProjectName}/${CreationTimestamp}
projectversion	arn:${Partition}:rekognition:${Region}:${Account}:project/${ProjectName}/version/${VersionName}/${CreationTimestamp}	aws:ResourceTag/${TagKey}
dataset	arn:${Partition}:rekognition:${Region}:${Account}:project/${ProjectName}/dataset/${DatasetType}/${CreationTimestamp}

Kunci kondisi untuk Amazon Rekognition

Amazon Rekognition 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 kondisi global yang tersedia.

Kunci syarat	Deskripsi	Jenis
aws:RequestTag/${TagKey}	Memfilter akses dengan tag yang diteruskan dalam permintaan	String
aws:ResourceTag/${TagKey}	Memfilter akses dengan tag yang terkait dengan sumber daya	String
aws:TagKeys	Memfilter akses dengan kunci tag yang diteruskan dalam permintaan	ArrayOfString