CreateKeyVersion - - Centre de documentation Alibaba Cloud

Description de l'opération

Vous pouvez créer une version uniquement pour une CMK asymétrique dont l'état est Enabled. Vous pouvez appeler l'opération CreateKey pour créer une CMK asymétrique et l'opération DescribeKey pour interroger l'état de la CMK. L'état est spécifié par le paramètre KeyState.
L'intervalle minimum pour créer une version de la même CMK est de sept jours. Vous pouvez appeler l'opération DescribeKey pour interroger l'heure à laquelle la dernière version d'une CMK a été créée. L'heure est spécifiée par le paramètre LastRotationDate.
Si une CMK se trouve dans un magasin de clés privé, vous ne pouvez pas créer de version pour cette CMK.
Vous pouvez créer un maximum de 50 versions pour une CMK dans la même région.

Vous pouvez créer une version pour la CMK dont l'identifiant est 0b30658a-ed1a-4922-b8f7-a673ca9c**** en utilisant les paramètres fournis dans cette rubrique.

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
KeyId	string	Oui	L'identifiant de la CMK. L'identifiant doit être unique au niveau mondial. Remarque Vous pouvez également définir la valeur sur un alias lié à la CMK. Pour plus d'informations, consultez Présentation des alias.	0b30658a-ed1a-4922-b8f7-a673ca9c****

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	b96f250a-4b75-498c-91be-22c6928f85be
KeyVersion	object	Les métadonnées de la version.
KeyId	string	L'identifiant de la CMK. L'identifiant doit être unique au niveau mondial.	0b30658a-ed1a-4922-b8f7-a673ca9c****
KeyVersionId	string	L'identifiant de la version.	c0a3d5dc-0b47-4199-a050-b289349a****
CreationDate	string	La date et l'heure de création de la version. L'heure est affichée en UTC.	2019-08-02T10:38:27Z

Exemples

JSON format

{
  "RequestId": "b96f250a-4b75-498c-91be-22c6928f85be",
  "KeyVersion": {
    "KeyId": "key-hzz62f1cb66fa42qo****",
    "KeyVersionId": "key-hzz62f1cb66fa42qo****-20v29b****",
    "CreationDate": "2023-07-02T10:38:27Z"
  }
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	Rejected.UnsupportedOperation	Unsupported operation.	The operation is not supported.
404	Forbidden.AliasNotFound	The specified Alias is not found.	The error message returned because the specified alias does not exist.
404	Forbidden.KeyNotFound	The specified Key is not found.	The error message returned because the specified CMK does not exist.
409	Rejected.Disabled	The request was rejected because the key state is Disabled.	The request was rejected because the key state is Disabled.
409	Rejected.Unavailable	The request was rejected because the key state is Unavailable.	The request was denied because the key status is unavailable.
409	Rejected.PendingDeletion	The request was rejected because the key state is PendingDeletion.	The request was rejected because the key state is PendingDeletion.

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

Notes de version

Consultez Notes de version pour la liste complète.