Queries the details of an image creation task.
Operation description
- The image template that is specified by the
ImagePipelineId
parameter cannot be a deleted image template. When an image template is deleted, the corresponding image creation task is deleted. - You must specify
ImagePipelineId
orExecutionId
. - You can configure the query token by using the
NextToken
parameter. Set the value of NextToken to the value ofNextToken
that was returned the last time you called theDescribeImagePipelineExecutions
operation. Then, use theMaxResults
parameter to specify the maximum number of entries to return on each page to query the details of the image creation task.
Debugging
Authorization information
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
RegionId | string | Yes | The region ID. You can call the DescribeRegions operation to query the most recent region list. | cn-hangzhou |
Tag | object [] | No | Note
This parameter is not publicly available.
| |
Key | string | No | Note
This parameter is not publicly available.
| null |
Value | string | No | Note
This parameter is not publicly available.
| null |
ImagePipelineId | string | No | The ID of the image template. | ip-2ze5tsl5bp6nf2b3**** |
ExecutionId | string | No | The ID of the image creation task. | exec-5fb8facb8ed7427c**** |
Status | string | No | The status of the image creation task. You can specify multiple values. Separate the values with commas (,). Example:
Note
If you want to query the image creation tasks in all states, specify all values.
| BUILDING |
NextToken | string | No | The pagination token that is used in the request to retrieve a new page of results. You do not need to specify this parameter for the first request. You must specify the token that is obtained from the previous query as the value of | AAAAAdDWBF2**** |
MaxResults | integer | No | The maximum number of entries per page. Valid values: 1 to 500. Default value: 50. | 50 |
Response parameters
Examples
Sample success responses
JSON
format
{
"NextToken": "AAAAAdDWBF2****",
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"TotalCount": 1,
"MaxResults": 50,
"ImagePipelineExecution": {
"ImagePipelineExecutionSet": [
{
"CreationTime": "2020-11-24T06:00:00Z",
"ImagePipelineId": "ip-2ze5tsl5bp6nf2b3****",
"Status": "BUILDING",
"ModifiedTime": "2020-11-25T06:00:00Z",
"ResourceGroupId": "rg-bp67acfmxazb4p****",
"Message": "Create transition vpc \"vpc-2ze70rc7093j9idu6****\" success!",
"ImageId": "m-bp67acfmxazb4p****",
"ExecutionId": "exec-5fb8facb8ed7427c****",
"Tags": {
"Tag": [
{
"TagValue": "null",
"TagKey": "null"
}
]
}
}
]
}
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | InvalidParameter.Status | %s | - |
400 | MissingParameter.ImagePipelineId | The specified parameter ImagePipelineId should not be empty. | The specified parameter ImagePipelineId should not be empty. |
403 | Invalid.NextToken | The specified NextToken is not valid. | - |
404 | InvalidImagePipeline.NotFound | %s | - |
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation | ||||||||
---|---|---|---|---|---|---|---|---|---|---|
2023-04-04 | The Error code has changed | see changesets | ||||||||
|