Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
I passaggi seguenti descrivono come utilizzare EBS Direct APIs per leggere le istantanee:
-
Usa l' ListSnapshotBlocks azione per visualizzare tutti gli indici di blocco e i token di blocco dei blocchi in un'istantanea. Oppure usa l' ListChangedBlocks azione per visualizzare solo gli indici di blocco e i token di blocco dei blocchi che sono diversi tra due istantanee dello stesso volume e dello stesso lignaggio delle istantanee. Queste operazioni ti consentono di identificare i token e gli indici di blocco per i quali vuoi ottenere dati.
-
Usa l' GetSnapshotBlock azione e specifica l'indice di blocco e il token di blocco del blocco per il quale desideri ottenere i dati.
Nota
Non puoi usare EBS direct APIs con istantanee archiviate.
I seguenti esempi mostrano come leggere le istantanee utilizzando EBS Direct. APIs
Argomenti
Elenco dei blocchi in uno snapshot
Il comando di list-snapshot-blockssnap-0987654321
Il parametro --starting-block-index
limita i risultati agli indici di blocco maggiori di 1000
e il parametro --max-results
limita i risultati ai primi 100
blocchi.
aws ebs list-snapshot-blocks --snapshot-id
snap-0987654321
--starting-block-index1000
--max-results100
La seguente risposta di esempio per il comando precedente elenca gli indici e i token di blocco nello snapshot. Utilizza il comando get-snapshot-block
e specifica l'indice e il token del blocco per cui vuoi ottenere i dati. I token di blocco sono validi fino all'ora di scadenza indicata.
{
"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
}
Elenco dei blocchi diversi tra due snapshot
Quando effettui richieste paginate per elencare i blocchi modificati tra due snapshot, tieni presente quanto indicato di seguito:
-
La risposta può includere uno o più array
ChangedBlocks
vuoti. Esempio:-
Snapshot 1: snapshot completo con 1000 blocchi con indici blocco
0
-999
. -
Snapshot 2: snapshot incrementale con un solo blocco modificato con indice blocco
999
.
L'elencazione dei blocchi modificati per questi snapshot con
StartingBlockIndex = 0
eMaxResults = 100
restituisce un array diChangedBlocks
vuoto. Occorre richiedere i risultati rimanenti utilizzandonextToken
fino a quando il blocco modificato non viene restituito nella decima serie di risultati, che include blocchi con indici blocco900
-999
. -
-
La risposta può saltare blocchi non scritti negli snapshot. Esempio:
-
Snapshot 1: snapshot completo con 1000 blocchi con indici blocco
2000
-2999
. -
Snapshot 2: snapshot incrementale con un solo blocco modificato con indice blocco
2000
.
Elencando i blocchi modificati per questi snapshot con
StartingBlockIndex = 0
eMaxResults = 100
, la risposta salta gli indici blocco0
-1999
e include l'indice blocco2000
. La risposta non includerà arrayChangedBlocks
vuoti. -
Il comando di list-changed-blockssnap-1234567890
snap-0987654321
Il parametro --starting-block-index
limita i risultati agli indici di blocco maggiori di 0
e il parametro --max-results
limita i risultati ai primi 500
blocchi.
aws ebs list-changed-blocks --first-snapshot-id
snap-1234567890
--second-snapshot-idsnap-0987654321
--starting-block-index0
--max-results500
La seguente risposta di esempio per il comando precedente mostra che gli indici di blocco 0, 6000, 6001, 6002 e 6003 sono diversi tra i due snapshot. Inoltre, gli indici di blocco 6001, 6002 e 6003 esistono solo nel primo ID snapshot specificato e non nel secondo perché nella risposta non è presente un secondo token di blocco.
Utilizza il comando get-snapshot-block
e specifica l'indice e il token del blocco per cui vuoi ottenere i dati. I token di blocco sono validi fino all'ora di scadenza indicata.
{
"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"
}
Recupero dei dati di blocco da uno snapshot
Il comando di get-snapshot-block6001
con il token AAABASBpSJ2UAD3PLxJnCt6zun4/T4sU25Bnb8jB5Q6FRXHFqAIAqE04hJoR
di blocco, in uno snapshot. snap-1234567890
I dati binari vengono memorizzati nel file data
nella directory C:\Temp
in un computer Windows. Se esegui il comando in un computer Linux o Unix, sostituisci il percorso di output /tmp/data
in modo che i dati vengano inseriti nel file data
nella directory /tmp
.
aws ebs get-snapshot-block --snapshot-id
snap-1234567890
--block-index6001
--block-tokenAAABASBpSJ2UAD3PLxJnCt6zun4/T4sU25Bnb8jB5Q6FRXHFqAIAqE04hJoR
C:/Temp/data
La risposta di esempio seguente per il comando precedente mostra la dimensione dei dati restituiti, il checksum per convalidare i dati e l'algoritmo del checksum. I dati binari vengono salvati automaticamente nella directory e nel file specificati nel comando di richiesta.
{
"DataLength": "524288",
"Checksum": "cf0Y6/Fn0oFa4VyjQPOa/iD0zhTflPTKzxGv2OKowXc=",
"ChecksumAlgorithm": "SHA256"
}