调用DescribeManagedClusters查询已添加的子集群列表_容器服务 Kubernetes 版 ACK(ACK)-阿里云帮助中心

获取ACK One主控集群下的子集群列表。

调试

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

授权信息

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

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

操作	访问级别	资源类型	条件关键字	关联操作
adcp:DescribeManagedClusters	list	全部资源 ``	无	无

请求参数

名称	类型	必填	描述	示例值
ClusterId	string	是	主控集群 ID。	c2f41fd4599454a9c9ad8b3daafe8****

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	BDA85C7A-FC81-56C4-9BC2-9112EE970059
Clusters	array<object>	集群信息列表。
Cluster	object	集群详细信息。
Cluster	object	集群信息。
Name	string	集群名称。	ackone-heyuan
ClusterID	string	集群 ID。	c2f41fd4599454a9c9ad8b3daafe8****
Region	string	集群所在地域。	cn-hangzhou
State	string	子集群状态： `initial`：初始化中。 `failed`：创建失败。 `running`：运行中。 `inactive`：待激活。 `deleting`：删除中。 `delete_failed`：删除失败。 `deleted`：已删除。	running
ClusterType	string	集群类型。	One
Created	string	集群的创建时间。	2022-03-23T06:22:28Z
Updated	string	集群更新时间。	2022-03-23T06:22:28Z
InitVersion	string	集群的初始版本号。	1.20.4-aliyun.1
CurrentVersion	string	集群的最新版本号。	1.22.3-aliyun.1
ResourceGroupId	string	资源组 ID。	rg-acfmx7o7ewy****
VpcID	string	VPC ID。	vpc-bp1fhizs9fxuvit06****
VSwitchID	string	虚拟交换机 ID。	vsw-m5e0pbkgmhvzecf7e****
Profile	string	集群标识。	Default
ClusterSpec	string	集群规格。`ack.pro.small`表示基础版。	ack.pro.small
Status	object	子集群在主控集群中的状态。
State	string	子集群在主控集群中的状态： `Installing`：添加中。 `Successed`：添加成功。 `Failed`：添加失败。 `Deleting`: 移除中 `Deleted`：已移除。	Successed
Message	string	状态信息。	SUCCESS
MeshStatus	object	子集群在服务网格中的状态。
InMesh	boolean	子集群是否在服务网格中，取值： `true`：子集群在服务网格实例中。 `false`：子集群不在服务网格实例中。	true

示例

正常返回示例

JSON格式

{
  "RequestId": "BDA85C7A-FC81-56C4-9BC2-9112EE970059",
  "Clusters": [
    {
      "Cluster": {
        "Name": "ackone-heyuan",
        "ClusterID": "c2f41fd4599454a9c9ad8b3daafe8****",
        "Region": "cn-hangzhou",
        "State": "running",
        "ClusterType": "One",
        "Created": "2022-03-23T06:22:28Z\n",
        "Updated": "2022-03-23T06:22:28Z\n",
        "InitVersion": "1.20.4-aliyun.1\n",
        "CurrentVersion": "1.22.3-aliyun.1\n",
        "ResourceGroupId": "rg-acfmx7o7ewy****",
        "VpcID": "vpc-bp1fhizs9fxuvit06****",
        "VSwitchID": "vsw-m5e0pbkgmhvzecf7e****",
        "Profile": "Default",
        "ClusterSpec": "ack.pro.small"
      },
      "Status": {
        "State": "Successed",
        "Message": "SUCCESS"
      },
      "MeshStatus": {
        "InMesh": true
      }
    }
  ]
}

错误码

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

变更历史

变更时间	变更内容概要	操作
2021-12-30	新增 OpenAPI	查看变更详情