Menetapkan kebijakan kunci untuk suatu kunci dalam instans KMS.
Deskripsi operasi
-
Untuk informasi mengenai kebijakan akses yang diperlukan agar pengguna RAM atau peran RAM dapat memanggil operasi API ini, lihat Resource Access Management.
-
Untuk informasi selengkapnya tentang kebijakan kunci, lihat Ikhtisar kebijakan kunci.
Coba sekarang
Test
RAM authorization
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| KeyId |
string |
Yes |
ID atau Alibaba Cloud Resource Name (ARN) dari kunci tersebut. Catatan
Untuk mengakses kunci milik Akun Alibaba Cloud lain, Anda harus menentukan ARN kunci tersebut. Format ARN kunci adalah |
key-hzz630494463ejqjx**** |
| PolicyName |
string |
No |
Nama kebijakan kunci. Nama hanya dapat berupa `default`. |
default |
| Policy |
string |
Yes |
Kebijakan kunci. Kebijakan ini menggunakan format JSON dan panjangnya maksimal 32.768 byte. Kebijakan kunci terdiri atas elemen-elemen berikut:
Kode berikut memberikan contoh kebijakan kunci:
Bagian berikut menjelaskan elemen-elemen dalam Statement:
Catatan
Setelah Anda memberikan izin kepada RAM user atau RAM role milik Akun Alibaba Cloud lain, Anda harus menggunakan Akun Alibaba Cloud tempat RAM user atau RAM role tersebut berada untuk memberikan izin penggunaan kunci melalui Konsol RAM. Untuk informasi selengkapnya, lihat Kebijakan khusus untuk KMS, Memberikan izin kepada RAM user, dan Memberikan izin kepada RAM role. |
{"Statement":[{"Action":["kms:*"],"Effect":"Allow","Principal":{"RAM":["acs:ram::119285303511****:*"]},"Resource":["*"],"Sid":"kms default key policy"},{"Action":["kms:List*","kms:Describe*","kms:Create*","kms:Enable*","kms:Disable*","kms:Get*","kms:Set*","kms:Update*","kms:Delete*","kms:Cancel*","kms:TagResource","kms:UntagResource","kms:ImportKeyMaterial","kms:ScheduleKeyDeletion"],"Effect":"Allow","Principal":{"RAM":["acs:ram::119285303511****:user/for_test_policy"]},"Resource":["*"]}],"Version":"1"} |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
|||
| RequestId |
string |
ID permintaan, yaitu pengidentifikasi unik yang dihasilkan oleh Alibaba Cloud. Anda dapat menggunakan ID ini untuk memecahkan masalah. |
381D5D33-BB8F-395F-8EE4-AE3BB4B523C8 |
Contoh
Respons sukses
JSONformat
{
"RequestId": "381D5D33-BB8F-395F-8EE4-AE3BB4B523C8"
}
Kode kesalahan
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | MissingParameter | The parameter needed but no provided. | The required parameters are not specified. |
| 400 | InvalidParameter | The specified parameter is not valid. | An invalid value is specified for the parameter. |
| 400 | Forbidden.NoPermission | This operation is forbidden by permission system. | You are not authorized to perform this operation. |
| 400 | Forbidden.KeyPolicyUnSupported | The specified key does not support key policy. | The specified key does not support key policies. |
| 400 | Rejected.ShareQuotaExceedLimit | Instance Share Quota Exceed Limit. | The instance share quota exceeds the limit. |
| 500 | InternalFailure | Internal Failure | An internal error occurred. |
| 403 | Forbidden.DKMSInstanceStateInvalid | The DKMS instance state is invalid. | Your dedicated KMS instance is invalid. |
| 404 | Forbidden.KeyNotFound | The specified Key is not found. | The error message returned because the specified CMK does not exist. |
| 404 | Forbidden.ResourceNotFound | Policy not found. |
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.