Menetapkan kebijakan kunci untuk CMK dalam instance KMS.
Deskripsi operasi
-
Untuk informasi tentang kebijakan akses yang diperlukan bagi pengguna RAM atau peran RAM untuk memanggil operasi API ini, lihat Resource Access Management.
-
Untuk informasi selengkapnya tentang kebijakan kunci, lihat Key policy overview.
Coba sekarang
Test
RAM authorization
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| KeyId |
string |
Yes |
ID atau Alibaba Cloud Resource Name (ARN) dari kunci. Catatan
Untuk mengakses kunci milik akun Alibaba Cloud lain, Anda harus menentukan ARN dari kunci tersebut. ARN kunci memiliki format |
key-hzz630494463ejqjx**** |
| PolicyName |
string |
No |
Nama kebijakan kunci. Nama hanya dapat berupa `default`. |
default |
| Policy |
string |
Yes |
Kebijakan kunci. Kebijakan dalam format JSON. Panjang kebijakan maksimum adalah 32.768 byte. Kebijakan kunci berisi elemen-elemen berikut:
Kode berikut memberikan contoh kebijakan kunci:
Bagian berikut menjelaskan elemen-elemen dalam Statement:
Catatan
Setelah Anda memberikan izin kepada pengguna RAM atau peran RAM dari akun Alibaba Cloud lain, Anda harus menggunakan akun Alibaba Cloud tempat pengguna RAM atau peran RAM tersebut berada untuk memberikan izin kepada pengguna RAM atau peran RAM tersebut untuk menggunakan kunci di konsol RAM. Untuk informasi selengkapnya, lihat Custom policies for KMS, Grant permissions to a RAM user, dan Grant permissions to a 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 dari permintaan, yang merupakan pengenal 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.