All Products
Search

This Product

    Key Management Service:UpdateSecretVersionStage

    Document Center

    Key Management Service:UpdateSecretVersionStage

    Last Updated:Dec 21, 2025

    Memperbarui stage versi sebuah secret.

    Deskripsi operasi

    • Untuk informasi selengkapnya mengenai kebijakan akses yang diperlukan untuk memanggil operasi ini sebagai pengguna Resource Access Management (RAM) atau peran RAM, lihat Resource Access Management.

    • Operasi ini hanya mendukung generic secret. Anda dapat melakukan hal berikut:

      • Menambahkan stage versi ke versi secret tertentu.

      • Menghapus stage versi dari versi secret tertentu.

      • Memindahkan stage versi dari satu versi secret ke versi secret lainnya.

    • Jumlah total stage versi untuk setiap generic secret tidak boleh melebihi 8.

    Topik ini memberikan contoh cara memperbarui stage versi secret bernama secret001. Dalam contoh ini, stage ACSCurrent digunakan untuk menandai versi 002.

    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) secret tersebut.

    Catatan

    Untuk mengakses secret di akun Alibaba Cloud yang berbeda, Anda harus menentukan ARN secret tersebut. Format ARN adalah acs:kms:${region}:${account}:secret/${secret-name}.

    secret001
    VersionStage

    string

    Yes

    Stage versi secret tersebut.

    Skenario 1: Menambahkan stage versi ke versi secret tertentu.

    Tentukan parameter ini dan MoveToVersion. Jangan tentukan RemoveFromVersion. Parameter ini dapat diatur ke ACSCurrent, ACSPrevious, atau stage kustom.

    Skenario 2: Menghapus stage versi dari versi secret tertentu.

    Tentukan parameter ini dan RemoveFromVersion. Jangan tentukan MoveToVersion. Parameter ini harus diatur ke stage kustom.

    Catatan

    ACSCurrent dan ACSPrevious adalah stage yang dicadangkan sistem. Anda tidak dapat menghapusnya secara langsung. Anda hanya dapat menghapusnya dari satu versi secret dan menyambungkannya ke versi lain.

    Skenario 3: Menghapus stage versi dari versi secret tertentu dan menyambungkannya ke versi secret lain.

    Tentukan parameter ini, MoveToVersion, dan RemoveFromVersion. Parameter ini dapat diatur ke ACSCurrent, ACSPrevious, atau stage kustom.

    ACSCurrent
    RemoveFromVersion

    string

    No

    Nomor versi secret tersebut. Parameter ini menentukan bahwa stage versi yang diatur oleh VersionStage dihapus dari versi ini.

    Catatan

    Anda harus menentukan setidaknya salah satu dari RemoveFromVersion atau MoveToVersion.

    001
    MoveToVersion

    string

    No

    Nomor versi secret tersebut. Parameter ini menentukan bahwa stage versi yang diatur oleh VersionStage disambungkan ke versi ini.

    Catatan

    • Anda harus menentukan setidaknya salah satu dari RemoveFromVersion atau MoveToVersion.

    • Jika Anda mengatur VersionStage ke ACSCurrent atau ACSPrevious, Anda harus menentukan parameter ini.

    002

    Elemen respons

    Element

    Type

    Description

    Example

    object

    SecretName

    string

    Nama secret tersebut.

    secret001
    RequestId

    string

    ID permintaan. Alibaba Cloud menghasilkan ID unik untuk setiap permintaan. Anda dapat menggunakan ID ini untuk memecahkan masalah.

    8cad259f-4d77-40ec-bbd7-b9c47a423bb9

    Contoh

    Respons sukses

    JSONformat

    {
  "SecretName": "secret001",
  "RequestId": "8cad259f-4d77-40ec-bbd7-b9c47a423bb9"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidParameter some of the specified parameters "\" is not valid
    400 Rejected.LimitExceeded exceed secret limits error
    400 Rejected.InvalidRequest param mismatch
    400 Rejected.UnsupportedOperation secret stages in unnormal status
    500 InternalFailure Internal Failure
    403 Forbidden.NoPermission This operation is forbidden by permission system
    404 Forbidden.ResourceNotFound Resource not found
    409 Rejected.ResourceInDeleteWindow secret in delete peroid

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.