LockSnapshot - Elastic Compute Service - Centre de documentation Alibaba Cloud

Verrouille un instantané en mode de conformité pour le protéger contre toute suppression accidentelle ou malveillante. Tant qu'un instantané est verrouillé, il ne peut pas être supprimé.

Description de l'opération

Vous pouvez également utiliser cette interface pour reconfigurer un instantané verrouillé. Les options de configuration disponibles dépendent du mode de verrouillage et de l'état du verrouillage :

Si un instantané est verrouillé en mode de conformité et se trouve dans sa période de rétractation, vous pouvez prolonger ou raccourcir la période de rétractation et la durée de verrouillage.
Si un instantané est verrouillé en mode de conformité et que sa période de rétractation a expiré, vous pouvez uniquement prolonger la durée de verrouillage.

Remarque

La reconfiguration d'un instantané verrouillé pendant sa période de rétractation déclenche une nouvelle opération de verrouillage. Cette opération réinitialise tous les paramètres de verrouillage au lieu de les ajuster individuellement.

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:LockSnapshot

update

*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
SnapshotId	string	Oui	L'identifiant de l'instantané.	s-9dp2qojdpdfmgfmf****
LockMode	string	Oui	Le mode de verrouillage. Valeur valide : `compliance` : verrouille l'instantané en mode de conformité. 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. Vous ne pouvez pas raccourcir la durée de verrouillage, mais les utilisateurs disposant des autorisations RAM requises peuvent 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
LockDuration	integer	Oui	La durée pendant laquelle verrouiller l'instantané. Le verrouillage expire automatiquement à la fin de cette période. Unité : jours. Valeurs valides : 1 à 36500.	1
CoolOffPeriod	integer	Oui	La période de rétractation. En mode de conformité, vous pouvez définir une période de rétractation ou l'ignorer pour verrouiller l'instantané immédiatement. Pendant la période de rétractation, les utilisateurs disposant des autorisations RAM requises peuvent déverrouiller l'instantané, modifier la période de rétractation et la durée de verrouillage. L'instantané ne peut pas être supprimé pendant la période de rétractation. Une fois la période de rétractation expirée, vous pouvez uniquement prolonger la durée de verrouillage. Unité : heures. Valeurs valides : 0 à 72. La valeur `0` indique que la période de rétractation est ignorée et que l'instantané est verrouillé immédiatement. Si l'instantané est déjà verrouillé en mode de conformité, vous devez définir ce paramètre sur `0` pour prolonger la durée de verrouillage.	3
DryRun	boolean	Non	Indique si un test à blanc doit être effectué pour la requête. 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, le système renvoie l'erreur correspondante. Si la vérification réussit, le système renvoie le code d'erreur `DryRunOperation`. `false` (valeur par défaut) : envoie une requête normale et exécute l'opération une fois la vérification réussie.	false
ClientToken	string	Non	Un jeton que vous fournissez pour garantir l'idempotence de la requête. Le jeton ne peut contenir que des caractères ASCII et ne doit pas dépasser 64 caractères. Pour plus de détails, consultez Comment garantir l'idempotence.	5EC38E7D-389F-1925-ABE2-D7925A8F****

É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****
LockedSnapshotInfo	object	Informations sur l'instantané verrouillé.
SnapshotId	string	L'identifiant de l'instantané.	s-9dp2qojdpdfmgfmf****
LockMode	string	Le mode de verrouillage. Valeurs possibles : `compliance` : l'instantané est verrouillé en mode de conformité. Un instantané verrouillé dans ce mode ne peut pas être déverrouillé et ne peut être supprimé qu'après l'expiration de sa durée de verrouillage. Vous ne pouvez pas raccourcir la durée de verrouillage, mais les utilisateurs disposant des autorisations RAM requises peuvent la prolonger à tout moment. Lors du verrouillage d'un instantané en mode de conformité, vous pouvez éventuellement spécifier une période de rétractation.	compliance
LockStatus	string	L'état du verrouillage. Valeurs possibles : `compliance-cooloff` : l'instantané est verrouillé en mode de conformité mais se trouve encore dans sa période de rétractation. L'instantané ne peut pas être supprimé, mais les utilisateurs disposant des autorisations RAM requises peuvent le déverrouiller, 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 sa période de rétractation a expiré. L'instantané ne peut pas être déverrouillé ni supprimé, mais les utilisateurs disposant des autorisations RAM requises peuvent prolonger sa durée de verrouillage. `expired` : la durée de verrouillage a expiré. L'instantané est désormais déverrouillé et peut être supprimé.	compliance-cooloff
LockCreationTime	string	L'heure à laquelle l'instantané a été verrouillé. L'heure est en UTC et est formatée selon la norme ISO 8601 sous la forme `yyyy-MM-ddTHH:mm:ssZ`.	2025-10-15T10:00:00Z
CoolOffPeriod	integer	La période de rétractation pour le mode de conformité. Unité : heures.	3
CoolOffPeriodExpiredTime	string	L'heure à laquelle la période de rétractation pour le mode de conformité expire. L'heure est en UTC et est formatée selon la norme ISO 8601 sous la forme `yyyy-MM-ddTHH:mm:ssZ`.	2025-10-15T13:00:00Z
LockDuration	integer	La durée de verrouillage. L'instantané est automatiquement déverrouillé lorsque cette durée expire. Unité : jours.	1
LockDurationStartTime	string	L'heure à laquelle la durée de verrouillage commence. L'heure est en UTC et est formatée selon la norme ISO 8601 sous la forme `yyyy-MM-ddTHH:mm:ssZ`. Si vous verrouillez un instantané dans l'état `progressing`, la durée de verrouillage ne commence que lorsque l'instantané passe à l'état `accomplished`.	2025-10-15T10:00:00Z
LockExpiredTime	string	L'heure à laquelle le verrouillage expire. L'heure est en UTC et est formatée selon la norme ISO 8601 sous la forme `yyyy-MM-ddTHH:mm:ssZ`.	2025-10-16T10:00:00Z

Exemples

JSON format

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "LockedSnapshotInfo": {
    "SnapshotId": "s-9dp2qojdpdfmgfmf****",
    "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	InvalidLockMode.Malformed	The specified parameter LockMode is invalid. Please check the valid range for this parameter.	The specified parameter LockMode is invalid. Please check the valid range for this parameter.
400	InvalidLockDuration.ExceedRetentionDays	The specified parameter LockDuration is invalid. The LockDuration should be less than the snapshot RetentionDays.	The specified parameter LockDuration is invalid. The LockDuration should be less than the snapshot RetentionDays.
400	InvalidCoolOffPeriod.ExceedLockDuration	The specified parameter CoolOffPeriod is invalid. The CoolOffPeriod should be less than the LockDuration.	The specified parameter CoolOffPeriod is invalid. The CoolOffPeriod should be less than the LockDuration.
403	InvalidOperation.SnapshotNotAvailable	The unavailable snapshot does not support locking.	The unavailable snapshot does not support locking.
403	InvalidOperation.ResourceManagedByCloudProduct	The current operation is not supported because the resource is managed by a cloud product [%s]. Please contact the relevant cloud product to confirm the reason.	The current operation is not supported because the resource is managed by a cloud product. Please contact the relevant cloud product to confirm the reason.
403	InvalidOperation.LockSharedSnapshotUnsupported	The shared snapshot does not support locking.	The shared snapshot does not support locking.
403	InvalidOperation.CoolOffPeriodExpired	The snapshot is locked in compliance mode; and the cool-off period has expired. The current operation is not supported.
404	InvalidSnapshotId.NotFound	The specified snapshot is not found.	The specified Snapshot does not exist.

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

Notes de version

Consultez Notes de version pour la liste complète.