Télécharger un objet depuis un bucket

Vous pouvez télécharger un objet depuis l’un de vos buckets ou depuis un bucket qu’un autre utilisateur a partagé avec vous. Pour en savoir plus, voir Référence des Access Control List (ACL).

Nous recommandons de ne pas dépasser 200 téléchargements par seconde depuis un même bucket.

Vous pouvez télécharger la version actuelle ou n’importe quelle version précédente d’un objet. Pour en savoir plus, voir Lister les versions d’un objet.

Vous pouvez télécharger un objet :

  • Depuis n’importe quel Software Development Kit (SDK), par exemple AWS CLI. L’objet que vous téléchargez est stocké à l’endroit depuis lequel vous exécutez la commande, par exemple votre répertoire root.

  • Depuis une adresse URL, à l’un des deux formats suivants :

    • https://oos.<REGION>.outscale.com/<BUCKET>/<OBJECT_KEY>

    • https://<BUCKET>.oos.<REGION>.outscale.com/<OBJECT_KEY>

Télécharger un objet depuis un bucket avec AWS CLI (s3api)

Avant de commencer : Installez et configurez AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.

Pour télécharger un objet depuis un bucket, utilisez la commande get-object en suivant cette syntaxe :

Exemple de requête
$ aws s3api get-object \
    --profile YOUR_PROFILE \
    --bucket BUCKET_NAME \
    --key OBJECT_NAME \
        outfile=<~/home/Name_Of_The_Downloaded_Object> \
    --range bytes=0-499 \
    --version-id qAfAAsAAuA00kclkg0A0AAuAAjaAtA. \
    --part-number NOT_SPECIFIED \
    --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 nom du bucket.

  • key : Le nom de l’objet dans le bucket.

  • outfile : Le nom que vous souhaitez donner à l’objet une fois téléchargé sur votre machine. Ce nom peut être un chemin d’accès.

    Tapez directement le nom pour l’objet, sans l’attribut outfile devant.

  • (optionnel) range : Permet de définir et de demander une plage d’octets spécifique d’un objet, ce qui permet de ne télécharger qu’une partie spécifique des données. Pour en savoir plus, voir la documentation RFC 9110 HTTP Range officielle.

  • (optionnel) version-id : L’ID d’une version précédente ou de la version actuelle de l’objet.

    Si l’attribut version-id commence par un tiret ("-"), vous devez le spécifier en suivant cette syntaxe :

    --version-id=-qAfAAsAAuA00kclkg0A0AAuAAjaAtA.

  • (optionnel) part-number : Le numéro de la partie d’un objet dans un dépôt partitionné. Ce nombre doit être un entier compris entre 1 et 1000. Pour en savoir plus, voir Créer un dépôt partitionné.

  • 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 get-object renvoie les éléments suivants :

  • AcceptRanges : Le type d’accept ranges pour l’objet.

  • ContentType : Le type de contenu de l’objet.

  • LastModified : La date et l’heure à laquelle l’objet a été déposé ou copié pour la dernière fois.

  • ContentLength : La taille de l’objet, en octets.

  • ETag : L’ETag de l’objet.

  • ContentRange : Indique la plage d’octets de l’objet défini dans la demande et la taille totale de l’objet.

  • VersionID : L’ID d’une version précédente ou de la version actuelle de l’objet.

  • CacheControl : Le cache control de l’objet.

  • Metadata : Les metadata de l’objet, le cas échéant.

  • ObjectLockMode : Le mode Object Lock de l’objet.

  • ObjectLockRetainUntilDate : La date, au format ISO 8601, à laquelle l’objet ne sera plus verrouillé.

Exemple de résultat
{
    "AcceptRanges": "bytes",
    "ContentType": "binary/octet-stream",
    "LastModified": "Mon, 01 Apr 2017 12:12:40 GMT",
    "ContentLength": 42,
    "ETag": "\"e163009009b626ebac1f9876546f8366\"",
    "ContentRange": "bytes 0-499/1106699",
    "VersionId": "7395H3JvbAV16lq1tBbxUbtaJ7K4PCP",
    "CacheControl": "public,max-age=3600, private",
    "Metadata": {},
    "ObjectLockMode": "COMPLIANCE",
    "ObjectLockRetainUntilDate": "2024-06-14T15:56:39.979000+00:00"
}

Télécharger un objet depuis un bucket avec AWS CLI (s3)

Avant de commencer : Installez et configurez AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.

Pour télécharger un objet depuis un bucket, utilisez la commande cp en suivant cette syntaxe :

$ aws s3 cp s3://YOUR_BUCKET/YOUR_OBJECT PATH/TO/FILE \
    --profile YOUR_PROFILE \
    --debug \
    --dryrun \
    --expected-size 1234 \
    --endpoint https://oos.eu-west-2.outscale.com

Cette commande contient les attributs suivants que vous devez spécifier :

  • s3://YOUR_BUCKET/YOUR_OBJECT : Le nom du bucket et le nom de l’objet qu’il contient.

  • PATH/TO/FILE : Le chemin vers l’endroit où vous souhaitez que l’objet soit téléchargé.

  • (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.

  • (optionnel) debug : Si inclus, renvoie un rapport détaillé de l’opération. Cet attribut est utile pour analyser et résoudre les problèmes que vous pouvez rencontrer.

  • (optionnel) dryrun : Fournit une vue d’ensemble des opérations effectuées par la commande sans pour autant l’exécuter. Vous pouvez l’utiliser comme mesure de sécurité pour examiner l’impact d’une commande avant de l’exécuter.

  • (optionnel) expected-size : Si l’objet est supérieur à 50 Go, spécifie la taille attendue du téléchargement, en octets. Cet attribut est utile si vous souhaitez confirmer l’intégrité ou la taille attendue du fichier téléchargé. Pour en savoir plus, voir Tutoriel : Utiliser un dépôt partitionné avec AWS CLI (s3).

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

Télécharger un objet depuis un bucket avec s3cmd

Vous pouvez gérer vos ressources de stockage objet en utilisant des commandes s3cmd. Pour en savoir plus, voir s3cmd.

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