UpdateGroup

Last Updated: Nov 10, 2017

Interface description

Updates user group information.

Request parameters

Action
  • Type: String
  • Required: Yes
  • Description: Operation name. Value: UpdateGroup

GroupName

  • Type: String
  • Required: Yes
  • Description: Group name.
  • Format: ^[a-zA-Z0-9\-]+$

NewGroupName

  • Type: String
  • Required: No
  • Description: New group name.
  • Format: ^[a-zA-Z0-9\-]+$

NewComments

  • Type: String
  • Required: No
  • Description: New remark information. It consists of a maximum of 128 characters.

Return parameters

Group

Required permissions

Action

ram:UpdateGroup

Resource

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

Error messages

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.

Operation examples

Request example

  1. https://ram.aliyuncs.com/?Action=UpdateGroup
  2. &GroupName=Dev-Team
  3. &NewGroupName=NewDev-Team
  4. &<Public request parameters>

Return example

XML format

  1. <UpdateGroupResponse>
  2. <RequestId>EC6647CC-0A36-EC7A-BA72-CC81BF3DE182</RequestId>
  3. <Group>
  4. <GroupName>NewDev-Team</GroupName>
  5. <Comments>Development team</Comments>
  6. <CreateDate>2015-01-23T12:33:18Z</CreateDate>
  7. <UpdateDate>2015-01-23T12:33:18Z</UpdateDate>
  8. </Group>
  9. </UpdateGroupResponse>

JSON format

  1. {
  2. "RequestId": "EC6647CC-0A36-EC7A-BA72-CC81BF3DE182",
  3. "Group": {
  4. "GroupName": "NewDev-Team",
  5. "Comments": "Development team",
  6. "CreateDate" : "2015-01-23T12:33:18Z",
  7. "UpdateDate" : "2015-01-23T12:33:18Z"
  8. }
  9. }
Thank you! We've received your feedback.