6.4. グループの取得

GET /1/(tenantId)/groups/(groupName)

グループ情報を取得する。

Request Headers:  

• X-Application-Id -- アプリケーションID(必須)
• X-Application-Key -- アプリケーションキー(必須)
• X-Session-Token -- セッショントークン(オプション)

Parameters:

• groupName (string) -- グループ名

Status Codes:

• 200 OK -- 正常取得した
• 401 Unauthorized -- 認証エラー
• 403 Forbidden -- 権限エラー
• 404 Not Found -- グループが存在しない

Response JSON Object:  

• _id (string) -- グループID
• name (string) -- グループ名
• users (array) -- 所属ユーザIDの一覧
• groups (array) -- 所属グループ名の一覧
• ACL (object) -- ACL
• createdAt (string) -- 作成日時
• updatedAt (string) -- 更新日時
• etag (string) -- ETag値

レスポンスの例

{
    "_id": "52116f01ac521e1742000001",
    "name": "group3",
    "users": [ "xxxxx", "yyyyy", "zzzzz" ],
    "groups" : [ "group2", "group3" ],
    "ACL": {/*ACL*/},
    "createdAt": "2013-08-27T04:37:30.000Z",
    "updatedAt": "2013-08-27T04:37:30.000Z",
    "etag": "8c92c97e-01a7-11e4-9598-53792c688d1b"
}

注意事項

• _GROUPS バケットのcontentACLおよび対象グループの read 権限が必要。