745      阿裏雲

ListGroups__組管理接口_RAM API文檔_訪問控製-阿裏雲

接口描述

　列出所有的用戶組

請求參數

Action

• 類型：String
• 必須：是
• 描述：操作名稱，取值：ListGroups

Marker

• 名稱：Marker
• 類型：String
• 必須：否
• 描述：當請求的返回結果被截斷時，可以使用Marker獲取從當前截斷位置之後的內容

MaxItems

• 名稱：MaxIter
• 類型：Integer
• 必須：否
• 取值範圍：[1 - 1000]
• 默認值：100
• 描述：指定返回結果的條數，當返回結果達到MaxItems限製被截斷時，返回參數IsTruncated將等於true

返回參數

Groups

• 類型：Group Type Array
• 描述：組信息集合

IsTruncated

• 類型：Boolean
• 描述：請求返回結果是否被截斷

Marker

• 類型：String
• 描述：當IsTruncated為true時才有此字段，當返回true時，需要繼續調用此接口，並且使用Marker獲取截斷後的內容

需要的權限

Action

ram:ListGroups

Resource

acs:ram:*:${AccountId}:group/*

操作示例

請求示例

https://ram.aliyuncs.com/?Action=ListGroups
&<公共請求參數>

返回示例

XML格式

<ListGroupsResponse>
  <RequestId>065527AA-2F2E-AD7C-7484-F2626CFE4934</RequestId>
  <IsTruncated>true</IsTruncated>
  <Marker>EXAMPLE</Marker>
  <Groups>
    <Group>
      <GroupName>Dev-Team</GroupName>
      <Comments>開發團隊</Comments>
      <CreateDate>2015-01-23T12:33:18Z</CreateDate>
      <UpdateDate>2015-01-23T12:33:18Z</UpdateDate>
    </Group>
    <Group>
      <GroupName>QA-Team</GroupName>
      <Comments>測試團隊</Comments>
      <CreateDate>2015-02-18T17:22:08Z</CreateDate>
      <UpdateDate>2015-02-18T17:22:08Z</UpdateDate>
    </Group>
  </Groups>
</ListGroupsResponse>

JSON格式

{
    "RequestId": "065527AA-2F2E-AD7C-7484-F2626CFE4934",
    "IsTruncated": true,
    "Marker": "EXAMPLE",
    "Groups": {
        "Group": [
            {
                "GroupName": "Dev-Team",
                "Comments": "開發團隊",
                "CreateDate" : "2015-01-23T12:33:18Z",
                "UpdateDate" : "2015-01-23T12:33:18Z"
            },
            {
                "GroupName": "QA-Team",
                "Comments": "測試團隊",
                "CreateDate" : "2015-02-18T17:22:08Z",
                "UpdateDate" : "2015-02-18T17:22:08Z"
            }
        ]
    }
}

最後更新：2016-11-23 17:16:05

  上一篇： UpdateGroup__組管理接口_RAM API文檔_訪問控製-阿裏雲

  下一篇： DeleteGroup__組管理接口_RAM API文檔_訪問控製-阿裏雲