使用ListAccessAssignments查詢授權列表-雲SSO-阿里雲

調用ListAccessAssignments查詢授權列表。

介面說明

本文將提供一個樣本，查詢在 RD 帳號114240524784****上的授權資訊。返回結果顯示，該 RD 帳號上存在一條授權記錄。

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

cloudsso:ListAccessAssignments

list

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
DirectoryId	string	是	目錄 ID。	d-00fc2p61****
AccessConfigurationId	string	否	訪問配置 ID，用於查詢的過濾條件。	ac-00jhtfl8thteu6uj****
TargetType	string	否	任務目標類型，用於查詢的過濾條件。取值：RD-Account，表示任務目標類型為 RD 帳號。說明 `TargetId`與`TargetType`必須同時配置才能作為有效過濾條件進行查詢。	RD-Account
TargetId	string	否	任務目標 ID，用於查詢的過濾條件。說明 `TargetId`與`TargetType`必須同時配置才能作為有效過濾條件進行查詢。	114240524784****
PrincipalType	string	否	雲 SSO 身份類型，用於查詢的過濾條件。取值： User：使用者。 Group：使用者組。說明 `PrincipalId`與`PrincipalType`必須同時配置才能作為有效過濾條件進行查詢。	User
PrincipalId	string	否	雲 SSO 身份 ID，用於查詢的過濾條件。具體如下：當`PrincipalType`為 User 時，`PrincipalId`為雲 SSO 使用者識別碼。當`PrincipalType`為 Group 時，`PrincipalId`為雲 SSO 使用者組 ID。說明 `PrincipalId`與`PrincipalType`必須同時配置才能作為有效過濾條件進行查詢。	u-00q8wbq42wiltcrk****
NextToken	string	否	查詢返回結果下一頁的令牌。首次調用 API 不需要`NextToken`。當您首次調用 API 時，如果返回資料總條數超過`MaxResults`限制，資料會被截斷，只返回`MaxResults`條資料，同時，返回參數`IsTruncated`為`true`，返回一個`NextToken`。您可以使用上一次返回的`NextToken`繼續調用 API，其他請求參數保持不變，查詢被截斷的資料。您可以按此方法多次查詢，直到`IsTruncated`為`false`，表示全部資料查詢完畢。	K1c3o9K7pFxoTtxH1Nm7MMLb7zrDGvftYBQBPDVv7AD3a8yhRb3Mk8L9ivmN6bFSjfkZNTAg3h4****
MaxResults	integer	否	每頁的最巨量資料條數。取值範圍：1~20。預設值：10。	10

返回參數

名稱	類型	描述	樣本值
	object	返回結果。
NextToken	string	查詢返回結果下一頁的令牌。說明只有`IsTruncated`為`true`，才顯示該參數。	K1c3o9K7pFxoTtxH1Nm7MMLb7zrDGvftYBQBPDVv7AD3a8yhRb3Mk8L9ivmN6bFSjfkZNTAg3h4****
RequestId	string	請求 ID。	66898413-EB80-556D-9429-06FE3548F672
MaxResults	integer	每頁的最巨量資料條數。	10
TotalCounts	integer	符合請求參數條件的資料總條數。	1
IsTruncated	boolean	返回結果是否被截斷。取值： true：已截斷。 false：未截斷。	false
AccessAssignments	array<object>	授權資訊列表。
	object	授權資訊列表。
AccessConfigurationName	string	訪問配置名稱。	ECS-Admin
TargetPathName	string	任務目標在資來源目錄中的路徑名稱。	rd-3G****/root/dev-test
PrincipalId	string	雲 SSO 身份 ID。	u-00q8wbq42wiltcrk****
TargetPath	string	任務目標在資來源目錄中的路徑 ID。	rd-3G**/r-Wm/114240524784**
CreateTime	string	授權成功的時間。	2021-11-04T10:03:08Z
TargetType	string	任務目標類型。取值：RD-Account，表示任務目標類型為 RD 帳號。	RD-Account
PrincipalName	string	雲 SSO 身份名稱。	Alice
TargetName	string	任務目標名稱。	dev-test
AccessConfigurationId	string	訪問配置 ID。	ac-00jhtfl8thteu6uj****
PrincipalType	string	雲 SSO 身份類型。取值： User：使用者。 Group：使用者組。	User
TargetId	string	任務目標 ID。	114240524784****

樣本

正常返回樣本

JSON格式

{
  "NextToken": "K1c3o9K7pFxoTtxH1Nm7MMLb7zrDGvftYBQBPDVv7AD3a8yhRb3Mk8L9ivmN6bFSjfkZNTAg3h4****",
  "RequestId": "66898413-EB80-556D-9429-06FE3548F672",
  "MaxResults": 10,
  "TotalCounts": 1,
  "IsTruncated": false,
  "AccessAssignments": [
    {
      "AccessConfigurationName": "ECS-Admin",
      "TargetPathName": "rd-3G****/root/dev-test",
      "PrincipalId": "u-00q8wbq42wiltcrk****",
      "TargetPath": "rd-3G****/r-Wm****/114240524784****",
      "CreateTime": "2021-11-04T10:03:08Z",
      "TargetType": "RD-Account",
      "PrincipalName": "Alice",
      "TargetName": "dev-test",
      "AccessConfigurationId": "ac-00jhtfl8thteu6uj****",
      "PrincipalType": "User",
      "TargetId": "114240524784****"
    }
  ]
}

錯誤碼

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

變更歷史

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