Descargar objeto

Descripción

Esta API te permite descargar el objeto requerido almacenado en 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

GET

{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
Es aconsejable obtener la URL del bucket desde la consola.

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 descargado

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

Range: Para descargar un rango de bytes específico de un objeto

retrieve-meta: Para recuperar los metadatos del objeto | Valores posibles: True/False | Valor predeterminado: False

Alcance

Stratus.fileop.READ

Parámetros de consulta para sobrescribir respuestas

Los siguientes parámetros de consulta se pueden agregar para modificar las respuestas y obtener la respuesta requerida. Todos estos son parámetros opcionales. La sobrescritura solo funcionará si la solicitud es exitosa.

responseContentType String

optional

Establece el encabezado Content-Type de la respuesta. Solo se pueden usar tipos de contenido estándar definidos por IANA.

responseContentLanguage String

optional

Establece el encabezado Content-Language de la respuesta

responseContentDisposition String

optional

Establece el encabezado Content-Disposition de la respuesta. El valor del parámetro debe estar en este formato:
attachment; filename=“name”
Ejemplo: attachment; filename=“logo.svg”

responseCacheControl String

optional

Establece el encabezado Cache-Control de la respuesta.
Ejemplo: public,max-age=3600,no-transform

Detalles de la respuesta

Tras la ejecución exitosa, la respuesta contendrá el objeto que será descargado y se mostrará el mensaje de éxito.

Posibles respuestas de error

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

Failure Response
copy
{
"status": 404,
"code": "key_not_found",
"message": "no such key is associated with any object in the bucket"
}

View more

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

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

View more

Sample Request
copy

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

Sample Response
copy

200 OK
// Bytes de datos sin procesar

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit