Classic/VPC環境で利用できます。
指定したヘッダを利用してオブジェクトを照会します。オペレーションに使用されるリクエストクエリパラメータ、リクエストボディはありません。
リクエスト
リクエスト形式を説明します。リクエスト形式は次の通りです。
| メソッド | URI |
|---|---|
| GET | /{bucket-name}/{object-name} |
リクエスト構文
リクエスト構文は次の通りです。
GET https://{endpoint}/{bucket-name}/{object-name} # path style
GET https://{bucket-name}.{endpoint}/{object-name} # virtual host style
リクエストヘッダ
GetObjectヘッダを紹介します。Object Storage APIリクエストで共通して使用されるヘッダの詳細は、Object Storage共通リクエストヘッダをご参照ください。
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
range |
String | Optional | 指定の範囲内でオブジェクトの容量をバイト(Byte)単位で返す |
if-match |
String | Optional | 指定した ETag文字列がソースオブジェクトと一致する場合、オブジェクトを返す |
if-none-match |
String | Optional | 指定した ETag文字列がソースオブジェクトと一致しない場合、オブジェクトを返す |
if-unmodified-since |
String | Optional | 指定した日付以降にソースオブジェクトを変更しなかった場合、オブジェクトを返す
|
if-modified-since |
String | Optional | 指定した日付以降にソースオブジェクトを変更した場合、オブジェクトを返す
|
リクエストパスパラメータ
パラメータの説明は次の通りです。
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
bucket-name |
String | Required | オブジェクトを照会するバケットの名前 |
object-name |
String | Required | 照会するオブジェクトの名前 |
リクエスト例
リクエストのサンプルコードは次の通りです。
GET /example-bucket/worker-bee HTTP/1.1
Authorization: {authorization-string}
x-amz-date: 20160825T183244Z
Host: kr.object.ncloudstorage.com
レスポンス
レスポンス形式を説明します。
レスポンスヘッダ
Object Storage APIで共通して使用されるレスポンスヘッダの詳細は、Object Storageの共通レスポンスヘッダをご参照ください。
レスポンスステータスコード
Object Storage APIで共通して使用されるレスポンスステータスコードの詳細は、Object Storageのレスポンスステータスコードをご参照ください。
レスポンス例
レスポンスのサンプルコードは次の通りです。
HTTP/1.1 200 OK
Date: Thu, 25 Aug 2016 18:34:25 GMT
x-amz-request-id: 116dcd6b-215d-4a81-bd30-30291fa38f93
Accept-Ranges: bytes
ETag: "d34d8aada2996fc42e6948b926513907"
Content-Type: text/plain; charset=UTF-8
Last-Modified: Thu, 25 Aug 2016 17:46:53 GMT
Content-Length: 467
Female bees that are not fortunate enough to be selected to be the 'queen'
while they were still larvae become known as 'worker' bees. These bees lack
the ability to reproduce and instead ensure that the hive functions smoothly,
acting almost as a single organism in fulfilling their purpose.