Chargement d'un objet de stockage d'objets dans un seau
Chargez un objet dans un seau ou un dossier du service de stockage d'objets.
Pour charger des objets dont la taille est supérieure à 64 MiB, la console utilise des chargements en plusieurs parties. Vous devez disposer des autorisations OBJECT_CREATE et OBJECT_OVERWRITE pour effectuer des chargements en plusieurs parties. Pour plus de détails, voir Chargements en plusieurs parties du service de stockage d'objets et Informations détaillées sur les services de stockage d'objets, de stockage d'archives et de transfert de données.
Utilisez l'option de préfixe pour ajouter une valeur de préfixe au nom de tout objet que vous chargez dans le seau. Vous pouvez utiliser le préfixe pour rechercher uniquement dans le seau les objets dont le nom correspond au préfixe. Par exemple, si vous avez inclus le préfixe "test" lors d'un chargement d'objet, tous les noms d'objet inclus sont précédés de cette valeur de préfixe. Un objet nommé "my-object.txt" est chargé dans le seau en tant que "testmy-object.txt".
Pour plus d'informations sur la création de préfixes pour les objets, voir Attribution de nom aux objets à l'aide des préfixes et des hiérarchies.
Voir Recherche d'objets dans un seau pour plus d'informations sur la recherche d'objets dans un seau à l'aide de l'option de préfixe.
Utilisez la commande oci os object put et les paramètres requis pour charger un objet dans un seau :
oci os object put --bucket-name bucket_name --file file_location [OPTIONS]
où
file_location
est le répertoire source de l'objet en cours de chargement, par exemple,C:\workspace\Uploads\MyFile.txt
ou/home/user/Documents/Uploads/MyFile.txt
. Le nom de l'objet chargé n'inclut pas les informations de chemin (par exemple,C:\workspace\Uploads\
), seulement le nom du fichier (MyFile.txt
).Un objet peut être chargé en une seule partie ou en plusieurs parties. Utilisez l'option
--no-multipart
pour le chargement en une seule partie. Pour plus d'informations sur les chargements en plusieurs parties, voir Chargements en plusieurs parties du service de stockage d'objets.Pour plus d'informations sur les attributs que vous pouvez ajouter lors du chargement d'un objet, voir En-têtes de réponse facultatifs et métadonnées.
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. Voir Transmission d'entrée complexe et Utilisation d'un fichier JSON pour une entrée complexe pour plus d'informations sur le formatage JSON.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 chargé
Incluez le paramètre
storage-tier
pour affecter un niveau de stockage à l'objet que vous chargez.oci os object put --bucket-name bucket_name --file file_location --storage-tier [Archive | InfrequentAccess | Standard] [OPTIONS]
Par exemple, si vous effectuez un chargement vers un seau configuré au niveau standard et que vous voulez affecter l'objet au niveau de stockage InfrequentAccess, incluez
--storage-tier InfrequentAccess
dans la commande :
Voir Niveaux de stockage d'objets pour plus d'informations sur le fonctionnement des niveaux de stockage.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 ne spécifiez pas de niveau de stockage dans la commande, l'objet est automatiquement affecté et chargé vers le niveau de stockage par défaut du seau (Standard ou Archive).
Attribution de nom à l'objet chargé
Incluez le paramètre
name
pour nommer l'objet chargé 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 du fichier est utilisé comme nom de l'objet chargé (s'il n'est pas lu à partir de STDIN)Pour la liste complète des paramètres et valeurs des commandes de l'interface de ligne de commande, voir Informations de référence sur les commandes de l'interface.
Exécutez l'opération PutObject pour charger un objet dans un seau.
Le stockage d'objets ajoute un préfixe à la chaîne d'espace de noms du stockage d'objets et du nom du seau pour le nom de l'objet lors de la création d'une URL à utiliser avec l'API :
/n/object_storage_namespace/b/bucket/o/object_name
Le nom d'objet correspond à tout élément après
/o/
, ce qui peut inclure des niveaux de hiérarchie et des chaînes de préfixe.