All Products
Search

This Product

    Key Management Service:RotateSecret

    Document Center

    Key Management Service:RotateSecret

    Last Updated:Jun 10, 2026

    Segera melakukan rotasi pada secret.

    Deskripsi operasi

    Batasan:

    • Sebuah secret pada setiap akun Alibaba Cloud dapat dirotasi maksimum 50 kali per jam.

    • Operasi RotateSecret tidak tersedia untuk secret standar.

    Dalam contoh ini, secret RdsSecret/Mysql5.4/MyCred dirotasi secara manual, dan nomor versi secret ditetapkan menjadi 000000123 setelah secret dirotasi.

    Untuk informasi lebih lanjut tentang kebijakan akses yang diperlukan oleh pengguna RAM atau peran RAM untuk memanggil API ini, lihat Resource Access Management.

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

    Catatan

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

    000000123

    Elemen respons

    Element

    Type

    Description

    Example

    object

    VersionId

    string

    Nomor versi secret setelah secret dirotasi.

    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.