DescribeAckClusters - 查詢 ACK 叢集狀態 - Cloud Firewall

查詢阿里雲K8SContainer Service（ACK）叢集，查詢合格ACK叢集（例如指定叢集類型、叢集規格）列表資訊。

調試

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

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱	類型	必填	描述	樣本值
RegionNo	string	是	ACK 叢集地區 ID。	cn-hangzhou
MemberUid	string	否	ACK 叢集資源所屬的阿里雲 UID。	135809047715****
PageSize	string	是	分頁參數：每頁顯示條數。	10
PageNo	string	是	頁碼。	1
ClusterId	string	否	ACK 叢集 ID。	cb0f5640b1b2d404cad6ba21509d7847b
ClusterName	string	否	ACK 叢集名稱。	ack-cluster-name
ClusterSpec	string	否	ACK 叢集規格。枚舉值： ack.pro.small : 叢集 Pro 版	ack.pro.small
ConnectorStatus	string	否	ACK 叢集連接器執行個體狀態。	ready

返回參數

名稱	類型	描述	樣本值
	object
Clusters	array<object>	ACK 叢集列表。
	object	ACK 叢集。
MemberUid	string	ACK 叢集資源所屬的阿里雲 UID。	135809047715****
RegionId	string	ACK 叢集地區 ID。	cn-hangzhou
ClusterId	string	ACK 叢集 ID。	cb0f5640b1b2d404cad6ba21509d7847b
ClusterName	string	ACK 叢集名稱。	ack-cluster-name
ClusterType	string	ACK 叢集類型。取值來源： DescribeClustersV1 ：查看本帳號下合格 ACK 叢集（例如指定叢集類型、叢集規格）列表資訊。枚舉值： ExternalKubernetes : 註冊叢集。 ManagedKubernetes : ACK 託管類的叢集，包括 ACK 託管叢集（Pro 版、基礎版）、ACK Serverless 叢集（Pro 版、基礎版）、ACK Edge 叢集（Pro 版、基礎版）、ACK 靈駿叢集（Pro 版）。 Kubernetes : ACK 專有叢集。	ManagedKubernetes
Profile	string	當您選擇`cluster_type`為`ManagedKubernetes`時，即 ACK 託管類的叢集時，您可以進一步指定叢集的子類型。取值來源： DescribeClustersV1 ：查看本帳號下合格 ACK 叢集（例如指定叢集類型、叢集規格）列表資訊。枚舉值： Lingjun : ACK 靈駿叢集，提供 Pro 版。 Serverless : ACK Serverless 叢集，包括 ACK Serverless 叢集 Pro 版和 ACK Serverless 叢集基礎版。 Default : ACK 託管叢集，包括 ACK 叢集 Pro 版和 ACK 叢集基礎版。 Edge : ACK Edge 叢集，包括 ACK Edge 叢集 Pro 版和 ACK Edge 叢集基礎版。	Default
VpcId	string	ACK 叢集所屬 VPC 執行個體 ID。	vpc-2vcg932hsxsxuqbgl****
Network	string	ACK 叢集網路外掛程式。取值來源： DescribeClustersV1 ：查看本帳號下合格 ACK 叢集（例如指定叢集類型、叢集規格）列表資訊。枚舉值： terway-eniip : Terway-eniip Flannel : Flannel	terway-eniip
ClusterSpec	string	ACK 叢集規格。枚舉值： ack.pro.small : 叢集 Pro 版	ack.pro.small
State	string	ACK 叢集運行狀態。取值來源： DescribeClustersV1 ：查看本帳號下合格 ACK 叢集（例如指定叢集類型、叢集規格）列表資訊。枚舉值： running : 叢集運行中 scaling : 叢集伸縮中 stopped : 叢集已經停止運行 upgrading : 叢集升級中 updating : 叢集配置變更中 deleting : 叢集刪除中 deleted : 叢集已經被刪除 initial : 叢集建立中 draining : 節點排水中 delete_failed : 叢集刪除失敗 failed : 叢集建立失敗 removing : 節點移除中	running
PageNo	integer	頁碼。	1
PageSize	integer	分頁參數：每頁顯示條數。	10
RequestId	string	請求 ID。	C5DDD596-1191-5F36-A504-8733045A****
TotalCount	integer	總數。	1

樣本

正常返回樣本

JSON格式

{
  "Clusters": [
    {
      "MemberUid": "135809047715****",
      "RegionId": "cn-hangzhou",
      "ClusterId": "cb0f5640b1b2d404cad6ba21509d7847b",
      "ClusterName": "ack-cluster-name",
      "ClusterType": "ManagedKubernetes",
      "Profile": "Default",
      "VpcId": "vpc-2vcg932hsxsxuqbgl****",
      "Network": "terway-eniip",
      "ClusterSpec": "ack.pro.small",
      "State": "running"
    }
  ],
  "PageNo": 1,
  "PageSize": 10,
  "RequestId": "C5DDD596-1191-5F36-A504-8733045A****",
  "TotalCount": 1
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	ErrorParametersUid	The aliUid parameter is invalid.	aliUid 不合法
400	ErrorParameters	Parameters error.	參數錯誤。
400	ErrorDBSelect	An error occurred while querying database.	內部錯誤：資料庫查詢錯誤
400	ErrorRegionNo	regionNo error.	地區選擇錯誤，請重新輸入。
400	ErrorAckNotOpen	ACK service is not open.	ACK服務未開通。

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

變更歷史

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