Querying a Mesh Upgrade Task

This API is used to query a mesh upgrade task.

For details, see Calling APIs.

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
If you are using identity policy-based authorization, the following identity policy-based permissions are required.
Action

Access Level

Resource Type (*: required)

Condition Key

Alias

Dependencies
asm:mesh:getUpgradeJob

Read

mesh *

g:EnterpriseProjectId

g:ResourceTag/<tag-key>

-

-

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
asm:mesh:getUpgradeJob	Read	mesh *	g:EnterpriseProjectId g:ResourceTag/<tag-key>	-	-

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

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID
job_id	Yes	String	Mesh upgrade task ID

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	API calling can be authenticated using a token or AK/SK. If you use a token, this parameter is mandatory and must be set to the token.

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
kind	String	API type. Fixed value: Job
apiVersion	String	API version. Fixed value: v3
metadata	MeshJobMetadata object	Basic information about a mesh job. Metadata is a collection of attributes.
spec	MeshJobSpec object	Attributes of a mesh job
status	MeshJobStatus object	Mesh job status

**Table 4** MeshJobSpec
Parameter	Type	Description
type	String	Job type
subjobs	Array of MeshJob objects	Sub-job information of a mesh job

**Table 5** MeshJob
Parameter	Type	Description
kind	String	API type. Fixed value: Job
apiVersion	String	API version. Fixed value: v3
metadata	MeshJobMetadata object	Basic information about a mesh job. Metadata is a collection of attributes.
spec	MeshJobSpec object	Attributes of a mesh job
status	MeshJobStatus object	Mesh job status

**Table 6** MeshJobMetadata
Parameter	Type	Description
uid	String	ID of a mesh job, which is unique. The value is automatically generated after the job is created. A custom value will not take effect.
creationTimestamp	String	Time when a mesh job is created
updateTimestamp	String	Time when a mesh job is updated

**Table 7** MeshJobStatus
Parameter	Type	Description
phase	String	Mesh job phase
reason	String	Reason why a mesh job is in the current phase
startTime	String	Start time of a mesh job
completionTime	String	Start time of a mesh job