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 AWS X-Ray
AWS X-Ray (awalan layanan:xray) menyediakan sumber daya, tindakan, dan kunci konteks kondisi khusus layanan berikut untuk digunakan dalam IAM kebijakan izin.
Referensi:
-
Pelajari cara mengonfigurasi layanan ini.
-
Lihat daftar APIoperasi yang tersedia untuk layanan ini.
-
Pelajari cara mengamankan layanan ini dan sumber dayanya dengan menggunakan kebijakan IAM izin.
Topik
Tindakan yang ditentukan oleh AWS X-Ray
Anda dapat menentukan tindakan berikut dalam Action elemen pernyataan IAM kebijakan. Gunakan kebijakan untuk memberikan izin untuk melaksanakan operasi dalam AWS. Ketika Anda menggunakan tindakan dalam kebijakan, Anda biasanya mengizinkan atau menolak akses ke API operasi atau CLI perintah 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 menyertakan jenis sumber daya, maka Anda dapat menentukan ARN jenis itu dalam 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 IAM kebijakan, Anda harus menyertakan pola ARN atau 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 |
|---|---|---|---|---|---|
| BatchGetTraceSummaryById[hanya izin] | Memberikan izin untuk mengambil metadata untuk daftar jejak yang ditentukan oleh ID | Baca | |||
| BatchGetTraces | Memberikan izin untuk mengambil daftar jejak yang ditentukan oleh ID. Setiap jejak adalah kumpulan dokumen segmen yang berasal dari satu permintaan. Gunakan GetTraceSummaries untuk mendapatkan daftar jejak IDs | Daftar | |||
| CancelTraceRetrieval | Memberikan izin untuk membatalkan pekerjaan pengambilan jejak yang sedang berlangsung yang dimulai dengan StartTraceRetrieval menggunakan yang disediakan. RetrievalToken Pembatalan yang berhasil akan mengembalikan respons HTTP 200 | Baca | |||
| CreateGroup | Memberikan izin untuk membuat sumber daya grup dengan nama dan ekspresi filter | Tulis | |||
| CreateSamplingRule | Memberikan izin untuk membuat aturan untuk mengontrol perilaku pengambilan sampel untuk aplikasi yang diinstrumentasi | Tulis | |||
| DeleteGroup | Memberikan izin untuk menghapus sumber daya grup | Tulis | |||
| DeleteResourcePolicy | Memberikan izin untuk menghapus kebijakan sumber daya | Tulis | |||
| DeleteSamplingRule | Memberikan izin untuk menghapus aturan pengambilan sampel | Tulis | |||
| GetDistinctTraceGraphs[hanya izin] | Memberikan izin untuk mengambil grafik layanan yang berbeda untuk satu atau lebih jejak spesifik IDs | Baca | |||
| GetEncryptionConfig | Memberikan izin untuk mengambil konfigurasi enkripsi saat ini untuk data X-Ray | Baca | |||
| GetGroup | Memberikan izin untuk mengambil detail sumber daya grup | Baca | |||
| GetGroups | Memberikan izin untuk mengambil semua detail grup aktif | Baca | |||
| GetIndexingRules | Memberikan izin untuk mengambil semua aturan pengindeksan. Aturan pengindeksan digunakan untuk menentukan laju pengambilan sampel sisi server untuk rentang yang dicerna melalui tujuan dan diindeks oleh X-Ray CloudWatchLogs | Baca | |||
| GetInsight | Memberikan izin untuk mengambil detail wawasan tertentu | Baca | |||
| GetInsightEvents | Memberikan izin untuk mengambil peristiwa dari wawasan tertentu | Baca | |||
| GetInsightImpactGraph | Memberikan izin untuk mengambil bagian dari grafik layanan yang terpengaruh untuk wawasan tertentu | Baca | |||
| GetInsightSummaries | Memberikan izin untuk mengambil ringkasan semua wawasan untuk grup dan rentang waktu dengan filter opsional | Baca | |||
| GetRetrievedTracesGraph | Memberikan izin untuk mengambil grafik layanan untuk jejak berdasarkan yang ditentukan RetrievalToken dari grup log CloudWatch Penelusuran Transaksi | Baca | |||
| GetSamplingRules | Memberikan izin untuk mengambil semua aturan pengambilan sampel | Baca | |||
| GetSamplingStatisticSummaries | Memberikan izin untuk mengambil informasi tentang hasil pengambilan sampel terbaru untuk semua aturan pengambilan sampel | Baca | |||
| GetSamplingTargets | Memberikan izin untuk meminta kuota sampling untuk aturan yang digunakan layanan untuk sampel permintaan | Baca | |||
| GetServiceGraph | Memberikan izin untuk mengambil dokumen yang menjelaskan layanan yang memproses permintaan masuk, dan layanan hilir yang mereka panggil sebagai hasilnya | Baca | |||
| GetTimeSeriesServiceStatistics | Memberikan izin untuk mengambil agregasi statistik layanan yang ditentukan oleh rentang waktu tertentu yang dimasukkan ke dalam interval waktu | Baca | |||
| GetTraceGraph | Memberikan izin untuk mengambil grafik layanan untuk satu atau lebih jejak spesifik IDs | Baca | |||
| GetTraceSegmentDestination | Memberikan izin untuk mengambil tujuan data saat ini yang dikirim ke dan PutTraceSegments OpenTelemetry API | Baca | |||
| GetTraceSummaries | Memberikan izin untuk mengambil IDs dan metadata untuk jejak yang tersedia untuk jangka waktu tertentu menggunakan filter opsional. Untuk mendapatkan jejak penuh, berikan jejak IDs ke BatchGetTraces | Baca | |||
| Link[hanya izin] | Memberikan izin untuk berbagi sumber daya X-Ray dengan akun pemantauan | Tulis | |||
| ListResourcePolicies | Memberikan izin untuk membuat daftar kebijakan sumber daya | Daftar | |||
| ListRetrievedTraces | Memberikan izin untuk mengambil daftar jejak yang diberikan RetrievalToken dari grup log Penelusuran CloudWatch Transaksi | Daftar | |||
| ListTagsForResource | Memberikan izin untuk membuat daftar tag untuk sumber daya X-Ray | Daftar | |||
| PutEncryptionConfig | Memberikan izin untuk memperbarui konfigurasi enkripsi untuk data X-Ray | Manajemen izin | |||
| PutResourcePolicy | Memberikan izin untuk membuat atau memperbarui kebijakan sumber daya | Tulis | |||
| PutSpans | Memberikan izin untuk mengunggah OpenTelemetry rentang ke X-Ray AWS | Tulis | |||
| PutSpansForIndexing[hanya izin] | Memberikan izin untuk mengunggah rentang ke AWS X-Ray untuk diindeks | Tulis | |||
| PutTelemetryRecords | Memberikan izin untuk mengirim telemetri daemon AWS X-Ray ke layanan | Tulis | |||
| PutTraceSegments | Memberikan izin untuk mengunggah dokumen segmen ke AWS X-Ray. SDKX-Ray menghasilkan dokumen segmen dan mengirimkannya ke daemon X-Ray, yang mengunggahnya dalam batch | Tulis | |||
| StartTraceRetrieval | Memberikan izin untuk memulai proses pengambilan jejak menggunakan rentang waktu yang ditentukan dan untuk jejak yang diberikan IDs pada grup log Pencarian Transaksi CloudWatch | Baca | |||
| TagResource | Memberikan izin untuk menambahkan tag ke sumber daya X-Ray | Penandaan | |||
| UntagResource | Memberikan izin untuk menghapus tag dari sumber daya X-Ray | Penandaan | |||
| UpdateGroup | Memberikan izin untuk memperbarui sumber daya grup | Tulis | |||
| UpdateIndexingRule | Memberikan izin untuk memodifikasi konfigurasi aturan pengindeksan | Tulis | |||
| UpdateSamplingRule | Memberikan izin untuk memodifikasi konfigurasi aturan sampling | Tulis | |||
| UpdateTraceSegmentDestination | Memberikan izin untuk mengubah tujuan data yang dikirim ke PutTraceSegments dan OpenTelemetry API | Tulis |
Jenis sumber daya yang ditentukan oleh AWS X-Ray
Jenis sumber daya berikut ditentukan oleh layanan ini dan dapat digunakan dalam Resource elemen pernyataan kebijakan IAM izin. 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 |
|---|---|---|
| group |
arn:${Partition}:xray:${Region}:${Account}:group/${GroupName}/${Id}
|
|
| sampling-rule |
arn:${Partition}:xray:${Region}:${Account}:sampling-rule/${SamplingRuleName}
|
Kunci kondisi untuk AWS X-Ray
AWS X-Ray mendefinisikan kunci kondisi berikut yang dapat digunakan dalam Condition elemen IAM kebijakan. 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} | Filter akses berdasarkan tanda yang diberikan dalam permintaan | String |
| aws:ResourceTag/${TagKey} | Filter akses dengan tanda yang terkait dengan sumber daya | String |
| aws:TagKeys | Filter akses berdasarkan kunci tanda yang diberikan dalam permintaan | ArrayOfString |
