ListSecretVersionIds - - Centre de documentation Alibaba Cloud

Consulte toutes les informations de version d'un secret.

Description de l'opération

Pour plus de détails sur la stratégie d'accès requise pour qu'un utilisateur RAM (Resource Access Management) ou un rôle RAM puisse appeler cette opération, reportez-vous à Contrôle d'accès.
Les informations de version n'incluent pas les valeurs des secrets. Par défaut, seules les versions de secret disposant d'étapes de version sont renvoyées.

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 du secret ou l'Amazon Resource Name (ARN) du secret. Remarque Lors de l'accès à un secret depuis un autre compte Alibaba Cloud, vous devez spécifier l'ARN du secret. Le format de l'ARN du secret est `acs:kms:${region}:${account}:secret/${secret-name}`.	secret001
IncludeDeprecated	string	Non	Indique si les versions de secret qui n'ont pas d'étapes de version doivent être incluses dans la réponse. Valeurs valides : false (par défaut) : ne les inclut pas. true : les inclut.	false
PageNumber	integer	Non	Le numéro de la page actuelle dans une requête paginée. Valeur par défaut : 1.	1
PageSize	integer	Non	Le nombre d'entrées par page dans une requête paginée. Valeur par défaut : 20.	10

É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. Cet identifiant unique est généré par Alibaba Cloud pour la requête et peut être utilisé pour le dépannage.	5b75d8b1-5b6a-4ec0-8e0c-c08befdfad47
PageSize	integer	La taille de la page.	10
PageNumber	integer	Le numéro de la page actuelle.	1
TotalCount	integer	Le nombre total d'entrées.	1
VersionIds	object
VersionId	array<object>	La liste des informations de version du secret.
	array<object>	La liste des informations de version du secret.
VersionId	string	The version number.	v1
CreateTime	string	The time when the version was created.	2024-02-21T15:39:26Z
VersionStages	object
VersionStage	array	The version stage label.
	string	The version stage label.	{"VersionStage": ["ACSCurrent","uStage1"]}

Exemples

JSON format

{
  "SecretName": "secret001",
  "RequestId": "5b75d8b1-5b6a-4ec0-8e0c-c08befdfad47",
  "PageSize": 10,
  "PageNumber": 1,
  "TotalCount": 1,
  "VersionIds": {
    "VersionId": [
      {
        "VersionId": "v1",
        "CreateTime": "2024-02-21T15:39:26Z",
        "VersionStages": {
          "VersionStage": [
            "{\"VersionStage\": [\"ACSCurrent\",\"uStage1\"]}"
          ]
        }
      }
    ]
  }
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur
400	InvalidParameter	some of the specified parameters "\" is not valid
500	InternalFailure	Internal Failure
403	Forbidden.NoPermission	This operation is forbidden by permission system
404	Forbidden.ResourceNotFound	Resource not found

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

Notes de version

Consultez Notes de version pour la liste complète.