Create User#

指定したテナントにユーザーを作成します。

📒注: 「root」という名前のユーザーは作成できません。

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/{tenantID}/users

HTTPステータスコード#

正常時:201

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

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

名前 In Type デフォルト値
/必須指定
Description
tenantID path string 必須 テナント識別子
X-Auth-Token header string 必須 認証のトークン
uniqueName body string 必須 ユーザー名
uniqueName、fullNameに同じ情報がセットされます(レスポンスボディ部参照)。
制限値は以下です。
長さ:128Byte以下
使用可能な文字種:
- 半角英数字
- .(ドット)
- @(アットマーク)
- -(ハイフン)
- _(アンダースコア)
memberOf body array 任意 ユーザーを所属させるグループID(複数指定可)
指定しない場合、グループに所属しないユーザーが作成されます。
📒注: グループに所属していないユーザーは、オブジェクトとストレージにデータをput/getできません。作成後にグループに所属させてください(「Change User Information」参照)。
📒注: リクエストボディは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 accountIdからuserURNまでを含むユーザーデータの情報
accountId string テナント識別子
fullName string ユーザー名(表示用)
id string ユーザー識別子
オブジェクトストレージ内で一意の識別子です。この識別子を利用してユーザーの操作を実施します。
memberOf array ユーザを所属させるグループID(複数指定可)
uniqueName string ユーザー名
userURN string テナント識別子+ユーザー名
例:urn:sgws:identity::accountId:user/ユーザ名
responseTime string 応答が生成された日時
status object 要求の結果
「success」または「error」が表示されます。

リクエスト例#

リクエストヘッダー

POST /v2/admin/46799197538990820493/users HTTP/1.1
User-Agent: curl/7.29.0
Host: objectstorage-s.jp-east-3.cloud.global.fujitsu.com
Accept: */*
X-Auth-Token:gAAAAABc72i6Bskkj5zvEx8-JQo8hNnAa4RL0Ghi-uOijSpiVguEHvIzPwdxP-5tabj-m6-GBaQ1Xrz8wz4HE3Cyg1mhXmDSU0mEA4JQK3tSxawLLuacwrIBeL1oaurCaNZgD-X4zSlaLdvozwVP1EkWRpG4YQ5fTySZCW123UC7ZBAUvKTbPXI
Content-Length: 125
Content-Type: application/x-www-form-urlencoded

リクエストボディ

{
  "uniqueName": "testuser03",
  "memberOf": [
    "25aefd91-1d71-4e34-a3f8-55b54639cc2f",
    "57687db1-1faa-495d-8663-27bfe7f9c12b"
  ]
}

レスポンス例#

レスポンスヘッダー

HTTP/1.1 201 Created
Date: Thu, 30 May 2019 05:23:07 GMT
Content-Type: application/json
Content-Length: 394
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: Thu, 30 May 2019 05:23:07 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-28167-119089-1_201

レスポンスボディ

{
    "apiVersion": "2.2",
    "code": 201,
    "data": {
        "accountId": "46799197538990820493",
        "fullName": "testuser03",
        "id": "b15c5e23-4858-4489-ac19-b3c793aed9ee",
        "memberOf": [
            "25aefd91-1d71-4e34-a3f8-55b54639cc2f",
            "57687db1-1faa-495d-8663-27bfe7f9c12b"
        ],
        "uniqueName": "user/testuser03",
        "userURN": "urn:sgws:identity::46799197538990820493:user/testuser03"
    },
    "responseTime": "2019-05-30T05:23:07.727Z",
    "status": "success"
}