---
title: "Descargar objeto"
url: https://docs.catalyst.zoho.com/es/api/code-reference/cloud-scale/stratus/download-object/
description: "Esta API te permite realizar operaciones de descarga en un objeto almacenado en Stratus."
last_updated: 2026-03-24T12:08:39Z
service: Cloud Scale
type: api
---

# Descargar objeto

### Descripción

Esta API te permite descargar el [objeto](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/objects/introduction/) requerido almacenado en un bucket. El bucket se referencia por su [nombre único de bucket](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/buckets/name-bucket/#ideal-practices-to-name-a-bucket), y el objeto requerido se referencia usando su nombre.

### Detalles de la solicitud

#### URL de solicitud

`GET` {bucket_name}.zohostratus.com/{key}

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

* Es aconsejable obtener la URL del bucket desde la consola.

#### Parámetros de ruta

- **project_id** (Numerical): El [ID único](https://docs.catalyst.zoho.com/es/getting-started/set-up-a-catalyst-project/general-settings/) del proyecto

- **bucket_name** (String): El [nombre del bucket](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/buckets/name-bucket/#ideal-practices-to-name-a-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](https://www.iana.org/assignments/media-types/media-types.xhtml).

- **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**

```json

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

```

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

**Failure Response**

```json

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

```

**Sample Request**

```bash

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

```

**Sample Response**

```bash

200 OK
// Bytes de datos sin procesar

```

### SDK Documentation

* [Download Object - Java SDK](https://docs.catalyst.zoho.com/es/sdk/java/v1/cloud-scale/stratus/download-object/)
* [Download Object - Node.js SDK](https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/cloud-scale/stratus/download-object/)
* [DownloadObject - Python SDK](https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/stratus/download-object/)
* [Download - Web SDK](https://docs.catalyst.zoho.com/es/sdk/web/v4/cloud-scale/stratus/overview/)
* [Download - iOS SDK](https://docs.catalyst.zoho.com/es/sdk/ios/v2/cloud-scale/stratus/download-object/)
* [Download - Android SDK](https://docs.catalyst.zoho.com/es/sdk/android/v2/cloud-scale/stratus/download-object/)
* [Download - Flutter SDK](https://docs.catalyst.zoho.com/es/sdk/flutter/v2/cloud-scale/stratus/download-object/)