お知らせ:

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

Objectの存在確認

このSDKメソッドを使用すると、特定のオブジェクトがBucket内に存在するか、またユーザーがそのオブジェクトにアクセスするために必要な権限を持っているかを確認できます。以下のコードスニペットで使用されているBucket参照は、コンポーネントインスタンスです。

BucketでVersioningを有効にしている場合、特定のバージョンのオブジェクトが利用可能かどうかを確認するために、パラメータとしてversionIDを渡す必要があります。

Info: このSDKメソッドを使用するには、Adminスコープで初期化する必要があります。この要件の詳細については、このセクションをご覧ください。

このSDKメソッドを使用すると、以下のいずれかのレスポンスが返されます:

  • true: オブジェクトが利用可能で、指定されたバージョンが利用可能で、ユーザーがオブジェクトにアクセスするための適切な権限を持っている場合。
  • false:
    • オブジェクトまたはオブジェクトの特定のバージョンがBucket内に利用できない場合。
    • ユーザーがオブジェクトにアクセスするために必要な権限を持っていない場合。
    • Bucketが存在しない場合。

使用パラメータ

Parameter Name Data Type Definition
objectName String 必須パラメータです。オブジェクトの完全な名前を保持します。
versionId String 任意パラメータです。Versioningが有効な場合、オブジェクトの一意のバージョンIDを保持します。
throwErr Boolean 任意パラメータです。このパラメータを「true」に設定すると、プロジェクト内にBucketが見つからない場合にエラーをスローします。デフォルト値は「false」です。
copy
const options = {
versionId: 'djkfhdiufy762',
throwErr: false
};
const headObjectRes = await bucket.headObject("sam/out/sample.txt", options);
console.log(headObjectRes);

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

Note: throwErrパラメータを指定してSDKを使用し、オブジェクトが存在しない場合、または十分な権限がない場合、以下に記載されたエラーのいずれかが発生する可能性があります。
Error Code Meaning
404 Not Found。Objectが見つかりません。
401 Unauthorized/Access Denied - ユーザーに特定の操作を実行する権限がありません。
403 Permission Denied - ユーザーに特定のオブジェクトにアクセスする権限がありません。

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