686      阿里云  技术社区[云栖]

UpdateGroup__组管理接口_RAM API文档_访问控制-阿里云

接口描述

　更新用户组信息

请求参数

Action

• 类型：String
• 必须：是
• 描述：操作名称，取值：UpdateGroup

GroupName

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

NewGroupName

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

NewComments

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

返回参数

Group

• 类型：Group Type
• 描述：组信息

需要的权限

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

最后更新：2016-11-23 17:16:05

  上一篇： GetGroup__组管理接口_RAM API文档_访问控制-阿里云

  下一篇： ListGroups__组管理接口_RAM API文档_访问控制-阿里云