All Products
Search
Document Center

Elastic Compute Service:StartImagePipelineExecution

Last Updated:Mar 19, 2024

Executes a pipeline task by using an image template.

Operation description

  • After you create an image template, you can call the StartImagePipelineExecution operation to create a pipeline task. The system creates, copies, and shares images based on the parameters configured in the image template.
  • You can execute only one pipeline task for each image template.

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 list of regions.

cn-hangzhou
TemplateTagobject []No
Note This parameter is deprecated.
KeystringNo
Note This parameter is deprecated.
null
ValuestringNo
Note This parameter is deprecated.
null
ImagePipelineIdstringYes

The ID of the image template.

ip-2ze5tsl5bp6nf2b3****
ClientTokenstringNo

The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but make sure that the token is unique among requests. The token can contain only ASCII characters and cannot exceed 64 characters in length. For more information, see How to ensure idempotence.

123e4567-e89b-12d3-a456-426655440000

Response parameters

ParameterTypeDescriptionExample
object
ExecutionIdstring

The ID of the image creation task.

exec-5fb8facb8ed7427c****
RequestIdstring

The request ID.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Examples

Sample success responses

JSONformat

{
  "ExecutionId": "exec-5fb8facb8ed7427c****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Error codes

HTTP status codeError codeError messageDescription
403InvalidImagePipeline.HasRunningExecution%s-
404InvalidImagePipeline.NotFound%s-
500StartImagePipelineExecution.FailedStart image pipeline execution failed.Failed to execute the image template task.

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

Change history

Change timeSummary of changesOperation
No change history