Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Kunci tindakan, sumber daya, dan kondisi untuk Amazon API Gateway Management V2
Amazon API Gateway Management V2 (awalan layanan:apigateway) 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 Amazon API Gateway Management V2
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 |
|---|---|---|---|---|---|
| DELETE | Memberikan izin untuk menghapus sumber daya tertentu | Tulis | |||
| GET | Memberikan izin untuk membaca sumber daya tertentu | Baca | |||
| PATCH | Memberikan izin untuk memperbarui sumber daya tertentu | Tulis | |||
| POST | Memberikan izin untuk membuat sumber daya tertentu | Tulis | |||
| PUT | Memberikan izin untuk memperbarui sumber daya tertentu | Tulis | |||
Jenis sumber daya yang ditentukan oleh Amazon API Gateway Management V2
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 |
|---|---|---|
| AccessLogSettings |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/stages/${StageName}/accesslogsettings
|
|
| Api |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}
|
apigateway:Request/ApiKeyRequired apigateway:Request/AuthorizerType apigateway:Request/AuthorizerUri apigateway:Request/DisableExecuteApiEndpoint apigateway:Request/EndpointType apigateway:Request/RouteAuthorizationType apigateway:Resource/ApiKeyRequired apigateway:Resource/AuthorizerType apigateway:Resource/AuthorizerUri apigateway:Resource/DisableExecuteApiEndpoint apigateway:Resource/EndpointType |
| Apis |
arn:${Partition}:apigateway:${Region}::/apis
|
apigateway:Request/ApiKeyRequired apigateway:Request/AuthorizerType apigateway:Request/AuthorizerUri apigateway:Request/DisableExecuteApiEndpoint apigateway:Request/EndpointType |
| ApiMapping |
arn:${Partition}:apigateway:${Region}::/domainnames/${DomainName}/apimappings/${ApiMappingId}
|
|
| ApiMappings |
arn:${Partition}:apigateway:${Region}::/domainnames/${DomainName}/apimappings
|
|
| Authorizer |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/authorizers/${AuthorizerId}
|
apigateway:Request/AuthorizerType apigateway:Request/AuthorizerUri apigateway:Resource/AuthorizerType |
| Authorizers |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/authorizers
|
apigateway:Request/AuthorizerType |
| AuthorizersCache |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/stages/${StageName}/cache/authorizers
|
|
| Cors |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/cors
|
|
| Deployment |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/deployments/${DeploymentId}
|
|
| Deployments |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/deployments
|
|
| ExportedAPI |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/exports/${Specification}
|
|
| Integration |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/integrations/${IntegrationId}
|
|
| Integrations |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/integrations
|
|
| IntegrationResponse |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/integrations/${IntegrationId}/integrationresponses/${IntegrationResponseId}
|
|
| IntegrationResponses |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/integrations/${IntegrationId}/integrationresponses
|
|
| Model |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/models/${ModelId}
|
|
| Models |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/models
|
|
| ModelTemplate |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/models/${ModelId}/template
|
|
| Route |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/routes/${RouteId}
|
apigateway:Request/ApiKeyRequired apigateway:Request/RouteAuthorizationType apigateway:Resource/ApiKeyRequired |
| Routes |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/routes
|
apigateway:Request/ApiKeyRequired |
| RouteResponse |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/routes/${RouteId}/routeresponses/${RouteResponseId}
|
|
| RouteResponses |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/routes/${RouteId}/routeresponses
|
|
| RouteRequestParameter |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/routes/${RouteId}/requestparameters/${RequestParameterKey}
|
|
| RouteSettings |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/stages/${StageName}/routesettings/${RouteKey}
|
|
| Stage |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/stages/${StageName}
|
apigateway:Request/AccessLoggingDestination apigateway:Request/AccessLoggingFormat apigateway:Resource/AccessLoggingDestination |
| Stages |
arn:${Partition}:apigateway:${Region}::/apis/${ApiId}/stages
|
apigateway:Request/AccessLoggingDestination |
| VpcLink |
arn:${Partition}:apigateway:${Region}::/vpclinks/${VpcLinkId}
|
|
| VpcLinks |
arn:${Partition}:apigateway:${Region}::/vpclinks
|
Kunci kondisi untuk Amazon API Gateway Management V2
Amazon API Gateway Management V2 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 |
|---|---|---|
| apigateway:Request/AccessLoggingDestination | Memfilter akses berdasarkan tujuan log akses. Tersedia selama CreateStage dan UpdateStage operasi | String |
| apigateway:Request/AccessLoggingFormat | Memfilter akses dengan format log akses. Tersedia selama CreateStage dan UpdateStage operasi | String |
| apigateway:Request/ApiKeyRequired | Memfilter akses dengan persyaratanAPI. Tersedia selama CreateRoute dan UpdateRoute operasi. Juga tersedia sebagai koleksi selama impor dan impor ulang | ArrayOfBool |
| apigateway:Request/ApiName | Memfilter akses berdasarkan API nama. Tersedia selama CreateApi dan UpdateApi operasi | String |
| apigateway:Request/AuthorizerType | Memfilter akses berdasarkan jenis otorisasi dalam permintaan, misalnya REQUEST atauJWT. Tersedia selama CreateAuthorizer dan UpdateAuthorizer. Juga tersedia selama impor dan impor ulang sebagai ArrayOfString | ArrayOfString |
| apigateway:Request/AuthorizerUri | Memfilter akses oleh URI fungsi otorisasi Lambda. Tersedia selama CreateAuthorizer dan UpdateAuthorizer. Juga tersedia selama impor dan impor ulang sebagai ArrayOfString | ArrayOfString |
| apigateway:Request/DisableExecuteApiEndpoint | Memfilter akses berdasarkan status titik akhir execute-api default. Tersedia selama CreateApi dan UpdateApi operasi | Bool |
| apigateway:Request/EndpointType | Memfilter akses berdasarkan jenis titik akhir. Tersedia selama CreateDomainName, UpdateDomainName, CreateApi, dan UpdateApi operasi | ArrayOfString |
| apigateway:Request/MtlsTrustStoreUri | Memfilter akses oleh URI truststore yang digunakan untuk otentikasi timbal balikTLS. Tersedia selama CreateDomainName dan UpdateDomainName operasi | String |
| apigateway:Request/MtlsTrustStoreVersion | Memfilter akses berdasarkan versi truststore yang digunakan untuk otentikasi timbal balikTLS. Tersedia selama CreateDomainName dan UpdateDomainName operasi | String |
| apigateway:Request/RouteAuthorizationType | Memfilter akses berdasarkan jenis otorisasi, misalnyaNONE,, AWS_IAMCUSTOM,JWT. Tersedia selama CreateRoute dan UpdateRoute operasi. Juga tersedia sebagai koleksi selama impor | ArrayOfString |
| apigateway:Request/SecurityPolicy | Memfilter akses berdasarkan TLS versi. Tersedia selama CreateDomain dan UpdateDomain operasi | ArrayOfString |
| apigateway:Request/StageName | Memfilter akses berdasarkan nama tahap penerapan yang Anda coba buat. Tersedia selama CreateDeployment operasi | String |
| apigateway:Resource/AccessLoggingDestination | Memfilter akses dengan tujuan log akses dari sumber daya Tahap saat ini. Tersedia selama UpdateStage dan DeleteStage operasi | String |
| apigateway:Resource/AccessLoggingFormat | Memfilter akses dengan format log akses dari sumber daya Tahap saat ini. Tersedia selama UpdateStage dan DeleteStage operasi | String |
| apigateway:Resource/ApiKeyRequired | Memfilter akses dengan persyaratan API kunci untuk sumber daya Rute yang ada. Tersedia selama UpdateRoute dan DeleteRoute operasi. Juga tersedia sebagai koleksi selama impor ulang | ArrayOfBool |
| apigateway:Resource/ApiName | Memfilter akses berdasarkan API nama. Tersedia selama UpdateApi dan DeleteApi operasi | String |
| apigateway:Resource/AuthorizerType | Memfilter akses berdasarkan jenis otorisasi saat ini, misalnya REQUEST atauJWT. Tersedia selama UpdateAuthorizer dan DeleteAuthorizer operasi. Juga tersedia selama impor dan impor ulang sebagai ArrayOfString | ArrayOfString |
| apigateway:Resource/AuthorizerUri | Memfilter akses oleh otorisasi Lambda saat ini yang terkait dengan arus. URI API Tersedia selama UpdateAuthorizer dan DeleteAuthorizer. Juga tersedia sebagai koleksi selama impor ulang | ArrayOfString |
| apigateway:Resource/DisableExecuteApiEndpoint | Memfilter akses berdasarkan status titik akhir execute-api default. Tersedia selama UpdateApi dan DeleteApi operasi | Bool |
| apigateway:Resource/EndpointType | Memfilter akses berdasarkan jenis titik akhir. Tersedia selama UpdateDomainName, DeleteDomainName, UpdateApi, dan DeleteApi operasi | ArrayOfString |
| apigateway:Resource/MtlsTrustStoreUri | Memfilter akses oleh URI truststore yang digunakan untuk otentikasi timbal balikTLS. Tersedia selama UpdateDomainName dan DeleteDomainName operasi | String |
| apigateway:Resource/MtlsTrustStoreVersion | Memfilter akses berdasarkan versi truststore yang digunakan untuk otentikasi timbal balikTLS. Tersedia selama UpdateDomainName dan DeleteDomainName operasi | String |
| apigateway:Resource/RouteAuthorizationType | Memfilter akses berdasarkan jenis otorisasi sumber daya Route yang ada, misalnya NONE AWS_IAM,CUSTOM. Tersedia selama UpdateRoute dan DeleteRoute operasi. Juga tersedia sebagai koleksi selama impor ulang | ArrayOfString |
| apigateway:Resource/SecurityPolicy | Memfilter akses berdasarkan TLS versi. Tersedia selama UpdateDomainName dan DeleteDomainName operasi | ArrayOfString |
| aws:RequestTag/${TagKey} | Memfilter akses dengan adanya pasangan nilai kunci tag dalam permintaan | String |
| aws:ResourceTag/${TagKey} | Memfilter akses dengan pasangan nilai kunci tag yang dilampirkan ke sumber daya | String |
| aws:TagKeys | Memfilter akses dengan adanya kunci tag dalam permintaan | ArrayOfString |
