ListUserKubeConfigStates - 擷取指定使用者所有叢集的 KubeConfig 狀態列表 - Container Service for Kubernetes

如果您需要查看目前使用者各個叢集KubeConfig的下發情況，您可以調用ListUserKubeConfigStates介面來擷取目前使用者所有叢集的KubeConfig狀態列表。

介面說明

說明

使用該介面需要擁有管理Container Service（CS）的許可權（AliyunCSFullAccess）

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

cs:ListUserKubeConfigStates

none

*全部資源

*

無

請求文法

GET /users/{Uid}/kubeconfig/states HTTP/1.1

路徑參數

名稱	類型	必填	描述	樣本值
Uid	string	否	阿里雲帳號內指定 RAM 使用者或 RAM 角色 ID。	206945240368******

請求參數

名稱	類型	必填	描述	樣本值
page_number	integer	否	當前頁數。取值範圍：大於等於 1。預設值：1。	2
page_size	integer	否	每頁返回的結果數。取值範圍：1-100。預設值：50。	10

返回參數

名稱	類型	描述	樣本值
	object	返回體參數。
states	array<object>	使用者 KubeConfig 狀態詳情。
	object
cluster_id	string	叢集 ID。	c5b5e80b0b64a4bf6939d2d8fbbc5****
cert_expire_time	string	KubeConfig 認證到期時間。格式：RFC3339 格式的 UTC 時間。	2028-04-09T06:20:47Z
cert_state	string	KubeConfig 認證目前狀態。包含以下狀態： Expired: 認證已到期 Unexpired: 認證未到期 Unissued: 認證未頒發 Unknown: 未知狀態 Removed: 已清除（認證存在頒發記錄）	Unissued
cluster_state	string	叢集運行狀態，取值： `initial`：叢集建立中。 `failed`：叢集建立失敗。 `running`：叢集運行中。 `updating`：叢集升級中。 `updating_failed`：叢集升級失敗。 `scaling`：叢集擴縮容中。 `stopped`：叢集已經停止運行。 `deleting`：叢集刪除中。 `deleted`：叢集已經被刪除。 `delete_failed`：叢集刪除失敗。	running
cluster_name	string	叢集名稱。	cluster-demo
page	object	分頁參數。
page_number	integer	當前頁數。	1
page_size	integer	每頁返回的記錄數。	10
total_count	integer	結果總數。	100

樣本

正常返回樣本

JSON格式

{
  "states": [
    {
      "cluster_id": "c5b5e80b0b64a4bf6939d2d8fbbc5****\n",
      "cert_expire_time": "2028-04-09T06:20:47Z",
      "cert_state": "Unissued",
      "cluster_state": "running",
      "cluster_name": "cluster-demo"
    }
  ],
  "page": {
    "page_number": 1,
    "page_size": 10,
    "total_count": 100
  }
}

錯誤碼

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

變更歷史

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