Create or replace an object#
新しいオブジェクトを作成します。または、既存のオブジェクトを置き換えます。
APIエンドポイント#
| リージョン | APIエンドポイント |
|---|---|
| 西日本リージョン3の場合 | https://objectstorage.jp-west-3.cloud.global.fujitsu.com |
| 東日本リージョン3の場合 | https://objectstorage.jp-east-3.cloud.global.fujitsu.com |
HTTPメソッドとURI#
PUT
/v2/{account}/{container}/{object}
HTTPステータスコード#
正常時：201
エラー時：400,401,403,404,405,408,409,411,412,416,422,500,501
リクエストパラメータの説明#
| 名前 | In | Type | デフォルト値 /必須指定 |
Description |
|---|---|---|---|---|
| X-Auth-Token | header | string | 必須 | 認証トークン |
| Content-Length | header | integer | 任意 | オブジェクトのサイズ(バイト単位) chunked形式の転送を行う場合は設定できません。 |
| Transfer-Encoding | header | string | 任意 | chunked形式の転送を行う場合はTransfer-Encoding:chunkedを設定します。 |
| Content-Type | header | string | 必須 | オブジェクトのMIMEタイプを変更します。 |
| ETag | header | string | 任意 | リクエストボディのMD5チェックサム 例えば、アップロードするファイルのMD5チェックサムです。完全なアップロードを行うために、あらかじめオブジェクトのMD5チェックサムを計算しておき、本ヘッダーに設定してリクエストすることを強くお勧めします。なお、この値は引用符で囲まない値です。 |
| Content-Encoding | header | string | 任意 | 内容の暗号化メタデータを設定します。 |
| x-object-meta-name | header | string | 任意 | オブジェクトのメタデータ {name}はメタデータの名前です。追加または更新するメタデータ名項目ごとにX-Object-Meta-nameヘッダーを指定する必要があります。 |
| account | path | string | 必須 | プロジェクト単位でユニークに割り当てられる名前 |
| container | path | string | 必須 | コンテナのユニークな名前 |
| object | path | string | 必須 | オブジェクトのユニークな名前 a～z A～Z 0～9 ! エクスクラメーション # ハッシュマーク $ ドルマーク % パーセント - ハイフン _ アンダースコア . ピリオド * アスタリスク , カンマ @ アットマーク = イコール ~ チルダ + プラス : コロン |
レスポンスヘッダーの説明#
| 名前 | Type | Description |
|---|---|---|
| Date | string | トランザクションが実行された日時 |
| Content-Type | string | オブジェクトのMIME typeの種類 |
| Content-Length | string | レスポンスボディのバイト数 |
| Connection | string | 持続接続の状態を表示します。 |
| X-Trans-Id | string | このリクエストに付与されるID トラブルについて問い合わせる際に利用されます。 |
| Last-Modified | string | 最終更新時刻（GMT表示） |
| ETag | string | この値はオブジェクトのMD5チェックサムです。 実際にダウンロードしたオブジェクトのMD5チェックサムの値とETagヘッダーの値を比べることを強くお勧めします。もし違いがあった場合は、コンテンツが破損しているため、リトライ処理を行ってください。 |
| X-Timestamp | integer | リクエストを処理した時刻（UNIX Epoch秒表示） |
| x-ntap-sg-trace-id | string | このリクエストに対する処理ID トラブルについて問い合わせる際に利用されます。 |
| X-Fcx-Endpoint-Request | string | APIエンドポイントとしてリクエストを受け付けたことを示す番号 |
リクエスト例#
curl -i $publicURL/janeausten/helloworld.txt -T ./helloworld.txt -X PUT -H "Content-Type: text/html; charset=UTF-8" -H "X-Auth-Token: $token"
レスポンス例#
HTTP/1.1 201 Created Date: Tue, 05 Jun 2018 06:05:15 GMT Content-Type: text/html; charset=utf-8 Content-Length: 10 Connection: keep-alive X-Trans-Id: 1228830871 Last-Modified: Tue, 05 Jun 2018 06:05:15 GMT ETag: 93b885adfe0da089cdf634904fd59f71 X-Timestamp: 1528178715.349705 x-ntap-sg-trace-id: d3f84f0136326db X-Fcx-Endpoint-Request: EXECUTED_api2-rmp1.test.local-29236-6873-1_201