お知らせ:

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

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

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

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

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

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

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

使用パラメータ

パラメータ名 データ型 定義
key String 必須パラメータです。オブジェクトの完全な名前を保持します。
versionId String 任意パラメータです。バージョニングが有効な場合、オブジェクトの一意のバージョンIDを保持します。
throwErr Boolean 任意パラメータです。このパラメータを「true」に設定すると、オブジェクトがプロジェクト内に見つからない場合にエラーをスローします。デフォルト値は「false」です。
copy
Boolean throwErr = true;
Boolean headObjectRes = bucket.headObject("sam/out/sample.txt", "versionId", throwErr);
System.out.println(headObjectRes);

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

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

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