Documentación de Oracle Cloud Infrastructure

Carga de un objeto de Object Storage en un cubo

Cargue un objeto en un cubo o carpeta en Object Storage.

Para cargar objetos de más de 64 MiB, la consola utiliza cargas de varias partes. Necesita los permisos OBJECT_CREATE y OBJECT_OVERWRITE para realizar cargas de varias partes. Para obtener más información, consulte Cargas de varias partes de Object Storage y Detalles de Object Storage, Archive Storage y Data Transfer.

Utilice la opción de prefijo para anteponer un valor de prefijo a cualquier nombre de objeto que cargue en el cubo. Puede utilizar el prefijo para buscar en el cubo solo aquellos objetos cuyos nombres coincidan con el prefijo. Por ejemplo, si ha incluido el prefijo "test" durante la carga de un objeto, todos los nombres de objetos incluidos se anteponen a ese valor de prefijo. Se carga un objeto denominado "my-object.txt" en el cubo como "testmy-object.txt".

Consulte Nomenclatura de objetos mediante prefijos y jerarquías para obtener más información sobre la creación de prefijos para objetos.

Consulte Búsqueda de objetos en un cubo para obtener más información sobre cómo buscar objetos en un cubo mediante la opción de prefijo.

    1. En la página de lista Cubos, seleccione el cubo de Object Storage con el que desea trabajar. Si necesita ayuda para buscar la página de lista o el cubo de Object Storage, consulte Enumeración de cubos.
    2. En la página de detalles, seleccione Objetos.
    3. Seleccione Cargar. Para cargar objetos en una carpeta o subcarpeta de la lista Objetos, abra esa carpeta y seleccione Cargar.
    4. Introduzca la siguiente información:

      • Prefijo de nombre de objeto: (opcional) si se proporciona, este prefijo se antepone a cada uno de los archivos que cargue.

        • Las cadenas de prefijo tienen un delimitador de barra ("/") para simular la jerarquía y crear carpetas o subcarpetas.

        • Cadenas de prefijo sin un delimitador con fines de coincidencia para realizar operaciones en bloque permitidas.

        Para obtener más información, consulte Nomenclatura de objetos mediante prefijos y jerarquías.

      • Nivel de almacenamiento: especifique el tipo de nivel de almacenamiento al que pertenece el objeto que se está cargando:

        • Nivel estándar

        • Acceso poco frecuente

        • Archivo

        Consulte Niveles de almacenamiento de objetos para obtener descripciones de los tipos de nivel de almacenamiento.

        Nota

        Los cubos de nivel de almacenamiento estándar pueden contener una combinación de objetos con diferentes asignaciones de nivel de almacenamiento. Un objeto permanece en el cubo estándar, incluso si el objeto se archiva, se restaura o si se cambia la asignación de nivel.

    5. Seleccione los objetos que desea cargar en el cuadro Seleccionar archivos de la computadora mediante uno de los siguientes métodos:

      • Arrastre uno o más archivos desde el equipo hasta el cuadro.

      • Seleccione el enlace select files (Seleccionar archivos) para mostrar un cuadro de diálogo de selección de archivos donde puede navegar hasta los archivos que desea cargar.

      Los archivos que seleccione para cargar se muestran en una lista. Para eliminar un archivo seleccionado de la carga, seleccione la X junto al nombre del archivo.

      Si los archivos que seleccione para cargar ya están almacenados en el cubo o la carpeta con el mismo nombre, la consola muestra mensajes que le advierten de una sobreescritura.

    6. (Opcional) Seleccione Mostrar metadatos y cabeceras de respuesta opcionales para especificar valores para los metadatos y cabeceras de respuesta opcionales que se mostrarán en el cuadro de diálogo Detalles de objeto.

      1. Seleccione el tipo de atributo que va a agregar:

        • Para agregar una cabecera de respuesta, seleccione un valor en la lista Nombre y, a continuación, introduzca un valor en el cuadro Valor.

        • Para agregar metadatos, introduzca un valor en el cuadro Nombre y, a continuación, introduzca un valor en el cuadro Valor.

      2. Para agregar otro atributo, seleccione + Agregar más cabeceras o metadatos. Para suprimir un atributo, seleccione la X junto al atributo.

    7. Seleccione Cargar. Los objetos seleccionados se cargan y se muestran en la lista de objetos del cubo o la carpeta.

  • Utilice el comando oci os object put y los parámetros necesarios para cargar un objeto en un cubo:

    oci os object put --bucket-name bucket_name --file file_location [OPTIONS]

    donde file_location es la ruta de acceso del directorio de origen del objeto que se está cargando, como C:\workspace\Uploads\MyFile.txt o /home/user/Documents/Uploads/MyFile.txt. El nombre del objeto cargado no incluye la información de ruta de acceso (por ejemplo, C:\workspace\Uploads\), solo el nombre de archivo real (MyFile.txt).

    Un objeto se puede cargar como una sola parte o como varias partes. Utilice la opción --no-multipart para cargarlo como una sola parte. Para obtener más información sobre las cargas de varias partes, consulte Cargas de varias partes de Object Storage.

    Para obtener más información sobre los atributos que puede agregar al cargar un objeto, consulte Cabeceras de respuesta y metadatos opcionales.

    Para agregar pares de clave-valor de metadatos personalizados, utilice la opción --metadata:

    oci os object put --bucket-name bucket_name --file file_location --name object_name  --metadata json_formatted_key-value_pairs
    donde JSON-formatted_key-value_pair es una entrada de par de valor de clave como formato JSON válido. Consulte Transferencia de entrada compleja y Uso de un archivo JSON para entrada compleja para obtener más información sobre el formato JSON.

    Por ejemplo:

    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=="
}

    Especificación del nivel de almacenamiento del objeto cargado

    Incluya el parámetro storage-tier para asignar un nivel de almacenamiento al objeto que está cargando.

    oci os object put --bucket-name bucket_name --file file_location --storage-tier [Archive | InfrequentAccess | Standard] [OPTIONS]

    Por ejemplo, si va a cargar en un cubo configurado en el nivel estándar y desea asignar el objeto al nivel de almacenamiento InfrequentAccess, incluya --storage-tier InfrequentAccess en el comando:

    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=="
}
    Consulte Niveles de almacenamiento de objetos para obtener más información sobre cómo funcionan los niveles de almacenamiento.

    Si no especifica un nivel de almacenamiento en el comando, el objeto se asigna y carga automáticamente en el nivel de almacenamiento por defecto del cubo (Standard o Archive).

    Asignación de un nombre al objeto cargado

    Incluya el parámetro name para asignar un nombre al objeto cargado, excluida su ruta. Este parámetro es necesario si el objeto se lee desde STDIN. Por ejemplo:

    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 no incluye el parámetro name, el nombre de archivo se utiliza como nombre del objeto cargado (si no se lee desde STDIN)

    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 PutObject para cargar 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.