---
title: "オブジェクトの可用性確認"
url: https://docs.catalyst.zoho.com/ja/sdk/java/v1/cloud-scale/stratus/check-object-availability/
description: "このページでは、バケット内にオブジェクトが存在するかを確認するためのJava 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: "Objects Help Documentation"
    url: /ja/cloud-scale/help/stratus/objects/introduction/
  - name: "Node.js SDK"
    url: /ja/sdk/nodejs/v2/cloud-scale/stratus/check-object-availability/
  - name: "Python SDK"
    url: /ja/sdk/python/v1/cloud-scale/stratus/check-object-availability/
  - 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
---

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

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

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

バケットで[バージョニング](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/stratus-config/general-settings/#versioning)を有効にしている場合、特定のバージョンのオブジェクトが利用可能かどうかを確認するために、パラメータとして`versionID`を渡す必要があります。

この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>**必須**パラメータです。オブジェクトの完全な名前を保持します。</td>
		</tr>
		<tr>
			<td>`versionId`</td>
			<td>**String**</td>
			<td>**任意**パラメータです。[バージョニング](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/stratus-config/general-settings/#versioning)が有効な場合、オブジェクトの一意のバージョンIDを保持します。</td>
		</tr>
		<tr>
			<td>`throwErr`</td>
			<td>**Boolean**</td>
			<td>**任意**パラメータです。このパラメータを「**true**」に設定すると、オブジェクトがプロジェクト内に見つからない場合にエラーをスローします。デフォルト値は「**false**」です。</td>
		</tr>
	</tbody>
</table>

```java
Boolean throwErr = true;
Boolean headObjectRes = bucket.headObject("sam/out/sample.txt", "versionId", throwErr);
System.out.println(headObjectRes);
```

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

> **Note:** `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。オブジェクトが見つかりません。</td>
		</tr>
		<tr>
			<td>`401`</td>
			<td>Unauthorized/Access Denied - ユーザーが特定の操作を実行する権限を持っていません。</td>
		</tr>
		<tr>
			<td>`403`</td>
			<td>Permission Denied - ユーザーが特定のオブジェクトにアクセスする権限を持っていません。</td>
		</tr>
	</tbody>
</table>