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

Consulta as informações de bloqueio de snapshots, como o status de bloqueio e as configurações de bloqueio.

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
SnapshotIds	array	Não	Os IDs dos snapshots. Comprimento do array: 1 a 100.
	string	Não	O ID do snapshot.	s-bp67acfmxazb4p****
LockStatus	string	Não	O status de bloqueio. Valores válidos: \n- compliance-cooloff: O snapshot está bloqueado no modo de conformidade, mas ainda está no período de carência. O snapshot não pode ser excluído, mas os 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 os 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 está atualmente desbloqueado e pode ser excluído.	compliance-cooloff
NextToken	string	Não	O token de consulta. Defina o valor como o valor do parâmetro NextToken retornado pela chamada de API anterior.	caeba0bbb2be03f84eb48b699f0a****
MaxResults	integer	Não	O número de entradas por página durante a paginação para uma consulta paginada. Valor máximo: 100. \n\nValor padrão: \n- Se nenhuma configuração for especificada ou o valor da configuração for menor que 10, o valor padrão será 10. \n- Se o valor da configuração for maior que 100, o valor padrão será 100.	10
DryRun	boolean	Não	Especifica se deve ser realizada apenas uma pré-verificação da solicitação. Valores válidos: \n- true: A solicitação é pré-verificada, mas não executada. O sistema verifica se os parâmetros obrigatórios foram especificados, se o formato da solicitação é válido e se os limites do serviço são atendidos. Se a solicitação falhar na pré-verificação, um erro será retornado. Se a solicitação passar na pré-verificação, o código de erro DryRunOperation será retornado. \n- false: A solicitação é pré-verificada e executada se passar na pré-verificação. Este é o valor padrão.	false

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema da resposta.
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
NextToken	string	O token de consulta retornado pela chamada atual.	caeba0bbb2be03f84eb48b699f0a****
LockedSnapshotsInfo	array<object>	As informações dos snapshots bloqueados.
	object	As informações do snapshot bloqueado.
SnapshotId	string	O ID do snapshot.	s-bp67acfmxazb4p****
LockMode	string	O modo de bloqueio. Valores válidos: \n- compliance: O snapshot está bloqueado 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 os 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, mas ainda está no período de carência. O snapshot não pode ser excluído, mas os 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 os 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 está atualmente desbloqueado 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 de acordo com o 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 em que o período de carência no modo de conformidade termina. A hora é exibida no formato yyyy-MM-ddTHH:mm:ssZ de acordo com o 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 término da duração do bloqueio. Unidade: dias.	1
LockDurationStartTime	string	A hora em que a duração do bloqueio começa. A hora é exibida no formato yyyy-MM-ddTHH:mm:ssZ de acordo com o padrão ISO 8601. É usado o UTC+0. Se 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 conclusão.	2025-10-15T10:00:00Z
LockExpiredTime	string	A hora em que o bloqueio expira. A hora é exibida no formato yyyy-MM-ddTHH:mm:ssZ de acordo com o 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****",
  "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"
    }
  ]
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidLockStatus.Malformed	The specified parameter LockStatus is invalid. Please check the valid range for this parameter.	O parâmetro LockStatus especificado é inválido. Verifique os valores válidos para este parâmetro.
404	InvalidSnapshotLock.NotFound	The specified snapshot(s) %s is(are) not locked.	O snapshot especificado não está bloqueado.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.