DescribeLockedSnapshots - Elastic Compute Service - Centre de documentation Alibaba Cloud

Obtient les informations de verrouillage d'un instantané, telles que son état de verrouillage et ses paramètres.

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

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

ecs:DescribeLockedSnapshots

list

Snapshot

acs:ecs:{#regionId}:{#accountId}:snapshot/*

Snapshot

acs:ecs:{#regionId}:{#accountId}:snapshot/{#SnapshotId}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région. Vous pouvez appeler l'opération DescribeRegions pour interroger la liste la plus récente des régions d'Alibaba Cloud.	cn-hangzhou
SnapshotIds	array	Non	Un tableau de 1 à 100 identifiants d'instantanés.
	string	Non	L'identifiant de l'instantané.	s-bp67acfmxazb4p****
LockStatus	string	Non	L'état de verrouillage de l'instantané. Valeurs valides : `compliance-cooloff` : l'instantané est verrouillé en mode de conformité, mais se trouve encore dans la période de rétractation. L'instantané ne peut pas être supprimé, mais un utilisateur disposant des autorisations RAM requises peut déverrouiller l'instantané, prolonger ou raccourcir la période de rétractation, et prolonger ou raccourcir la durée de verrouillage. `compliance` : l'instantané est verrouillé en mode de conformité et la période de rétractation est terminée. L'instantané ne peut pas être déverrouillé ni supprimé, mais un utilisateur disposant des autorisations RAM requises peut prolonger la durée de verrouillage. `expired` : le verrouillage de l'instantané a expiré et l'instantané peut être supprimé.	compliance-cooloff
NextToken	string	Non	Le jeton utilisé pour récupérer la page de résultats suivante. Définissez ce paramètre sur la valeur `NextToken` de la requête précédente.	caeba0bbb2be03f84eb48b699f0a****
MaxResults	integer	Non	Le nombre d'entrées à retourner sur chaque page. Valeur maximale : 100. Valeur par défaut : Si vous ne spécifiez pas ce paramètre ou si vous spécifiez une valeur inférieure à 10, la valeur par défaut est 10. Si vous spécifiez une valeur supérieure à 100, la valeur 100 est utilisée.	10
DryRun	boolean	Non	Indique si un test à blanc doit être effectué. Valeurs valides : `true` : effectue un test à blanc sans exécuter l'opération réelle. Le système vérifie les paramètres requis, le format de la requête et les limites du service. Si la vérification échoue, une erreur est renvoyée. Si la vérification réussit, le code d'erreur `DryRunOperation` est renvoyé. `false` (par défaut) : envoie une requête normale. Le système exécute l'opération si la requête est valide.	false

Éléments de réponse

Élément	Type	Description	Exemple
	object	Schéma de la réponse.
RequestId	string	L'identifiant de la requête.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
NextToken	string	Le jeton utilisé pour récupérer la page de résultats suivante. Si ce paramètre n'est pas renvoyé, cela indique que tous les résultats ont été renvoyés.	caeba0bbb2be03f84eb48b699f0a****
LockedSnapshotsInfo	array<object>	Une liste des instantanés verrouillés.
	object	Détails concernant un instantané verrouillé.
SnapshotId	string	L'identifiant de l'instantané.	s-bp67acfmxazb4p****
LockMode	string	Le mode de verrouillage. La seule valeur possible est : `compliance` : un instantané en mode de conformité ne peut pas être déverrouillé et ne peut être supprimé qu'après l'expiration de sa durée de verrouillage. La durée de verrouillage ne peut pas être raccourcie après la fin de la `période de rétractation`, mais un utilisateur disposant de l'autorisation RAM requise peut la prolonger à tout moment. Lorsque vous verrouillez un instantané en mode de conformité, vous pouvez éventuellement spécifier une période de rétractation.	compliance
LockStatus	string	L'état de verrouillage. Valeurs valides : `compliance-cooloff` : l'instantané est verrouillé en mode de conformité et se trouve dans sa période de rétractation. L'instantané ne peut pas être supprimé. Cependant, un utilisateur disposant de l'autorisation RAM requise peut déverrouiller l'instantané, ou prolonger ou raccourcir la période de rétractation et la durée de verrouillage. `compliance` : l'instantané est verrouillé en mode de conformité et la période de rétractation est terminée. L'instantané ne peut pas être déverrouillé ni supprimé, mais un utilisateur disposant de l'autorisation RAM requise peut prolonger la durée de verrouillage. `expired` : le verrouillage de l'instantané a expiré. L'instantané est déverrouillé et peut être supprimé.	compliance-cooloff
LockCreationTime	string	L'heure à laquelle l'instantané a été verrouillé, en UTC. L'heure est formatée selon le modèle `yyyy-MM-ddTHH:mm:ssZ` conformément à la norme ISO 8601.	2025-10-15T10:00:00Z
CoolOffPeriod	integer	La durée de la période de rétractation en mode de conformité, en heures.	3
CoolOffPeriodExpiredTime	string	L'heure à laquelle la période de rétractation se termine, en UTC. L'heure est formatée selon le modèle `yyyy-MM-ddTHH:mm:ssZ` conformément à la norme ISO 8601.	2025-10-15T13:00:00Z
LockDuration	integer	La durée du verrouillage en jours. L'instantané est automatiquement déverrouillé à l'expiration de cette durée.	1
LockDurationStartTime	string	L'heure à laquelle la durée de verrouillage commence, en UTC. L'heure est formatée selon le modèle `yyyy-MM-ddTHH:mm:ssZ` conformément à la norme ISO 8601. Si vous verrouillez un instantané qui se trouve dans l'état `progressing`, la durée de verrouillage ne commence qu'après que l'instantané est passé à l'état `accomplished`.	2025-10-15T10:00:00Z
LockExpiredTime	string	L'heure à laquelle le verrouillage expire, en UTC. L'heure est formatée selon le modèle `yyyy-MM-ddTHH:mm:ssZ` conformément à la norme ISO 8601.	2025-10-16T10:00:00Z

Exemples

JSON format

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "NextToken": "caeba0bbb2be03f84eb48b699f0a****",
  "LockedSnapshotsInfo": [
    {
      "SnapshotId": "s-bp67acfmxazb4p****",
      "LockMode": "compliance",
      "LockStatus": "compliance-cooloff",
      "LockCreationTime": "2025-10-15T10:00:00Z",
      "CoolOffPeriod": 3,
      "CoolOffPeriodExpiredTime": "2025-10-15T13:00:00Z",
      "LockDuration": 1,
      "LockDurationStartTime": "2025-10-15T10:00:00Z",
      "LockExpiredTime": "2025-10-16T10:00:00Z"
    }
  ]
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidLockStatus.Malformed	The specified parameter LockStatus is invalid. Please check the valid range for this parameter.	The specified parameter LockStatus is invalid. Please check the valid range for this parameter.
404	InvalidSnapshotLock.NotFound	The specified snapshot(s) %s is(are) not locked.	The specified snapshot is not locked.

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

Notes de version

Consultez Notes de version pour la liste complète.