PutSecretValue - - Centre de documentation Alibaba Cloud

Description de l'opération

Pour plus d'informations sur la stratégie d'accès requise pour qu'un utilisateur RAM ou un rôle RAM puisse appeler cette opération OpenAPI, consultez Resource Access Management.
Cette opération prend uniquement en charge les secrets génériques. Chaque secret générique peut comporter jusqu'à 10 versions. Si le nombre de versions dépasse cette limite, KMS supprime la version la plus ancienne.
Par défaut, la nouvelle valeur de secret est marquée avec ACSCurrent, et la version précédente qui était marquée avec ACSCurrent est marquée avec ACSPrevious. Vous pouvez spécifier le paramètre VersionStage pour remplacer ce comportement par défaut.
Cette opération stocke une nouvelle version d'une valeur de secret. Vous ne pouvez pas l'utiliser pour modifier une version existante d'une valeur de secret. Vous devez spécifier un numéro de version lorsque vous stockez une nouvelle version. KMS traite les requêtes selon les règles suivantes :
- Si le numéro de version n'existe pas dans le secret, KMS crée une nouvelle version et stocke la valeur du secret.
- Si le numéro de version existe déjà dans le secret, KMS compare la valeur du secret dans la requête avec la valeur stockée. Si les valeurs sont identiques, la requête est ignorée et un message de succès est renvoyé. Cela rend l'opération idempotente. Si les valeurs sont différentes, la requête est rejetée.

Cette rubrique fournit un exemple de stockage d'une nouvelle version de la valeur d'un secret pour le secret nommé secret001. Le nouveau numéro de version (VersionId) est v3 et la valeur du secret (SecretData) est importantdata.

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
VersionId	string	Oui	Le numéro de version du secret. La valeur doit être unique dans le secret.	v3
SecretName	string	Oui	Le nom ou l'Alibaba Cloud Resource Name (ARN) du secret. Remarque Lorsque vous accédez à un secret dans un autre compte Alibaba Cloud, vous devez spécifier l'ARN du secret. L'ARN d'un secret suit le format `acs:kms:${region}:${account}:secret/${secret-name}`.	secret001
SecretData	string	Oui	La valeur du secret. La valeur est chiffrée et stockée dans la nouvelle version spécifiée.	importantdata
SecretDataType	string	Non	Le type de la valeur du secret. Valeurs valides : text (par défaut) binary	text
VersionStages	string	Non	Les étiquettes d'étape utilisées pour marquer la nouvelle version. Si vous ne spécifiez pas ce paramètre, KMS marque la nouvelle version avec ACSCurrent.	["ACSCurrent","ACSNext"]

Pour plus d'informations sur les paramètres de requête courants, consultez Paramètres courants.

Éléments de réponse

Élément	Type	Description	Exemple
	object
SecretName	string	Le nom du secret.	secret001
VersionId	string	Le numéro de version du secret.	v3
RequestId	string	L'identifiant de la requête, qui est un identifiant unique généré par Alibaba Cloud. Vous pouvez utiliser cet identifiant pour résoudre les problèmes.	f94ec9d3-2d10-4922-9a5c-5dcd5ebcb5e8
VersionStages	object
VersionStage	array	Les étiquettes d'étape de la version du secret.
	string	L'étiquette d'étape de la version du secret.	{ "VersionStage": [ "ACSCurrent", "ACSNext" ] }

Exemples

JSON format

{
  "SecretName": "secret001",
  "VersionId": "v3",
  "RequestId": "f94ec9d3-2d10-4922-9a5c-5dcd5ebcb5e8",
  "VersionStages": {
    "VersionStage": [
      "{ \"VersionStage\": [ \"ACSCurrent\", \"ACSNext\" ] }"
    ]
  }
}

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
500	InternalFailure	Internal Failure
403	Forbidden.NoPermission	This operation is forbidden by permission system
404	Forbidden.ResourceNotFound	Resource not found
409	Rejected.ResourceExist	The request was rejected becasue key already exsit

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

Notes de version

Consultez Notes de version pour la liste complète.