Tous les produits
Search
Centre de documentation

:RotateSecret

Dernière mise à jour :Aug 06, 2026

Effectue immédiatement la rotation d'un secret.

Description de l'opération

Limites :

• Un secret de chaque compte Alibaba Cloud peut faire l'objet d'une rotation au maximum 50 fois par heure.

• L'opération RotateSecret n'est pas disponible pour les secrets standard.

Dans cet exemple, le secret RdsSecret/Mysql5.4/MyCred est soumis à une rotation manuelle, et le numéro de version du secret est défini sur 000000123 après la rotation.

Pour plus d'informations sur la stratégie d'accès requise par un utilisateur RAM ou un rôle RAM pour appeler cette API, consultez Resource Access Management.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Aucune autorisation n'est requise pour cette opération. En cas de problème, contactez le support technique.

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

SecretName

string

Oui

Le nom du secret.

RdsSecret/Mysql5.4/MyCred

VersionId

string

Oui

Le numéro de version du secret après la rotation du secret.\n\n> Le numéro de version est utilisé pour garantir l'idempotence de la requête. Secrets Manager utilise ce numéro de version pour empêcher votre application de créer la même version du secret lorsqu'elle réessaie une requête. Si un numéro de version existe déjà, Secrets Manager ignore la requête de rotation et renvoie un message de réussite.

000000123

Éléments de réponse

Élément

Type

Description

Exemple

object

VersionId

string

Le numéro de version du secret après la rotation du secret.

000000123

SecretName

string

Le nom du secret.

RdsSecret/Mysql5.4/MyCred

RequestId

string

L'identifiant de la requête.

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

Arn

string

L'Alibaba Cloud Resource Name (ARN) du secret.

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

Exemples

JSON format

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

Codes d'erreur

Code de statut HTTP

Code d'erreur

Message d'erreur

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.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.