调用DescribeServiceMeshClusters接口获取服务网格的可用集群。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeServiceMeshClusters

系统规定参数。取值：DescribeServiceMeshClusters。

ServiceMeshId String 否 cb8963379255149cb98c8686f274x****

服务网格ID

返回数据

名称 类型 示例值 描述
RequestId String 31d3a0f0-07ed-4f6e-9004-1804498c****

请求ID
Clusters Array of Cluster

集群列表信息
SgId String sg-bp197668l6iupljy****

安全组ID
VpcId String vpc-8vbrwmt95b4zf6wf7****

专有网络ID
CreationTime String 2020-05-12T15:38:16+08:00

集群创建时间
UpdateTime String 2020-05-12T15:38:16+08:00

集群最后修改时间
ErrorMessage String fail

集群的异常信息
State String running

集群状态，取值：

  • running：运行中
  • starting ：启动中
  • stopping ：终止中
  • stopped：已停止
  • failed：失败
ServiceMeshId String cb8963379255149cb98c8686f274x****

服务网格ID
RegionId String cn-hangzhou

集群所在地域ID
ClusterDomain String c.com

集群域名
Version String v1.16.6-aliyun.1

集群版本号
ClusterType String Ask

集群类型
Name String ask1

集群名称
ClusterId String c80f45444b3da447da60a911390c2****

集群ID
ForbiddenFlag Long 0

数据面集群不能加入ASM的原因，取值：

  • 0：表示正常，可加入
  • 1：表示您没有集群的adminlevel权限
  • 2：集群和网格位于不同的VPC中，并且它们之间没有CEN
  • 3：集群的CIDR与网格冲突
  • 4：集群已具有名为istio system的命名空间

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeServiceMeshClusters
&ServiceMeshId=cb8963379255149cb98c8686f274x****
&公共请求参数

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeServiceMeshClustersResponse>
    <RequestId>31d3a0f0-07ed-4f6e-9004-1804498c****</RequestId>
    <Clusters>
        <SgId>sg-bp197668l6iupljy****</SgId>
        <VpcId>vpc-8vbrwmt95b4zf6wf7****</VpcId>
        <CreationTime>2020-05-12T15:38:16+08:00</CreationTime>
        <UpdateTime>2020-05-12T15:38:16+08:00</UpdateTime>
        <ErrorMessage>fail</ErrorMessage>
        <State>running</State>
        <ServiceMeshId>cb8963379255149cb98c8686f274x****</ServiceMeshId>
        <RegionId>cn-hangzhou</RegionId>
        <ClusterDomain>c.com</ClusterDomain>
        <Version>v1.16.6-aliyun.1</Version>
        <ClusterType>Ask</ClusterType>
        <Name>ask1</Name>
        <ClusterId>c80f45444b3da447da60a911390c2****</ClusterId>
        <ForbiddenFlag>0</ForbiddenFlag>
    </Clusters>
</DescribeServiceMeshClustersResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "31d3a0f0-07ed-4f6e-9004-1804498c****",
  "Clusters" : {
    "SgId" : "sg-bp197668l6iupljy****",
    "VpcId" : "vpc-8vbrwmt95b4zf6wf7****",
    "CreationTime" : "2020-05-12T15:38:16+08:00",
    "UpdateTime" : "2020-05-12T15:38:16+08:00",
    "ErrorMessage" : "fail",
    "State" : "running",
    "ServiceMeshId" : "cb8963379255149cb98c8686f274x****",
    "RegionId" : "cn-hangzhou",
    "ClusterDomain" : "c.com",
    "Version" : "v1.16.6-aliyun.1",
    "ClusterType" : "Ask",
    "Name" : "ask1",
    "ClusterId" : "c80f45444b3da447da60a911390c2****",
    "ForbiddenFlag" : 0
  }
}

错误码

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