インターフェイス説明

ユーザーグループ情報を更新します。

リクエストパラメータ

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ステータスコード: 400
  • エラーメッセージ:パラメータ - 「GropuName」に無効な文字が含まれています。
InvalidParameter.GroupName.Length
  • HTTPステータスコード: 400
  • エラーメッセージ:パラメータ - 「GroupName」は長さの制限を超えています。
InvalidParameter.NewGroupName.InvalidChars
  • HTTPステータスコード: 400
  • エラーメッセージ:パラメータ - 「NewGroupName」に無効な文字が含まれています。
InvalidParameter.NewGroupName.Length
  • HTTPステータスコード: 400
  • エラーメッセージ:パラメータ - 「NewGroupName」は長さの制限を超えています。
InvalidParameter.NewComments.Length
  • HTTPステータスコード: 400
  • エラーメッセージ:パラメータ - 「NewComments」は長さの制限を超えています。
EntityNotExist.Group
  • HTTPステータスコード: 404
  • エラーメッセージ:グループは存在しません。
EntityAlreadyExists.Group
  • HTTPステータスコード: 409
  • エラーメッセージ:グループは既に存在しています。

操作の例

リクエストの例
https://ram.aliyuncs.com/?Action=UpdateGroup
&GroupName=Dev-Team
&NewGroupName=NewDev-Team
&<Public request parameters>
戻り値の例
  • XML形式
    <UpdateGroupResponse>
        <RequestId>EC6647CC-0A36-EC7A-BA72-CC81BF3DE182</RequestId>
        <Group>
            <GroupName>NewDev-Team</GroupName>
            <Comments>Development team</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": "Development team",
            "CreateDate" : "2015-01-23T12:33:18Z",
            "UpdateDate" : "2015-01-23T12:33:18Z"
        }