オブジェクトの可用性確認
この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
Yes
No
Send your feedback to us
Skip
Submit