调用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 不存在

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