---
title: "バケットの可用性確認"
url: https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/stratus/check-bucket/
description: "このページでは、プロジェクト内にバケットが存在するかどうかを確認するための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/check-bucket/
  - name: "Node.js SDK"
    url: /ja/sdk/nodejs/v2/cloud-scale/stratus/check-bucket/
  - name: "Web SDK"
    url: /ja/sdk/web/v4/cloud-scale/stratus/check-bucket/
  - 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
---

# バケットの可用性確認

`head_bucket()` SDKメソッドを使用すると、Stratus内のバケットの存在を確認し、さらにユーザーがバケット内のオブジェクトにアクセスするための関連権限を持っているかどうかを確認できます。以下のコードスニペットで使用されている`stratus`の参照は、[コンポーネントインスタンス](https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/stratus/create-stratus-instance/)です。

このSDKを使用した場合のレスポンス：

* バケットが存在し、ユーザーがバケットにアクセスするための関連権限を持っている場合、レスポンスとして「**true**」が返されます。

* バケットが存在しない場合、またはユーザーがバケットにアクセスする権限を持っていない場合、レスポンスとして「**false**」が返されます。

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

<table class="content-table">
	<thead>
		<tr>
			<th class="w20p">パラメータ名</th>
			<th class="w20p">データ型</th>
      <th class="w60p">定義</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>`bucket_name`</td>
			<td>**String**</td>
			<td>必須パラメータです。バケットの[一意の名前](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/buckets/name-bucket/#ideal-practices-to-name-a-bucket)を保持します。</td>
		</tr>
		<tr>
			<td>`throw_err`</td>
			<td>**Boolean**</td>
			<td>任意パラメータです。このパラメータを「**true**」に設定すると、プロジェクト内にバケットが見つからない場合にエラーをスローします。デフォルト値は「**false**」です。</td>
		</tr>
	</tbody>
</table>

```python
bucket_res = stratus.head_bucket('bucket_name', throw_err=False)
print(bucket_res)

```

#### 発生する可能性のあるエラー

> **注意：** `throw_err`パラメータを使用してSDKを使用し、バケットが存在しない場合、または十分な権限がない場合、以下に示すエラーのいずれかが発生する可能性があります。

<table class="content-table">
	<thead>
		<tr>
			<th class="w30p">エラーコード</th>
			<th class="w70p">意味</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>`404`</td>
			<td>Not Found。Stratus内にバケットが見つかりません。</td>
		</tr>
		<tr>
			<td>`401`</td>
			<td>Unauthorized/Access Denied - ユーザーは特定の操作を実行する権限がありません。</td>
		</tr>
		<tr>
			<td>`403`</td>
			<td>Permission Denied - ユーザーは特定のバケットにアクセスする権限がありません。</td>
		</tr>
	</tbody>
</table>