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.
Concepts pour les API EBS Direct
Voici les concepts clés que vous devez comprendre avant de commencer à utiliser les API EBS Direct.
Instantanés
Les instantanés représentent le principal moyen de sauvegarde des données de vos volumes EBS. Avec le API directes EBS, vous pouvez également sauvegarder des données de vos disques locaux vers des instantanés. Afin d’économiser les frais de stockage, les instantanés successifs sont incrémentiels ; ils contiennent uniquement les données du volume ayant changé depuis l’instantané précédent. Pour de plus amples informations, veuillez consulter Instantanés Amazon EBS.
Note
Les API EBS direct ne prennent pas en charge les instantanés publics et les instantanés locaux sur. AWS Outposts
Blocs
Un bloc est un fragment de données au sein d’un instantané. Chaque instantané peut contenir des milliers de blocs. Tous les blocs d’un instantané sont de taille fixe.
Index de bloc
Un index de blocs est un index logique en unités de 512 blocs Kio. Pour identifier l’index de blocs, divisez le décalage logique des données dans le volume logique par la taille de bloc (décalage logique des données/524288). Le décalage logique des données doit être 512 aligné en Kio.
Jetons de bloc
Un jeton de bloc est le hachage d’identification d’un bloc dans un instantané. Il est utilisé pour localiser les données de bloc. Les jetons de bloc renvoyés par les API directes EBS sont temporaires. Ils changent selon l'horodatage d'expiration qui leur est spécifié, ou si vous en exécutez un autre ListSnapshotBlocks ou ListChangedBlocks demandez le même instantané.
Total de contrôle
Une somme de contrôle est une référence de petite taille dérivée d’un bloc de données dans le but de détecter les erreurs introduites lors de sa transmission ou de son stockage. Les API directes EBS utilisent les sommes de contrôle pour valider l’intégrité des données. Lorsque vous lisez les données d'un instantané EBS, le service fournit des sommes de contrôle Base64-encoded SHA256 pour chaque bloc de données transmis, que vous pouvez utiliser à des fins de validation. Lorsque vous écrivez des données dans un instantané EBS, vous devez fournir une somme de contrôle SHA256 codée en Base64 pour chaque bloc de données transmis. Le service valide les données reçues à l’aide de la somme de contrôle fournie. Pour plus d’informations, consultez Utilisez les sommes de contrôle des API directes EBS pour valider les données des instantanés plus loin dans ce guide.
Chiffrement
Le chiffrement protège vos données en les convertissant en code illisible qui ne peut être déchiffré que par les personnes ayant accès à la clé KMS utilisée pour les chiffrer. Vous pouvez utiliser les API directes EBS pour lire et écrire des instantanés chiffrés, mais il existe certaines limitations. Pour plus d’informations, consultez Résultats du chiffrement pour les API EBS Direct plus loin dans ce guide.
Actions d’API
Les API directes EBS se composent de six actions. Il y a trois actions de lecture et trois actions d’écriture. Les actions de lecture sont :
-
ListSnapshotBlocks— renvoie les index de blocs et les jetons de bloc des blocs dans l'instantané spécifié
-
ListChangedBlocks— renvoie les index de bloc et les jetons de bloc des blocs qui sont différents entre deux instantanés spécifiés du même volume et de la même lignée d'instantanés.
-
GetSnapshotBlock— renvoie les données dans un bloc pour l'ID de snapshot, l'index de bloc et le jeton de bloc spécifiés.
Les actions d’écriture sont :
-
StartSnapshot— lance un instantané, soit en tant qu'instantané incrémentiel d'un instantané existant, soit en tant que nouveau cliché. L'instantané démarré reste en attente jusqu'à ce qu'il soit terminé à l'aide de l' CompleteSnapshot action.
-
PutSnapshotBlock— ajoute des données à un instantané démarré sous la forme de blocs individuels. Vous devez spécifier une somme de contrôle Base64-encoded SHA256 pour le bloc de données transmis. Le service valide le total de contrôle après la fin de la transmission des données. La requête échoue lorsque le total de contrôle calculé par le service ne correspond pas à la valeur que vous avez spécifiée.
-
CompleteSnapshot— complète une capture d'écran démarrée qui est en attente. L’instantané passe alors à l’état terminé.
Signature Version 4 (signature)
Signature Version 4 est le processus permettant d'ajouter des informations d'authentification aux AWS demandes envoyées par HTTP. Pour des raisons de sécurité, la plupart des demandes AWS doivent être signées à l'aide d'une clé d'accès, qui consiste en un identifiant de clé d'accès et une clé d'accès secrète. Ces deux clés sont généralement appelées informations d’identification de sécurité. Pour plus d’informations sur la façon d’obtenir les informations d’identification permettant d’accéder à votre compte, reportez-vous à Informations d’identification de sécurité AWS.
Si vous avez l’intention de créer manuellement des requêtes HTTP, vous devez apprendre à les signer. Lorsque vous utilisez le AWS Command Line Interface (AWS CLI) ou l'un des AWS kits SDK pour envoyer des demandes AWS, ces outils signent automatiquement les demandes pour vous à l'aide de la clé d'accès que vous avez spécifiée lors de la configuration des outils. Lorsque vous utilisez ces derniers, vous n’avez pas besoin d’apprendre à signer vous-même les demandes.
Pour plus d'informations, consultez la section Signer des demandes d' AWS API dans le guide de l'utilisateur IAM.
