StartImagePipelineExecution_云服务器 ECS_API文档-阿里云OpenAPI开发者门户

接口说明

镜像模板创建好之后，需要通过该接口执行构建镜像的任务，系统将根据镜像模板设置好的参数进行构建、分发、共享镜像。
同一个镜像模板，同一时间只能执行一个构建镜像任务。取消构建镜像任务（CancelImagePipelineExecution）可同时执行多次，并且取消构建镜像任务和构建镜像任务之间互不干扰。
执行镜像构建模板时，需要创建多台中转实例辅助构建镜像，中转实例为按量计费的 ECS 实例，将收取一定的费用。更多信息，请参见按量付费。

流控信息

请求速率为1000/60(s)。

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

ecs:StartImagePipelineExecution	Update	ImagePipeline acs:ecs:{#regionId}:{#accountId}:imagepipeline/{#imagepipelineId}	无	无

请求参数

字段名称	字段详情
RegionIdstring	所属的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。示例值:cn-hangzhou参考取值来源: DescribeRegions
deprecatedTemplateTagarray<object>	说明该参数已废弃。子级条数 <= 20
Tagarray<object>	标签列表。子级条数 <= 20
ImagePipelineIdstring	镜像模板 ID。示例值:ip-2ze5tsl5bp6nf2b3****参考取值来源: CreateImagePipeline DescribeImagePipelines
ClientTokenstring	保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符，且不能超过 64 个字符。更多详情，请参见如何保证幂等性。示例值:123e4567-e89b-12d3-a456-426655440000

返回参数

字段名称	字段详情
ExecutionIdstring	构建任务 ID。示例值:exec-5fb8facb8ed7427c****
RequestIdstring	请求 ID。示例值:473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

400	InvalidImage.OsTypeUnsupported	The specified base image does not support image building.	诊断
400	InvalidParameter.BuildContent	%s.	诊断
400	InvalidParameter.TestContent	%s.	诊断
400	InvalidImageComponent.NotSupported	%s.	诊断
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	诊断
400	InvalidTagKey.Malformed	The specified Tag.N.Key is not valid. Tag keys cannot be empty or null, support up to 128 characters, cannot start with "aliyun" or "acs:", and cannot contain "http://" or "https://".	诊断
400	InvalidTagValue.Malformed	The specified Tag.N.Value is not valid. Tag values support up to 128 characters, and cannot contain "http://" or "https://".	诊断
403	InvalidImagePipeline.HasRunningExecution	%s	诊断
403	InvalidImagePipeline.OSSObjectNotAuthorized	The ImportImageOptions.DiskDeviceMappings.OSSObject of the specified ImagePipeline is not allowed to access.	诊断
403	InvalidImagePipeline.OSSObjectNeedRestore	The ImportImageOptions.DiskDeviceMappings.OSSObject of the specified ImagePipeline is an archived object and needs to be restored first.	诊断
403	InvalidOperation.NoRightAccessOSS	ECS service is not authorized to access your OSS. Check your RAM roles and policies, and ensure that ecs.aliyuncs.com is authorized to assume AliyunECSImageImportDefaultRole.	诊断
404	InvalidImagePipeline.NotFound	%s	诊断
404	InvalidInstanceType.NotFound	The specified instance type does not exist.	诊断
404	InvalidVSwitchId.NotFound	The specified VSwitchId does not exist.	诊断
404	InvalidRegionId.NotFound	%s	诊断
404	InvalidImage.NotFound	%s.	诊断
404	ImageComponent.NotFound	%s.	诊断
404	InvalidImagePipeline.BaseImageNotFound	The BaseImage of the specified ImagePipeline is not found.	诊断
404	InvalidImagePipeline.OSSObjectNotFound	The ImportImageOptions.DiskDeviceMappings.OSSObject of the specified ImagePipeline is not found in this region.	诊断
500	StartImagePipelineExecution.Failed	Start image pipeline execution failed.	诊断

变更历史

	变更时间	变更内容概要	操作
	2025-01-13	变更错误码403 变更错误码404
	2024-12-19	变更错误码400 新增请求参数Tag 删除返回参数
	2024-11-07	变更错误码404
	2024-10-10	新增错误码400 变更错误码404

StartImagePipelineExecution_云服务器 ECS_API文档

接口说明

流控信息

授权信息

请求参数

返回参数

返回示例

错误码

变更历史

相关示例