Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Les étapes suivantes décrivent comment utiliser l'EBS direct APIs pour lire des instantanés :
-
Utilisez cette ListSnapshotBlocks action pour afficher tous les index de blocs et les jetons de bloc des blocs dans un instantané. Vous pouvez également utiliser cette ListChangedBlocks action pour afficher uniquement les index de blocs et les jetons de blocs différents entre deux instantanés du même volume et de la même lignée de clichés. Ces actions vous aident à identifier les jetons de bloc et les index de bloc des blocs pour lesquels vous pouvez obtenir des données.
-
Utilisez l' GetSnapshotBlock action et spécifiez l'index du bloc et le jeton de bloc du bloc pour lequel vous souhaitez obtenir des données.
Note
Vous ne pouvez pas utiliser EBS direct APIs avec des instantanés archivés.
Les exemples suivants montrent comment lire des instantanés à l'aide de l'EBS direct. APIs
Rubriques
Liste des blocs dans un instantané
L'list-snapshot-blockssnap-0987654321. Le paramètre --starting-block-index limite les résultats aux index de blocs supérieurs à 1000, et le paramètre --max-results limite les résultats aux premiers blocs 100.
aws ebs list-snapshot-blocks --snapshot-idsnap-0987654321--starting-block-index1000--max-results100
L’exemple de réponse suivant pour la commande précédente répertorie les index de bloc et les jetons de bloc dans l’instantané. Utilisez la commande get-snapshot-block et spécifiez l'index de bloc et le jeton de bloc du bloc pour lequel vous souhaitez obtenir des données. Les jetons de bloc sont valides jusqu'au délai d'expiration indiqué.
{
"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
}Liste des blocs qui sont différents entre deux instantanés
Tenez compte des points suivants lorsque vous effectuez des demandes paginées pour répertorier les blocs modifiés entre deux instantanés :
-
La réponse peut inclure un ou plusieurs tableaux
ChangedBlocksvides. Par exemple :-
Instantané 1 – instantané complet avec 1 000 blocs avec des index de blocs
0–999. -
Instantané 2 – instantané incrémentiel avec un seul bloc modifié avec l’index de bloc
999.
La liste des blocs modifiés pour ces instantanés avec
StartingBlockIndex = 0etMaxResults = 100renvoie un tableau vide deChangedBlocks. Vous devez demander les autres résultats en utilisantnextTokenjusqu’à ce que le bloc modifié soit retourné dans le dixième jeu de résultats, qui comprend les blocs avec les index de bloc900–999. -
-
La réponse peut ignorer les blocs non écrits dans les instantanés. Par exemple :
-
Instantané 1 – instantané complet avec 1 000 blocs avec des index de blocs
2000–2999. -
Instantané 2 – instantané incrémentiel avec un seul bloc modifié avec l’index de bloc
2000.
En listant les blocs modifiés pour ces instantanés avec
StartingBlockIndex = 0etMaxResults = 100, la réponse ignore les index de bloc0–1999et inclut l’index de bloc2000. La réponse n’inclura pas les tableauxChangedBlocksvides. -
L'list-changed-blockssnap-1234567890 et. snap-0987654321 Le paramètre --starting-block-index limite les résultats aux index de blocs supérieurs à 0, et le paramètre --max-results limite les résultats aux premiers blocs 500.
aws ebs list-changed-blocks --first-snapshot-idsnap-1234567890--second-snapshot-idsnap-0987654321--starting-block-index0--max-results500
L’exemple de réponse suivant pour la commande précédente montre que les index de bloc 0, 6000, 6001, 6002 et 6003 sont différents entre les deux instantanés. De plus, les index de bloc 6001, 6002 et 6003 existent uniquement dans le premier ID d’instantané spécifié, et pas dans le second ID d’instantané car la réponse ne répertorie aucun second jeton de bloc.
Utilisez la commande get-snapshot-block et spécifiez l’index de bloc et le jeton de bloc du bloc pour lequel vous souhaitez obtenir des données. Les jetons de bloc sont valides jusqu'au délai d'expiration indiqué.
{
"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"
}Obtenir des données de bloc à partir d’un instantané
L'get-snapshot-block6001 avec le jeton de blocAAABASBpSJ2UAD3PLxJnCt6zun4/T4sU25Bnb8jB5Q6FRXHFqAIAqE04hJoR, sous forme d'instantanésnap-1234567890. Les données binaires seront générées dans le fichier data dans le répertoire C:\Temp sur un ordinateur Windows. Si vous exécutez la commande sur un ordinateur Linux ou Unix, remplacez le chemin de sortie par /tmp/data pour générer les données dans le fichier data du répertoire /tmp.
aws ebs get-snapshot-block --snapshot-idsnap-1234567890--block-index6001--block-tokenAAABASBpSJ2UAD3PLxJnCt6zun4/T4sU25Bnb8jB5Q6FRXHFqAIAqE04hJoRC:/Temp/data
L’exemple de réponse suivant pour la commande précédente montre la taille des données renvoyées, la somme de contrôle pour valider les données et l’algorithme de la somme de contrôle. Les données binaires sont automatiquement enregistrées dans le répertoire et le fichier que vous avez spécifiés dans la commande de demande.
{
"DataLength": "524288",
"Checksum": "cf0Y6/Fn0oFa4VyjQPOa/iD0zhTflPTKzxGv2OKowXc=",
"ChecksumAlgorithm": "SHA256"
}