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

Descrição

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

Especifique vários parâmetros de solicitação, como RegionId, DiskIds e InstanceId, para filtrar a consulta. Os parâmetros especificados mantêm uma relação lógica E entre si.
Apenas os parâmetros definidos funcionam como condições de filtro. Se DiskIds e SnapshotLinkIds estiverem configurados como arrays JSON vazios, o sistema os considera condições de filtro válidas e retorna uma resposta vazia.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para maior comodidade, recomendamos chamar esta operação diretamente no OpenAPI Explorer. A ferramenta também gera dinamicamente exemplos de código da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeSnapshotLinks	A operação a ser executada. Defina o valor como DescribeSnapshotLinks.
RegionId	String	Sim	cn-hangzhou	O ID da região do disco. Chame a operação DescribeRegions para obter a lista mais recente de regiões.
InstanceId	String	Não	i-bp1h6jmbefj2cyqs****	O ID da instância.
DiskIds	String	Não	["d-bp1d6tsvznfghy7y", "d-bp1ippxbaql9zet7", ... "d-bp1ib7bcz07lcxa9"]	Os IDs dos discos. O valor é um array JSON composto por até 100 IDs de disco. Separe múltiplos IDs com vírgulas (,).
SnapshotLinkIds	String	Não	["sl-bp1grgphbcc9brb5", "sl-bp1c4izumvq0i5bs", ... "sl-bp1akk7isz866dds"]	Os IDs das cadeias de snapshots. O valor é um array JSON composto por até 100 IDs de cadeia de snapshots. Separe múltiplos IDs com vírgulas (,).
PageNumber	Integer	Não	1	O número da página a ser retornada. A numeração começa em 1. Valor padrão: 1
PageSize	Integer	Não	50	A quantidade de entradas a serem retornadas em cada página. Valores válidos: 1 a 100. Valor padrão: 10.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
PageNumber	Integer	1	O número da página retornada.
PageSize	Integer	50	A quantidade de entradas retornadas por página.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	O ID da solicitação.
SnapshotLinks	Array of SnapshotLink		Detalhes sobre as cadeias de snapshots.
SnapshotLink
Category	String	standard	A categoria do snapshot. Nota Este parâmetro será removido futuramente. Recomendamos usar o parâmetro `InstantAccess` para garantir compatibilidade futura.
InstanceId	String	i-bp1h6jmbefj2cyqs****	O ID da instância.
InstanceName	String	testInstanceName	O nome da instância.
InstantAccess	Boolean	false	Indica se o recurso de acesso instantâneo está ativado. Valores válidos: true: O recurso de acesso instantâneo está ativado. Este recurso pode ser ativado apenas para SSDs aprimorados (ESSDs). false: O recurso de acesso instantâneo está desativado. O snapshot é um snapshot normal sem o recurso de acesso instantâneo ativado.
RegionId	String	cn-hangzhou	O ID da região onde está localizado o disco de source da cadeia de snapshots.
SnapshotLinkId	String	sl-2ze0y1jwzpb1geqx****	O ID da cadeia de snapshots.
SourceDiskId	String	d-bp1d6tsvznfghy7y****	O ID do disco de source. Este parâmetro é mantido mesmo que o disco de source seja excluído.
SourceDiskName	String	testSourceDiskName	O nome do disco de source.
SourceDiskSize	Integer	40	A capacidade do disco de source. Unidade: GiB.
SourceDiskType	String	data	A categoria do disco de source. Valores válidos: system: disco do sistema data: disco de dados
TotalCount	Integer	1	O número total de snapshots.
TotalSize	Long	2097152	A capacidade total de todos os snapshots na cadeia de snapshots. Unidade: byte.
TotalCount	Integer	9	O número total de cadeias de snapshots.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=DescribeSnapshotLinks
&RegionId=cn-hangzhou
&InstanceId=i-bp1h6jmbefj2cyqs****
&DiskIds=["d-bp1d6tsvznfghy7y****", "d-bp1ippxbaql9zet7****", ... "d-bp1ib7bcz07lcxa9****"]
&SnapshotLinkIds=["sl-bp1grgphbcc9brb5****", "sl-bp1c4izumvq0i5bs****", ... "sl-bp1akk7isz866dds****"]
&PageNumber=1
&PageSize=10
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<DescribeSnapshotLinksResponse>
      <SnapshotLinks>
            <SnapshotLink>
                  <InstanceName>testInstanceName1</InstanceName>
                  <TotalCount>1</TotalCount>
                  <Category>standard</Category>
                  <SourceDiskSize>40</SourceDiskSize>
                  <InstanceId>i-bp1dh0xo8nucqe1o****</InstanceId>
                  <SnapshotLinkId>sl-bp1hgvjgqo3wn8u7****</SnapshotLinkId>
                  <SourceDiskName>testSourceDiskName1</SourceDiskName>
                  <RegionId></RegionId>
                  <SourceDiskType>system</SourceDiskType>
                  <TotalSize>3806330880</TotalSize>
                  <SourceDiskId>d-bp149tb0mqn0boy6****</SourceDiskId>
            </SnapshotLink>
            <SnapshotLink>
                  <InstanceName>testInstanceName2</InstanceName>
                  <TotalCount>1</TotalCount>
                  <Category>standard</Category>
                  <InstanceId>i-bp1c84ts5f4b6t6z****</InstanceId>
                  <SnapshotLinkId>sl-bp163h35n7endbpv****</SnapshotLinkId>
                  <SourceDiskName>testSourceDiskName2</SourceDiskName>
                  <RegionId></RegionId>
                  <TotalSize>2709520384</TotalSize>
                  <SourceDiskType>data</SourceDiskType>
                  <SourceDiskId>d-bp1cl4hqnh0i2u5h****</SourceDiskId>
            </SnapshotLink>
      </SnapshotLinks>
      <PageNumber>1</PageNumber>
      <PageSize>2</PageSize>
      <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
      <TotalCount>9</TotalCount>
</DescribeSnapshotLinksResponse>

Formato JSON

{
    "SnapshotLinks": {
        "SnapshotLink": [
            {
                "InstanceName": "testInstanceName1",
                "TotalCount": 1,
                "Category": "standard",
                "SourceDiskSize": 40,
                "InstanceId": "i-bp1dh0xo8nucqe1o****",
                "SnapshotLinkId": "sl-bp1hgvjgqo3wn8u7****",
                "SourceDiskName": "testSourceDiskName1",
                "RegionId": "",
                "SourceDiskType": "system",
                "TotalSize": 3806330880,
                "SourceDiskId": "d-bp149tb0mqn0boy6****"
            },
            {
                "InstanceName": "testInstanceName2",
                "TotalCount": 1,
                "Category": "standard",
                "InstanceId": "i-bp1c84ts5f4b6t6z****",
                "SnapshotLinkId": "sl-bp163h35n7endbpv****",
                "SourceDiskName": "testSourceDiskName2",
                "RegionId": "",
                "TotalSize": 2709520384,
                "SourceDiskType": "data",
                "SourceDiskId": "d-bp1cl4hqnh0i2u5h****"
            }
        ]
    },
    "PageNumber": 1,
    "PageSize": 1,
    "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
    "TotalCount": 2
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidRegionId	The specified regionId is invalid.	A mensagem de erro retornada porque o parâmetro RegionId especificado é inválido.
400	InvalidSnapshotLinkIds	The specified snapshotLinkIds is invalid.	A mensagem de erro retornada porque o parâmetro SnapshotLinkIds especificado é inválido.
400	InvalidDiskIds	The specified diskIds is invalid.	A mensagem de erro retornada porque o parâmetro DiskIds especificado é inválido.
500	InternalError	The request processing has failed due to some unknown error.	A mensagem de erro retornada devido à ocorrência de um erro interno. Tente novamente mais tarde. Se o erro persistir, envie um ticket.

Para obter uma lista de códigos de erro, visite o API Error Center.