更新用户组

功能介绍

该接口提供更新用户组信息的功能。

URI

• URI格式

  PATCH /v3/groups/{group_id}

• URI参数说明

  属性	是否必选	类型	说明
  group_id	是	String	用户组的ID。

请求

• Request Header参数说明

  参数	是否必选	类型	说明
  Content-Type	是	String	该字段内容填为“application/json;charset=utf8”。
  X-Auth-Token	是	String	已认证的拥有Security Administrator权限的token。

• Request Body参数说明

  参数	是否必选	类型	说明
  group	是	Object	group请求体。
  description	否	String	用户组的描述，长度小于等于255字符。
  domain_id	否	String	用户组所属domain的ID。
  name	否	String	用户组的名称，长度小于等于64字符。

• 请求样例

  curl -i -k -H 'Accept:application/json' -H 'Content-Type:application/json;charset=utf8' -H "X-Auth-Token:$token" -X PATCH -d'{"group": {"description": "Contract developers 2016"}}' https://sample.domain.com/v3/groups/aaec2abd4eba430fbf61541ffde76650

响应

• Response Body参数说明

  参数	是否必选	类型	说明
  group	是	Dict	用户组的响应体。
  description	是	String	用户组描述。
  domain_id	是	String	用户组所属domain的ID。
  id	是	String	用户组的ID。
  links	是	Dict	用户组的资源链接。
  name	是	String	用户组的名称。

• 响应样例

  {
    "group": {
      "domain_id": "d54061ebcb5145dd814f8eb3fe9b7ac0",
      "description": "Contract developers 2016",
      "id": "aaec2abd4eba430fbf61541ffde76650",
      "links": {
        "self": "https://sample.domain.com/v3/groups/aaec2abd4eba430fbf61541ffde76650"
      },
      "name": "jixiang1"
    }
  }

状态码