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 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".

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

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

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, consulte Lista de cubos.
2. En la página de detalles del cubo, seleccione Objetos.
  Se abre el separador Objetos. Todos los objetos del cubo seleccionado se muestran en una tabla.
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 Object Storage 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 su equipo 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 Cabeceras de respuesta y metadatos opcionales para especificar los valores de las cabeceras de respuesta y metadatos opcionales que se mostrarán en el cuadro de diálogo Detalles de objeto.
  
  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.
  
  Para agregar otro atributo, seleccione Agregar más cabeceras o metadatos. Para suprimir un atributos, seleccione la X que se encuentra 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 la ruta (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 información detallada sobre las cargas de varias partes, consulte Cargas de varias partes del almacenamiento de objetos.

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 del par de clave-valor 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=="
}
```
Para obtener una lista completa de parámetros y valores para los comandos de la CLI, consulte la Referencia de comandos de la CLI.
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 está cargando 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 Object Storage 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)
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.

Documentación de Oracle Cloud Infrastructure

Carga de un objeto de Object Storage en un cubo

Especificación del nivel de almacenamiento del objeto cargado

Asignación de un nombre al objeto cargado