Documentación de Oracle Cloud Infrastructure

Copia de un objeto en otro cubo de Object Storage

Copie un objeto en otro cubo de Object Storage.

Atención

La copia de objetos no funciona si no autoriza el servicio Object Storage para copiar objetos en su nombre. Consulte Permisos del servicio para obtener más información.

Reglas de sobrescritura de copia de objetos

Utilice las reglas de sobrescritura para controlar la copia de objetos según sus valores de etiqueta de entidad (ETag).

  • Suscribir objeto de destino: utilice esta opción si no desea limitar una operación de copia mediante un valor ETag. Esta opción es la opción predeterminada. Esta opción se puede utilizar en cualquier operación de copia, independientemente de si implica sobrescribir un objeto existente.

  • No sobrescribir ningún objeto de destino: utilice esta opción para evitar la sobrescritura de una copia existente de un objeto en la ubicación de destino, independientemente del valor de ETag del objeto de destino.

  • Sobrescribir el objeto de destino solo si coincide con el valor ETag especificado: utilice esta opción para evitar la sustitución accidental de un objeto en la ubicación de destino que no tenga el valor ETag especificado. Al utilizar esta opción, la operación de copia solo se realiza correctamente si el ETag que proporcione al iniciar la solicitud de copia coincide con el ETag del objeto de destino.

  • Copiar el objeto solo si el origen coincide con el ETag especificado: utilice esta opción si desea que la operación de copia se realice correctamente solo si el ETag que ha proporcionado al iniciar la solicitud de copia coincide con el ETag del objeto de origen. Para los objetos que se actualizan y sobrescriben de manera intencionada como parte de la actividad de gestión de datos, esta opción garantiza que solo se pueda copiar la versión especificada del objeto (según lo indicado por el ETag). Si el valor ETag del objeto cambia después de crear la solicitud de trabajo de copia, pero antes de que se ejecute la operación de copia, la operación de copia no se completa.

Atención

Si sobrescribe un objeto, la operación no se puede deshacer.

Ámbito y restricciones

  • Los objetos no se pueden copiar directamente desde Archive Storage. Para copiar objetos que están en el almacenamiento de archivos, primero debe restaurar el objeto en el nivel de almacenamiento de objetos estándar. Los objetos se pueden copiar directamente en cubos del nivel Archivo desde los niveles de Estándar o Acceso poco frecuente. Al copiar objetos en un cubo de Archive Storage, la copia del objeto se archiva inmediatamente.

  • Especifique un cubo de destino existente para la solicitud de copia. La operación de copia no crea automáticamente cubos.

  • Al copiar un objeto, el objeto de destino recibe un nuevo valor de ETag.

  • Si cambia el nombre, sobrescribe o elimina un objeto de origen durante una operación de copia, la operación de copia falla y el objeto de destino no se crea ni se sobrescribe.

  • No se admite la copia masiva. Identifique un único objeto en la solicitud de copia.

Permisos de servicio

Dado que Object Storage es un servicio regional, debe autorizar el servicio Object Storage para cada región que lleve a cabo operaciones de copia en su nombre. Por ejemplo, puede autorizar el servicio Object Storage de la región Este de EE. UU. (Ashburn) para que gestione objetos en su nombre. Después de autorizar el servicio Object Storage, puede copiar un objeto almacenado en un cubo de Este de EE. UU. (Ashburn) en un cubo de otra región.

Para determinar el valor del identificador de región de una región de Oracle Cloud Infrastructure, consulte Regiones y dominios de disponibilidad.

Para administradores:

Para activar la copia de objetos, debe autorizar al servicio para que gestione objetos en su nombre:

  • Puede crear una política que autorice el servicio en la región especificada para gestionar espacios de nombres de Object Storage, cubos y sus objetos asociados en todos los compartimentos del arrendamiento:

    Allow service objectstorage-<region_identifier> to manage object-family in tenancy

  • En lugar de utilizar el verbo de política manage, puede crear una política que reduce el ámbito de acceso mediante una de las siguientes sentencias:

    Allow service objectstorage-<region_identifier> to manage object-family in tenancy where any {request.permission='OBJECT_READ', request.permission='OBJECT_INSPECT', request.permission='OBJECT_CREATE', request.permission='OBJECT_OVERWRITE', request.permission='OBJECT_DELETE'}
    Allow service objectstorage-<region_identifier> to manage object-family in compartment <compartment_name> where any {request.permission='OBJECT_READ', request.permission='OBJECT_INSPECT', request.permission='OBJECT_CREATE', request.permission='OBJECT_OVERWRITE', request.permission='OBJECT_DELETE'}

Cómo copiar un objeto

    1. Abra el menú de navegación y haga clic en Almacenamiento. En Almacenamiento de objetos y de archivo, haga clic en Cubos.
    2. Seleccione el compartimento en la lista en Ámbito de lista. Todos los cubos de ese compartimento se muestran en formato tabular.
    3. Haga clic en el cubo que contiene el objeto que desea copiar. Aparece la página Detalles del cubo.
    4. Haga clic en Objetos en Recursos. Aparece la lista Objetos. Todos los objetos del cubo se muestran en formato tabular.
    5. Haga clic en el menú Acciones (Menú Acciones) situado junto al objeto que desea copiar (el objeto de origen) y seleccione Copiar. Aparece el recuadro de diálogo Copiar Objeto.

      La consola comprueba las políticas de IAM que están en vigor para realizar esta tarea correctamente. Si observa que falta una advertencia en una política, puede dejar que la consola intente crear las políticas que faltan o copiar los detalles de política que faltan en el portapapeles para enviar un correo electrónico al administrador. Si cree que tiene las políticas necesarias, continúe y pruebe a realizar la operación de copia.

    6. Complete los siguientes pasos:

      • Espacio de nombres de destino: introduzca el espacio de nombres del cubo de destino para el objeto copiado. La cadena de espacio de nombres de su arrendamiento se proporciona como valor por defecto. Consulte Descripción de los Espacios de Nombres para obtener más información.

      • Región de destino: seleccione de la lista la región de OCI que contiene el cubo de destino para el objeto copiado. El arrendamiento se debe suscribir a una región para que pueda copiar un objeto en un cubo de dicha región.

      • Cubo de destino: introduzca el nombre del cubo de destino del objeto copiado. El destino debe ser un cubo existente al que tenga acceso. Consulte Cubos para obtener más información sobre cómo crear un cubo.

      • Nombre de objeto de destino: (opcional) introduzca un nombre alternativo para el objeto que se está copiando si no desea utilizar su nombre original. Por defecto, el nombre es el mismo que el objeto que está copiando.

      • Capa de almacenamiento de destino: (Opcional) especifique el nivel de almacenamiento en el que desea cargar el objeto si desea que sea diferente del nivel de almacenamiento de origen. Están soportados los siguientes niveles de almacenamiento:

        Si no especifica un nivel de almacenamiento de destino, el objeto se almacena en el mismo nivel de almacenamiento que el bloque. Consulte Niveles de almacenamiento de objetos para obtener más información.

      • Regla de sustitución: seleccione la regla de sustitución adecuada para la solicitud de copia:

        • Sobrescribir objeto de destino

        • No sobrescribir ningún objeto de destino

        • Sobrescribir el objeto de destino solo si coincide con el ETag especificado

        • Copiar el objeto solo si el origen coincide con el ETag especificado

        Consulte Reglas de sobrescritura de copia de objetos para obtener descripciones de cada una de estas reglas.

    7. Haga clic en Copiar objeto.

    Aparece el cuadro de diálogo Detalles de solicitud de trabajo, que confirma que la solicitud de copia se ha enviado correctamente y realiza un seguimiento del estado de la solicitud.

  • Utilice el comando oci os object copy y los parámetros necesarios para copiar un objeto en otro cubo:

    oci os object copy --bucket-name source_bucket_name --source-object-name source_object_name --destination-bucket destination_bucket_name [OPTIONS]

    Por ejemplo:

    oci os object copy --bucket-name photos --source-object-name hummingbird.jpg --destination-namespace ansh8lvru1zp --destination-bucket UK_photos
    Copia de un objeto en una región diferente

    Incluya el parámetro destination-region y el identificador de región para especificar un cubo de destino en la región de allí que el que reside el objeto de destino.

    Por ejemplo:

    oci os object copy --bucket-name photos --source-object-name hummingbird.jpg --destination-bucket UK_photos --destination-region uk-london-1
    El arrendamiento se debe suscribir a una región para que pueda copiar un objeto en un cubo de dicha región.
    Copia en un nivel de almacenamiento de destino diferente

    Incluya el parámetro destination-object-storage-tier y un valor de nivel de almacenamiento soportado para copiar el objeto en un nivel de almacenamiento diferente en el cubo de destino que el nivel en el que reside en el origen.

    Por ejemplo:

    oci os object copy --bucket-name photos --source-object-name hummingbird.jpg --destination-bucket UK_photos --destination-object-storage-tier Archive

    Los valores soportados son:

    • Standard (por defecto)

    • InfrequentAccess

    • Archive

    • Si no especifica un nivel de almacenamiento de destino, el objeto se almacena en el mismo nivel de almacenamiento que el bloque. Consulte Niveles de almacenamiento de objetos para obtener más información.

    Especificación del espacio de nombres del objeto copiado

    Incluya el parámetro destination-namespace y su valor para especificar el espacio de nombres de destino en el que se copia el objeto.

    Por ejemplo:

    oci os object copy --bucket-name photos --source-object-name hummingbird.jpg --destination-bucket UK_photos --destination-namespace MyNamespace
    Consulte Descripción de los Espacios de Nombres para obtener más información.
    Especificación de un nombre alternativo para el objeto copiado

    Incluya el parámetro destination-object-name y su valor para aplicar un nombre alternativo al objeto copiado.

    Por ejemplo:

    oci os object copy --bucket-name photos --source-object-name hummingbird.jpg --destination-bucket UK_photos --destination-object-name hummingbird_brochure.jpg

    Por defecto, el nombre es el mismo que el objeto que está copiando.

    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 CopyObject para copiar un objeto en otro cubo.