ListUserBasicInfos查詢RAM使用者基本資料-存取控制-阿里雲 - Resource Access Management

介面說明

您可以通過以下兩個 API 查詢所有 RAM 使用者的資訊，區別如下：

ListUsers：查詢 RAM 使用者的詳細資料。
ListUserBasicInfos：查詢 RAM 使用者的基本資料，僅包括 RAM 使用者登入名稱稱UserPrincipalName、RAM 使用者顯示名稱DisplayName和 RAM 使用者識別碼UserId。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ram:ListUserBasicInfos

list

*User

acs:ram::{#accountId}:user/*

無

請求參數

名稱	類型	必填	描述	樣本值
Marker	string	否	當請求的返回結果被截斷時，可以使用`Marker`擷取從當前截斷位置之後的內容。	EXAMPLE
MaxItems	integer	否	返回結果的條數。當返回結果達到`MaxItems`限制被截斷時，返回參數`IsTruncated`將等於`true`。取值範圍：1~1000。預設值：100。	100
Tag	array<object>	否	標籤列表。
	object	否	標籤列表。
Key	string	否	標籤鍵。 N 的取值範圍：1~20，N 必須連續。	operator
Value	string	否	標籤值。 N 的取值範圍：1~20，N 必須連續。	alice
Status	string	否	指定查詢的使用者狀態，支援 active，freeze 狀態。指定全部狀態時使用逗號拼接，如：active,freeze。未指定狀態時預設指定 active 狀態。使用 Tag 標籤時，不支援指定 status 查詢，預設查詢全部狀態的使用者。	active

返回參數

名稱	類型	描述	樣本值
	object	返回結果。
RequestId	string	請求 ID。	EF2B25FD-CADE-445B-BE4D-E082E0FF1A0F
IsTruncated	boolean	請求返回結果是否被截斷。取值： true：已截斷。 false：未截斷。	true
UserBasicInfos	object
UserBasicInfo	array<object>	RAM 使用者的基本資料。
	object	RAM 使用者的基本資料。
UserPrincipalName	string	RAM 使用者的登入名稱稱。	test@example.onaliyun.com
DisplayName	string	RAM 使用者的顯示名稱。	test
UserId	string	RAM 使用者識別碼。	20732900249392****
Status	string	RAM 使用者的使用者狀態。	active
Marker	string	當`IsTruncated`為`true`時才有此參數，當返回`true`時，需要繼續調用此介面，並且使用`Marker`擷取截斷後的內容。	EXAMPLE

樣本

正常返回樣本

JSON格式

{
  "RequestId": "EF2B25FD-CADE-445B-BE4D-E082E0FF1A0F",
  "IsTruncated": true,
  "UserBasicInfos": {
    "UserBasicInfo": [
      {
        "UserPrincipalName": "test@example.onaliyun.com",
        "DisplayName": "test",
        "UserId": "20732900249392****",
        "Status": "active"
      }
    ]
  },
  "Marker": "EXAMPLE"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。