Create Tenant#

テナントを作成します。

APIエンドポイント#

リージョン APIエンドポイント
西日本リージョン3の場合 https://objectstorage-s.jp-west-3.cloud.global.fujitsu.com
東日本リージョン3の場合 https://objectstorage-s.jp-east-3.cloud.global.fujitsu.com

HTTPメソッドとURI#

POST

/v2/admin/accounts

HTTPステータスコード#

正常時:201

エラー時:400, 403, 404, 405, 409, 411, 412, 416, 422, 500, 501, 503

リクエストパラメータの説明#

名前 In Type デフォルト値
/必須指定
Description
X-Auth-Token header string 必須 認証のトークン
name body string 必須 作成するテナント名
制限値は以下です。
長さ:20byte以下
使用可能な文字種:
- 半角英数字
- +(プラス)
- =(等号)
- ,(カンマ)
- .(ドット)
- @(アットマーク)
- -(ハイフン)
- _(アンダースコア)
quotaObjectGigaBytes body integer 無制限
任意
このテナント内に格納できる最大byte数
GB単位で指定します。
「null」の文字列を指定した場合、または本パラメータを省略した場合は、ディスク使用量が無制限に設定されます。
📒注: 指定する値は上限値であり、実際に領域が確保されるわけではありません。
📒注: リクエストボディはJSON形式で指定してください。

レスポンスヘッダーの説明#

名前 Type Description
Date string トランザクションが実行された日時
Content-Type string MIME仕様で定義されているコンテントの形式
Content-Length string レスポンスボディのバイト数
X-Fcx-Endpoint-Request string このリクエストに付与されるID
トラブルについて問い合わせる際に利用されます。

レスポンスボディ(正常系)の説明#

名前 Type Description
apiVersion string APIの内部のバージョン番号
code string HTTPステータスコードと同じ内容が表示されます。
data object idからquotaObjectBytesまでを含むテナントデータの情報
id string テナント識別子
オブジェクトストレージ内で一意の識別子です。この識別子を利用してテナントの操作を実施します。
name string テナント名
quotaObjectBytes integer このテナント内に格納できる最大byte数
responseTime string 応答が生成された日時
status object 要求の結果
「success」または「error」が表示されます。

リクエスト例#

リクエストヘッダー

POST /v2/admin/accounts HTTP/1.1
User-Agent: curl/7.29.0
Host: objectstorage-s.jp-east-3.cloud.global.fujitsu.com
Accept: */*
X-Auth-Token:gAAAAABc236PN4N0X8JJZtdpB5XG5NPdoAMz6RsJSyF7VGsdoJDyBbs1lPStC0w74FkvHMrhWrm18p85bJcI
7ccfOuns5FN-v6QFHe1SLSdVL0Xf3-yiaON3cdZdD4Ogs8jydvUuGs4eyZWqzz-2csEC7nQFkSM_QT8SYE7kKEZQAqqtpC-zfxA
X-Auth-Token:gAAAAABc236PN4N0X8JJZtdpB5XG5NPdoAMz6RsJSyF7VGsdoJDyBbs1lPStC0w74FkvHMrhWrm18p85bJcI7ccfOuns5FN-v6QFHe1SLSdVL0Xf3-yiaON3cdZdD4Ogs8jydvUuGs4eyZWqzz-2csEC7nQFkSM_QT8SYE7kKEZQAqqtpC-zfxA

リクエストボディ

{
  "name": "fj-k5objt-tenant-90",
  "quotaObjectGigaBytes": 10
}

レスポンス例#

レスポンスヘッダー

HTTP/1.1 201 Created
Date: Wed, 15 May 2019 02:50:56 GMT
Content-Type: application/json
Content-Length: 189
Connection: keep-alive
Api-Version: 2
Cache-Control: private
Content-Security-Policy: frame-ancestors 'self'; block-all-mixed-content
Expires: Wed, 15 May 2019 02:50:56 GMT
Strict-Transport-Security: max-age=31536000; includeSubDomains
Vary: Api-Version
X-Content-Security-Policy: frame-ancestors: 'self'; block-all-mixed-content
X-Content-Type-Options: nosniff
X-Frame-Options: SAMEORIGIN
X-Fcx-Endpoint-Request: EXECUTED_api3-rmp2.management.jp-east-3.local-23283-40973-1_201

レスポンスボディ

{
    "apiVersion": "2.2",
    "code": 201,
    "data": {
        "id": "19750958992555654532",
        "name": "fj-k5objt-tenant-90",
        "quotaObjectBytes": 10737418240
    },
    "responseTime": "2019-05-15T02:50:56.511Z",
    "status": "success"
}