Déposer une partie

Vous pouvez déposer plusieurs parties d’un objet volumineux dans un dépôt partitionné.

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

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

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 dépôt partitionné.

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 dépôt partitionné pour reconstituer l’objet à l’intérieur de votre bucket, ou si vous annulez le dépôt partitionné et par conséquent supprimez toutes les parties que vous avez déposées sur votre bucket. Pour en savoir plus, voir Finaliser un dépôt partitionné ou Annuler un dépôt partitionné.

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 dépôt partitionné. Pour en savoir plus, voir Créer un dépôt partitionné.

  • 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 attributs suivants 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 dépôt partitionné.

  • key : Le nom donné au dépôt partitionné 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 dépôt partitionné. Pour en savoir plus, voir Créer un dépôt partitionné.

  • (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 dépôt partitionné.

    Si vous perdez cet élément, vous pouvez le retrouver. Pour en savoir plus, voir Lister les dépôts partitionnés 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 dépôt partitionné 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 dépôt partitionné. Pour en savoir plus, voir Finaliser un dépôt partitionné.

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.