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" }