---
title: "Cargar objeto"
url: https://docs.catalyst.zoho.com/es/api/code-reference/cloud-scale/stratus/upload-object/
service: Cloud Scale
type: api
---






# Cargar objeto

### Descripción

Esta API te permite cargar el objeto requerido a un bucket. El bucket se referencia por su nombre único de bucket, y el objeto requerido se referencia usando su nombre.

### Detalles de la solicitud

#### URL de solicitud
<p>{bucket_name}.zohostratus.com/{key}</p>

El nombre de dominio anterior cambiará con respecto al centro de datos:

<table class="content-table">
	<thead>
		<tr>
	        <th class="w20p">DC</th>
            <th class="w40p">Nombre de dominio</th>
		</tr>
	</thead>
	<tbody>
        <tr>
            <td>US</td>
            <td>zohostratus.com</td>
        </tr>
        <tr>
            <td>EU</td>
            <td>zohostratus.eu</td>
        </tr>
         <tr>
            <td>IN</td>
            <td>zohostratus.in</td>
        </tr>
        <tr>
            <td>AU</td>
            <td>zohostratus.com.au</td>
        </tr>
        <tr>
            <td>CA</td>
            <td>zohostratus.ca</td>
        </tr>
        <tr>
            <td>SA</td>
            <td>zohostratus.sa</td>
        </tr>
        <tr>
            <td>JP</td>
            <td>zohostratus.jp</td>
        </tr>
	</tbody>
</table>

Nota: Si la API se usa en el entorno de desarrollo, entonces el dominio se estructurará de esta manera: https://<bucket_name>-development.zohostratus.com


#### Parámetros de ruta

El ID único del proyecto

El nombre del bucket

El nombre del objeto que necesita ser cargado

Nota: Los siguientes puntos deben tenerse en cuenta al proporcionar el valor para key:

* La longitud máxima de la clave (incluyendo el nombre de la ruta y el nombre del objeto) debe ser de solo 255 caracteres.

* La clave no puede contener los siguientes caracteres incluyendo el espacio: comillas dobles, ambos corchetes angulares, hashtag, barra invertida y símbolo de barra vertical.

#### Parámetros de consulta

Este es un ID generado por Stratus cuando el versionado está habilitado. Puedes usar version_id para referenciar al objeto requerido.

#### Encabezados de solicitud
 **Authorization:** Zoho-oauthtoken {oauth_token} <br>


**Encabezados opcionales** <br>
 **content-type:** application/json

 **content-length:** Longitud sin procesar del objeto que se está cargando en bytes.

 **compress:** Si se debe comprimir el objeto al almacenarlo. Por defecto, la compresión siempre se realiza.

 **cache-control:** Usa este encabezado para especificar las políticas de caché del navegador.

 **overwrite:** Especifica si necesitas sobrescribir un recurso. Esto solo es soportado para los objetos de buckets sin versionado.

 **expires-after:** Esta es una opción que puedes usar para establecer el Time-to-Live (TTL) en segundos para un objeto. El valor debe ser mayor o igual a 60 segundos.

 **x-user-meta:{1stKey}={1stValue};{2ndKey}={2ndValue};..{NthKey}={NthValue};:** Metadatos para el objeto. Cada par clave-valor se separa por punto y coma como se muestra en la columna anterior. **2047 caracteres** es la longitud máxima permitida para este encabezado. 


#### Alcance

Stratus.fileop.CREATE


### Detalles de la respuesta

Tras la ejecución exitosa, la respuesta contendrá el mensaje de éxito y el objeto será cargado.

#### Posibles respuestas de error

**404** debido a que no se encontró el objeto/bucket:


    {
    "status": 404,
    "code": "bucket_not_found",
    "message": "no such bucket exists"
    }



**403** No autorizado. Cuando no tienes los permisos requeridos para realizar la operación de carga


    {
    "status": 403,
    "code": "access_forbidden",
    "message": "request denied by resource access policy"
    }


**400** Solicitud incorrecta. Nombre de archivo inválido


    {
    "status": 400,
    "code": "key_name_invalid",
    "message": "key name does not support one or more character(s)"
    }


**409** Conflicto. Ya existe un objeto con el mismo nombre


    {
    "status": 409,
    "code": "key_already_exists",
    "message": "key is already associated with another object in the bucket"
    }







curl -X PUT https://{bucket_name}.zohostratus.com/{key}
-H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57"



200 OK


   

* Upload Object - Java SDK
* Upload Object - Node.js SDK
* UploadObject - Python SDK
* Upload - Web SDK
* Upload - iOS SDK
* Upload - Android SDK
* Upload - Flutter SDK