すべてのプロダクト
Search

このプロダクト

    Object Storage Service:get-object

    ドキュメントセンター

    Object Storage Service:get-object

    最終更新日:Apr 21, 2026

    バケットからオブジェクトをダウンロードします。

    注意事項

    • デフォルトでは、GetObject API オペレーションには HTTP と HTTPS 経由でアクセスできます。HTTPS 経由のアクセスのみを強制するには、バケットポリシーを使用します。詳細については、「OSS リソースへのアクセスを他のユーザーに許可するためのバケットポリシーの設定」をご参照ください。

    • オブジェクトがアーカイブストレージクラスにある場合、まず RestoreObject リクエストを送信してオブジェクトを解凍する必要があります。リクエストがタイムアウトしないようにしてください。

    権限

    デフォルトでは、Alibaba Cloud アカウント (root ユーザー) は完全な権限を持っています。Alibaba Cloud アカウント (root ユーザー) 配下の RAM ユーザーまたは RAM ロールは、デフォルトではいかなる権限も持っていません。Alibaba Cloud アカウント (root ユーザー) またはアカウント管理者は、RAM ポリシーまたはバケットポリシーを通じて操作権限を付与する必要があります。

    API

    アクション

    説明

    GetObject

    oss:GetObject

    オブジェクトをダウンロードします。

    oss:GetObjectVersion

    オブジェクトをダウンロードする際に、versionId を通じてオブジェクトのバージョンを指定する場合、この権限が必要です。

    kms:Decrypt

    オブジェクトをダウンロードする際に、オブジェクトのメタデータに X-Oss-Server-Side-Encryption: KMS が含まれている場合、この権限が必要です。

    コマンド構文

    ossutil api get-object --bucket value --key value [flags]

    パラメーター

    タイプ

    説明

    --accept-encoding

    string

    クライアントのエンコーディングタイプを指定します。

    --bucket

    string

    バケットの名前。

    --if-match

    string

    指定された ETag がオブジェクトの ETag と一致する場合、OSS はオブジェクトのメタデータと 200 OK ステータスコードを返します。それ以外の場合は、412 Precondition Failed エラーを返します。

    --if-modified-since

    string

    指定された時刻がオブジェクトの最終更新時刻より前の場合、OSS はオブジェクトのメタデータと 200 OK ステータスコードを返します。それ以外の場合は、304 Not Modified ステータスコードを返します。

    --if-none-match

    string

    指定された ETag がオブジェクトの ETag と一致しない場合、OSS はオブジェクトのメタデータと 200 OK ステータスコードを返します。それ以外の場合は、304 Not Modified ステータスコードを返します。

    --if-unmodified-since

    string

    指定された時刻がオブジェクトの最終更新時刻と同じかそれ以降の場合、OSS はオブジェクトのメタデータと 200 OK ステータスコードを返します。それ以外の場合は、412 Precondition Failed エラーを返します。

    --key

    string

    オブジェクトの完全なパス。

    --range

    stringArray

    取得するオブジェクトのバイト範囲。

    --response-cache-control

    string

    応答で返す Cache-Control ヘッダー。

    --response-content-disposition

    string

    応答で返す Content-Disposition ヘッダー。

    --response-content-encoding

    string

    応答で返す Content-Encoding ヘッダー。

    --response-content-language

    string

    応答で返す Content-Language ヘッダー。

    --response-expires

    string

    応答で返す Expires ヘッダー。

    --version-id

    string

    取得するオブジェクトのバージョン ID。

    説明

    • get-object コマンドは GetObject API オペレーションに基づいて構築されています。API オペレーションのパラメーターの詳細については、「GetObject」をご参照ください。

    • サポートされているグローバルコマンドラインオプションについては、「グローバルコマンドラインオプション」をご参照ください。

    例

    • examplebucket バケットから exampleobject オブジェクトを取得します。

      ossutil api get-object --bucket examplebucket --key exampleobject

    • examplebucket バケットからバージョン ID が 123 の exampleobject オブジェクトを取得します。

      ossutil api get-object --bucket examplebucket --key exampleobject --version-id 123

    • examplebucket バケットからオブジェクト exampleobject の指定された範囲を取得します。

      ossutil api get-object --bucket examplebucket --key exampleobject --range bytes=1-10

    • exampleobject オブジェクトの変更時刻が Mon, 11 May 2020 08:16:23 GMT より後である場合、examplebucket バケットから exampleobject オブジェクトを取得します。

      ossutil api get-object --bucket examplebucket --key exampleobject --if-modified-since "Mon, 11 May 2020 08:16:23 GMT"

    • examplebucket バケットから exampleobject を取得します。exampleobject の ETag が 123 と等しい場合にオブジェクトが返されます。

      ossutil api get-object --bucket examplebucket --key exampleobject --if-match 123

    • examplebucket バケットから exampleobject を取得し、Gzip 圧縮で応答を転送します。

      ossutil api get-object --bucket examplebucket --key exampleobject --accept-encoding gzip

    API リファレンス

    このコマンドは GetObject RESTful API に基づいて構築されています。より多くのカスタマイズを行うには、署名を計算するためのコードを記述する必要がある直接的な API リクエストを行うことができます。詳細については、「GetObject」をご参照ください。