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
Yes
No
Send your feedback to us
Skip
Submit