Modification du nom d'un objet Object Storage
Renommez un objet dans un bucket Object Storage.
Pour plus d'informations sur la dénomination des objets, reportez-vous à Noms d'objet.
Utilisez la commande oci os object rename et les paramètres requis pour renommer un objet dans un bucket :
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 avec une balise d'entité spécifique
Afin que l'opération de changement de nom dépende de la présence d'une balise d'entité spécifique pour l'objet, 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
Ecrasement d'un objet
Pour les opérations de changement de nom dans lesquelles vous souhaitez écraser un objet d'un bucket par un autre objet, 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 l'écrasement d'un objet
Lors du changement de nom d'un objet, vous pouvez empêcher le système d'écraser un autre objet du même bucket en utilisant l'option
--new-obj-if-none-match-e-tag *
. Cette option empêche l'opération de changement de nom si un objet existe avec la valeur--new-name
indiqué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 *
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 RenameObject pour renommer un objet dans 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.