インターフェイス説明

特定のユーザーグループ内のユーザーの一覧を表示します。

リクエストパラメータ

Action
  • データ型:String
  • 必須項目:はい
  • 説明:操作の名称。 値:
    ListUsersForGroup
GroupName
  • データ型:String
  • 必須項目:はい
  • 説明:グループの名称。 例:Dev-Team
Marker
  • 名称:Marker
  • データ型:String
  • 必須項目:いいえ
  • 説明:返された結果がインターセプトされた場合は、「Marker」を使用して、インターセプトされた戻り値の続きのコンテンツを取得できます。
MaxItems
  • 名称:MaxItems
  • データ型:Integer
  • 必須項目:いいえ
  • 値の範囲:「1~1000」
  • デフォルト値:100
  • 説明:戻り値の数。 返された結果が「MaxItems」の制限に達し、インターセプトされた場合、リターンパラメータIsTruncatedの値はtrueになります。

リターンパラメータ

Users
  • データ型:Userの配列
  • 説明:ユーザー情報の集合
IsTruncated
  • データ型:Boolean
  • 説明:戻り値がインターセプトされているかどうかを判断します。
Marker
  • データ型:String
  • 説明:このパラメータは、パラメータ IsTruncated の値がtrue の場合にのみ使用できます。 true の場合、このインターフェイスを起動し、Marker を使用して、インターセプトされた部分の続きのコンテンツを取得する必要があります。

必要な権限

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

エラーメッセージ

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

操作の例

リクエストの例
https://ram.aliyuncs.com/?Action=ListUsersForGroup
&GroupName=dev
&<Public request parameters>
戻り値の例
  • XML形式
    <ListUsersForGroupResponse>
      <RequestId>5756784B-79C4-E82E-24C2-FC3E171E5AB3</RequestId>
      <Users>
        <User>
          <UserId>1227489245380721</UserId>
          <UserName>zhangqiang</UserName>
          <DisplayName>zhangqiang</DisplayName>
          <JoinDate>2015-01-23T12:33:18Z</JoinDate>
        </User>
        <User>
          <UserId>1406498224724456</UserId>
          <UserName>lili</UserName>
          <DisplayName>lili</DisplayName>
          <JoinDate>2015-02-18T17:22:08Z</JoinDate>
        </User>
      </Users>
    </ListUsersForGroupResponse>
  • JSON形式
    
      "RequestId" : "4B450CA1-36E8-4AA2-8461-86B42BF4CC4E",
      "Users" : {
        "User" : [
          
            "UserId" : "1227489245380721",
            "UserName" : "zhangqiang",
            "DisplayName" : "zhangqiang",
            "JoinDate" : "2015-01-23T12:33:18Z"
          
          
            "UserId" : "1406498224724456",
            "UserName" : "lili",
            "DisplayName" : "lili",
            "JoinDate" : "2015-02-18T17:22:08Z"