Documentation Oracle Cloud Infrastructure

Téléchargement vers le serveur d'un objet Object Storage vers un bucket

Téléchargez un objet vers un bucket ou un dossier dans Object Storage.

Pour télécharger des objets de plus de 64 MiB, la console utilise des téléchargements multipart. Vous devez disposer des droits d'accès OBJECT_CREATE et OBJECT_OVERWRITE pour effectuer des téléchargements multipart. Pour plus de détails, reportez-vous à Téléchargements multipart vers le serveur Object Storage et à Détails relatifs à Object Storage, à Archive Storage et à Data Transfer.

Utilisez l'option de préfixe pour ajouter une valeur de préfixe au nom de tout objet téléchargé vers le bucket. Vous pouvez utiliser le préfixe pour rechercher dans le bucket uniquement les objets dont le nom correspond au préfixe. Par exemple, si vous avez inclus le préfixe "test" lors du téléchargement d'un objet, tous les noms d'objet inclus sont ajoutés au début avec cette valeur de préfixe. Un objet nommé "my-object.txt" est téléchargé vers le bucket en tant que "testmy-object.txt".

Pour plus d'informations sur la création de préfixes pour les objets, reportez-vous à Dénomination des objets à l'aide de préfixes et de hiérarchies.

Pour plus d'informations sur la recherche d'objets dans un bucket à l'aide de l'option de préfixe, par exemple, Recherche d'objets dans un bucket.

    1. Sur la page de liste Buckets, sélectionnez le bucket Object Storage à utiliser. Si vous avez besoin d'aide pour trouver la page de liste ou le bucket, reportez-vous à Liste des buckets.
    2. Sur la page de détails du bucket, sélectionnez Objets.
      L'onglet Objets s'ouvre. Tous les objets du bucket sélectionné sont affichés dans une table.
    3. Sélectionnez Télécharger vers le serveur. Pour télécharger des objets vers un dossier ou un sous-dossier dans la liste Objets, ouvrez ce dossier et sélectionnez Télécharger vers le serveur.
    4. Saisissez les informations suivantes:
      • Préfixe de nom d'objet : (facultatif) si celui-ci est fourni, il est ajouté au début de chaque fichier téléchargé.
        • Chaînes de préfixe avec délimiteur de barre oblique ("/") pour simuler la hiérarchie et créer des dossiers ou sous-dossiers.
        • Chaînes de préfixe sans délimiteur à des fins de mise en correspondance pour effectuer des opérations en masse autorisées.

        Pour plus d'informations, reportez-vous à Dénomination des objets à l'aide de préfixe et de hiérarchie.

      • Niveau de stockage : indiquez le type de niveau de stockage auquel l'objet en cours de téléchargement appartient :
        • Niveau standard
        • Accès rare
        • Archiver

        Pour obtenir une description des types de niveau de stockage, reportez-vous à Niveaux Object Storage.

        Remarque

        Les buckets dotés du niveau de stockage Standard peuvent contenir des objets avec différentes affectations de niveau de stockage. Un objet reste dans le bucket Standard même s'il est archivé ou restauré, ou si l'affectation de niveau est modifiée.
    5. Sélectionnez les objets à télécharger dans la zone Choisir des fichiers sur votre ordinateur à l'aide de l'une des méthodes suivantes :
      • Faites glisser des fichiers à partir de votre ordinateur vers la zone.
      • Cliquez sur le lien Sélectionner des fichiers pour afficher une boîte de dialogue de sélection de fichier dans laquelle vous pouvez accéder aux fichiers à télécharger.

      Les fichiers sélectionnés pour le téléchargement sont affichés sous forme de liste. Pour enlever un fichier sélectionné du téléchargement, sélectionnez X en regard du nom du fichier.

      Si les fichiers sélectionnés pour le téléchargement vers le serveur sont déjà stockés dans le bucket ou le dossier sous le même nom, la console affiche un message vous avertissant de l'écrasement des données.

    6. (Facultatif) Sélectionnez Métadonnées et en-têtes de réponse facultatifs pour indiquer les valeurs des métadonnées et des en-têtes de réponse facultatifs à afficher dans la boîte de dialogue Détails de l'objet.
      1. Sélectionnez le type d'attribut que vous êtes en train d'ajouter :
        • Pour ajouter un en-tête de réponse, sélectionnez une valeur dans la liste Nom, puis entrez une valeur dans la zone Valeur.
        • Pour ajouter des métadonnées, saisissez une valeur dans la zone Nom, puis une valeur dans la zone Valeur.
      2. Pour ajouter un autre attribut, sélectionnez Ajouter d'autres en-têtes ou métadonnées. Pour supprimer un Attribut, sélectionnez la croix (X) en regard de celui-ci.
    7. Sélectionnez Télécharger vers le serveur. Les objets sélectionnés sont téléchargés vers le serveur et affichés dans la liste des objets du bucket ou du dossier.

  • Utilisez la commande oci os object put et les paramètres requis pour télécharger un objet vers un bucket :

    oci os object put --bucket-name bucket_name --file file_location [OPTIONS]

    où file_location est le chemin d'accès au répertoire source de l'objet en cours de téléchargement, tel que C:\workspace\Uploads\MyFile.txt ou /home/user/Documents/Uploads/MyFile.txt. Le nom de l'objet téléchargé n'inclut pas le chemin d'accès (par exemple, C:\workspace\Uploads\), mais uniquement le nom de fichier réel (MyFile.txt).

    Un objet peut être téléchargé en une seule partie ou en plusieurs parties. Utilisez l'option --no-multipart pour effectuer le téléchargement en une seule partie. Pour obtenir des informations détaillées sur les téléchargements multipart vers le serveur, reportez-vous à Téléchargements multipart vers Object Storage.

    Pour plus d'informations sur les attributs que vous pouvez ajouter lorsque vous téléchargez un objet vers le serveur, reportez-vous à Métadonnées et en-têtes de réponse facultatifs.

    Pour ajouter des paires clé-valeur de métadonnées personnalisées, utilisez l'option --metadata :

    oci os object put --bucket-name bucket_name --file file_location --name object_name  --metadata json_formatted_key-value_pairs
    où JSON-formatted_key-value_pair est une entrée de paire clé-valeur en tant que JSON formaté valide. Pour plus d'informations sur le formatage JSON, reportez-vous à Transmission d'une entrée complexe et Utilisation d'un fichier JSON pour une entrée complexe.

    Par exemple :

    oci os object put --bucket-name MyBucket --file C:\workspace\MyFile.txt --metadata '{"Department": "Finance"}'
{
  "etag": "3504606b-8412-4b5d-924a-aeaeacf1df1e",
  "last-modified": "Wed, 20 Nov 2019 04:37:29 GMT",
  "opc-content-md5": "1B2M2Y8AsgTpgAmY7PhCfg=="
}

    Pour obtenir la liste complète des paramètres et des valeurs des commandes de la CLI, reportez-vous à Référence des commandes de la CLI.

    Spécification du niveau de stockage de l'objet téléchargé

    Incluez le paramètre storage-tier pour affecter un niveau de stockage à l'objet que vous téléchargez.

    oci os object put --bucket-name bucket_name --file file_location --storage-tier [Archive | InfrequentAccess | Standard] [OPTIONS]

    Par exemple, si vous effectuez un téléchargement vers un bucket standard configuré par niveau et que vous voulez affecter l'objet au niveau de stockage InfrequentAccess, incluez --storage-tier InfrequentAccess dans la commande :

    oci os object put --bucket-name MyStandardBucket --file C:\workspace\Uploads\MyDocument.txt --storage-tier InfrequentAccess
{
	"etag": "6b292c1a-b01b-4f36-97c8-4567fb43d071",
	"last-modified": "Sat, 12 Dec 2020 12:58:01 GMT",
	"opc-content-md5": "9P61OSaYe4fXxaeK8siuDw=="
}

    Pour plus d'informations sur le fonctionnement des niveaux de stockage, reportez-vous à Niveaux Object Storage.

    Si vous n'indiquez pas de niveau de stockage dans la commande, l'objet est automatiquement affecté au niveau de stockage par défaut du bucket (Standard ou Archive) et téléchargé vers ce dernier.

    Nommer l'objet téléchargé

    Incluez le paramètre name pour nommer l'objet téléchargé vers le serveur, sans son chemin. Ce paramètre est requis si l'objet est lu à partir de STDIN. Par exemple :

    oci os object put --bucket-name MyBucket --file C:\workspace\Uploads\MyFile.txt --name AboutMyCompany
{
	"etag": "cadb9f8a-3292-45e6-a1e8-f075699fb619",
	"last-modified": "Fri, 11 Dec 2020 14:04:19 GMT",
	"opc-content-md5": "9P61OSaYe4fXxaeK8siuDw=="
}

    Si vous n'incluez pas le paramètre name, le nom de fichier est utilisé comme nom de l'objet téléchargé (s'il n'est pas lu à partir de STDIN)

  • Exécutez l'opération PutObject pour télécharger un objet vers un bucket.

    Object Storage ajoute la chaîne d'espace de noms Object Storage et le nom du bucket au début du nom d'objet lors de la construction d'une URL à utiliser avec l'API:

    /n/object_storage_namespace/b/bucket/o/object_name

    Le nom d'objet correspond à tout ce qui suit /o/, ce qui peut inclure des niveaux hiérarchiques et des chaînes de préfixe.