Chargement d'archives volumineuses en plusieurs parties (chargement partitionné) - Amazon S3 Glacier

Cette page s'adresse uniquement aux clients existants du service S3 Glacier utilisant Vaults et l'API REST d'origine datant 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 l'API Amazon S3, 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 sécurité, notamment de multiples options de cryptage, 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.

Chargement d'archives volumineuses en plusieurs parties (chargement partitionné)

Processus de chargement partitionné

Comme indiqué dans Chargement d'une archive dans Amazon S3 Glacier, nous encourageons les clients Amazon S3 Glacier (S3 Glacier) à utiliser le chargement partitionné pour charger les archives de plus de 100 mébioctets (Mio).

  1. Lancement du chargement partitionné

    Lorsque vous envoyez une demande pour lancer un chargement partitionné, S3 Glacier renvoie un ID de chargement partitionné, qui est l'identifiant unique de votre chargement partitionné. Cet ID sera requis pour toute opération de chargement partitionné suivante. L'ID n'expire pas avant au moins 24 heures après que S3 Glacier a terminé la tâche.

    Dans votre demande de lancement d'un chargement partitionné, vous devez spécifier la taille des parties en nombre d'octets. Chacune des parties que vous chargez, à l'exception de la dernière partie, doit correspondre à cette taille.

    Note

    Vous n'avez pas besoin de connaître la taille globale de l'archive lorsque vous utilisez le chargement partitionné. Cela signifie que vous pouvez utiliser des téléchargements partiels dans les cas où vous ne connaissez pas la taille de l'archive lorsque vous commencez à charger l'archive. Vous devez juste définir la taille des parties au moment du lancement d'un chargement partitionné.

    Dans la demande de lancement de chargement partitionné, vous pouvez également fournir une description facultative de l'archive.

  2. Chargement des parties

    Pour chaque demande de chargement de partie, vous devez inclure l'ID de chargement partitionné que vous avez obtenu à l'étape 1. Dans la demande, vous devez également spécifier la plage de contenu, en octets, en identifiant la position de la partie dans l'archive finale. S3 Glacier se servira par la suite des informations sur la plage de contenu pour assembler l'archive dans le bon ordre. Etant donné que vous indiquez la plage de contenu de chaque partie que vous chargez, il détermine la position de chaque partie dans l'assemblage final de l'archive ; par conséquent, vous pouvez charger les parties dans n'importe quel ordre. Vous pouvez également charger différentes parties en parallèle. Si vous chargez une nouvelle partie en utilisant la même plage de contenu que celle définie pour une partie précédemment chargée, cette dernière est remplacée.

  3. Achèvement (ou arrêt) du chargement partitionné

    Après avoir chargé toutes les parties d'une archive, utilisez l'opération d'achèvement. Là encore, vous devez spécifier l'ID de chargement dans votre demande. S3 Glacier crée une archive en concaténant les parties par ordre croissant en fonction de la plage de contenu que vous avez indiquée. Dans la réponse de S3 Glacier à une demande d'achèvement du chargement partitionné figure l'ID de l'archive nouvellement créée. Si vous avez ajouté une description facultative de l'archive à la demande de lancement du chargement partitionné, S3 Glacier l'associe à l'archive assemblée. Lorsque votre opération d'achèvement de chargement partitionné aboutit, vous ne pouvez pas faire référence à l'ID de chargement partitionné. Cela signifie que vous ne pouvez pas accéder aux parties associées à l'ID de chargement partitionné.

    Si vous arrêtez un chargement partitionné, vous ne pouvez pas charger de parties supplémentaires en utilisant cet ID de chargement partitionné. L'ensemble du stockage consommé par les parties associées au chargement partitionné arrêté est libéré. Si des parties étaient en cours de chargement, ces opérations peuvent encore réussir ou échouer même après un arrêt.

Opérations supplémentaires de chargement partitionné

Amazon S3 Glacier (S3 Glacier) propose les appels d'API de chargement partitionné supplémentaires suivants.

  • Affichage des parties : cette opération vous permet d'afficher la liste des parties d'un chargement partitionné spécifique. Elle renvoie des informations sur les parties que vous chargées dans le cadre d'un chargement partitionné. Pour chaque demande d'affichage d'une liste de parties, S3 Glacier renvoie les informations pour un maximum de 1 000 parties. S'il existe d'autres parties à afficher pour le chargement partitionné, le résultat est paginé et la réponse renvoyée inclut un marqueur à partir duquel poursuivre l'affichage de la liste. Vous devez envoyer des demandes supplémentaires pour extraire les parties suivantes. Notez que la liste des parties renvoyée n'inclut pas les parties dont le chargement n'est pas terminé.

  • Affichage des chargements partitionnés : cette opération vous permet d'obtenir la liste des chargements partitionnés en cours. Un chargement partitionné en cours est un chargement que vous avez lancé, mais que vous n'avez pas encore terminé ou arrêté. Pour chaque demande d'affichage d'une liste de chargements partitionnés, S3 Glacier renvoie jusqu'à 1 000 chargements partitionnés. S'il existe d'autres chargements partitionnés à afficher, le résultat est paginé et la réponse renvoyée inclut un marqueur à partir duquel poursuivre l'affichage de la liste. Vous devez envoyer des demandes supplémentaires pour extraire les chargements partitionnés restants.

En bref

Le tableau suivant fournit les principales spécifications du chargement partitionné.

Élément Spécification
Taille maximale d'archive 10 000 x 4 gibioctets (Gio)
Nombre maximum de parties par chargement 10 000
Taille de partie

De 1 Mio à 4 Gio ; la dernière partie peut être inférieure à 1 Mio. Vous spécifiez la valeur de taille en octets.

La taille de la partie doit être un mébioctet (1 024 kibioctets [Kio]) multiplié par une puissance de 2. Par exemple, 1048576 (1 Mio), 2097152 (2 Mio), 4194304 (4 Mio), 8388608 (8 Mio).

Nombre maximum de parties renvoyées pour une demande de liste des parties 1 000
Nombre maximum de chargements partitionnés renvoyés dans le cadre d'une demande d'affichage de chargements partitionnés 1 000