Téléchargement 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 d'Object Storage et à Détails relatifs à Object Storage, Archive Storage et Transfert de données.
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 du répertoire source de l'objet en cours de téléchargement vers le serveur, tel queC:\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 du fichier (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 plus d'informations sur les téléchargements multiparts, reportez-vous à Téléchargements multiparts 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 dans un format JSON 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==" }
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 configuré au niveau Standard et que vous voulez affecter l'objet au niveau de stockage InfrequentAccess, incluez
--storage-tier InfrequentAccess
dans la commande :
Pour plus d'informations sur le fonctionnement des niveaux de stockage, reportez-vous à Niveaux Object Storage.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==" }
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)Afin d'obtenir la liste complète des paramètres et des valeurs pour les commandes d'interface de ligne de commande, reportez-vous à Référence de commande d'CLI.
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.