首页 容器服务 ACK 分布式云容器平台ACK One API参考指南 API目录 集群 DescribeHubClusterDetails - 获取主控集群详情

DescribeHubClusterDetails - 获取主控集群详情

获取ACKOne主控集群的详细信息 。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。
  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
    • 对于必选的资源类型，用背景高亮的方式表示。
    • 对于不支持资源级授权的操作，用全部资源表示。
  • 条件关键字：是指云产品自身定义的条件关键字。
  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
操作访问级别资源类型条件关键字关联操作
adcp:DescribeHubClusterDetailsRead
  • AckOne
    acs:adcp::{#accountId}:*
    无
无

请求参数

名称类型必填描述示例值
ClusterIdstring是

主控集群ID。

c676decda7b8148d69a9aba751877****

返回参数

名称类型描述示例值
object
RequestIdstring

请求ID。

52C1B7DF-96C1-5214-97B6-1B0859FEAFE5
Clusterobject

集群详情。

Endpointsobject

集群访问端点。

IntranetApiServerEndpointstring

API Server地址（内网）。

https://172.16.6.**:6443
PublicApiServerEndpointstring

API Server地址（公网）。

https://123.57.21.***:6443
ClusterInfoobject

集群详情。

Profilestring

集群配置信息。

Default
CreationTimestring

集群创建时间。

2022-03-23T06:22:28Z
UpdateTimestring

集群更新时间。

2022-03-21T02:51:35.542Z
ErrorMessagestring

集群创建失败的错误提示。

The specified product does not exist.
Versionstring

集群版本。

1.22.3-aliyun.1
Statestring

集群状态：

  • initial：初始化中
  • failed：创建失败
  • running：运行中
  • inactive：待激活
  • deleting：删除中
  • delete_failed：删除失败
  • deleted：已删除
running
ClusterIdstring

主控集群ID。

cb09fda0dc2f94a8397c76638c7ecf***
Namestring

集群名称。

ackone-heyuan
RegionIdstring

集群所在地域ID

cn-beijing
ClusterSpecstring

集群规格

  • ack.pro.small 基础版
ack.pro.small
Networkobject

集群的网络配置。

VpcIdstring

VPC的ID。

vpc-f8ziib1019r9o0hdv2***
VSwitchesarray

vSwitch列表。

string

交换机ID

["vsw-f8zubs2z9x1cjnzk29***"]
SecurityGroupIDsarray

关联的安全组ID。

string

关联的安全组ID。

["sg-f8zubs2z9x1cj***"]
IPStackstring

支持的IP版本

  • ipv4 支持ipv4
  • ipv6 支持ipv6
  • dual 同时支持ipv4和ipv6
ipv4
ClusterDomainstring

集群域名。

cluster.local
ApiServerobject

apiserver信息。

EnabledPublicboolean

是否开启公网API Server访问端点

  • true 开启公网访问端点
  • false 未开启公网访问端点
true
LoadBalancerIdstring

负载均衡实例id。

lb-hp3ioqbfeq37h13rwe***
ApiServerEipIdstring

EIP实例ID。

eip-abc****
MeshConfigobject

服务网格(ASM)配置

EnableMeshboolean

是否启用服务网格(ASM)

  • true 启用
  • false 未启用
false
MeshIdstring

服务网格(ASM)实例ID

cb09fda0dc2f94a8397c76638c7ecf***
LogConfigobject

日志配置信息。

EnableLogboolean

是否启用审计日志配置

  • true 启用
  • false 未启用
false
LogProjectstring

日志服务LogProject的名称。

k8s-log-abc
LogStoreTTLstring

日志存储天数

7
Conditionsarray

集群删除条件信息列表

object

集群删除条件信息对象

Typestring

删除条件类型

DeletionProtection
Statusstring

删除条件状态，取值

  • True 不能删除
  • False 允许删除
  • Unknow 未知
True
Reasonstring

删除条件原因

Successful
Messagestring

删除条件错误信息

Successful
WorkflowConfigobject

工作流集群配置信息

ArgoServerEnabledboolean

是否启用Argo Server UI。取值

  • true： 启用
  • false： 禁用
true
WorkflowScheduleModestring

工作流调度模式。取值

  • cost-optimized：成本优先
  • stock-optimized：库存优先
cost-optimized
PriceLimitstring

工作流负载价格限制。WorkflowScheduleMode取值为cost-optimized时生效。

0.08
WorkflowUnitsarray

集群工作流地域配置列表。

object

集群工作流地域配置。

RegionIdstring

地域ID。

cn-beijing
VpcIdstring

VPC的ID。

vpc-f8zukabbkv5aw7zkm****
VSwitchesarray

集群工作流交换机列表。

object

集群工作流交换机。

VswitchIdstring

交换机ID。

vsw-wz9sf0hsuizl7bxnj****
ZoneIdstring

可用区ID。

cn-hangzhou-e

示例

正常返回示例

JSON格式

{
  "RequestId": "52C1B7DF-96C1-5214-97B6-1B0859FEAFE5",
  "Cluster": {
    "Endpoints": {
      "IntranetApiServerEndpoint": "https://172.16.6.**:6443",
      "PublicApiServerEndpoint": "https://123.57.21.***:6443"
    },
    "ClusterInfo": {
      "Profile": "Default",
      "CreationTime": "2022-03-23T06:22:28Z",
      "UpdateTime": "2022-03-21T02:51:35.542Z",
      "ErrorMessage": "The specified product does not exist.",
      "Version": "1.22.3-aliyun.1",
      "State": "running",
      "ClusterId": "cb09fda0dc2f94a8397c76638c7ecf***",
      "Name": "ackone-heyuan",
      "RegionId": "cn-beijing",
      "ClusterSpec": "ack.pro.small "
    },
    "Network": {
      "VpcId": "vpc-f8ziib1019r9o0hdv2***",
      "VSwitches": [
        "[\"vsw-f8zubs2z9x1cjnzk29***\"]"
      ],
      "SecurityGroupIDs": [
        "[\"sg-f8zubs2z9x1cj***\"]"
      ],
      "IPStack": "ipv4",
      "ClusterDomain": "cluster.local"
    },
    "ApiServer": {
      "EnabledPublic": true,
      "LoadBalancerId": "lb-hp3ioqbfeq37h13rwe***",
      "ApiServerEipId": "eip-abc****"
    },
    "MeshConfig": {
      "EnableMesh": false,
      "MeshId": "cb09fda0dc2f94a8397c76638c7ecf***\n"
    },
    "LogConfig": {
      "EnableLog": false,
      "LogProject": "k8s-log-abc",
      "LogStoreTTL": "7"
    },
    "Conditions": [
      {
        "Type": "DeletionProtection",
        "Status": "True",
        "Reason": "Successful",
        "Message": "Successful"
      }
    ],
    "WorkflowConfig": {
      "ArgoServerEnabled": true,
      "WorkflowScheduleMode": "cost-optimized",
      "PriceLimit": "0.08",
      "WorkflowUnits": [
        {
          "RegionId": "cn-beijing",
          "VpcId": "vpc-f8zukabbkv5aw7zkm****",
          "VSwitches": [
            {
              "VswitchId": "vsw-wz9sf0hsuizl7bxnj****",
              "ZoneId": "cn-hangzhou-e"
            }
          ]
        }
      ]
    }
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2021-12-30新增 OpenAPI
阿里云首页 容器服务Kubernetes版 相关技术圈