UpdateSecretVersionStage - - Centre de documentation Alibaba Cloud

Description de l'opération

Pour plus d'informations sur la stratégie d'accès requise pour appeler cette opération en tant qu'utilisateur ou rôle Resource Access Management (RAM), consultez Resource Access Management.
Cette opération prend uniquement en charge les secrets génériques. Vous pouvez effectuer les opérations suivantes :
- Ajouter une étape de version à une version de secret spécifiée.
- Supprimer une étape de version d'une version de secret spécifiée.
- Supprimer une étape de version d'une version de secret spécifiée et l'associer à une autre version de secret.
Le nombre total d'étapes de version pour chaque secret générique ne peut pas dépasser 8.

Cette rubrique fournit un exemple de mise à jour de l'étape de version du secret nommé secret001. Dans cet exemple, l'étape ACSCurrent est utilisée pour marquer la version 002.

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 ou l'Alibaba Cloud Resource Name (ARN) du secret. Remarque Pour accéder à un secret dans un autre compte Alibaba Cloud, vous devez spécifier l'ARN du secret. L'ARN est au format `acs:kms:${region}:${account}:secret/${secret-name}`.	secret001
VersionStage	string	Oui	L'étape de version du secret. Scénario 1 : Ajouter une étape de version à une version de secret spécifiée. Spécifiez ce paramètre et MoveToVersion. Ne spécifiez pas RemoveFromVersion. Ce paramètre peut être défini sur ACSCurrent, ACSPrevious ou une étape personnalisée. Scénario 2 : Supprimer une étape de version d'une version de secret spécifiée. Spécifiez ce paramètre et RemoveFromVersion. Ne spécifiez pas MoveToVersion. Ce paramètre doit être défini sur une étape personnalisée. Remarque ACSCurrent et ACSPrevious sont des étapes réservées par le système. Vous ne pouvez pas les supprimer directement. Vous pouvez uniquement les supprimer d'une version de secret pour les associer à une autre. Scénario 3 : Supprimer une étape de version d'une version de secret spécifiée et l'associer à une autre version de secret. Spécifiez ce paramètre, MoveToVersion et RemoveFromVersion. Ce paramètre peut être défini sur ACSCurrent, ACSPrevious ou une étape personnalisée.	ACSCurrent
RemoveFromVersion	string	Non	Le numéro de version du secret. Ce paramètre indique que l'étape de version définie par VersionStage est supprimée de cette version. Remarque Vous devez spécifier au moins l'un des paramètres RemoveFromVersion et MoveToVersion.	001
MoveToVersion	string	Non	Le numéro de version du secret. Ce paramètre indique que l'étape de version définie par VersionStage est associée à cette version. Remarque Vous devez spécifier au moins l'un des paramètres RemoveFromVersion et MoveToVersion. Si vous définissez VersionStage sur ACSCurrent ou ACSPrevious, vous devez spécifier ce paramètre.	002

Éléments de réponse

Élément	Type	Description	Exemple
	object
SecretName	string	Le nom du secret.	secret001
RequestId	string	L'identifiant de la requête. Alibaba Cloud génère un identifiant unique pour chaque requête. Vous pouvez utiliser cet identifiant pour résoudre les problèmes.	8cad259f-4d77-40ec-bbd7-b9c47a423bb9

Exemples

JSON format

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

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur
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

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

Notes de version

Consultez Notes de version pour la liste complète.