Tous les produits
Search
Centre de documentation

:DescribeKeyVersion

Dernière mise à jour :Aug 06, 2026

Consulte les métadonnées d'une version spécifique de CMK.

Description de l'opération

Cette rubrique fournit un exemple montrant comment interroger les informations sur une version de la CMK 1234abcd-12ab-34cd-56ef-12345678****. L'identifiant de la version de la CMK est 2ab1a983-7072-4bbc-a582-584b5bd8****. La réponse indique que l'heure de création de la version de la CMK est 2016-03-25T10:42:40Z.

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 globalement unique de la CMK.

Vous pouvez également définir ce paramètre sur un alias associé à la CMK. Pour plus d'informations, consultez Présentation des alias.

1234abcd-12ab-34cd-56ef-12345678****

KeyVersionId

string

Oui

L'identifiant globalement unique de la version de la CMK.

Vous pouvez appeler l'opération ListKeyVersions pour interroger les versions de la CMK.

2ab1a983-7072-4bbc-a582-584b5bd8****

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

RequestId

string

L'identifiant de la requête.

7021b6ec-4be7-4d3c-8a68-1e85d4d515a0

KeyVersion

object

Les métadonnées de la version de la CMK.

KeyId

string

L'identifiant globalement unique de la CMK.

Remarque

Si vous définissez le paramètre KeyId dans la requête sur un alias de la CMK, l'identifiant de la CMK à laquelle l'alias est associé est renvoyé.

1234abcd-12ab-34cd-56ef-12345678****

KeyVersionId

string

L'identifiant globalement unique de la version de la CMK.

2ab1a983-7072-4bbc-a582-584b5bd8****

CreationDate

string

La date et l'heure de création de la version de la CMK. L'heure est affichée en UTC.

2016-03-25T10:42:40Z

Exemples

JSON format

{
  "RequestId": "7021b6ec-4be7-4d3c-8a68-1e85d4d515a0",
  "KeyVersion": {
    "KeyId": "key-hzz630494463ejqjx****",
    "KeyVersionId": "2ab1a983-7072-4bbc-a582-584b5bd8****",
    "CreationDate": "2024-03-25T10:42:40Z"
  }
}

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.