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

Consulta as cadeias de snapshots de discos. Uma cadeia de snapshots consiste em todos os snapshots de um disco. Cada disco corresponde a uma cadeia de snapshots.

Descrição da operação

Ao chamar esta operação, observe os seguintes itens:

Os parâmetros de solicitação RegionId, DiskIds e InstanceId atuam como filtros. Esses parâmetros têm uma relação lógica AND.
Se você não especificar nenhum parâmetro, os filtros não entrarão em vigor. Se DiskIds e SnapshotLinkIds forem arrays vazios, os filtros serão considerados válidos, mas um conjunto de resultados vazio será retornado.

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

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ecs:DescribeSnapshotLinks

get

*Todos os recursos.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região do disco. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
InstanceId	string	Não	O ID da instância.	i-bp1h6jmbefj2cyqs****
DiskIds	string	Não	Os IDs dos discos. Você pode especificar até 100 IDs de discos por vez. O parâmetro DiskIds é um array JSON. Separe vários IDs de discos com vírgulas (,).	["d-bp1d6tsvznfghy7y**", "d-bp1ippxbaql9zet7", … "d-bp1ib7bcz07lcxa9**"]
SnapshotLinkIds	string	Não	Os IDs das cadeias de snapshots. Você pode especificar até 100 IDs de cadeias de snapshots por vez. O parâmetro SnapshotLinkIds é um array JSON. Separe vários IDs com vírgulas (,).	["sl-bp1grgphbcc9brb5**", "sl-bp1c4izumvq0i5bs", … "sl-bp1akk7isz866dds**"]
PageNumber	integer	Não	O número da página da lista de status do disco. Valor mínimo: 1. Valor padrão: 1.	1
PageSize	integer	Não	O número de entradas por página para uma consulta paginada. Valores válidos: 1 a 100. Valor padrão: 10.	50
NextToken	string	Não	O token de paginação. Defina este parâmetro com o valor NextToken retornado na chamada de API anterior.	caeba0bbb2be03f84eb48b699f0a****
MaxResults	integer	Não	O número máximo de entradas por página para uma consulta paginada. Valor máximo: 100. Valor padrão: Se este parâmetro não for especificado ou for definido com um valor menor que 10, o valor padrão será 10. Se este parâmetro for definido com um valor maior que 100, o valor padrão será 100.	10

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
NextToken	string	O token de paginação retornado nesta chamada.	caeba0bbb2be03f84eb48b699f0a****
PageNumber	integer	O número da página da lista de cadeias de snapshots.	1
PageSize	integer	O número de entradas por página que você especificou na solicitação.	50
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
SnapshotLinks	object
SnapshotLink	array<object>	A coleção de informações da cadeia de snapshots.
	object
Category	string	O tipo da cadeia de snapshots. Valores válidos: standard: cadeia de snapshots padrão. archive: cadeia de snapshots arquivada. flash: cadeia de snapshots de acesso instantâneo.	standard
InstanceId	string	O ID da instância.	i-bp1h6jmbefj2cyqs****
InstanceName	string	O nome da instância.	testInstanceName
InstantAccess	boolean	Indica se o recurso de acesso instantâneo a snapshot está ativado. Valores válidos: true: Ativado. Apenas discos ESSD suportam este recurso. false: Desativado. O snapshot é um snapshot padrão para o qual o recurso de acesso instantâneo a snapshot não está ativado. Nota Este parâmetro está obsoleto. Os snapshots padrão de discos ESSD foram atualizados para acesso instantâneo por padrão. Nenhuma configuração ou taxa adicional é necessária.	false
RegionId	string	O ID da região do disco de origem da cadeia de snapshots.	cn-hangzhou
SnapshotLinkId	string	O ID da cadeia de snapshots.	sl-2ze0y1jwzpb1geqx****
SourceDiskId	string	O ID do disco de origem. Este campo é mantido mesmo que o disco de origem do snapshot tenha sido excluído.	d-bp1d6tsvznfghy7y****
SourceDiskName	string	O nome do disco de origem.	testSourceDiskName
SourceDiskSize	integer	A capacidade do disco de origem. Unidade: GiB.	40
SourceDiskType	string	O tipo do disco de origem. Valores válidos: system: disco do sistema. data: disco de dados.	data
TotalCount	integer	O número total de snapshots.	1
TotalSize	integer	O tamanho total de todos os snapshots na cadeia de snapshots. Unidade: bytes.	2097152
TotalCount	integer	O número total de cadeias de snapshots. Nota Quando você usa os parâmetros MaxResults e NextToken para consulta paginada, o valor TotalCount retornado é inválido.	9

Exemplos

Resposta de sucesso

JSON formato

{
  "NextToken": "caeba0bbb2be03f84eb48b699f0a****",
  "PageNumber": 1,
  "PageSize": 50,
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "SnapshotLinks": {
    "SnapshotLink": [
      {
        "Category": "standard",
        "InstanceId": "i-bp1h6jmbefj2cyqs****",
        "InstanceName": "testInstanceName",
        "InstantAccess": false,
        "RegionId": "cn-hangzhou",
        "SnapshotLinkId": "sl-2ze0y1jwzpb1geqx****",
        "SourceDiskId": "d-bp1d6tsvznfghy7y****",
        "SourceDiskName": "testSourceDiskName",
        "SourceDiskSize": 40,
        "SourceDiskType": "data",
        "TotalCount": 1,
        "TotalSize": 2097152
      }
    ]
  },
  "TotalCount": 9
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidInstanceId.NotFound	The specified instanceId is not exists.
400	InvalidRegionId	The specified regionId is invalid.	O RegionId especificado é inválido.
400	InvalidSnapshotLinkIds	The specified snapshotLinkIds is invalid.	O SnapshotLinkId especificado é inválido.
400	InvalidDiskIds	The specified diskIds is invalid.	O disco especificado é inválido.
500	InternalError	The request processing has failed due to some unknown error.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.