调用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
  }
}

错误码

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