All Products
Search

This Product

    Key Management Service:UpdateSecretVersionStage

    Document Center

    Key Management Service:UpdateSecretVersionStage

    Last Updated:Jun 10, 2026

    Memindahkan label tahap versi ke versi secret yang berbeda.

    Deskripsi operasi

    • Untuk informasi lebih lanjut tentang 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 secret generik. Anda dapat melakukan operasi berikut:

      • Menambahkan tahap versi ke versi secret tertentu.

      • Menghapus tahap versi dari versi secret tertentu.

      • Menghapus tahap versi dari versi secret tertentu dan melampirkannya ke versi secret lain.

    • Total jumlah tahap versi untuk setiap secret generik tidak boleh melebihi 8.

    Topik ini memberikan contoh cara memperbarui tahap versi dari secret bernama secret001. Dalam contoh ini, tahap 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) dari secret.

    Catatan

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

    secret001
    VersionStage

    string

    Yes

    Tahap versi dari secret.

    Skenario 1: Menambahkan tahap versi ke versi secret tertentu.

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

    Skenario 2: Menghapus tahap versi dari versi secret tertentu.

    Tentukan parameter ini dan RemoveFromVersion. Jangan menentukan MoveToVersion. Parameter ini harus diatur ke tahap kustom.

    Catatan

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

    Skenario 3: Menghapus tahap versi dari versi secret tertentu dan melampirkannya ke versi secret lain.

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

    ACSCurrent
    RemoveFromVersion

    string

    No

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

    Catatan

    Anda harus menentukan setidaknya salah satu dari RemoveFromVersion dan MoveToVersion.

    001
    MoveToVersion

    string

    No

    Nomor versi dari secret. Parameter ini menentukan bahwa tahap versi yang diatur oleh VersionStage dilampirkan ke versi ini.

    Catatan

    • Anda harus menentukan setidaknya salah satu dari RemoveFromVersion dan 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 dari secret.

    secret001
    RequestId

    string

    ID dari permintaan. Alibaba Cloud menghasilkan ID unik untuk setiap permintaan. Anda dapat menggunakan ID tersebut 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.