--- title: "オブジェクトの可用性確認" url: https://docs.catalyst.zoho.com/ja/api/code-reference/cloud-scale/stratus/head-object/ description: "このAPIは、特定のオブジェクトがバケット内に存在するかどうかを確認できるようにします。" last_updated: 2026-02-23T12:39:41Z service: Cloud Scale type: api --- # オブジェクトの可用性確認 ### 説明 このAPIは、特定の[オブジェクト](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/objects/introduction/)がバケットに保存されているかどうかを確認できるようにします。バケットはその[一意のバケット名](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/buckets/name-bucket/#ideal-practices-to-name-a-bucket)で参照され、必要なオブジェクトはその名前を使用して参照されます。 [バージョニング](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/stratus-config/general-settings/#versioning)が有効な場合、必要なオブジェクトはその一意の`version ID`を使用しても参照できます。 ### リクエスト詳細 #### リクエストURL `HEAD` {api-domain}/baas/v1/project/{project_id}/bucket/objects - **project_id** (Numerical): プロジェクトの[一意のID](https://docs.catalyst.zoho.com/ja/getting-started/set-up-a-catalyst-project/general-settings/) #### クエリパラメータ - **bucket_name** (Alphanumeric, mandatory): [バケットの名前](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/buckets/name-bucket/#ideal-practices-to-name-a-bucket) - **object_key** (String, mandatory): オブジェクトの完全な名前を含みます。 - **version_id** (String, optional): バージョニングが有効な場合にStratusによって生成されるIDです。`version_id`を使用して必要なオブジェクトを参照できます。 #### リクエストヘッダー **Authorization:** Zoho-oauthtoken {oauth_token} **オプションヘッダー** **CATALYST-ORG:** {org_id} **Environment:** Development #### スコープ ZohoCatalyst.buckets.objects.READ ### レスポンス詳細 正常に実行されると、レスポンスにはオブジェクトがバケット内に存在することを示す**200**ステータスコードが含まれます。オブジェクトが正しくないか、バケット内に存在しない場合は、レスポンスとして**404**ステータスコードが返されます。 **リクエスト例** ```bash curl -X HEAD https://api.catalyst.zoho.com/baas/v1/project/10108000003823392/bucket/object?bucket_name=myBucketName&object_key=image.jpeg&version_id=dfd233fcds2wd223/ -H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57" ``` ### SDK Documentation * [Check Object Availability - Java SDK](https://docs.catalyst.zoho.com/ja/sdk/java/v1/cloud-scale/stratus/check-object-availability/) * [Check Object Availability - Node.js SDK](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/cloud-scale/stratus/check-object-availability/) * [Check Object Availability - Python SDK](https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/stratus/check-object-availability/) * [Stratus - Web SDK](https://docs.catalyst.zoho.com/ja/sdk/web/v4/cloud-scale/stratus/overview/) * [Stratus - iOS SDK](https://docs.catalyst.zoho.com/ja/sdk/ios/v2/cloud-scale/stratus/overview/) * [Stratus - Android SDK](https://docs.catalyst.zoho.com/ja/sdk/android/v2/cloud-scale/stratus/overview/) * [Stratus - Flutter SDK](https://docs.catalyst.zoho.com/ja/sdk/flutter/v2/cloud-scale/stratus/overview/)