インターフェイス説明

ユーザーグループを作成します。

リクエストパラメータ

Action
  • Type:String
  • 必須項目:はい
  • 説明:操作の名前。 値:
    CreateGroup
GroupName
  • データ型:String
  • 必須項目:はい
  • 説明:グループの名前。 使用できる文字数は最大 64 文字です。
  • 形式:
    ^[a-zA-Z0-9\-]+$
Comments
  • データ型:String
  • 必須項目:いいえ
  • 説明:補足情報。 使用できる文字数は最大128文字です。

リターンパラメータ

Group

必要な権限

Action
ram:CreateGroup
Resource
acs:ram:*:${AccountId}:group/*

エラーメッセージ

InvalidParameter.GroupName.InvalidChars
  • HTTPステータスコード:400
  • エラーメッセージ:パラメータ - 「GroupName」に無効な文字が含まれています。
InvalidParameter.GroupName.Length
  • HTTPステータスコード:400
  • エラーメッセージ:パラメータ - 「GroupName」は長さの制限を超えています。
InvalidParameter.Comments.Length
  • HTTPステータスコード:400
  • エラーメッセージ:パラメータ - 「Comments」は長さの制限を超えています。
EntityAlreadyExists.Group
  • HTTPステータスコード:409
  • エラーメッセージ:グループは既に存在します。
LimitExceeded.Group
  • HTTPステータスコード:409
  • エラーメッセージ:グループ数は制限を超えています。

操作の例

リクエストの例
https://ram.aliyuncs.com/?Action=CreateGroup
&GroupName=Dev-Team
&Comments=Development team
&<Public request parameters>
戻り値の例
  • XML形式
    <CreateGroupResponse>
        <RequestId>D3F0679E-9757-95DB-AF2D-04D5188C69C5</RequestId>
        <Group>
            <GroupName>Dev-Team</GroupName>
            <Comments>Development team</Comments>
            <CreateDate>2015-01-23T12:33:18Z</CreateDate>
        </Group>
    </CreateGroupResponse>
  • JSON形式
    
        "RequestId": "D3F0679E-9757-95DB-AF2D-04D5188C69C5",
        "Group": {
            "GroupName": "Dev-Team",
            "Comments": "Development team",
            "CreateDate": "2015-01-23T12:33:18Z"
        }