Show object content and metadata#
オブジェクトの内容とメタデータをダウンロードします。
APIエンドポイント#
| リージョン | APIエンドポイント |
|---|---|
| 西日本リージョン3の場合 | https://objectstorage.jp-west-3.cloud.global.fujitsu.com |
| 東日本リージョン3の場合 | https://objectstorage.jp-east-3.cloud.global.fujitsu.com |
HTTPメソッドとURI#
GET
/v2/{account}/{container}/{object}
HTTPステータスコード#
正常時：200
エラー時：400,401,403,404,405,409,411,412,416,422,500,501
リクエストパラメータの説明#
| 名前 | In | Type | デフォルト値 /必須指定 |
Description |
|---|---|---|---|---|
| X-Auth-Token | header | string | 必須 | 認証トークン |
| Range | header | string | 任意 | 取得するコンテンツのレンジ Rangeヘッダーを使ってレンジを指定してデータの一部を取得することができます。多数のレンジを指定する場合は、コンマ区切りで記述します。 レンジの指定方法は次のとおりです。 - Byte rangeデータの何バイト目から何バイト目まで返却するかを指定します。データの終了バイトの記述を省略した場合はデータの末尾まで返却します。 - Suffix byte rangeデータの末尾の何バイトを返却するかを指定します。 |
| Accept-Encoding | header | string | 任意 | 圧縮アルゴリズムの形式 |
| If-Match | header | string | 任意 | http://www.ietf.org/rfc/rfc2616.txtを参照してください。 |
| If-Modified-Since | header | string | 任意 | http://www.ietf.org/rfc/rfc2616.txtを参照してください。 |
| If-Unmodified-Since | header | string | 任意 | http://www.ietf.org/rfc/rfc2616.txtを参照してください。 |
| account | path | string | 必須 | プロジェクト単位でユニークに割り当てられる名前 |
| container | path | string | 必須 | コンテナのユニークな名前 |
| object | path | string | 必須 | オブジェクトのユニークな名前 |
レスポンスヘッダーの説明#
| 名前 | Type | Description |
|---|---|---|
| Date | string | トランザクションが実行された日時 |
| Content-Type | string | オブジェクトのMIME typeの種類 |
| Content-Length | string | レスポンスボディのバイト数 |
| Connection | string | 持続接続の状態を表示します。 |
| X-Trans-Id | string | このリクエストに付与されるID トラブルについて問い合わせる際に利用されます。 |
| x-ntap-sg-trace-id | string | このリクエストに対する処理ID トラブルについて問い合わせる際に利用されます。 |
| ETag | string | この値はオブジェクトのMD5チェックサムになります。 実際にダウンロードしたオブジェクトのMD5チェックサムの値とETagヘッダーの値を比べることを強くお勧めします。もし違いがあった場合は、コンテンツが破損しているため、リトライ処理を行ってください。 |
| Accept-Ranges | string | オブジェクトの取得で指定できるRangesのタイプ |
| Last-Modified | integer | 最終更新時刻（GMT表示） |
| X-Timestamp | string | リクエストを処理した時刻（UNIX Epoch秒表示） |
| X-Object-Meta-name | header | オブジェクトメタデータ {name}はメタデータ項目の名前です。 |
| X-Fcx-Endpoint-Request | string | APIエンドポイントとしてリクエストを受け付けたことを示す番号 |
リクエスト例#
curl -i $publicURL/marktwain/goodbye -X GET -o ./helloworld.txt -H "X-Auth-Token: $token"
レスポンス例#
HTTP/1.1 200 OK Date: Tue, 05 Jun 2018 02:55:18 GMT Content-Type: text/plain Content-Length: 102400 Connection: keep-alive X-Trans-Id: 3642997705 x-ntap-sg-trace-id: a6c1f7770ade07d4 ETag: 4c6426ac7ef186464ecbb0d81cbfcb1e Accept-Ranges: bytes Last-Modified: Tue, 05 Jun 2018 02:54:50 GMT X-Timestamp: 1528167290.626971 X-Fcx-Endpoint-Request: EXECUTED_api2-rmp1.test.local-15775-7549-1_200