All Products
Search
Document Center

Key Management Service:SetSecretPolicy

Last Updated:Jun 10, 2026

Mengatur kebijakan akses untuk secret di instance 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

SecretName

string

Yes

Nama atau Alibaba Cloud Resource Name (ARN) dari secret.

Catatan

Saat Anda mengakses secret di akun Alibaba Cloud lain, Anda harus menentukan ARN dari secret tersebut. ARN dari secret memiliki format acs:kms:${region}:${account}:secret/${secret-name}.

secret_test

PolicyName

string

No

Nama dari kebijakan secret. Nilai hanya dapat berupa `default`.

default

Policy

string

Yes

Konten dari kebijakan secret. Nilai harus dalam format JSON. Nilai dapat memiliki panjang hingga 32.768 byte.

Kebijakan secret berisi elemen-elemen berikut:

  • Version: Versi dari kebijakan secret. Nilai hanya dapat berupa 1.

  • Statement: Pernyataan dari kebijakan secret. Setiap kebijakan secret dapat berisi satu atau lebih pernyataan.

Kode berikut menunjukkan format dari kebijakan secret:

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

Bagian berikut menjelaskan elemen-elemen dalam pernyataan:

  • Sid: Opsional. Pengidentifikasi kustom dari pernyataan. Nilai dapat memiliki panjang hingga 128 karakter dan dapat berisi huruf besar (A-Z), huruf kecil (a-z), digit (0-9), dan karakter khusus, termasuk garis bawah (_), garis miring (/), tanda sama dengan (=), tanda tambah (+), titik (.), tanda at (@), dan tanda hubung (-).

  • Effect: Wajib. Menentukan apakah akan mengizinkan atau menolak izin dalam pernyataan. Nilai yang valid: Allow dan Deny.

  • Principal: Wajib. Principal yang diberi otorisasi untuk mengakses secret. Anda dapat mengatur parameter ini ke akun Alibaba Cloud saat ini (akun tempat secret berada), pengguna RAM atau peran RAM dari akun Alibaba Cloud saat ini, atau pengguna RAM atau peran RAM dari akun Alibaba Cloud lain.

  • Action: Wajib. Operasi API yang diizinkan atau ditolak. Nilai harus diawali dengan `kms:`. Untuk daftar operasi yang didukung, lihat Ikhtisar kebijakan secret. Jika Anda menentukan operasi yang tidak ada dalam daftar, operasi tersebut tidak berlaku.

  • Resource: Wajib. Nilai hanya dapat berupa `*`, yang menunjukkan secret KMS saat ini.

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

Catatan

Setelah Anda memberikan izin kepada pengguna RAM atau peran RAM dari akun Alibaba Cloud lain, Anda harus pergi ke konsol RAM dan menggunakan akun Alibaba Cloud tempat pengguna RAM atau peran RAM berada untuk memberikan pengguna RAM atau peran RAM tersebut izin untuk menggunakan secret. Untuk informasi selengkapnya, lihat Kebijakan kustom untuk KMS, Berikan izin kepada pengguna RAM, dan Berikan izin kepada peran RAM.

{"Version":"1","Statement": [{"Sid":"kms default secret policy","Effect":"Allow","Principal":{"RAM": ["acs:ram::119285303511****:*"]},"Action":["kms:*"],"Resource": ["*"] }] }

Elemen respons

Element

Type

Description

Example

object

RequestId

string

ID dari permintaan, yang merupakan 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.
403 Forbidden.DKMSInstanceStateInvalid The DKMS instance state is invalid. Your dedicated KMS instance is invalid.
404 Forbidden.ResourceNotFound Resource not found. The resource is not found.
404 Forbidden.KeyNotFound The specified Key is not found. The error message returned because the specified CMK does not exist.
503 SerivceUnvailableTemporary Service Unvailable Temporary The service is temporarily unavailable.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.