DescribeUserPermission - 查詢RAM使用者或角色的叢集授權資訊 - Container Service for Kubernetes

在ACK叢集中，您可以建立並指定不同RAM使用者或角色擁有不同的存取權限，從而確保安全存取控制和資源隔離。您可以調用DescribeUserPermission介面查詢RAM使用者或角色擁有的叢集許可權詳情，包括可訪問的資源、許可權的作用範圍、預置的角色類型、許可權來源等。

介面說明

注意事項：

如果調用該 API 的帳號為 RAM 使用者或 RAM 角色，則 API 將僅能返回調用帳號有 RBAC 管理員權限的叢集對應的許可權。如您需要該 API 列出所有叢集的許可權，則調用帳號需具備所有叢集的 RBAC 管理員權限。

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

cs:GetUserPermissions

get

*全部資源

*

無

請求文法

GET /permissions/users/{uid} HTTP/1.1

路徑參數

名稱	類型	必填	描述	樣本值
uid	string	是	指定 RAM 使用者或 RAM 角色的 ID。若查詢 RAM 使用者權限，則使用 RAM 使用者的 UID。若查詢 RAM 角色許可權，則使用 RAM 角色的 ID。	206945240368******

請求參數

名稱

類型

必填

描述

樣本值

當前API無需請求參數

返回參數

名稱	類型	描述	樣本值
	array	返回體參數。
	object	RAM 使用者叢集授權詳情。
resource_id	string	叢集訪問配置，格式為：當是叢集維度授權時，格式為：`{cluster_id}`。當是命名空間維度授權時，格式為：`{cluster_id}/{namespace}`。當是所有叢集授權時，值固定為：`all-clusters`。	c1b542****
resource_type	string	授與類型，取值： `cluster`：叢集維度。 `namespace`：命名空間維度。 `console`：所有叢集維度授權。	cluster
role_name	string	自訂角色名稱，當授權自訂角色時，該欄位為指定的自訂叢集管理角色名稱。	terway-pod-reader
role_type	string	預置的角色類型，取值： `admin`：管理員。 `ops`：營運人員。 `dev`：開發人員。 `restricted`：受限使用者。 `custom`：使用自訂的叢集管理角色。	admin
is_owner	integer	是否為叢集建立者的授權，取值： `0`：代表不是叢集建立者的授權記錄。 `1`：代表該授權記錄為叢集建立者的管理員權限。	1
is_ram_role	integer	是否為 RAM 角色授權，取值： `0`：代表目前記錄不是 RAM 角色授權。 `1`：代表目前記錄是 RAM 角色授權。	1

未在參數列表中展示的 parent_id 參數已廢棄，請勿使用。

樣本

正常返回樣本

JSON格式

[
  {
    "resource_id": "c1b542****",
    "resource_type": "cluster",
    "role_name": "terway-pod-reader",
    "role_type": "admin",
    "is_owner": 1,
    "is_ram_role": 1
  }
]

錯誤碼

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

變更歷史

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