LockSnapshot - Elastic Compute Service: Central de Documentação do Alibaba Cloud

Bloqueia um snapshot no modo de conformidade para evitar exclusão acidental ou maliciosa. Durante o período de bloqueio, nenhum usuário pode excluir o snapshot.

Descrição da operação

Você também pode usar esta operação para reconfigurar um snapshot bloqueado. Os itens configuráveis dependem do modo de bloqueio e do status de bloqueio:\n- Se o snapshot estiver bloqueado no modo de conformidade e estiver no período de carência, você pode estender ou encurtar o período de carência, ou estender ou encurtar a duração do bloqueio.\n- Se o snapshot estiver bloqueado no modo de conformidade e o período de carência tiver expirado, você poderá apenas estender a duração do bloqueio.\n> Se você reconfigurar um snapshot bloqueado durante o período de carência, o sistema tratará isso como uma operação de novo bloqueio. Todos os parâmetros de bloqueio são redefinidos em vez de serem ajustados individualmente.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
SnapshotId	string	Sim	O ID do snapshot.	s-9dp2qojdpdfmgfmf****
LockMode	string	Sim	O modo de bloqueio. Valores válidos: \n- compliance: Bloqueia o snapshot no modo de conformidade. Um snapshot bloqueado no modo de conformidade não pode ser desbloqueado por nenhum usuário e só pode ser excluído após a expiração da duração do bloqueio. Os usuários não podem encurtar a duração do bloqueio, mas usuários com as permissões necessárias do RAM podem estender a duração do bloqueio a qualquer momento. Ao bloquear um snapshot no modo de conformidade, você pode opcionalmente especificar um período de carência.	compliance
LockDuration	integer	Sim	A duração do bloqueio. O bloqueio do snapshot expira automaticamente após o fim da duração do bloqueio. \n\nUnidade: dias. \n\nValores válidos: 1 a 36500.	1
CoolOffPeriod	integer	Sim	O período de carência. No modo de conformidade, você pode definir um período de carência ou pular o período de carência para bloquear o snapshot diretamente. \n\nDurante o período de carência, usuários com as permissões necessárias do RAM podem desbloquear o snapshot, estender ou encurtar o período de carência e estender ou encurtar a duração do bloqueio. O snapshot não pode ser excluído durante o período de carência. \n\nApós o término do período de carência, você pode apenas estender a duração do bloqueio. \n\nUnidade: horas. \n\nValores válidos: 0 a 72. Um valor de 0 indica que o período de carência é ignorado e o snapshot é bloqueado diretamente. \n\nSe o snapshot tiver entrado no período de bloqueio do modo de conformidade, você deve definir este parâmetro como 0 para estender a duração do bloqueio.	3
DryRun	boolean	Não	Especifica se deve ser realizado apenas um dry run na solicitação. Valores válidos: \n- true: Realiza apenas um dry run. O sistema verifica se os parâmetros obrigatórios foram especificados, se o formato da solicitação é válido e se os limites de serviço foram atendidos. Se a solicitação falhar no dry run, um erro será retornado. Se a solicitação passar no dry run, o código de erro DryRunOperation será retornado. \n- false: Realiza um dry run e executa a solicitação se a solicitação passar no dry run. Este é o valor padrão.	false
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o valor, mas deve garantir que o valor seja exclusivo entre diferentes solicitações. O token de cliente pode conter apenas caracteres ASCII e não pode exceder 64 caracteres de comprimento. Para mais informações, consulte Como garantir a idempotência.	5EC38E7D-389F-1925-ABE2-D7925A8F****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema da resposta.
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
LockedSnapshotInfo	object	As informações do snapshot bloqueado.
SnapshotId	string	O ID do snapshot.	s-9dp2qojdpdfmgfmf****
LockMode	string	O modo de bloqueio. Valores válidos: \n- compliance: Bloqueia o snapshot no modo de conformidade. Um snapshot bloqueado no modo de conformidade não pode ser desbloqueado por nenhum usuário e só pode ser excluído após a expiração da duração do bloqueio. Os usuários não podem encurtar a duração do bloqueio, mas usuários com as permissões necessárias do RAM podem estender a duração do bloqueio a qualquer momento. Ao bloquear um snapshot no modo de conformidade, você pode opcionalmente especificar um período de carência.	compliance
LockStatus	string	O status de bloqueio. Valores válidos: \n- compliance-cooloff: O snapshot está bloqueado no modo de conformidade e ainda está no período de carência. O snapshot não pode ser excluído, mas usuários com as permissões necessárias do RAM podem desbloquear o snapshot, estender ou encurtar o período de carência e estender ou encurtar a duração do bloqueio. \n- compliance: O snapshot está bloqueado no modo de conformidade e o período de carência terminou. O snapshot não pode ser desbloqueado ou excluído, mas usuários com as permissões necessárias do RAM podem estender a duração do bloqueio. \n- expired: O snapshot estava bloqueado, mas a duração do bloqueio terminou e o bloqueio expirou. O snapshot não está bloqueado e pode ser excluído.	compliance-cooloff
LockCreationTime	string	A hora em que o snapshot foi bloqueado. A hora é exibida no formato yyyy-MM-ddTHH:mm:ssZ com base no padrão ISO 8601. É usado o UTC+0.	2025-10-15T10:00:00Z
CoolOffPeriod	integer	O período de carência no modo de conformidade. Unidade: horas.	3
CoolOffPeriodExpiredTime	string	A hora de término do período de carência no modo de conformidade. A hora é exibida no formato yyyy-MM-ddTHH:mm:ssZ com base no padrão ISO 8601. É usado o UTC+0.	2025-10-15T13:00:00Z
LockDuration	integer	A duração do bloqueio. O bloqueio do snapshot expira automaticamente após o fim da duração do bloqueio. Unidade: dias.	1
LockDurationStartTime	string	A hora de início da duração do bloqueio. A hora é exibida no formato yyyy-MM-ddTHH:mm:ssZ com base no padrão ISO 8601. É usado o UTC+0. \n\nSe você bloquear um snapshot que está no estado de progresso, a duração do bloqueio será calculada somente após o snapshot entrar no estado de concluído.	2025-10-15T10:00:00Z
LockExpiredTime	string	A hora de expiração do bloqueio. A hora é exibida no formato yyyy-MM-ddTHH:mm:ssZ com base no padrão ISO 8601. É usado o UTC+0.	2025-10-16T10:00:00Z

Exemplos

Resposta de sucesso

JSON formato

{
  "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"
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidLockMode.Malformed	The specified parameter LockMode is invalid. Please check the valid range for this parameter.	O parâmetro LockMode especificado é inválido. Verifique os valores válidos para este parâmetro.
400	InvalidLockDuration.ExceedRetentionDays	The specified parameter LockDuration is invalid. The LockDuration should be less than the snapshot RetentionDays.	O parâmetro LockDuration especificado é inválido. A duração do bloqueio deve ser menor que o período de retenção do snapshot.
400	InvalidCoolOffPeriod.ExceedLockDuration	The specified parameter CoolOffPeriod is invalid. The CoolOffPeriod should be less than the LockDuration.	O parâmetro CoolOffPeriod especificado é inválido. O período de resfriamento deve ser menor que a duração do bloqueio.
403	InvalidOperation.SnapshotNotAvailable	The unavailable snapshot does not support locking.	Snapshots indisponíveis não podem ser bloqueados.
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.	Os grupos de segurança gerenciados por serviços de nuvem não podem ser modificados.
403	InvalidOperation.LockSharedSnapshotUnsupported	The shared snapshot does not support locking.	Snapshots de fontes compartilhadas não suportam bloqueio.
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.	O snapshot especificado não existe. Verifique se o ID do snapshot está correto.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.