---
title: "オブジェクトの可用性確認"
url: https://docs.catalyst.zoho.com/ja/sdk/web/v4/cloud-scale/stratus/check-object/
description: "このページでは、バケット内にオブジェクトが存在するかどうかを確認するWeb SDKメソッドについて説明します。"
last_updated: 2026-02-23T12:39:41Z
service: Cloud Scale
type: general
related_links:
  - name: "Stratus Component Help Documentation"
    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: "Python SDK"
    url: /ja/sdk/python/v1/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
---

# オブジェクトの可用性確認

`headObject()` SDKメソッドを使用して、バケット内のオブジェクトの存在を確認し、さらにユーザーがバケット内のオブジェクトにアクセスするための適切な権限を持っているかどうかを確認できます。以下のコードスニペットで使用されているBucketリファレンスは、[コンポーネントインスタンス](https://docs.catalyst.zoho.com/ja/sdk/web/v4/cloud-scale/stratus/initialize-stratus-instance/#initialize-bucket-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>`key`</td>
			<td>**String**</td>
			<td>**必須**パラメータです。オブジェクトの[パス](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/objects/introduction/#path)を含む完全な名前を保持します。</td>
		</tr>
		<tr>
			<td>`options`</td>
			<td>**JSON Object**</td>
			<td>以下のパラメータを保持する**オプション**パラメータです:
				<ul>
					<li>`versionId`: 
						<ul>
							<li>オプションの**String**パラメータです。</li>
							<li>バケットで[バージョニング](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/stratus-config/general-settings/#versioning)が有効になっている場合、このパラメータを使用して一意のVersion IDで特定のバージョンを参照できます。</li>
						</ul>
					</li>
					<li>`throwErr`: 
						<ul>
							<li>オプションの**Boolean**パラメータです。</li>
							<li>このパラメータを「**true**」に設定すると、プロジェクトにバケットが見つからない場合にエラーをスローします。</li>
							<li>デフォルト値は「**false**」です。</li>
						</ul>
					</li>
				</ul>
			</td>
		</tr>
	</tbody>
</table>

### VersionIDなしのオブジェクト可用性確認

以下のSDKメソッドは、バケット内のオブジェクトの `topVersion`（最新バージョン）を提供します。

```javascript
// オブジェクトが利用可能か確認する
const checkObjectAvailability = await bucket.headObject("key")
```

### VersionID付きのオブジェクト可用性確認

以下のSDKメソッドは、オブジェクトの特定バージョンの可用性を確認します。必要なバージョンは一意の `versionId` で参照されます。

```javascript
// オブジェクトの特定バージョンが利用可能か確認する

const options = {
	versionId: 'djkfhdiufy762',
	throwErr: false
};
const checkObjectAvailability = await bucket.headObject("key", options)
```

**レスポンス例**

```json
{
 	"status": 200,
 	"content": true | false,
 	"message": "OK"
}
```