Tous les produits
Search
Centre de documentation

:ListKeyVersions

Dernière mise à jour :Aug 06, 2026

Consulte toutes les versions d'une CMK spécifiée.

Description de l'opération

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 lié à la CMK. Pour plus d'informations, consultez Utiliser des alias.

0b30658a-ed1a-4922-b8f7-a673ca9c****

PageNumber

integer

Non

Le numéro de la page à renvoyer.

Les pages commencent à la page 1.

Valeur par défaut : 1.

1

PageSize

integer

Non

Le nombre d'entrées à renvoyer sur chaque page.

Valeurs valides : 0 à 101.

Valeur par défaut : 10.

10

Éléments de réponse

Élément

Type

Description

Exemple

object

PageSize

integer

Le nombre d'entrées renvoyées par page.

10

RequestId

string

L'identifiant de la requête.

f71204c4-53cd-4eea-b405-653ba2db7e86

PageNumber

integer

Le numéro de la page renvoyée.

1

TotalCount

integer

Le nombre total de versions de clé renvoyées.

3

KeyVersions

object

KeyVersion

array<object>

Un tableau composé de versions de clé.

object

KeyId

string

The globally unique ID of the CMK.

Remarque

If you set the KeyId parameter to the alias of the CMK, the ID of the CMK to which the alias is bound is returned.

key-hzz630494463ejqjx****

KeyVersionId

string

The globally unique ID of the CMK version.

1e3304fd-68ac-4d5b-8886-ae5f01a1****

CreationDate

string

The date and time when the CMK version was created. The time is displayed in UTC.

2024-03-25T10:42:40Z

Exemples

JSON format

{
  "PageSize": 10,
  "RequestId": "f71204c4-53cd-4eea-b405-653ba2db7e86",
  "PageNumber": 1,
  "TotalCount": 3,
  "KeyVersions": {
    "KeyVersion": [
      {
        "KeyId": "key-hzz630494463ejqjx****",
        "KeyVersionId": "1e3304fd-68ac-4d5b-8886-ae5f01a1****",
        "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.
404 Forbidden.KeyNotFound The specified Key is not found. The error message returned because the specified CMK does not exist.

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

Notes de version

Consultez Notes de version pour la liste complète.