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