全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
访问控制

UpdateGroup

更新时间:2017-06-07 13:26:11

接口描述

 更新用户组信息

请求参数

Action
  • 类型:String
  • 必须:是
  • 描述:操作名称,取值:UpdateGroup

GroupName

  • 类型:String
  • 必须:是
  • 描述:指定组名称
  • 格式:^[a-zA-Z0-9\-]+$

NewGroupName

  • 类型:String
  • 必须:否
  • 描述:新的组名
  • 格式:^[a-zA-Z0-9\-]+$

NewComments

  • 类型:String
  • 必须:否
  • 描述:新的备注信息, 最大长度128个字符。

返回参数

Group

需要的权限

Action

ram:UpdateGroup

Resource

acs:ram:*:${AccountId}:group/${GroupName}

错误信息

InvalidParameter.GroupName.InvalidChars
  • HTTP Status:400
  • Error Message:The parameter - "GroupName" contains invalid chars.
InvalidParameter.GroupName.Length
  • HTTP Status:400
  • Error Message:The parameter - "GroupName" beyond the length limit.
InvalidParameter.NewGroupName.InvalidChars
  • HTTP Status:400
  • Error Message:The parameter - "NewGroupName" contains invalid chars.
InvalidParameter.NewGroupName.Length
  • HTTP Status:400
  • Error Message:The parameter - "NewGroupName" beyond the length limit.
InvalidParameter.NewComments.Length
  • HTTP Status:400
  • Error Message:The parameter - "NewComments" beyond the length limit.
EntityNotExist.Group
  • HTTP Status:404
  • Error Message:The group does not exist.
EntityAlreadyExists.Group
  • HTTP Status:409
  • Error Message:The group does already EXIST.

操作示例

请求示例

https://ram.aliyuncs.com/?Action=UpdateGroup
&GroupName=Dev-Team
&NewGroupName=NewDev-Team
&<公共请求参数>

返回示例

XML格式

<UpdateGroupResponse>
    <RequestId>EC6647CC-0A36-EC7A-BA72-CC81BF3DE182</RequestId>
    <Group>
        <GroupName>NewDev-Team</GroupName>
        <Comments>开发团队</Comments>
        <CreateDate>2015-01-23T12:33:18Z</CreateDate>
        <UpdateDate>2015-01-23T12:33:18Z</UpdateDate>
    </Group>
</UpdateGroupResponse>

JSON格式

{
    "RequestId": "EC6647CC-0A36-EC7A-BA72-CC81BF3DE182",
    "Group": {
        "GroupName": "NewDev-Team",
        "Comments": "开发团队",
        "CreateDate" : "2015-01-23T12:33:18Z",
        "UpdateDate" : "2015-01-23T12:33:18Z"
    }
}
本文导读目录