Créer un dépôt partitionné

Vous pouvez créer un dépôt partitionné pour stocker des objets volumineux dans un bucket en les divisant en plusieurs parties plus petites dans l’un de vos buckets ou dans un bucket pour lequel vous disposez des autorisations appropriées. Vous pouvez ensuite déposer ces parties en parallèle, ce qui améliore le débit des objets volumineux sur les réseaux stables à large bande passante.

Le rétablissement en cas de problèmes de réseau est donc plus rapide avec un dépôt partitionné car chaque partie plus petite nécessite moins de données à re-déposer comparé à un seul gros fichier.

Chaque partie peut aller de 1 octet à 5 GiB. Toutefois, nous recommandons d’utiliser le dépôt partitionné pour les objets de 100 Mio ou plus en plusieurs parties plus petites. Une fois toutes les parties déposées, vous pouvez soit finaliser le dépôt partitionné (et reconstituer l’objet dans votre bucket), soit l’annuler en supprimant toutes les parties. Cette approche permet de mobiliser efficacement les ressources et la bande passante tout en maîtrisant les transferts volumineux de données. Pour en savoir plus, voir Déposer une partie.

Vous pouvez déposer une partie d’un objet sans connaître sa taille définitive, ce qui est utile pour la création d’objets en temps réel. En effet, il n’y a pas de limite de temps pour finaliser le dépôt : vous pouvez interrompre et reprendre son cours si nécessaire, ce qui est idéal en cas de projets continus ou d’accès irréguliers au réseau.

Vous ne pouvez pas modifier l’ACL ou les permissions du dépôt partitionné une fois celui-ci créé.

Par défaut, les objets que vous stockés sont privés. Cependant, vous pouvez accorder à d’autres utilisateurs les accès aux objets que vous avez stockés sur votre bucket en utilisant une Access Control List (ACL). Pour en savoir plus, voir Référence des Access Control List (ACL).

Créer un dépôt partitionné avec AWS CLI

Avant de commencer :

Pour créer un dépôt partitionné, utilisez la commande create-multipart-upload en suivant cette syntaxe :

Exemple de requête
$ aws s3api create-multipart-upload \
    --profile YOUR_PROFILE \
    --bucket BUCKET \
    --key MULTIPART_UPLOAD \
    --acl private \
    --grant-full-control "id=USER_ID, id=USER_ID" \
    --grant-read "id=USER_ID, id=USER_ID" \
    --grant-read-acp "id=USER_ID, id=USER_ID" \
    --grant-write-acp "id=USER_ID, id=USER_ID" \
    --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 voulez créer le dépôt partitionné.

  • key : Le nom que vous voulez donner au dépôt partitionné.

  • (optionnel) acl : Les permissions que vous accordez pour votre bucket (private | public-read | public-read-write | authenticated-read).

    • Si vous ne spécifiez pas de permission pour votre bucket au moment de sa création, celui-ci sera automatiquement configuré comme private.

    • Lorsque vous spécifiez une nouvelle permission, celle-ci remplace toutes les anciennes. Par conséquent, vous devez spécifier toutes les permissions dans une seule commande.

    Pour en savoir plus à propos des permissions existantes, voir Obtenir des informations sur l’ACL d’un bucket et Obtenir des informations sur l’ACL d’un objet.

  • (optionnel) grant-full-control : Un ou plusieurs ID d’utilisateurs auxquels vous accordez la permission full-control.

  • (optionnel) grant-read : Un ou plusieurs ID d’utilisateurs auxquels vous accordez la permission read.

  • (optionnel) grant-read-acp : Un ou plusieurs ID d’utilisateurs auxquels vous accordez la permission read-acp.

  • (optionnel) grant-write : Un ou plusieurs ID d’utilisateurs auxquels vous accordez la permission write.

  • (optionnel) grant-write-acp : Un ou plusieurs ID d’utilisateurs auxquels vous accordez la permission write-acp.

    • Vous devez spécifier des ID utilisateur S3. Vous pouvez récupérer les ID utilisateur S3 via les méthodes Lister vos buckets et Lister les objets d’un bucket.

    • Vous pouvez également spécifier des adresses e-mail utilisateur en utilisant le format emailaddress=name@domain.com.

  • 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 create-multipart-upload renvoie les éléments suivants :

  • Bucket : Le nom du bucket.

  • Key : Le nom du dépôt partitionné.

  • UploadId : L’ID du dépôt partitionné.

    Conservez cet élément car il est obligatoire pour d’autres commandes.

Exemple de résultat
{
    "Bucket": "BUCKET",
    "Key": "MULTIPART_UPLOAD",
    "UploadId": "2~xrosnH8pbKTk3sjXijfGIUN1KAEM3Yc"
}

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.