Change Tenant Information#

指定したテナント情報を変更します。

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#

PATCH

/v2/admin/accounts/{tenantID}

HTTPステータスコード#

正常時:200

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

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

名前 In Type デフォルト値
/必須指定
Description
tenantID path string 必須 テナント識別子
X-Auth-Token header string 必須 認証のトークン
tenantName 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の内部のバージョン番号
data object idからquotaObjectBytesまでを含むテナントデータの情報
id string テナント識別子
オブジェクトストレージ内で一意の識別子です。この識別子を利用してテナントの操作を実施します。
name string テナント名
quotaObjectBytes integer このテナント内に格納できる最大byte数
responseTime string 応答が生成された日時
status object 要求の結果
「success」または「error」が表示されます。

リクエスト例#

リクエストヘッダー

PATCH /v2/admin/accounts/46799197538990820493 HTTP/1.1
User-Agent: curl/7.29.0
Host: objectstorage-s.jp-east-3.cloud.global.fujitsu.com
Accept: */*
X-Auth-Token:gAAAAABc57PJ1V4uasjcivmTtzKYW5KKBBT2RxPq2NbVdwg9dUeo0s-9w1guvgsIbwOBYnBUDmx2j4lfZPMEIV9r1Hk6x4ohEOUSk_cT-PQakbjJb1zHyJw2cdqSQx46nuLKU9fMu3Me2a9GBhTbK71uxfAapjclxOUo4ZfJDeJ1eZYDAWR7H9Q
Content-Length: 58
Content-Type: application/x-www-form-urlencoded

リクエストボディ

{
  "tenantName": "test_tenant_1",
  "quotaObjectGigaBytes": 200
}

レスポンス例#

レスポンスヘッダー

HTTP/1.1 200 OK
Date: Fri, 24 May 2019 09:05:14 GMT
Content-Type: application/json
Content-Length: 173
Connection: keep-alive
Api-Version: 2
Cache-Control: private, no-cache, max-age=0
Content-Security-Policy: frame-ancestors 'self'; block-all-mixed-content
Expires: Fri, 24 May 2019 09:05:14 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_api2-rmp1.management.jp-east-3.local-16332-88740-1_200

レスポンスボディ

{
    "apiVersion": "2.2",
    "data": {
        "id": "46799197538990820493",
        "name": "test_tenant_1",
        "quotaObjectBytes": 214748364800
    },
    "responseTime": "2019-05-24T09:05:14.786Z",
    "status": "success"
}