Modification du nom d'un objet de stockage d'objets
Renommez un objet dans un seau de stockage d'objets.
Pour plus d'informations sur l'attribution de nom aux objets, voir Nom des objets.
Utilisez la commande oci os object rename et les paramètres requis pour renommer un objet dans un seau :
oci os object rename --bucket-name bucket_name --name object_original_name --new-name object_new_name [OPTIONS]
Par exemple :
oci os object rename --bucket-name MyBucket --name MyFile.txt --new-name MyRenamedFile.txt { "etag": "3504606b-8412-4b5d-924a-aeaeacf1df1e" }
Renommer un objet ayant une balise d'entité spécifique
Pour rendre l'opération de changement de nom dépendante de l'objet comportant une balise d'entité spécifique, utilisez l'option
--src-obj-if-match-e-tag
.Par exemple :
oci os object rename --bucket-name MyBucket --name MyFile.txt --new-name MyRenamedFile.txt --src-obj-if-match-e-tag 6672BECB67CCFFBCE0530292F20ZBACE
Remplacement d'un objet
Pour les opérations de changement de nom où vous prévoyez de remplacer un objet d'un seau par un autre, vous pouvez rendre le changement de nom dépendant d'une balise d'entité spécifique. Pour ce faire, utilisez l'option
--new-obj-if-match-e-tag
.Par exemple :
oci os object rename --bucket-name MyBucket --name MyFile.txt --new-name MyRenamedFile.txt --new-obj-if-match-e-tag 6672BECB67CCFFBCE0530292F20ZBACE
Empêcher le remplacement d'un objet
Lorsque vous renommez un objet, vous pouvez empêcher le système de remplacer un autre objet dans le même seau à l'aide de l'option
--new-obj-if-none-match-e-tag *
. Cette option empêche l'exécution de l'opération de changement de nom si un objet existe avec la valeur--new-name
spécifiée et la même balise d'entité que l'objet source.Par exemple :
oci os object rename --bucket-name MyBucket --name MyFile.txt --new-name MyRenamedFile.txt --new-obj-if-none-match-e-tag *
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 RenameObject pour renommer 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.