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.
Pour plus d'informations sur la recherche d'objets dans un seau à l'aide de l'option de préfixe, voir Recherche d'objets dans un seau.
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_locationest le chemin d'accès au répertoire source de l'objet en cours de chargement, par exemple,C:\workspace\Uploads\MyFile.txtou/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-multipartpour 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_pairest une entrée de paire valeur-clé 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==" }Pour la liste complète des paramètres et des valeurs pour les commandes de l'interface de ligne de commande, voir .
Spécification du niveau de stockage de l'objet chargé
Incluez le paramètre
storage-tierpour 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é de niveau standard et que vous voulez affecter l'objet au niveau de stockage InfrequentAccess, incluez
--storage-tier InfrequentAccessdans 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==" }Voir Niveaux de stockage d'objets pour plus d'informations sur le fonctionnement des niveaux de stockage.
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
namepour 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)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_nameLe 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.