インターフェイス説明

ユーザーグループ情報を取得します。

リクエストパラメータ

Action
  • データ型：String
  • 必須項目：はい
  • 説明：操作の名称。 値：
    GetGroup
GroupName
  • データ型：String
  • 必須項目：はい
  • 説明：グループの名称。 例：dev。
  • 形式：
    ^[a-zA-Z0-9\-]+$

リターンパラメータ

Group

必要な権限

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

エラーメッセージ

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

操作の例

リクエストの例
https://ram.aliyuncs.com/?Action=GetGroup
&GroupName=Dev-Team
&<Public request parameters>
戻り値の例
  • XML形式
    <GetGroupResponse>
    <RequestId>D4065824-E422-3ED6-68B1-1AF7D5C7804C</RequestId>
    <Group>
        <GroupName>Dev-Team</GroupName>
        <Comments>Development team</Comments>
        <CreateDate>2015-01-23T12:33:18Z</CreateDate>
        <UpdateDate>2015-02-11T03:15:21Z</UpdateDate>
    </Group>
</GetGroupResponse>
  • JSON形式
    
    "RequestId": "D4065824-E422-3ED6-68B1-1AF7D5C7804C",
    "Group": {
        "GroupName": "Dev-Team",
        "Comments": "Development team",
        "CreateDate": "2015-01-23T12:33:18Z",
        "UpdateDate": "2015-02-11T03:15:21Z"
    }