All Products
Search
Document Center

Elastic Compute Service:DescribeImagePipelineExecutions

Last Updated:Mar 19, 2024

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 or ExecutionId.
  • You can configure the query token by using the NextToken parameter. Set the value of NextToken to the value of NextToken that was returned the last time you called the DescribeImagePipelineExecutions operation. Then, use the MaxResults parameter to specify the maximum number of entries to return on each page to query the details of the image creation task.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
RegionIdstringYes

The region ID. You can call the DescribeRegions operation to query the most recent region list.

cn-hangzhou
Tagobject []No
Note This parameter is not publicly available.
KeystringNo
Note This parameter is not publicly available.
null
ValuestringNo
Note This parameter is not publicly available.
null
ImagePipelineIdstringNo

The ID of the image template.

ip-2ze5tsl5bp6nf2b3****
ExecutionIdstringNo

The ID of the image creation task.

exec-5fb8facb8ed7427c****
StatusstringNo

The status of the image creation task. You can specify multiple values. Separate the values with commas (,). Example: BUILDING,DISTRIBUTING. Valid values:

  • BUILDING
  • DISTRIBUTING
  • RELEASING
  • SUCCESS
  • FAILED
  • CANCELLING
  • CANCELLED
Note If you want to query the image creation tasks in all states, specify all values.
BUILDING
NextTokenstringNo

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 NextToken.

AAAAAdDWBF2****
MaxResultsintegerNo

The maximum number of entries per page. Valid values: 1 to 500.

Default value: 50.

50

Response parameters

ParameterTypeDescriptionExample
object
NextTokenstring

A pagination token. It can be used in the next request to retrieve a new page of results. If NextToken is empty, no next page exists. For information about how to use the returned value, see the "Usage notes" section in this topic.

AAAAAdDWBF2****
RequestIdstring

The request ID.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
TotalCountinteger

The total number of returned image components.

1
MaxResultsinteger

The maximum number of entries per page.

50
ImagePipelineExecutionobject []

Details of the image creation task.

CreationTimestring

The time when the image creation task was created.

2020-11-24T06:00:00Z
ImagePipelineIdstring

The ID of the image template.

ip-2ze5tsl5bp6nf2b3****
Statusstring

The status of the image creation task. Valid values:

  • BUILDING
  • DISTRIBUTING
  • RELEASING
  • SUCCESS
  • FAILED
  • CANCELLING
  • CANCELLED
BUILDING
ModifiedTimestring

The last modification time of the image creation task.

2020-11-25T06:00:00Z
ResourceGroupIdstring

The ID of the resource group.

rg-bp67acfmxazb4p****
Messagestring

The data returned.

Create transition vpc "vpc-2ze70rc7093j9idu6****" success!
ImageIdstring

The ID of the image.

m-bp67acfmxazb4p****
ExecutionIdstring

The ID of the image creation task.

exec-5fb8facb8ed7427c****
Tagsobject []
Note This parameter is not publicly available.
TagValuestring
Note This parameter is not publicly available.
null
TagKeystring
Note This parameter is not publicly available.
null

Examples

Sample success responses

JSONformat

{
  "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 codeError codeError messageDescription
400InvalidParameter.Status%s-
400MissingParameter.ImagePipelineIdThe specified parameter ImagePipelineId should not be empty.The specified parameter ImagePipelineId should not be empty.
403Invalid.NextTokenThe specified NextToken is not valid.-
404InvalidImagePipeline.NotFound%s-

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2023-04-04The Error code has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    Error Codes 400 change
    delete Error Codes: 403
    delete Error Codes: 404