get-object

Classic/VPC環境で利用できます。

Object Storageに保存したオブジェクトをダウンロードします。

構文

get-object構文は次の通りです。

aws s3api get-object \
    --bucket <bucket> \
    --key <key> \
    [--version-id <version-id>] \
    [--range <range>] \
    [--part-number <part-number>] \
    [--sse-customer-algorithm <sse-customer-algorithm>] \
    [--sse-customer-key <sse-customer-key>] \
    [--sse-customer-key-md5 <sse-customer-key-md5>] \
    --endpoint-url <endpoint-url> \
    <outfile>

オプション

get-objectの実行時に指定できるオプションについて説明します。

必須オプション

get-objectの必須オプションです。

オプション	タイプ	必須の有無	説明
`--bucket`	String	Required	バケット名
`--key`	String	Required	オブジェクト名
`<outfile>`	String	Required	ダウンロードするファイルに付ける名前

任意オプション

get-objectの任意オプションです。指定しない場合、オプションにはデフォルト値が適用されます。

オプション	タイプ	必須の有無	説明
`--version-id`	String	Optional	オブジェクトのバージョン ID バージョン管理されているバケットで特定のバージョンのオブジェクトをダウンロードする場合
`--range`	String	Optional	ダウンロードするバイトの範囲
`--part-number`	String	Optional	ダウンロードするパート番号オブジェクトの一部パートのみをダウンロードする場合
`--sse-customer-algorithm`	String	Optional	ユーザー暗号化アルゴリズム (AES256)
`--sse-customer-key`	String	Optional	ユーザー提供の暗号化キー
`--sse-customer-key-md5`	String	Optional	ユーザー提供暗号化キーの MD5

共通オプション

awsコマンドで共通して使用するオプションについては、Object Storageのオプションをご参照ください。

例

オブジェクトのダウンロードリクエストが成功すると、指定されたパスにオブジェクトが保存され、オブジェクトのメタデータが返されます。

コマンド

コマンドの例は次の通りです。

aws s3api get-object --bucket my-test-bucket \
    --key img/image.png \
    --endpoint-url=https://kr.object.ncloudstorage.com \
    image.png

オブジェクトの一部のバイト範囲のみをダウンロードするコマンドの例は次の通りです。

aws s3api get-object --bucket my-test-bucket \
    --key img/image.png \
    --range bytes=0-31 \
    --endpoint-url=https://kr.object.ncloudstorage.com \
    partial.png

マルチパートオブジェクトの特定のパートだけをダウンロードするコマンドの例は次の通りです。

aws s3api get-object --bucket my-test-bucket \
    --key large.bin \
    --part-number 1 \
    --endpoint-url=https://kr.object.ncloudstorage.com \
    part1.bin

出力

出力の例は次の通りです。

{
    "AcceptRanges": "bytes",
    "LastModified": "Wed, 02 Sep 2026 06:39:50 GMT",
    "ContentLength": 70,
    "ETag": "\"2cd8bde463f5d82aae0f0cec061d6b8f\"",
    "ContentType": "image/png",
    "Metadata": {},
    "StorageClass": "Standard"
}

バイト範囲を指定してダウンロードした出力の例は次の通りです。リクエストした範囲と全体のサイズがContentRangeとして返されます。

{
    "AcceptRanges": "bytes",
    "LastModified": "Wed, 02 Sep 2026 06:39:50 GMT",
    "ContentLength": 32,
    "ETag": "\"2cd8bde463f5d82aae0f0cec061d6b8f\"",
    "ContentRange": "bytes 0-31/70",
    "ContentType": "image/png",
    "Metadata": {},
    "StorageClass": "Standard"
}

特定のパートのみをダウンロードした出力の例は次の通りです。オブジェクトのパートの総数がPartsCountとして返されます。

{
    "AcceptRanges": "bytes",
    "LastModified": "Wed, 02 Sep 2026 06:39:06 GMT",
    "ContentLength": 5242880,
    "ETag": "\"cad5bfe2c36bcb9a8f19d6122296cc1c-1\"",
    "ContentRange": "bytes 0-5242879/5242880",
    "ContentType": "application/octet-stream",
    "Metadata": {},
    "StorageClass": "Standard",
    "PartsCount": 1
}