インターフェイス説明

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

リクエストパラメータ

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"