GetObject

印刷する
共有
PDF

記事の要約

この要約は役に立ちましたか?

ご意見ありがとうございます

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

コンテナ(バケット)のオブジェクトをダウンロードしてメタデータを照会します。
レスポンスヘッダを通じてオブジェクトのメタデータを確認し、レスポンスボディを通じてオブジェクトの内容をダウンロードします。
大容量オブジェクトの場合、レスポンスボディはセグメントオブジェクトの結合情報を含みます。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド	URI
GET	/v1/AUTH_{project_id}/{container}/{object}

リクエストヘッダ

ヘッダの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`X-Auth-Token`	String	Optional	発行したトークンの値
`X-Newest`	Boolean	Optional	最新のコピー情報でレスポンスするかどうかを設定 `true` \| `false` `true`: すべてのコピーに対してクエリを行い、最新のコピー情報でレスポンスヘッダが省略された場合、レスポンスが最も早い情報でレスポンス
`Range`	String	Optional	対象オブジェクトの範囲を指定 `Bytes=-5`: 最後の5バイト `Bytes=10-15`: 10バイトから15 バイトまでの6バイト `Bytes=10-15,-5`: 10バイトから15バイトまでの6バイトと最後の5バイトを一緒に返す、`Content-Type`ヘッダを`multipart/byteranges`にして返す `Bytes=6-`: 6バイトから最後まで `Bytes=1-3,2-5`: 1バイトから3バイトまでの3バイトと、2バイトから5バイトまでの3バイトを一緒に返す、`Content-Type`ヘッダを`multipart/byteranges`にして返す
`If-Match`	String	Optional	ETag条件ヘッダ詳細は、RFC2616で確認
`If-None-Match`	String	Optional	ETag条件ヘッダ詳細は、RFC2616で確認
`If-Modified-Since`	String	Optional	Last-Modified条件ヘッダ詳細は、RFC2616で確認
`If-Unmodified-Since`	String	Optional	Last-Modified条件ヘッダ詳細は、RFC2616で確認

リクエストパスパラメータ

リクエストパスパラメータの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`project_id`	String	Required	プロジェクト ID プロジェクト IDの確認方法は、Archive Storageの概要を参照
`container`	String	Required	コンテナ(バケット)の名前
`object`	String	Required	オブジェクト名

リクエストクエリパラメータ

パラメータの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`temp_url_sig`	String	Required	保存するリソースにアクセス可能な仮 URLの署名承認されたリクエストであることを検証
`temp_url_expires`	Integer	Required	保存するリソースにアクセス可能な仮 URLの有効期限(Unix Timestamp)
`filename`	String	Conditional	オブジェクトの保存場所とファイル名
`multipart-manifest`	String	Conditional	大容量オブジェクトのマルチパートアップロードを宣言 Static大容量オブジェクトのマニフェストを取得する際に使用値として`put`を入力するとマルチパートアップロードとして認識され、パートを１つのファイルに結合するようにサーバに指示リクエストボディにパートを結合するためのマニフェストを必ず作成

リクエスト例

リクエストのサンプルコードは次の通りです。

curl -X GET "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}" 
-H "X-Auth-Token: $token"

レスポンス

レスポンス形式を説明します。

レスポンスヘッダ

ヘッダの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`Content-Type`	String	-	レスポンス結果の MIMEタイプ
`ETag`	String	-	ETagヘッダの値
`Last-Modified`	String	-	オブジェクトの最終更新時間(UTC)
`X-Timestamp`	Integer	-	オブジェクトが作成された時刻(Unix Timestamp)
`Accept-Ranges`	String	-	オブジェクトが対応する範囲タイプ
`Content-Length`	String	-	レスポンス結果の長さ(Byte)
`X-Trans-Id`	String	-	リクエストのトランザクション ID
`X-Openstack-Request-Id`	String	-	リクエストのトランザクション ID `X-Trans-Id`と同じ
`X-Object-Meta-{name}`	String	-	設定するメタデータ `{name}`部分にメタデータのキーを入力ヘッダの値にメタデータの値を入力
`Content-Disposition`	String	-	ブラウザのレスポンス処理方式
`Content-Encoding`	String	-	オブジェクトのエンコード方式
`X-Delete-At`	Integer	-	オブジェクトの自動削除予定時刻(Unix Timestamp) データを一時的に保存する場合に使用入力された日時にオブジェクトを削除
`X-Object-Manifest`	String	-	大容量オブジェクトをアップロードする場合、オブジェクト(SLO)のマニフェスト形式: `{container}/{prefix}`
`Date`	String	-	リクエストのレスポンスタイム(UTC)
`X-Static-Large-Object`	Boolean	-	大容量オブジェクト(SLO)かどうか `true` \| `false`

レスポンスステータスコード

レスポンスステータスコードの説明は次の通りです。

HTTPステータスコード	コード	メッセージ	説明
200	-	OK	リクエスト成功
206	-	Partial Content	Rangeパラメータを通じて、オブジェクト内容一部のリクエストが成功
403	-	Not Found	コンテナ(バケット)は存在しない

レスポンス例

レスポンスのサンプルコードは次の通りです。

HTTP/1.1 200 OK
Content-Length: 210012
Accept-Ranges: bytes
Last-Modified: Tue, 11 Sep 2018 02:12:30 GMT
Etag: 9bd5b4f25faf491080654a34d57c3636
X-Timestamp: 1536631949.99141
Content-Type: text/plain
X-Trans-Id: tx9b5c78b06d0f41c5bd4bf-005b989fb7
X-Openstack-Request-Id: tx9b5c78b06d0f41c5bd4bf-005b989fb7
Date: Wed, 12 Sep 2018 05:10:15 GMT

この記事は役に立ちましたか?

What's Next

PutObject

リクエスト
レスポンス

タグ

Archive Storage