Consulta as cadeias de snapshots de discos. Uma cadeia de snapshots consiste em todos os snapshots de um disco. Cada disco possui uma cadeia de snapshots.
Descrição da operação
Descrição da operação
Ao chamar esta operação, observe os seguintes itens:
-
Parâmetros de solicitação como
RegionId,DiskIdseInstanceIdatuam como filtros. O operador lógico AND é aplicado entre esses parâmetros. -
Se você não especificar nenhum parâmetro, os filtros não entrarão em vigor. Se tanto
DiskIdsquantoSnapshotLinkIdsforem definidos como matrizes vazias, os filtros serão considerados válidos, mas um resultado vazio será retornado.
Experimente agora
Testar
Autorização RAM
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 a operação 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. Defina o valor de DiskIds como uma matriz JSON. Separe vários IDs 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. Defina o valor de SnapshotLinkIds como uma matriz 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 cadeias de snapshots. As páginas começam em 1. Valor padrão: 1. |
1 |
| PageSize |
integer |
Não |
As configurações de paginação para o número de entradas por página em uma consulta paginada. Valores válidos: 1 a 100. Valor padrão: 10. |
50 |
| NextToken |
string |
Não |
O token de paginação. Defina o valor como o valor de NextToken retornado da última chamada de API. |
caeba0bbb2be03f84eb48b699f0a**** |
| MaxResults |
integer |
Não |
As configurações de paginação para o número máximo de entradas por página em uma consulta paginada. Valor máximo: 100. Valor padrão:
|
10 |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
|||
| NextToken |
string |
O token de paginação retornado pela chamada atual. |
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. |
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 de cadeia de snapshots. Valores válidos:
|
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 snapshots está ativo. Valores válidos:
Nota
Este parâmetro foi descontinuado. Os snapshots padrão de discos SSD corporativos são atualizados para acesso instantâneo por padrão. Você não precisa realizar configurações adicionais e nenhuma taxa adicional é cobrada. |
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. Se o disco de origem do snapshot for excluído, este campo ainda será mantido. |
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 de disco do disco de origem. Valores válidos:
|
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 |
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 does not exist. Please verify the instance ID and the current region. | |
| 400 | InvalidRegionId | The specified parameter RegionId is not valid. Please call DescribeRegions to query the supported regions. | |
| 400 | InvalidSnapshotLinkIds | The specified parameter SnapshotLinkIds is not valid. Ensure the value is a valid list of snapshot link IDs. | |
| 400 | InvalidDiskIds | The specified parameter DiskIds is not valid. Ensure the value is a valid list of disk IDs. | |
| 500 | InternalError | The request processing has failed due to an internal error and you may retry later or contact support with the request ID. |
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.