如果您需要查看當前叢集的存取控制情況，您可以調用ListClusterKubeconfigStates介面來擷取當前叢集已下發使用者KubeConfig的列表以及狀態。
介面說明
使用該介面需要擁有 ram:ListUsers 和 ram:ListRoles 許可權
使用該介面需要擁有管理Container Service（CS）的許可權（AliyunCSFullAccess）
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
cs:ListClusterKubeconfigStates |
none |
*Cluster
|
無 | 無 |
請求文法
GET /clusters/{ClusterId}/kubeconfig/states HTTP/1.1路徑參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| ClusterId |
string |
否 |
叢集 ID。 |
c82e6987e2961451182edacd74faf**** |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| pageNumber |
integer |
否 |
頁碼。
|
1 |
| pageSize |
integer |
否 |
每頁記錄數。
|
10 |
| cloudServiceKubeConfig |
boolean |
否 |
是否查詢叢集內雲產品服務角色 KubeConfig 列表
枚舉值：
|
true |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
響應體參數。 |
||
| states |
array<object> |
叢集關聯的 KubeConfig 狀態列表。 |
|
|
array<object> |
|||
| account_id |
string |
阿里雲帳號、RAM 使用者或角色 ID。 |
22855***************** |
| account_name |
string |
RAM 使用者登入名稱稱或角色名稱。 |
tom |
| account_display_name |
string |
RAM 使用者顯示名稱或角色名稱。 |
tom |
| account_type |
string |
帳號類型。
|
RamUser |
| account_state |
string |
帳號狀態。
|
Active |
| cert_expire_time |
string |
KubeConfig 用戶端認證到期時間。 |
2027-07-15T01:32:20Z |
| cert_state |
string |
KubeConfig 用戶端認證狀態。
|
Expired |
| revokable |
boolean |
KubeConfig 用戶端認證是否可吊銷。 |
true |
| cloud_service_name |
string |
雲產品名稱 |
cs/ecs/sls |
| cloud_service_roles |
array<object> |
叢集雲產品服務角色關聯的叢集角色列表 |
|
|
object |
叢集雲產品服務角色關聯的叢集角色資訊 |
||
| type |
string |
叢集雲產品服務角色關聯的叢集角色類型 枚舉值：
|
ClusterRole |
| role_name |
string |
叢集雲產品服務角色關聯的叢集角色名稱 |
cluster-admin |
| role_namespace |
string |
叢集雲產品服務角色關聯的叢集角色命名空間 |
kube-system |
| is_default_template |
boolean |
內容是否與預設的叢集角色模板一致
|
|
| page |
object |
分頁資訊。 |
|
| page_number |
integer |
頁碼。 |
1 |
| page_size |
integer |
每頁包含的最大記錄數量。 |
10 |
| total_count |
integer |
結果總數。 |
5 |
樣本
正常返回樣本
JSON格式
{
"states": [
{
"account_id": "22855*****************",
"account_name": "tom",
"account_display_name": "tom",
"account_type": "RamUser",
"account_state": "Active",
"cert_expire_time": "2027-07-15T01:32:20Z",
"cert_state": "Expired",
"revokable": true,
"cloud_service_name": "cs/ecs/sls",
"cloud_service_roles": [
{
"type": "ClusterRole",
"role_name": "cluster-admin",
"role_namespace": "kube-system",
"is_default_template": true
}
]
}
],
"page": {
"page_number": 1,
"page_size": 10,
"total_count": 5
}
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。