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 de fichiers dans un bucket Lightsail avec chargement partitionné

Grâce au chargement partitionné, vous pouvez charger un seul fichier dans votre compartiment en tant qu'ensemble de parties. Chaque partie est une portion contiguë des données du fichier. Vous pouvez charger ces parties de fichier indépendamment et dans n'importe quel ordre. Si le transfert d'une partie échoue, vous pouvez la retransférer sans affecter les autres. Une fois toutes les parties de votre fichier chargées, Amazon S3 les assemble et crée l'objet dans votre compartiment dans Amazon Lightsail. En général, lorsque l'objet atteint la taille de 100 Mo, vous devez préférer les chargements partitionnés au chargement d'objet en une seule opération. Pour plus d'informations sur les compartiments, veuillez consulter Stockage d'objets.

L'utilisation du chargement partitionné offre les avantages suivants :

Nous vous recommandons d'utiliser le chargement partitionné comme suit :

Table des matières

Processus de chargement partitionné

Le chargement en plusieurs parties est un processus en trois étapes qui utilise les actions Amazon S3 pour charger des fichiers dans votre compartiment dans Lightsail :

Lorsque la demande de chargement partitionné est terminée, Amazon Simple Storage Service construit l'objet à partir des parties chargées. Ensuite, vous pouvez accéder à l'objet de la même manière que vous accédez à n'importe quel autre objet dans votre compartiment.

Vous pouvez lister tous vos chargements partitionnés en cours ou obtenir une liste des parties que vous avez chargées pour un chargement partitionné spécifique. Chacune de ces opérations est expliquée dans cette section.

Lancement du chargement partitionné

Lorsque vous envoyez une demande pour lancer un chargement partitionné, Amazon Simple Storage Service renvoie une réponse avec un ID de chargement. Il s'agit d'un identifiant unique pour votre chargement partitionné. Vous devez inclure l'ID de chargement dès que vous chargez les parties, listez les parties, terminez un chargement ou arrêtez un chargement. Si vous souhaitez fournir des métadonnées qui décrivent l'objet en cours de chargement, vous devez spécifier les métadonnées dans la demande de lancement du chargement partitionné.

Chargement de parties

Lorsque vous chargez une partie, outre l'ID de chargement, vous devez spécifier un numéro de partie. Vous pouvez choisir n'importe quel numéro de partie compris entre 1 et 10 000. Un numéro de partie identifie de manière unique une partie et sa place dans l'objet que vous chargez. Le numéro de partie que vous choisissez ne doit pas obligatoirement constituer une séquence consécutive (par exemple, cela peut être 1, 5 et 14). Si vous chargez une nouvelle partie avec le même numéro qu'une partie précédemment chargée, cette dernière est remplacée.

Chaque fois que vous importez une partie, Amazon Simple Storage Service renvoie un ETag en-tête dans sa réponse. Pour chaque téléchargement partiel, vous devez enregistrer le numéro de pièce et la ETag valeur. Vous devez inclure ces valeurs dans la demande ultérieure pour terminer le chargement partitionné.

Fin du chargement partitionné

Lorsque vous terminez un chargement partitionné, Amazon Simple Storage Service crée un objet en concaténant les parties par ordre croissant en fonction des numéros de partie. Si des métadonnées d'objet sont fournies dans la demande de lancement du chargement partitionné, Amazon Simple Storage Service les associe à l'objet. À l'issue d'une demande de chargement complet, les parties n'existent plus.

Votre demande complète de téléchargement en plusieurs parties doit inclure l'ID de téléchargement et une liste des numéros de pièce et des ETag valeurs correspondantes. La réponse d'Amazon Simple Storage Service inclut un ETag identifiant unique les données d'objet combinées. Il ne ETag s'agit pas nécessairement d'un MD5 hachage des données de l'objet.

Si vous le souhaitez, vous pouvez arrêter le chargement partitionné. Après avoir arrêté un chargement partitionné, vous ne pouvez pas charger de partie avec le même ID de chargement. Tout le stockage de n'importe quelle partie du chargement partitionné annulé est alors libéré. Si des chargements de partie étaient en cours, ils peuvent encore aboutir ou échouer même après un arrêt. Pour libérer tout le stockage consommé par l'ensemble des parties, vous devez arrêter un chargement partitionné uniquement après la fin du chargement de toutes les parties.

Listes de chargement partitionné

Vous pouvez lister les parties d'un chargement partitionné spécifique ou de tous les chargements partitionnés en cours. L'opération de liste des parties renvoie des informations sur les parties que vous avez chargées pour un chargement partitionné spécifique. Pour chaque demande de liste des parties, Amazon Simple Storage Service renvoie des informations sur les parties pour le chargement partitionné spécifié, pour 1 000 parties maximum. S'il y a plus de 1 000 parties dans le chargement partitionné, vous devez envoyer une série de demandes de liste des parties pour récupérer toutes les parties. Notez que la liste des parties renvoyée n'inclut pas les parties dont le chargement n'est pas terminé. En utilisant l'opération d'affichage des chargements partitionnés, vous pouvez 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é. Chaque demande renvoie 1,000 chargements partitionnés maximum. S'il y a plus de 1 000 chargements partitionnés en cours, vous devez envoyer des demandes supplémentaires pour récupérer les chargements partitionnés restants. Utilisez uniquement la liste renvoyée pour la vérification. N'utilisez pas le résultat de la liste lorsque vous envoyez une demande de chargement partitionné complet. Conservez plutôt votre propre liste des numéros de pièces que vous avez spécifiés lors du téléchargement des pièces et des ETag valeurs correspondantes renvoyées par Amazon Simple Storage Service.

Opérations simultanées de chargement partitionné

Dans un environnement de développement distribué, il est possible pour l'application de lancer plusieurs mises à jour sur le même objet en même temps. L'application doit lancer plusieurs chargements partitionnés grâce à la même clé d'objet. Pour chacun de ces chargements, l'application peut ensuite charger des parties et envoyer une demande de chargement complet à Amazon Simple Storage Service pour créer l'objet. Lorsque les compartiments sont activés pour le contrôle de version, un chargement partitionné terminé crée toujours une nouvelle version. Pour les compartiments qui ne sont pas activés pour le contrôle de version, d'autres demandes peuvent avoir la priorité, par exemple les demandes reçues après le début et avant la fin d'un chargement partitionné.

Conservation du chargement partitionné

Toutes les parties chargées d'un chargement partitionné sont stockées sur votre compartiment. Elles consomment l'espace de stockage de votre compartiment jusqu'à ce que vous terminiez le chargement, arrêtiez le chargement ou que le chargement expire. Un chargement partitionné expire et il est supprimé 24 heures après le moment où il a été créé. Lorsque vous arrêtez un chargement partitionné ou qu'il expire, toutes les parties chargées sont supprimées et l'espace de stockage qu'elles utilisaient sur votre compartiment est libéré.

Limites de la fonction de chargement partitionné d'Amazon Simple Storage Service

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

Fractionner le fichier à charger

Utilisez la commande split sur le système d'exploitation Linux ou Unix pour fractionner un fichier en plusieurs parties que vous chargez ensuite dans votre compartiment. Il existe des applications gratuites similaires que vous pouvez utiliser sur le système d'exploitation Windows pour fractionner un fichier. Après avoir divisé le fichier en plusieurs parties, passez à la section Lancer un chargement partitionné de ce guide.

Lancer un chargement partitionné à l'aide de l' AWS CLI

Suivez la procédure ci-dessous pour lancer un chargement partitionné à l'aide de l' AWS Command Line Interface (AWS CLI). Pour ce faire, utilisez la commande create-multipart-upload. Pour plus d'informations, consultez create-multipart-uploadle manuel de référence des AWS CLI commandes.

Téléchargez une pièce à l'aide du AWS CLI

Suivez la procédure ci-dessous pour charger une partie du chargement partitionné à l'aide de l' AWS Command Line Interface (AWS CLI). Pour ce faire, utilisez la commande upload-part. Pour plus d'informations, veuillez consulter upload-part dans la Référence des commandes AWS CLI .

Répertoriez les parties d'un téléchargement partitionné à l'aide du AWS CLI

Suivez la procédure ci-dessous pour répertorier les parties d'un chargement partitionné à l'aide de l' AWS Command Line Interface (AWS CLI). Pour ce faire, utilisez la commande list-parts. Pour plus d'informations, veuillez consulter list-parts dans la Référence des commandes AWS CLI .

Complétez cette procédure pour obtenir les valeurs ETag pour toutes les parties chargées dans un chargement partitionné. Vous aurez besoin de ces valeurs pour terminer le chargement partitionné (explications plus loin dans ce guide). Toutefois, si vous avez enregistré toutes les valeurs ETag à partir de la réponse de vos chargements de parties, vous pouvez ignorer cette procédure et passer à la section Créer un chargement partitionné .json de ce guide.

Créer un fichier .json de chargement partitionné

Suivez la procédure ci-dessous pour créer un fichier .json de chargement partitionné qui définit toutes les parties que vous avez chargées et leurs valeurs ETag. Cette action est requise plus loin dans ce guide pour terminer le chargement partitionné.

Effectuez un téléchargement en plusieurs parties à l'aide du AWS CLI

Suivez la procédure ci-dessous pour terminer un chargement partitionné à l'aide de l' AWS Command Line Interface (AWS CLI). Pour ce faire, utilisez la commande complete-multipart-upload. Pour plus d'informations, consultez complete-multipart-uploadle manuel de référence des AWS CLI commandes.

Répertoriez les téléchargements partitionnés pour un bucket à l'aide du AWS CLI

Suivez la procédure ci-dessous pour répertorier tous les chargements partitionnés pour un compartiment à l'aide de l' AWS Command Line Interface (AWS CLI). Pour ce faire, utilisez la commande list-multipart-uploads. Pour plus d'informations, consultez list-multipart-uploadsle manuel de référence des AWS CLI commandes.

Arrêtez un téléchargement partitionné à l'aide du AWS CLI

Procédez comme suit pour arrêter un téléchargement partitionné à l'aide du AWS Command Line Interface (AWS CLI). Vous effectuez cette opération si vous avez démarré un chargement partitionné mais que vous ne souhaitez plus le poursuivre. Pour ce faire, utilisez la commande abort-multipart-upload. Pour plus d'informations, consultez abort-multipart-uploadle manuel de référence des AWS CLI commandes.