オブジェクトの可用性確認
このSDKメソッドを使用すると、バケット内に特定のオブジェクトが存在するか、ユーザーがオブジェクトにアクセスするために必要な権限を持っているかを確認できます。以下のコードスニペットで使用されているBucketの参照は、コンポーネントインスタンスです。
バケットのバージョニングを有効にしている場合、特定のバージョンのオブジェクトが利用可能かどうかを確認するには、パラメータとしてversion_idを渡す必要があります。
このSDKメソッドを使用すると、以下のいずれかのレスポンスが返されます：
- true: オブジェクトが利用可能で、指定されたバージョンが利用可能で、ユーザーがオブジェクトにアクセスするための関連権限を持っている場合。
- false:
- オブジェクトまたはオブジェクトの特定バージョンがバケット内に存在しない場合。
- ユーザーがオブジェクトにアクセスするために必要な権限を持っていない場合。
- バケットが存在しない場合。
使用するパラメータ
| パラメータ名 | データ型 | 定義 |
|---|---|---|
| key | String | 必須パラメータです。オブジェクトの完全な名前を保持します。 |
| version_id | String | 任意パラメータです。バージョニングが有効な場合、オブジェクトの一意のバージョンIDを保持します。 |
| throw_err | Boolean | 任意パラメータです。このパラメータを「true」に設定すると、プロジェクト内にバケットが見つからない場合にエラーをスローします。デフォルト値は「false」です。 |
copy
head_object_res = bucket.head_object( "sam/out/sample.txt", 'version_id', throw_err=False)
print(head_object_res)発生する可能性のあるエラー
注意： throw_errパラメータを使用してSDKを使用し、オブジェクトが存在しない場合、または十分な権限がない場合、以下に示すエラーのいずれかが発生する可能性があります。
| エラーコード | 意味 |
|---|---|
| 404 | Not Found。Stratus内にオブジェクトが見つかりません。 |
| 401 | Unauthorized/Access Denied - ユーザーは特定の操作を実行する権限がありません。 |
| 403 | Permission Denied - ユーザーは特定のオブジェクトにアクセスする権限がありません。 |
最終更新日 2026-02-23 18:09:41 +0530 IST
Yes
No
Thank you for your feedback!
Send your feedback to us
Skip
Submit