お知らせ:

当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

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

headObject() SDKメソッドを使用して、バケット内のオブジェクトの存在を確認し、さらにユーザーがバケット内のオブジェクトにアクセスするための適切な権限を持っているかどうかを確認できます。以下のコードスニペットで使用されているBucketリファレンスは、コンポーネントインスタンスです。

このSDKを使用した場合の可能なレスポンス:

  • バケットが存在し、ユーザーがバケット内のオブジェクトにアクセスするための適切な権限を持っている場合、レスポンス「true」が返されます。

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

使用パラメータ

パラメータ名 データ型 定義
key String 必須パラメータです。オブジェクトのパスを含む完全な名前を保持します。
options JSON Object 以下のパラメータを保持するオプションパラメータです:
  • versionId:
    • オプションのStringパラメータです。
    • バケットでバージョニングが有効になっている場合、このパラメータを使用して一意のVersion IDで特定のバージョンを参照できます。
  • throwErr:
    • オプションのBooleanパラメータです。
    • このパラメータを「true」に設定すると、プロジェクトにバケットが見つからない場合にエラーをスローします。
    • デフォルト値は「false」です。

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

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

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

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

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

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

const options = { versionId: ‘djkfhdiufy762’, throwErr: false }; const checkObjectAvailability = await bucket.headObject(“key”, options)

レスポンス例

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

最終更新日 2026-02-23 18:09:41 +0530 IST