---
title: "Extract a Zipped Object"
url: https://docs.catalyst.zoho.com/en/sdk/python/v1/cloud-scale/stratus/extract-zipped-object/
description: "This page lists the Python SDK method to extract a zipped object."
last_updated: 2026-09-08T11:07:33Z
service: Cloud Scale
type: general
related_links:
  - name: "Stratus Component Help Documentation"
    url: /en/cloud-scale/help/stratus/introduction
  - name: "Java SDK"
    url: /en/sdk/java/v1/cloud-scale/stratus/extract-zipped-object/
  - name: "JavaScript SDK Documentation"
    url: /en/sdk/javascript/v1/cloudscale/stratus/extract-zipped-object/
  - name: "iOS SDK"
    url: /en/sdk/ios/v2/cloud-scale/stratus/overview/
  - name: "Android SDK"
    url: /en/sdk/android/v2/cloud-scale/stratus/overview/
  - name: "Flutter SDK"
    url: /en/sdk/flutter/v2/cloud-scale/stratus/overview/
  - name: "REST API"
    url: /en/api/code-reference/cloud-scale/stratus/get-all-buckets/#GetAllBuckets
---

# Extract a Zipped Object

The following SDK method will allow you to extract a zip file inside Stratus, and every individual content present in the zip file will be considered as individual object and uploaded to Stratus in the same bucket. This entire process will happen *asynchronously*. The Bucket reference used in the below code snippet is the [component instance](https://docs.catalyst.zoho.com/en/sdk/python/v1/cloud-scale/stratus/create-bucket-instance/).

> **Info:** To use this SDK method, you need intialize it with **Admin** scope. You can learn more about this requirement from this [section](https://docs.catalyst.zoho.com/en/sdk/nodejs/v2/overview/#initialize-sdk-with-scopes)

> **Note:** Since the extraction process occurs asynchronously, the time in which the entire process is completed is dependent on the size of the zip file that is being extracted.

**Parameters Used**

<table class="content-table">
	<thead>
		<tr>
			<th class="w20p">Parameter Name</th>
			<th class="w20p">Data Type</th>
      <th class="w60p">Definition</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>`key`</td>
			<td>**String**</td>
			<td>A **Mandatory** parameter.  Will be the name of the zip file, you need to extract</td>
		</tr>
    <tr>
			<td>`destination`</td>
			<td>**String**</td>
			<td>A **Mandatory** parameter. Will contain the complete [path information](https://docs.catalyst.zoho.com/en/cloud-scale/help/stratus/objects/introduction/#path) of the destination, where the extracted objects will be stored in the bucket.</td>
		</tr>
	</tbody>
</table>

```python
unzip_res = bucket.unzip_object("sam/out/sample.zip","output/") 
print(unzip_res)
```

#### Example Response

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

### Get Zip Extraction Status

The zip extraction process occurs asynchronously, and the time it takes to complete the extraction process is highly contingent on the size of the zip file.

> **Info:** To use this SDK method, you need intialize it with **Admin** scope. You can learn more about this requirement from this [section](https://docs.catalyst.zoho.com/en/sdk/nodejs/v2/overview/#initialize-sdk-with-scopes)

Using the `task_id` parameter, in the following SDK method, we can determine the status of the extraction. The `task_id` is returned in the response of `unzip_object()` method.

```python
res = bucket.get_unzip_status("sam/out/sample.zip", 'task_id')
print(res)
```

#### Example Response

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