Déposer une partie

Vous pouvez déposer plusieurs parties d’un objet volumineux dans un multipart upload.

Vous pouvez déposer une partie sur l’un des multipart upload que vous avez créés ou sur un multipart upload créé par un autre utilisateur. Vous devez avoir les permission appropriées, à la fois pour le multipart upload et pour le bucket.

Il est recommandé d’utiliser le multipart upload pour les objets de 100 Mio ou plus. Vous pouvez déposer jusqu’à 10000 parties de 1 Mio à 4 Gio chacune dans un multipart upload.

Lorsque vous déposez une partie, vous spécifiez une clé qui peut alors être utilisée pour identifier la partie. Pour en savoir plus, voir Lister les parties d’un multipart upload.

Les parties que vous déposez doivent toutes avoir la même taille, à l’exception de la dernière partie qui doit être égale ou inférieure aux autres.

Lorsque toutes les parties sont déposées, vous devez spécifier si vous voulez finaliser le multipart upload pour reconstituer l’objet à l’intérieur de votre bucket, ou si vous annulez le multipart upload et par conséquent supprimez toutes les parties que vous avez déposées sur votre bucket. Pour en savoir plus, voir Finaliser un multipart upload ou Annuler un multipart upload.

Déposer une partie avec AWS CLI

Avant de commencer :

  • Installez et configurez AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.

  • Créer un multipart upload. Pour en savoir plus, voir Créer un multipart upload.

  • Diviser votre objet en plusieurs parties. Pour ce faire, vous pouvez utiliser un outil tiers ou écrire votre propre script pour diviser l’objet en morceaux de la taille requise.

Pour déposer une partie, utilisez la commande upload-part en suivant cette syntaxe :

Exemple de requête
$ aws s3api upload-part \
    --profile YOUR_PROFILE \
    --bucket BUCKET \
    --key MULTIPART_UPLOAD \
    --body usr/bin/YOUR_OBJECT \
    --part-number 1 \
    --upload-id 2~xrosnH8pbKTk3sjXijfGIUN1KAEM3Yc \
    --content-length 1048567 \
    --endpoint https://oos.eu-west-2.outscale.com

Cette commande contient les options suivantes que vous devez spécifier :

  • (optionnel) profile : Le profil nommé que vous voulez utiliser, créé pendant la configuration d’AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.

  • bucket : Le bucket dans lequel vous avez crée le multipart upload.

  • key : Le nom donné au multipart upload dans lequel vous voulez déposer une partie.

  • body : Le chemin sur votre machine vers la partie que vous voulez déposer.

  • part-number : Le numéro de la partie que vous voulez déposer. Ce nombre doit être un entier compris entre 1 et 10000.

  • upload-id : L’ID du dépôt que vous avez reçu en créant le multipart upload. Pour en savoir plus, voir Créer un multipart upload.

  • (optionnel) content-length : Si la taille ne peut pas être définie automatiquement, la taille de l’objet, en octets. Le minimum doit être de 1048567 (1 Mio), et le maximum est 4294967296 (4 Gio).

  • endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête. Pour en savoir plus, voir Installer et configurer AWS CLI.

La commande upload-part renvoie l’élément suivant :

  • ETag : L’ETag de la partie.

    Conservez précieusement cet élément, vous en aurez besoin dans d’autres commande pour le multipart upload.

    Si vous perdez cet élément, vous pouvez le retrouver. Pour en savoir plus, voir Lister les multipart upload d’un bucket.
Exemple de résultat
{
    "ETag": "\"44c7af3f06fd63a36593826be3cb7684\""
}

La partie que vous avez déposée n’apparaît pas immédiatement dans le bucket car le processus de multipart upload n’est pas encore terminé. En effet, les pièces déposées sont uniquement réassemblées et visibles dans le bucket en tant qu’objet unique une fois que vous avez explicitement finalisé le multipart upload. Pour en savoir plus, voir Finaliser un multipart upload.

Pages connexes

AWS™ et Amazon Web Services™ sont des marques de commerce d'Amazon Technologies, Inc. ou de ses affiliées aux États-Unis et/ou dans les autres pays.

Exporter en PDF