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
Authorization information
There is currently no authorization information disclosed in the API.
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
RegionId | string | Yes | The region ID. You can call the DescribeRegions operation to query the most recent list of regions. | cn-hangzhou |
TemplateTag | object [] | No | Note
This parameter is deprecated.
| |
Key | string | No | Note
This parameter is deprecated.
| null |
Value | string | No | Note
This parameter is deprecated.
| null |
ImagePipelineId | string | Yes | The ID of the image template. | ip-2ze5tsl5bp6nf2b3**** |
ClientToken | string | No | 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
Examples
Sample success responses
JSON
format
{
"ExecutionId": "exec-5fb8facb8ed7427c****",
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
403 | InvalidImagePipeline.HasRunningExecution | %s | - |
404 | InvalidImagePipeline.NotFound | %s | - |
500 | StartImagePipelineExecution.Failed | Start 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 time | Summary of changes | Operation |
---|
No change history