---
title: "Zipオブジェクトの展開"
url: https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/stratus/extract-zipped-object/
description: "このページでは、Zipオブジェクトを展開するためのPython SDKメソッドを説明します。"
last_updated: 2026-02-23T12:39:41Z
service: Cloud Scale
type: general
related_links:
  - name: "Stratusコンポーネントヘルプドキュメント"
    url: /ja/cloud-scale/help/stratus/introduction
  - name: "Java SDK"
    url: /ja/sdk/java/v1/cloud-scale/stratus/extract-zipped-object/
  - name: "Node.js SDK"
    url: /ja/sdk/nodejs/v2/cloud-scale/stratus/extract-zipped-object/
  - name: "Web SDK"
    url: /ja/sdk/web/v4/cloud-scale/stratus/overview/
  - name: "iOS SDK"
    url: /ja/sdk/ios/v2/cloud-scale/stratus/overview/
  - name: "Android SDK"
    url: /ja/sdk/android/v2/cloud-scale/stratus/overview/
  - name: "Flutter SDK"
    url: /ja/sdk/flutter/v2/cloud-scale/stratus/overview/
  - name: "REST API"
    url: /ja/api/code-reference/cloud-scale/stratus/get-all-buckets/#GetAllBuckets
---

# Zipオブジェクトの展開

以下のSDKメソッドを使用すると、Stratus内でzipファイルを展開でき、zipファイル内に存在する個々のコンテンツはそれぞれ個別のオブジェクトとしてStratus内の同じバケットにアップロードされます。このプロセス全体は*非同期的*に実行されます。以下のコードスニペットで使用されているBucketの参照は、[コンポーネントインスタンス](https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/stratus/create-bucket-instance/)です。

> **情報：** このSDKメソッドを使用するには、**Admin**スコープで初期化する必要があります。この要件の詳細については、[こちらのセクション](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/overview/#initialize-sdk-with-scopes)をご覧ください。

> **注意：** 展開プロセスは非同期的に実行されるため、プロセス全体の完了にかかる時間は、展開されるzipファイルのサイズに依存します。

**使用するパラメータ**

<table class="content-table">
	<thead>
		<tr>
			<th class="w20p">パラメータ名</th>
			<th class="w20p">データ型</th>
      <th class="w60p">定義</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>`key`</td>
			<td>**String**</td>
			<td>必須パラメータです。展開するzipファイルの名前です。</td>
		</tr>
    <tr>
			<td>`destination`</td>
			<td>**String**</td>
			<td>必須パラメータです。展開されたオブジェクトがバケット内に保存される宛先の完全な[パス情報](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/objects/introduction/#path)を保持します。</td>
		</tr>
	</tbody>
</table>

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

#### レスポンス例

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

### Zip展開ステータスの取得

zip展開プロセスは非同期的に実行され、展開プロセスの完了にかかる時間はzipファイルのサイズに大きく依存します。

> **情報：** このSDKメソッドを使用するには、**Admin**スコープで初期化する必要があります。この要件の詳細については、[こちらのセクション](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/overview/#initialize-sdk-with-scopes)をご覧ください。

以下のSDKメソッドで`task_id`パラメータを使用すると、展開のステータスを確認できます。`task_id`は`unzip_object()`メソッドのレスポンスで返されます。

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

#### レスポンス例

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