调用DescribeServiceMeshUpgradeStatus查询ASM实例和ASM网关的升级状态。

调试

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

请求参数

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

系统规定参数。取值:DescribeServiceMeshUpgradeStatus

ServiceMeshId String 11fd0027-c27e-41bb-a565-75583054****

ASM实例ID

GuestClusterIds String caeac85a793c94afbbb0a4bb20320****

加入ASM实例管控的数据面集群ID列表,使用逗号分隔。

AllIstioGatewayFullNames String istio-system:ingressgateway1,istio-system:ingressgateway2

ASM网关的全限定名称列表。使用逗号分隔。

返回数据

名称 类型 示例值 描述
RequestId String 11fd0027-c27e-41bb-a565-75583054****

请求ID

UpgradeDetail Object

升级状态结果

FinishedGatewaysNum Long 1

升级完成的网关数目

MeshStatus String running

ASM实例状态,取值:

  • running:运行中
  • upgrading:升级中
  • upgrading_failed:升级失败
TotalGatewaysNum Long 2

所有的网关数目

GatewayStatusRecord Map

ASM网关状态记录

Object

ASM网关状态

Status String upgrading

ASM网关升级状态。取值:

  • upgrading:升级中
  • pending:升级等待中
  • finished:升级已完成
  • notStart:升级未开始
  • failed:升级失败
  • unknown:其他状态
Message String success

ASM网关实例的额外状态信息

Version String 1.9.7

ASM网关版本

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeServiceMeshUpgradeStatus
&ServiceMeshId=11fd0027-c27e-41bb-a565-75583054****
&GuestClusterIds=caeac85a793c94afbbb0a4bb20320****
&AllIstioGatewayFullNames=istio-system:ingressgateway1,istio-system:ingressgateway2
&公共请求参数

正常返回示例

XML格式

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

<DescribeServiceMeshUpgradeStatusResponse>
    <RequestId>11fd0027-c27e-41bb-a565-75583054****</RequestId>
    <UpgradeDetail>
        <FinishedGatewaysNum>1</FinishedGatewaysNum>
        <MeshStatus>running</MeshStatus>
        <TotalGatewaysNum>2</TotalGatewaysNum>
        <GatewayStatusRecord>
            <key>
                <Status>upgrading</Status>
                <Message>success</Message>
                <Version>1.9.7</Version>
            </key>
        </GatewayStatusRecord>
    </UpgradeDetail>
</DescribeServiceMeshUpgradeStatusResponse>

JSON格式

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

{
  "RequestId" : "11fd0027-c27e-41bb-a565-75583054****",
  "UpgradeDetail" : {
    "FinishedGatewaysNum" : 1,
    "MeshStatus" : "running",
    "TotalGatewaysNum" : 2,
    "GatewayStatusRecord" : {
      "key" : {
        "Status" : "upgrading",
        "Message" : "success",
        "Version" : "1.9.7"
      }
    }
  }
}

错误码

HttpCode 错误码 错误信息 描述
503 ERR404 Not found 不存在

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