All Products
Search

This Product

    Key Management Service:RotateSecret

    Document Center

    Key Management Service:RotateSecret

    Last Updated:Dec 21, 2025

    Memutar ulang sebuah secret secara manual.

    Deskripsi operasi

    Batasan:

    • Setiap secret dalam Akun Alibaba Cloud dapat diputar ulang maksimal 50 kali per jam.

    • Operasi RotateSecret tidak tersedia untuk secret standar.

    Pada contoh ini, secret RdsSecret/Mysql5.4/MyCred diputar ulang secara manual, dan nomor versi secret diatur menjadi 000000123 setelah pemutaran ulang.

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

    RdsSecret/Mysql5.4/MyCred
    VersionId

    string

    Yes

    Nomor versi secret setelah secret diputar ulang.

    Catatan

    Nomor versi digunakan untuk memastikan idempotensi permintaan. Secrets Manager menggunakan nomor versi ini untuk mencegah aplikasi Anda membuat versi secret yang sama ketika aplikasi mencoba ulang permintaan. Jika nomor versi tersebut sudah ada, Secrets Manager akan mengabaikan permintaan rotasi dan mengembalikan pesan sukses.

    000000123

    Elemen respons

    Element

    Type

    Description

    Example

    object

    VersionId

    string

    Nomor versi secret setelah secret diputar ulang.

    000000123
    SecretName

    string

    Nama secret.

    RdsSecret/Mysql5.4/MyCred
    RequestId

    string

    ID permintaan.

    10257c86-269d-43aa-aaf3-90ed4144bb7c
    Arn

    string

    Alibaba Cloud Resource Name (ARN) dari secret.

    acs:kms:cn-hangzhou:154035569884****:secret/RdsSecret/Mysql5.4/MyCred

    Contoh

    Respons sukses

    JSONformat

    {
  "VersionId": "000000123",
  "SecretName": "RdsSecret/Mysql5.4/MyCred",
  "RequestId": "10257c86-269d-43aa-aaf3-90ed4144bb7c",
  "Arn": "acs:kms:cn-hangzhou:154035569884****:secret/RdsSecret/Mysql5.4/MyCred"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidParameter The specified parameter is not valid. An invalid value is specified for the parameter.
    404 InvalidAccessKeyId.NotFound The Access Key ID provided does not exist in our records.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.