---
title: "Extraer un objeto comprimido"
url: https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/cloud-scale/stratus/extract-zipped-object/
description: "Esta página lista el método del SDK de Node.js para extraer un objeto comprimido."
last_updated: 2026-03-20T16:21:56Z
service: Cloud Scale
type: general
related_links:
  - name: "Stratus Component Help Documentation"
    url: /es/cloud-scale/help/stratus/introduction
  - name: "Java SDK"
    url: /es/sdk/java/v1/cloud-scale/stratus/extract-zipped-object/
  - name: "Python SDK"
    url: /es/sdk/python/v1/cloud-scale/stratus/extract-zipped-object/
  - name: "Web SDK"
    url: /es/sdk/web/v4/cloud-scale/stratus/overview/
  - name: "iOS SDK"
    url: /es/sdk/ios/v2/cloud-scale/stratus/overview/
  - name: "Android SDK"
    url: /es/sdk/android/v2/cloud-scale/stratus/overview/
  - name: "Flutter SDK"
    url: /es/sdk/flutter/v2/cloud-scale/stratus/overview/
  - name: "REST API"
    url: /es/api/code-reference/cloud-scale/stratus/get-all-buckets/#GetAllBuckets
---

# Extraer un objeto comprimido en Stratus

El siguiente método del SDK te permitirá extraer un archivo zip dentro de Stratus, y cada contenido individual presente en el archivo zip será considerado como un objeto individual y subido a Stratus en el mismo bucket. Todo este proceso ocurrirá *de forma asíncrona*. La referencia del Bucket utilizada en el fragmento de código a continuación es la [instancia del componente](https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/cloud-scale/stratus/create-bucket-instance/).

> **Info:** Para usar este método del SDK, necesitas inicializarlo con el ámbito **Admin**. Puedes obtener más información sobre este requisito en esta [sección](https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/overview/#initialize-sdk-with-scopes)

> **Note:** Dado que el proceso de extracción ocurre de forma asíncrona, el tiempo en que se completa todo el proceso depende del tamaño del archivo zip que se está extrayendo.

**Parámetros utilizados**

<table class="content-table">
	<thead>
		<tr>
			<th class="w20p">Nombre del parámetro</th>
			<th class="w20p">Tipo de dato</th>
      <th class="w60p">Definición</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>`key`</td>
			<td>**String**</td>
			<td>Un parámetro **obligatorio**. Será el nombre del archivo zip que necesitas extraer</td>
		</tr>
    <tr>
			<td>`destPath`</td>
			<td>**String**</td>
			<td>Un parámetro **obligatorio**. Contendrá la [información completa de la ruta](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/objects/introduction/#path) del destino, donde los objetos extraídos se almacenarán en el bucket.</td>
		</tr>
	</tbody>
</table>

```javascript
const res = await bucket.unzipObject("sample.zip","output/");
console.log(res);
```

#### Respuesta de ejemplo

```json
{
  "key": "sample.zip",
  "destination": "output/",
  "task_id": "6963000000272049",
  "message": "Zip extract scheduled"
}
```

### Get Zip Extraction Status

El proceso de extracción del zip ocurre de forma asíncrona, y el tiempo que toma completar el proceso de extracción depende en gran medida del tamaño del archivo zip.

> **Info:** Para usar este método del SDK, necesitas inicializarlo con el ámbito **Admin**. Puedes obtener más información sobre este requisito en esta [sección](https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/overview/#initialize-sdk-with-scopes)

Usando el parámetro `taskId`, en el siguiente método del SDK, podemos determinar el estado de la extracción. El `taskId` se devuelve en la respuesta del método `unzipObject()`.

```javascript
const statusRes = await bucket.getUnzipStatus("sample.zip", 'taskId');
console.log(statusRes);
```

#### Respuesta de ejemplo

```json
{
"task_id": "6963000000272049",
"status": "SUCCESS"
}
```