Cambio de nombre de un objeto de Object Storage
Cambiar el nombre de un objeto en un cubo de Object Storage.
Para obtener información sobre la nomenclatura de objetos, consulte Nombres de objetos.
Utilice el comando oci os object rename y los parámetros necesarios para cambiar el nombre de un objeto en un cubo:
oci os object rename --bucket-name bucket_name --name object_original_name --new-name object_new_name [OPTIONS]
Por ejemplo:
oci os object rename --bucket-name MyBucket --name MyFile.txt --new-name MyRenamedFile.txt { "etag": "3504606b-8412-4b5d-924a-aeaeacf1df1e" }
Cambio de nombre de un objeto con una etiqueta de entidad específica
Para que la operación de cambio de nombre dependa del objeto que tiene una etiqueta de entidad específica, utilice la opción
--src-obj-if-match-e-tag
.Por ejemplo:
oci os object rename --bucket-name MyBucket --name MyFile.txt --new-name MyRenamedFile.txt --src-obj-if-match-e-tag 6672BECB67CCFFBCE0530292F20ZBACE
Sobrescritura de un objeto
Para las operaciones de cambio de nombre en las que desea sobrescribir un objeto de un cubo por otro, puede realizar el cambio de nombre en función de si tiene una etiqueta de entidad específica. Para ello, utilice la opción
--new-obj-if-match-e-tag
.Por ejemplo:
oci os object rename --bucket-name MyBucket --name MyFile.txt --new-name MyRenamedFile.txt --new-obj-if-match-e-tag 6672BECB67CCFFBCE0530292F20ZBACE
Prevención de la sobrescritura de un objeto
Al cambiar el nombre de un objeto, puede evitar que el sistema sobrescriba otro objeto en el mismo cubo con la opción
--new-obj-if-none-match-e-tag *
. Esta opción impide que se complete la operación de cambio de nombre si existe un objeto con el valor--new-name
especificado y la misma etiqueta de entidad del objeto de origen.Por ejemplo:
oci os object rename --bucket-name MyBucket --name MyFile.txt --new-name MyRenamedFile.txt --new-obj-if-none-match-e-tag *
Para obtener una lista completa de parámetros y valores para los comandos de la CLI, consulte la Referencia de comandos de CLI.
Ejecute la operación RenameObject para cambiar el nombre de un objeto en un cubo.
Object Storage antepone la cadena de espacio de nombres de Object Storage y el nombre del cubo al nombre del objeto a la hora de crear una URL para su uso con la API:
/n/object_storage_namespace/b/bucket/o/object_name
El nombre del objeto es todo lo que aparece después de
/o/
, que puede incluir niveles de jerarquía y cadenas de prefijo.