文档首页/应用服务网格 ASM/API参考/API/网格升级/查询网格升级任务 - GetCanaryUpgradeJob
更新时间：2026-02-02 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询网格升级任务 - GetCanaryUpgradeJob

功能介绍

该API用于查询网格升级任务

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    asm:mesh:getUpgradeJob

    Read

    mesh *

    • g:EnterpriseProjectId

    • g:ResourceTag/<tag-key>

    -

    -

URI

GET /v1/{project_id}/mesh-job/{job_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID。

job_id

是

String

网格升级任务ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值。

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

kind

String

API类型，固定值“Job”，该值不可修改

apiVersion

String

API版本，固定值“v3”，该值不可修改

metadata

MeshJobMetadata object

网格任务的基本信息，为集合类的元素类型，包含一组由不同名称定义的属性

spec

MeshJobSpec object

网格任务属性

status

MeshJobStatus object

网格任务状态

表4 MeshJobSpec

参数

参数类型

描述

type

String

任务类型

subjobs

Array of MeshJob objects

网格任务子任务信息

表5 MeshJob

参数

参数类型

描述

kind

String

API类型，固定值“Job”，该值不可修改

apiVersion

String

API版本，固定值“v3”，该值不可修改

metadata

MeshJobMetadata object

网格任务的基本信息，为集合类的元素类型，包含一组由不同名称定义的属性

spec

MeshJobSpec object

网格任务属性

status

MeshJobStatus object

网格任务状态

表6 MeshJobMetadata

参数

参数类型

描述

uid

String

网格任务ID，资源唯一标识，创建成功后自动生成，填写无效

creationTimestamp

String

网格任务创建时间

updateTimestamp

String

网格任务更新时间

表7 MeshJobStatus

参数

参数类型

描述

phase

String

网格任务阶段

reason

String

网格任务处于当前阶段的原因

startTime

String

网格任务开始时间

completionTime

String

网格任务开始时间

请求示例

无

响应示例

无

状态码

状态码

描述

200

网格任务详情

404

升级任务不存在

错误码

请参见错误码。

父主题：网格升级

相关文档