グループに所属するユーザーの参照 (GET /v3/groups/{group_id}/users{?name,enabled})
指定されたグループに所属しているユーザーの一覧を表示する。
Request Headers
Content-type
MIME仕様で定義されているコンテントの形式を示す。
application/jsonを指定する。(必須項目)
| Data Type | Cardinality | 
|---|---|
| xsd:string | 1..1 | 
Accept
MIME仕様で定義されているアクセプトの形式を示す。
application/jsonを指定する。(省略可)
| Data Type | Cardinality | 
|---|---|
| xsd:string | 1..1 | 
X-Auth-Token
有効な認証トークン
| Data Type | Cardinality | 
|---|---|
| xsd:string | 1..1 | 
Request Parameter
group_id
グループID(必須項目)
| Data Type | Cardinality | Parent Element | Child Element(s) | 
|---|---|---|---|
| xsd:string | 1..1 | なし | None | 
name
ユーザー名
| Data Type | Cardinality | Parent Element | Child Element(s) | 
|---|---|---|---|
| xsd:string | 0..1 | なし | None | 
enabled
有効設定
| Data Type | Cardinality | Parent Element | Child Element(s) | 
|---|---|---|---|
| xsd:boolean | 0..1 | なし | None | 
Response Headers
HTTPステータスコード
リクエストのHTTPステータスコードを返却する。
以下の値を返却する。
- 200:
- 正常終了
- 400:
- 不正なアクセス(パラメーター不正等)
- 401:
- 認証エラー
- 403:
- アクセス不可(権限がない)
- 404:
- 該当資源なし
- 409:
- データ競合が発生
- 500:
- 予期せぬエラー
- 501:
- 実装されていない
- 503:
- サービス利用不可
| Data Type | Cardinality | 
|---|---|
| int | 1..1 | 
Vary
以下のヘッダーを設定または変更することで、別のファイル形式で表現を要求できることを通知する。
X-Auth-Token
| Data Type | Cardinality | 
|---|---|
| xsd:string | 1..1 | 
Content-Type
MIME仕様で定義されているコンテントの形式を示す。
application/json
| Data Type | Cardinality | 
|---|---|
| xsd:string | 1..1 | 
Content-Length
エンティティの長さをバイトで示す。
| Data Type | Cardinality | 
|---|---|
| int | 1..1 | 
Date
作成された日付を示す。
| Data Type | Cardinality | 
|---|---|
| date | 1..1 | 
Response Elements
users
usersオブジェクト
| Data Type | Cardinality | Parent Element | Child Element(s) | 
|---|---|---|---|
| Element | 1..1 | なし | (user) | 
(user)
userオブジェクト(無名オブジェクト)
| Data Type | Cardinality | Parent Element | Child Element(s) | 
|---|---|---|---|
| Element | 1..n | users | default_project_id description domain_id enabled id name locale links | 
default_project_id
デフォルトプロジェクトID
| Data Type | Cardinality | Parent Element | Child Element(s) | 
|---|---|---|---|
| xsd:string | 1..1 | (user) | None | 
description
ユーザーの説明
| Data Type | Cardinality | Parent Element | Child Element(s) | 
|---|---|---|---|
| xsd:string | 1..1 | (user) | None | 
domain_id
ドメインID
| Data Type | Cardinality | Parent Element | Child Element(s) | 
|---|---|---|---|
| xsd:string | 1..1 | (user) | None | 
enabled
有効設定
| Data Type | Cardinality | Parent Element | Child Element(s) | 
|---|---|---|---|
| xsd:boolean | 1..1 | (user) | None | 
id
ユーザーID
| Data Type | Cardinality | Parent Element | Child Element(s) | 
|---|---|---|---|
| xsd:string | 1..1 | (user) | None | 
name
ユーザー名
| Data Type | Cardinality | Parent Element | Child Element(s) | 
|---|---|---|---|
| xsd:string | 1..1 | (user) | None | 
locale
メール通知言語
| Data Type | Cardinality | Parent Element | Child Element(s) | 
|---|---|---|---|
| xsd:string | 1..1 | (user) | None | 
links
ユーザーのリンク情報
| Data Type | Cardinality | Parent Element | Child Element(s) | 
|---|---|---|---|
| Element | 1..1 | (user) | self | 
links
APIのリンク情報
| Data Type | Cardinality | Parent Element | Child Element(s) | 
|---|---|---|---|
| Element | 1..1 | なし | self previous next | 
Example of Request
GET /v3/groups/--group-id--/users
X-Auth-Token: MIIIHgYJKoZIhvcNAQcCoIIIDzCCCAsCAQExC(省略)       
     Example of Response
HTTP/1.1 200 OK
Vary: X-Auth-Token
Content-Type: application/json
Content-Length: 492
Date: Wed, 03 Sep 2014 05:50:28 GMT
{
    "users": [
        {
            "default_project_id": "--project-id--",
            "description": "admin user",
            "domain_id": "--domain-id--",
            "enabled": true,
            "id": "--user-id--",
            "links": {
                "self": "http://identity.jp-east-1.cloud.global.fujitsu.com/v3/users/--user-id--"
            },
            "locale": "ja",
            "name": "admin"
        },
        {
            "default_project_id": "--project-id--",
            "description": "another user",
            "domain_id": "--domain-id--",
            "enabled": true,
            "id": "--user-id--",
            "links": {
                "self": "http://identity.jp-east-1.cloud.global.fujitsu.com/v3/users/--user-id--"
            },
            "locale": "ja",
            "name": "someone"
        }
    ],
    "links": {
        "self": "http://identity.jp-east-1.cloud.global.fujitsu.com/v3/groups/--group-id--/users",
        "previous": null,
        "next": null
    }
}