全部產品
Search
文件中心

Container Service for Kubernetes:DescribeHubClusters - 查詢已建立的艦隊Fleet執行個體列表

更新時間:Dec 22, 2025

擷取使用者ACK One艦隊Fleet執行個體列表。

調試

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

調試

授權資訊

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

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

adcp:DescribeHubClusters

list

*Cluster

acs:adcp::{#accountId}:cluster/*

請求參數

名稱

類型

必填

描述

樣本值

Profile

string

面向情境時的艦隊類型,取值:

  • Default:標準情境艦隊 Fleet 執行個體。

  • XFlow:工作流程情境艦隊 Fleet 執行個體。

預設值:Default

Default

ResourceGroupId

string

資源群組 ID

rg-aek3dinj3xkf***

Tag

array

標籤。最多支援指定 20 個標籤。

Tag

標籤。

返回參數

名稱

類型

描述

樣本值

object

響應結果。

RequestId

string

請求 ID。

2D676EFC-8C04-5CCE-A08E-BB97D24B47E8

Clusters

array<object>

叢集列表資訊

array<object>

叢集資訊列表。

Endpoints

object

叢集訪問端點。

IntranetApiServerEndpoint

string

API Server 地址(內網)。

https://172.16.6.**:6443

PublicApiServerEndpoint

string

API Server 地址(公網)。

https://123.57.21.***:6443

ClusterInfo

object

叢集詳情。

Profile

string

叢集配置資訊。

Default

CreationTime

string

叢集建立時間。

2021-11-05T10:25:48Z

UpdateTime

string

叢集最後更新時間。

2021-09-02T13:39:50Z

ErrorMessage

string

叢集建立失敗的錯誤提示。

Success

Version

string

叢集版本。

1.22.3-aliyun.1

State

string

叢集狀態:

  • initial:初始化中

  • failed:建立失敗

  • running:運行中

  • inactive:待啟用

  • deleting:刪除中

  • delete_failed:刪除失敗

  • deleted:已刪除

running

ClusterId

string

叢集 ID。

c2d3e0121ea214b438010502a8019****

Name

string

叢集名稱。

ackone-heyuan

RegionId

string

地區 ID。

cn-beijing

ClusterSpec

string

叢集規格

  • ack.pro.small 基礎版

ack.pro.small

ResourceGroupID

string

資源群組 ID。

rg-dt6rk4xm1r6***

Tags

array<object>

標籤列表。

object

標籤。

Key

string

標籤的鍵。

headername

Value

string

標籤的值。

release

Network

object

叢集的網路設定。

VpcId

string

叢集所屬的 VPC ID。

vpc-2zeusrwi7c2mlww4a****

VSwitches

array

叢集所屬的交換器 ID。

string

交換器 ID。

["vsw-2ze1h7tt2fgr1gxlx****"]

SecurityGroupIDs

array

安全性群組 id。

string

安全性群組 id。

["sg-2ze1h7tt2fgr****"]

ClusterDomain

string

叢集網域名稱。

cluster.local

ApiServer

object

apiserver 資訊。

EnabledPublic

boolean

是否開啟公網 API Server 訪問端點

  • true 開啟公網訪問端點

  • false 未開啟公網訪問端點

true

LoadBalancerId

string

關聯的Server Load Balancer執行個體 ID。

lb-bp1qyp4l6bscqxw69****

ApiServerEipId

string

EIP 執行個體 ID。

eip-xxx

MeshConfig

object

服務網格(ASM)配置

EnableMesh

boolean

是否啟用服務網格(ASM)

  • true 啟用

  • false 未啟用

false

MeshId

string

服務網格執行個體 ID

c2d3e0121ea214b438010502a8019****

LogConfig

object

日誌配置。

EnableLog

boolean

是否啟用審計日誌配置

  • true 啟用

  • false 停用

true

LogProject

string

Log Service LogProject 的名稱。

audit-log-abc

LogStoreTTL

string

日誌儲存天數

7

Conditions

array<object>

叢集刪除條件資訊列表

object

叢集刪除條件資訊對象

Type

string

刪除條件類型

DeletionProtection

Status

string

刪除條件狀態,取值

  • True 不能刪除

  • False 允許刪除

  • Unknow 未知

True

Reason

string

刪除條件原因

Successful

Message

string

刪除條件錯誤資訊

Successful!

樣本

正常返回樣本

JSON格式

{
  "RequestId": "2D676EFC-8C04-5CCE-A08E-BB97D24B47E8",
  "Clusters": [
    {
      "Endpoints": {
        "IntranetApiServerEndpoint": "https://172.16.6.**:6443\n",
        "PublicApiServerEndpoint": "https://123.57.21.***:6443\n"
      },
      "ClusterInfo": {
        "Profile": "Default",
        "CreationTime": "2021-11-05T10:25:48Z",
        "UpdateTime": "2021-09-02T13:39:50Z",
        "ErrorMessage": "Success",
        "Version": "1.22.3-aliyun.1\n",
        "State": "running",
        "ClusterId": "c2d3e0121ea214b438010502a8019****",
        "Name": "ackone-heyuan",
        "RegionId": "cn-beijing",
        "ClusterSpec": "ack.pro.small",
        "ResourceGroupID": "rg-dt6rk4xm1r6***",
        "Tags": [
          {
            "Key": "headername",
            "Value": "release"
          }
        ]
      },
      "Network": {
        "VpcId": "vpc-2zeusrwi7c2mlww4a****",
        "VSwitches": [
          "[\"vsw-2ze1h7tt2fgr1gxlx****\"]"
        ],
        "SecurityGroupIDs": [
          "[\"sg-2ze1h7tt2fgr****\"]\n"
        ],
        "ClusterDomain": "cluster.local"
      },
      "ApiServer": {
        "EnabledPublic": true,
        "LoadBalancerId": "lb-bp1qyp4l6bscqxw69****",
        "ApiServerEipId": "eip-xxx"
      },
      "MeshConfig": {
        "EnableMesh": false,
        "MeshId": "c2d3e0121ea214b438010502a8019****"
      },
      "LogConfig": {
        "EnableLog": true,
        "LogProject": "audit-log-abc",
        "LogStoreTTL": "7"
      },
      "Conditions": [
        {
          "Type": "DeletionProtection",
          "Status": "True",
          "Reason": "Successful",
          "Message": "Successful!"
        }
      ]
    }
  ]
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情