Réception des totaux de contrôle lors du téléchargement de données - Amazon S3 Glacier
Exemple de hachage d'arborescence : Extraction d'une plage d'une archive qui est alignée avec le hachage d'arborescenceSpécification de plage alignée avec le hachage d'arborescence

Cette page est réservée aux clients existants du service S3 Glacier utilisant Vaults et l'original REST API de 2012.

Si vous recherchez des solutions de stockage d'archives, nous vous conseillons d'utiliser les classes de stockage S3 Glacier dans Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval et S3 Glacier Deep Archive. Pour en savoir plus sur ces options de stockage, consultez les sections Classes de stockage S3 Glacier et Stockage de données à long terme à l'aide des classes de stockage S3 Glacier dans le guide de l'utilisateur Amazon S3. Ces classes de stockage utilisent Amazon S3API, sont disponibles dans toutes les régions et peuvent être gérées au sein de la console Amazon S3. Ils offrent des fonctionnalités telles que l'analyse des coûts de stockage, Storage Lens, des fonctionnalités de chiffrement optionnelles avancées, etc.

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.

Réception des totaux de contrôle lors du téléchargement de données

Lorsque vous extrayez une archive à l'aide de l'API de lancement de tâche (consultez la section Initier une tâche (POSToffres d'emploi)), vous pouvez éventuellement spécifier une plage à extraire de l'archive. De même, lorsque vous téléchargez vos données à l'aide de l'API de génération de sortie de tâche (consultez la section Génération de sortie de tâche (GET output)), vous pouvez éventuellement spécifier une plage de données à télécharger. Vous devez comprendre deux caractéristiques essentielles de ces plages lorsque vous procédez à l'extraction et au téléchargement des données de votre archive. La plage à extraire doit être alignée en termes de méga-octets avec l'archive. La plage à extraire et la plage à télécharger doivent toutes les deux être alignées avec le hachage d'arborescence pour vous permettre de recevoir les valeurs de total de contrôle lorsque vous téléchargez vos données. Les définitions de ces deux types d'alignement de plage sont les suivantes :

  • Aligné en mégaoctets : une plage [StartByte, EndBytes] est alignée en mégaoctets (1024* 1024) lorsqu'elle StartBytesest divisible par 1 Mo et EndBytesplus 1 est divisible par 1 Mo ou est égale à la fin de l'archive spécifiée (taille d'octet d'archive moins 1). Une plage utilisée dans l'API de lancement de tâche, si elle est spécifiée, doit être alignée en termes de méga-octets.

  • Aligné par arbre - Une plage [StartBytes, EndBytes] est un hachage arborescent aligné par rapport à une archive si et seulement si la racine du hachage arborescent construit sur cette plage est équivalente à un nœud dans le hachage arborescent de l'ensemble de l'archive. La plage à extraire et la plage à télécharger doivent toutes les deux être alignées avec le hachage d'arborescence pour vous permettre de recevoir les valeurs de total de contrôle des données que vous téléchargez. Pour obtenir un exemple de plages et de leur relation avec le hachage d'arborescence d'une archive, consultez la section Exemple de hachage d'arborescence : Extraction d'une plage d'une archive qui est alignée avec le hachage d'arborescence.

    Notez qu'une plage alignée avec le hachage d'arborescence est également alignée en termes de méga-octets. En revanche, une plage alignée en termes de méga-octets n'est pas nécessairement alignée avec le hachage d'arborescence.

Les cas suivants décrivent à quel moment vous recevez une valeur de total de contrôle lorsque vous téléchargez vos données archivées :

  • Si vous ne spécifiez pas de plage à extraire dans la demande de lancement de tâche et que vous téléchargez la totalité de l'archive dans la demande d'affichage de tâche.

  • Si vous ne spécifiez pas de plage à extraire dans la demande de lancement de tâche et que vous indiquez une plage à télécharger dans la demande d'affichage de tâche qui est alignée avec le hachage d'arborescence.

  • Si vous spécifiez une plage à extraire dans la demande de lancement de tâche qui est alignée avec le hachage d'arborescence et que vous téléchargez la totalité de la plage dans la demande d'affichage de tâche.

  • Si vous spécifiez une plage à extraire dans la demande de lancement de tâche qui est alignée avec le hachage d'arborescence et que vous indiquez une plage à télécharger dans la demande d'affichage de tâche qui est alignée avec le hachage d'arborescence.

Si vous spécifiez une plage à extraire dans la demande de lancement de tâche qui n'est pas alignée avec le hachage d'arborescence, vous pouvez tout de même obtenir vos données archivées, mais aucune valeur de total de contrôle n'est renvoyée lorsque vous téléchargez des données dans le cadre de la demande d'affichage de tâche.

Exemple de hachage d'arborescence : Extraction d'une plage d'une archive qui est alignée avec le hachage d'arborescence

Imaginons que votre coffre contient une archive de 6,5 Mo et que vous souhaitez extraire 2 Mo de l'archive. La façon dont vous spécifiez la plage de 2 Mo dans la demande de lancement de tâche détermine si vous recevez des valeurs de total de contrôle de données lorsque vous téléchargez vos données. Le schéma suivant illustre deux plages de 2 Mo que vous pouvez télécharger pour l'archive de 6,5 Mo. Les deux plages sont alignées en termes de méga-octets, mais une seule est alignée avec le hachage d'arborescence.

Schéma illustrant la récupération d'une plage d'archives alignée par hachage arborescent.

Spécification de plage alignée avec le hachage d'arborescence

Cette section fournit la spécification exacte d'une plage alignée avec le hachage d'arborescence. Les plages alignées avec le hachage d'arborescence sont essentielles lorsque vous téléchargez une partie d'une archive et que vous spécifiez la plage de données à extraire et la plage de données extraites à télécharger. Si ces deux plages sont alignées avec le hachage d'arborescence, vous recevez des valeurs de total de contrôle lorsque vous téléchargez les données.

Une plage [A, B] est alignée avec le hachage d'arborescence par rapport à une archive si et seulement si lorsqu'un nouveau hachage d'arborescence est créé sur [A, B], la racine du hachage d'arborescence de cette plage équivaut à un nœud du hachage de la totalité de l'archive. Pour obtenir une illustration, consultez le schéma dans la section Exemple de hachage d'arborescence : Extraction d'une plage d'une archive qui est alignée avec le hachage d'arborescence. Cette section fournit la spécification de l'alignement avec le hachage d'arborescence.

Prenez par exemple [P, Q) comme requête de plage pour une archive de N méga-octets (Mo) et P et Q comme multiples d'un Mo. Notez que la plage inclusive réelle est [P Mo, Q MB - 1 octet], mais pour simplifier, nous la présentons sous la forme [P, Q). Ces considérations étant présentées,

  • Si P est un nombre impair, il n'y a qu'une seule plage possible à être alignée sur le hachage d'arborescence, à savoir [P, P + 1 Mo).

  • Si P est un nombre pair et que k est le nombre maximal, où P peut être écrit sous la forme 2k * X, il y a au maximum k plages alignées sur le hachage d'arborescence qui commencent par P. X est un entier supérieur à 0. Les plages alignées avec le hachage d'arborescence sont classées dans les catégories suivantes :

    • Pour chaque i, où (0 <= i <= k) et où P + 2i < N, [P, Q + 2i) est une plage alignée avec le hachage d'arborescence.

    • P = 0 est le cas spécial où A = 2[lgN]*0