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

PUT

{bucket_name}.zohostratus.com/{key}

copy

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

DC	Nombre de dominio
US	zohostratus.com
EU	zohostratus.eu
IN	zohostratus.in
AU	zohostratus.com.au
CA	zohostratus.ca
SA	zohostratus.sa
JP	zohostratus.jp

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

project_id

Numerical

El ID único del proyecto

bucket_name

String

El nombre del bucket

key

String

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

version_id String

optional

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}

Encabezados opcionales

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:

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

View more

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

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

View more

400 Solicitud incorrecta. Nombre de archivo inválido

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

View more

409 Conflicto. Ya existe un objeto con el mismo nombre

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

View more

Sample Request
copy

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

Sample Response
copy

200 OK

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit