All Products
Search
Document Center

Key Management Service:SetKeyPolicy

Last Updated:Dec 21, 2025

Menetapkan kebijakan kunci untuk suatu kunci dalam instans KMS.

Deskripsi operasi

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

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 acs:kms:${region}:${account}:key/${keyid}.

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:

  • Version: Versi kebijakan kunci. Nilainya hanya boleh 1.

  • Statement: Pernyataan kebijakan kunci. Setiap kebijakan kunci dapat berisi satu atau beberapa pernyataan.

Kode berikut memberikan contoh kebijakan kunci:

{
    "Version": "1",
    "Statement": [
        {
            "Sid": "Enable RAM User Permissions",
            "Effect": "Allow",
            "Principal": {
              "RAM": ["acs:ram::112890462****:*"]
            },
            "Action": [
                "kms:*"
            ],
            "Resource": [
                "*"
            ]
        }
    ]
}

Bagian berikut menjelaskan elemen-elemen dalam Statement:

  • Sid: Opsional. Pengidentifikasi pernyataan khusus. Nilainya dapat mencapai panjang 128 karakter dan boleh berisi huruf besar, huruf kecil, angka, serta karakter khusus berikut: _ / + = . @ -.

  • Effect: Wajib diisi. Efek dari pernyataan kebijakan. Nilai yang valid: Allow dan Deny.

  • Principal: Wajib diisi. Pihak yang berwenang yang diberi izin untuk mengakses kunci. Anda dapat mengatur parameter ini ke Akun Alibaba Cloud saat ini, RAM user atau RAM role dari Akun Alibaba Cloud saat ini, atau RAM user atau RAM role dari Akun Alibaba Cloud lain.

  • Action: Wajib diisi. Operasi API yang diizinkan atau ditolak. Nilainya harus diawali dengan kms:. Untuk informasi selengkapnya mengenai operasi tersebut, lihat Ikhtisar kebijakan kunci. Jika Anda menentukan operasi yang tidak termasuk dalam daftar, operasi tersebut tidak akan berlaku.

  • Resource: Wajib diisi. Kunci tersebut. Nilainya hanya boleh *.

  • Condition: Opsional. Kondisi agar kebijakan berlaku. Anda dapat menggunakan kondisi untuk mengevaluasi konteks permintaan API guna menentukan apakah pernyataan kebijakan berlaku. Formatnya adalah "Condition": {"condition operator": {"condition key": "condition value"}}. Untuk informasi selengkapnya, lihat Ikhtisar kebijakan kunci.

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.