As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
As etapas a seguir descrevem como usar o EBS direct APIs para ler snapshots:
-
Use a ListSnapshotBlocks ação para visualizar todos os índices de blocos e tokens de blocos em um instantâneo. Ou use a ListChangedBlocks ação para visualizar somente os índices de blocos e os tokens de blocos que são diferentes entre dois instantâneos do mesmo volume e linhagem de instantâneos. Essas ações ajudam você a identificar os tokens e os índices de bloco dos blocos para os quais é possível querer obter dados.
-
Use a GetSnapshotBlock ação e especifique o índice do bloco e o token do bloco para o qual você deseja obter dados.
nota
Você não pode usar o EBS diretamente APIs com instantâneos arquivados.
Os exemplos a seguir mostram como ler instantâneos usando o EBS direct. APIs
Tópicos
Listar blocos em um snapshot
O comando de list-snapshot-blockssnap-0987654321. O parâmetro --starting-block-index limita os resultados para índices de bloco maiores que 1000, e o parâmetro --max-results limita os resultados aos primeiros 100 blocos.
aws ebs list-snapshot-blocks --snapshot-idsnap-0987654321--starting-block-index1000--max-results100
A resposta de exemplo a seguir para o comando anterior lista os índices e os tokens de bloco no snapshot. Use o comando get-snapshot-block e especifique o índice e o token do bloco do qual você deseja obter dados. Os tokens de bloco são válidos até o tempo de expiração listado.
{
"Blocks": [
{
"BlockIndex": 1001,
"BlockToken": "AAABAV3/PNhXOynVdMYHUpPsetaSvjLB1dtIGfbJv5OJ0sX855EzGTWos4a4"
},
{
"BlockIndex": 1002,
"BlockToken": "AAABATGQIgwr0WwIuqIMjCA/Sy7e/YoQFZsHejzGNvjKauzNgzeI13YHBfQB"
},
{
"BlockIndex": 1007,
"BlockToken": "AAABAZ9CTuQtUvp/dXqRWw4d07eOgTZ3jvn6hiW30W9duM8MiMw6yQayzF2c"
},
{
"BlockIndex": 1012,
"BlockToken": "AAABAQdzxhw0rVV6PNmsfo/YRIxo9JPR85XxPf1BLjg0Hec6pygYr6laE1p0"
},
{
"BlockIndex": 1030,
"BlockToken": "AAABAaYvPax6mv+iGWLdTUjQtFWouQ7Dqz6nSD9L+CbXnvpkswA6iDID523d"
},
{
"BlockIndex": 1031,
"BlockToken": "AAABATgWZC0XcFwUKvTJbUXMiSPg59KVxJGL+BWBClkw6spzCxJVqDVaTskJ"
},
...
],
"ExpiryTime": 1576287332.806,
"VolumeSize": 32212254720,
"BlockSize": 524288
}Listar blocos diferentes entre dois snapshots
Lembre-se do seguinte ao fazer solicitações paginadas para listar os blocos alterados entre dois snapshots:
-
A resposta pode incluir uma ou mais matrizes
ChangedBlocksvazias. Por exemplo:-
Snapshot 1: snapshot completo com 1000 blocos com índices de blocos
0-999. -
Snapshot 2: snapshot incremental com apenas um bloco alterado com índice de bloco
999.
Listar os blocos alterados para esses snapshot com
StartingBlockIndex = 0eMaxResults = 100retorna uma matriz vazia deChangedBlocks. É necessário solicitar os resultados restantes usandonextTokenaté que o bloco alterado seja retornado no décimo conjunto de resultados, que inclui blocos com índices de blocos900-999. -
-
A resposta pode ignorar blocos não escritos nos snapshots. Por exemplo:
-
Snapshot 1: snapshot completo com 1000 blocos com índices de blocos
2000-2999. -
Snapshot 2: snapshot incremental com apenas um bloco alterado com índice de bloco
2000.
Listando os blocos alterados para esses snapshots com
StartingBlockIndex = 0eMaxResults = 100, a resposta ignora os índices de blocos0-1999e inclui o índice de blocos2000. A resposta não incluirá matrizesChangedBlocksvazias. -
O comando de list-changed-blockssnap-1234567890 snap-0987654321 O parâmetro --starting-block-index limita os resultados para índices de bloco maiores que 0, e o parâmetro --max-results limita os resultados aos primeiros 500 blocos.
aws ebs list-changed-blocks --first-snapshot-idsnap-1234567890--second-snapshot-idsnap-0987654321--starting-block-index0--max-results500
A resposta de exemplo a seguir para o comando anterior mostra que os índices de bloco 0, 6000, 6001, 6002 e 6003 são diferentes entre os dois snapshots. Além disso, os índices de bloco 6001, 6002 e 6003 existem somente no primeiro ID de snapshot especificado, e não no segundo ID de snapshot, porque não há um segundo token de bloco listado na resposta.
Use o comando get-snapshot-block e especifique o índice e o token do bloco do qual você deseja obter dados. Os tokens de bloco são válidos até o tempo de expiração listado.
{
"ChangedBlocks": [
{
"BlockIndex": 0,
"FirstBlockToken": "AAABAVahm9SO60Dyi0ORySzn2ZjGjW/KN3uygGlS0QOYWesbzBbDnX2dGpmC",
"SecondBlockToken": "AAABAf8o0o6UFi1rDbSZGIRaCEdDyBu9TlvtCQxxoKV8qrUPQP7vcM6iWGSr"
},
{
"BlockIndex": 6000,
"FirstBlockToken": "AAABAbYSiZvJ0/R9tz8suI8dSzecLjN4kkazK8inFXVintPkdaVFLfCMQsKe",
"SecondBlockToken": "AAABAZnqTdzFmKRpsaMAsDxviVqEI/3jJzI2crq2eFDCgHmyNf777elD9oVR"
},
{
"BlockIndex": 6001,
"FirstBlockToken": "AAABASBpSJ2UAD3PLxJnCt6zun4/T4sU25Bnb8jB5Q6FRXHFqAIAqE04hJoR"
},
{
"BlockIndex": 6002,
"FirstBlockToken": "AAABASqX4/NWjvNceoyMUljcRd0DnwbSwNnes1UkoP62CrQXvn47BY5435aw"
},
{
"BlockIndex": 6003,
"FirstBlockToken": "AAABASmJ0O5JxAOce25rF4P1sdRtyIDsX12tFEDunnePYUKOf4PBROuICb2A"
},
...
],
"ExpiryTime": 1576308931.973,
"VolumeSize": 32212254720,
"BlockSize": 524288,
"NextToken": "AAADARqElNng/sV98CYk/bJDCXeLJmLJHnNSkHvLzVaO0zsPH/QM3Bi3zF//O6Mdi/BbJarBnp8h"
}Obter dados de bloco de um snapshot
O comando de get-snapshot-block6001 com o token do blocoAAABASBpSJ2UAD3PLxJnCt6zun4/T4sU25Bnb8jB5Q6FRXHFqAIAqE04hJoR, em um instantâneosnap-1234567890. Os dados binários serão enviados para o arquivo data no diretório C:\Temp em um computador Windows. Se você executar o comando em um computador Linux ou Unix, substitua o caminho de saída por /tmp/data para enviar os dados ao arquivo data no diretório /tmp.
aws ebs get-snapshot-block --snapshot-idsnap-1234567890--block-index6001--block-tokenAAABASBpSJ2UAD3PLxJnCt6zun4/T4sU25Bnb8jB5Q6FRXHFqAIAqE04hJoRC:/Temp/data
A resposta de exemplo a seguir para o comando anterior mostra o tamanho dos dados retornados, a soma de verificação para validar os dados e o algoritmo da soma de verificação. Os dados binários são salvos automaticamente no diretório e no arquivo especificados no comando da solicitação.
{
"DataLength": "524288",
"Checksum": "cf0Y6/Fn0oFa4VyjQPOa/iD0zhTflPTKzxGv2OKowXc=",
"ChecksumAlgorithm": "SHA256"
}