CreateImagePipeline-阿里云帮助中心

Creates an image template. Image templates can be used to build images.

Operation description

You can use image templates to customize image content and support cross-region and cross-account image building. Before you create an image template, take note of the following items:

You can only create custom image templates.
You can only use public images, custom images, shared images, or an image family as source images for building.
When you build an image by using an image template, multiple intermediate instances are created to assist in the image building process. Intermediate instances are ECS instances that use the pay-as-you-go billing method and incur fees. For more information, see Pay-as-you-go.

Take note of the following items about the build template content BuildContent:

The FROM command is deprecated. Regardless of the FROM command Settings in the BuildContent parameter, the system selects the source image based on the BaseImageType and BaseImage parameters.
The content size of an image template cannot exceed 16 KB. For more details about supported commands, see Commands supported by Image Builder.

For more information, see Image Builder overview.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

ecs:CreateImagePipeline

create

*ImagePipeline

acs:ecs:{#regionId}:{#accountId}:imagepipeline/*

None

ram:CreateServiceLinkedRole

Request parameters

Parameter	Type	Required	Description	Example
Tag	array<object>	No	The list of tags.
	object	No	The list of tags.
Key	string	No	The tag key. Valid values of N: 1 to 20. If this parameter is specified, it cannot be an empty string. The tag key can be up to 128 characters in length. It cannot start with `aliyun` or `acs:`, and cannot contain `http://` or `https://`.	TestKey
Value	string	No	The tag value. Valid values of N: 1 to 20. If this parameter is specified, it can be an empty string. The tag value can be up to 128 characters in length. It cannot start with `acs:`, and cannot contain `http://` or `https://`.	TestValue
RegionId	string	Yes	The region ID. You can call the DescribeRegions operation to query the most recent region list.	cn-hangzhou
ResourceGroupId	string	No	The ID of the resource group.	rg-bp67acfmxazb4p****
AddAccount	array	No	The Alibaba Cloud account ID for image sharing of the destination image. Valid values of N: 1 to 20.	1234567890
	integer	No	The Alibaba Cloud account ID for image sharing of the destination image. Valid values of N: 1 to 20.	1234567890
ToRegionId	array	No	The list of regions to which the destination image is distributed. Valid values of N: 1 to 20. If you do not specify this parameter, the image is created only in the current region by default.	cn-hangzhou
	string	No	The list of regions to which the destination image is distributed. Valid values of N: 1 to 20. If you do not specify this parameter, the image is created only in the current region by default.	cn-hangzhou
RepairItem	array	No	The image repair items. Repair items supported by Linux: fstab: fixes disk attach configuration issues. grub: fixes GRUB boot configuration issues. dhcp: fixes network DHCP issues. selinux: fixes Security-Enhanced Linux (SELinux) issues. growpart: fixes online automatic scale-out issues of the root partition. cloudinit: installs the cloud-init initialization service. aegis: installs the Security Center agent. nvme: fixes NVMe driver issues. virtio: fixes virtio driver issues. standardizedtimezone: fixes standard time zone issues. Repair items supported by Windows: bcd: fixes boot configuration data file issues. hotfix: fixes Windows patch issues. disk: fixes disk Settings issues. update: fixes Windows Update process issues. server: fixes service configuration issues. bootmgr: fixes Windows Boot Manager issues. vminit: fixes Windows initialization agent issues. osloader: fixes Windows OS Loader issues. virtio: fixes virtio driver issues. standardizedtimezone: fixes standard time zone issues.
	string	No	The image repair item.	fstab
BaseImageType	string	Yes	The source image type. Valid values: IMAGE: image. IMAGE_FAMILY: image family. OSS: OSS object.	IMAGE
BaseImage	string	No	The source image. If BaseImageType is set to IMAGE, set this parameter to the image ID. If BaseImageType is set to IMAGE_FAMILY, set this parameter to the image family name. If BaseImageType is set to OSS, you do not need to specify this parameter.	m-bp67acfmxazb4p****
Name	string	No	The template name. It must be 2 to 128 characters in length and must start with a letter or a Chinese character. It cannot start with `http://` or `https://`. It can contain letters, digits, Chinese characters, colons (:), underscores (_), periods (.), and hyphens (-). Note If you do not specify `Name`, the value of `ImagePipelineId` is used by default.	testImagePipeline
Description	string	No	The description. The description must be 2 to 256 characters in length and cannot start with `http://` or `https://`.	This is description.
ImageName `deprecated`	string	No	The prefix of the destination image name. Important [Deprecated] Use ImageOptions.ImageName instead.	testImageName
VSwitchId	string	No	The vSwitch ID of the VPC. If you do not specify this parameter, a new VPC and vSwitch are created by default. Make sure that your account has sufficient VPC resource quotas. For more information, see Limits.	vsw-bp67acfmxazb4p****
InstanceType	string	No	The instance type. You can call the DescribeInstanceTypes operation to query available instance types. If you do not specify this parameter, the system automatically selects an instance type with the minimum number of vCPUs and memory size based on resource availability. For example, the system selects the ecs.g6.large instance type by default. If ecs.g6.large is out of stock, the system selects ecs.g6.xlarge.	ecs.g6.large
SystemDiskSize	integer	No	The system disk size of the intermediate instance. Unit: GiB. Valid values: 20 to 500. Default value: 40.	40
InternetMaxBandwidthOut	integer	No	The outbound public bandwidth of the intermediate instance. Unit: Mbit/s. Valid values: 0 to 100. Default value: 0.	0
DeleteInstanceOnFailure	boolean	No	Specifies whether to release the intermediate instance if the image build fails. Valid values: true: releases the instance. false: does not release the instance. Default value: true. Note If the intermediate instance fails to start, the instance is not retained by default.	true
BuildContent	string	No	The content of the image build template. The content size cannot exceed 16 KB. For more information about supported commands, see Commands supported by Image Builder.	COMPONENT ic-bp12dvdzvr9k9*** COMPONENT acs:ecs:cn-hangzhou:18689161186**:imagecomponent/ComponentName/1..*
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 you must make sure that the token is unique among different 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
RepairMode	string	No	The repair mode in the image template. Valid values: Standard: standard repair mode. The standard repair package for Linux includes: GUESTOS.CloudInit GUESTOS.Dhcp GUESTOS.Virtio GUESTOS.OnlineResizeFS GUESTOS.Grub GUESTOS.Fstab GUESTOS.Nvme The standard repair package for Windows includes: GUESTOS.Virtio GUESTOS.Update GUESTOS.Hotfix GUESTOS.Server GUESTOS.Bcd GUESTOS.Disk GUESTOS.Bootmgr GUESTOS.OSLoader GUESTOS.Vminit All: full repair mode. The full repair package for Linux includes the following items in addition to those in the standard repair package: GUESTOS.Selinux GUESTOS.SecurityCenterAgent The full repair package for Windows includes the following items in addition to those in the standard repair package: GUESTOS.Server Customized: custom repair mode. In this mode, the repair items in the repair package are specified by the RepairItem parameter. Note As the detection and repair capabilities improve, the included repair items may increase. For more information about the specific meanings of repair items, see Image check overview.	Standard
ImageFamily `deprecated`	string	No	The destination image family. Important [Deprecated] Use ImageOptions.ImageFamily instead.	family
TestContent	string	No	The content of the image test template. The content size cannot exceed 16 KB. For more information about supported commands, see Commands supported by Image Builder.	COMPONENT ic-bp12dvdzvr9k9*** COMPONENT acs:ecs:cn-hangzhou:18689161186**:imagecomponent/ComponentName/1..*
ImportImageOptions	object	No	The properties and settings of the imported image. This parameter is required when BaseImageType is set to OSS.
Architecture	string	No	The system architecture of the system disk. After you specify a data disk snapshot to create a system disk, you must use Architecture to determine the system architecture of the system disk. Valid values: x86_64 arm64 Default value: x86_64.	x86_64
OSType	string	No	The operating system type. Valid values: windows linux Default value: linux.	linux
Platform	string	No	The operating system version. Valid values: Aliyun Anolis CentOS Ubuntu CoreOS SUSE Debian OpenSUSE FreeBSD RedHat Kylin UOS Fedora Fedora CoreOS CentOS Stream AlmaLinux Rocky Linux Gentoo Customized Linux Others Linux Windows Server 2022 Windows Server 2019 Windows Server 2016 Windows Server 2012 Windows Server 2008 Windows Server 2003 Other Windows Default value: Others Linux if the operating system type is Linux, or Other Windows if the operating system type is Windows.	Aliyun
BootMode	string	No	The boot mode of the image. Valid values: BIOS: BIOS boot mode. UEFI: UEFI boot mode. Default value: BIOS. If Architecture is set to arm64, the default value is UEFI, and you can only set this parameter to UEFI. Important To prevent instances from failing to start due to unsupported boot modes, make sure that you understand the boot modes supported by the destination image before you specify this parameter. For more information about image boot modes, see Image boot modes.	BIOS
LicenseType	string	No	The license type used to activate the operating system after the image is imported. Valid values: Auto: Alibaba Cloud detects the source operating system and assigns a license. In auto mode, the system first checks whether the Platform you specified has a license from official Alibaba Cloud channels and assigns it to the imported image. If no such license is available, the system switches to the Bring Your Own License (BYOL) method. Aliyun: uses a license from official Alibaba Cloud channels based on the Platform you specified. BYOL: uses the license provided by the source operating system. If you use BYOL, you must ensure that your license key is supported on Alibaba Cloud. Default value: Auto.	Auto
DiskDeviceMappings	array<object>	No	The list of custom image information to be created. If N is set to 1, it indicates the system disk. If N is set to 2 to 17, it indicates data disks.
	object	No
OSSBucket	string	No	The OSS bucket where the image file is stored.	ecsimageos
OSSObject	string	No	The name (key) of the image file saved in the OSS bucket after the image is uploaded.	CentOS_5.4_32.raw
Format	string	No	The image format. Valid values: RAW VHD QCOW2 Default value: none. This indicates that Alibaba Cloud automatically detects the image format, and the detected format prevails.	RAW
DiskImageSize	integer	No	The size of the custom image after the image is imported. The space consists of the system disk and data disks. You must ensure that the size of the system disk is greater than or equal to the size of the imported image file. Valid values: If N is set to 1, it indicates the system disk. Valid values: 1 to 2048. Unit: GiB. If N is set to 2 to 17, it indicates data disks. Valid values: 1 to 2048. Unit: GiB. After you upload the source image file to OSS, you can view the size of the image file in the OSS bucket.	40
Features	object	No	The properties related to image features.
NvmeSupport	string	No	Specifies whether the imported original image supports NVMe. Valid values: supported: supported. This indicates that instances created from this image support the NVMe protocol. unsupported: not supported. This indicates that instances created from this image do not support the NVMe protocol. Default value: unsupported.	supported
ImdsSupport	string	No	The metadata access mode of the image. Valid values: v1: When you create an ECS instance from this image, you cannot set the metadata access mode to "Reinforced mode only". v2: When you create an ECS instance from this image, you can set the metadata access mode to "Reinforced mode only". Default value: v1.	v2
RetainImportedImage	boolean	No	Important [Deprecated] Use ImportImageOptions.RetentionStrategy instead.	false
RetentionStrategy	string	No	The data retention policy for the imported image. Valid values: RetainOnlySuccessful: retains the image only if the build succeeds. RetainOnlyFailed: retains the image only if the build fails. RetainAlways: always retains the image regardless of the build result. RetainNever: never retains the image regardless of the build result. Default value: RetainNever.	RetainAlways
ImageName	string	No	The name of the imported image.	testImageName
Description	string	No	The description of the imported image.	This is description.
RoleName	string	No	The name of the RAM role used when the image is imported.
ImportImageTags	array<object>	No	The list of tags for the image.
	object	No
Key	string	No	The tag key of the image.	testKey
Value	string	No	The tag value of the image.	testValue
NvmeSupport `deprecated`	string	No	Specifies whether the built destination image supports NVMe. Important [Deprecated] Use ImageOptions.ImageFeatures.NvmeSupport instead.	auto
AdvancedOptions	object	No	The advanced settings.
RetainCloudAssistant	boolean	No	Specifies whether to retain Cloud Assistant. During the build process, the system automatically installs Cloud Assistant on the intermediate instance to execute commands. You can choose whether to retain it in the built destination image. Valid values: true: retains Cloud Assistant. false: does not retain Cloud Assistant. Default value: false. Note This setting does not affect the Cloud Assistant that is pre-installed in your image.	true
ImageNameSuffix	string	No	Specifies whether to disable the automatic addition of a suffix to the destination image name. Valid values: disable: disables the automatic addition.	disable
ImageOptions	object	No	The properties of the destination image.
ImageName	string	No	The prefix of the target image name. The prefix must be 2 to 64 characters in length and must start with a letter or a Chinese character. It cannot start with http:// or https://. It can contain letters, Chinese characters, digits, colons (:), underscores (), periods (.), and hyphens (-). The system automatically generates the final image name by concatenating the prefix and the build task ID (ExecutionId) in the {ImageName}{ExecutionId} format.	testImageName
ImageFamily	string	No	The target image family. The value must be 2 to 128 characters in length. It must start with a letter or a Chinese character, and cannot start with aliyun or acs:. It cannot contain http:// or https://. It can contain digits, colons (:), underscores (_), and hyphens (-).	family
Description	string	No	The description. The description must be 2 to 256 characters in length and cannot start with `http://` or `https://`.	This is description.
ImageFeatures	object	No	The properties related to destination image features.
NvmeSupport	string	No	Specifies whether the built destination image supports NVMe. Valid values: supported: supported. This indicates that instances created from this image support the NVMe protocol. unsupported: not supported. This indicates that instances created from this image do not support the NVMe protocol. auto: automatic detection. The system automatically detects whether the NVMe driver is installed in your image. This detection occurs before the build phase. If you install or uninstall the NVMe driver during the build, the detection result may be inaccurate. We recommend that you set this parameter to supported or unsupported based on the build content.	auto
ImageTags	array<object>	No	The tags of the destination image.
	object	No
Key	string	No	The tag key. Valid values of N: 1 to 20. If this parameter is specified, it cannot be an empty string. The tag key can be up to 128 characters in length. It cannot start with `aliyun` or `acs:`, and cannot contain `http://` or `https://`.	TestKey
Value	string	No	The tag value. Valid values of N: 1 to 20. If this parameter is specified, it can be an empty string. The tag value can be up to 128 characters in length. It cannot start with `acs:`, and cannot contain `http://` or `https://`.	TestValue

Response elements

Element	Type	Description	Example
	object
ImagePipelineId	string	The image template ID.	ip-2ze5tsl5bp6nf2b3****
RequestId	string	The request ID.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Examples

Success response

JSON format

{
  "ImagePipelineId": "ip-2ze5tsl5bp6nf2b3****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Error codes

HTTP status code	Error code	Error message	Description
400	InvalidSourceInstance.NotFound	The specified source instance is not found.	The specified source instance is not found.
400	InvalidName.Malformed	%s
400	InvalidDescription.Malformed	%s
400	InvalidImageName.Malformed	%s
400	InvalidBaseImageType.NotSupportedValue	%s
400	InvalidSystemDiskSize.NotSupportedValue	%s
400	InvalidInternetMaxBandwidthOut.NotSupportedValue	%s
400	InvalidAddAccountSize.ExceededMaxNumber	%s
400	InvalidToRegionIdSize.ExceededMaxNumber	%s
400	InvalidBuildContent.LengthExceeded	%s
400	InvalidImageTemplateCommandSize.ExceededMaxNumber	%s
400	DuplicatedCommand.FROM	%s
400	InvalidCommandOrder.FROM	%s
400	InvalidImageTemplateCommand.NotSupported	%s
400	InvalidCommandContent.RUN	%s
400	InvalidCommandContent.ENV	%s
400	InvalidCommandContent.WORKDIR	%s
400	InvalidCommandContent.COPY	%s
400	InvalidCommandContent.USER	%s
400	InvalidCommandContent.FROM	%s
400	InvalidCommandContent.CMD	%s
400	InvalidCommandContent.ENTRYPOINT	%s
400	QuotaExceed.ImagePipeline	%s.	The image template quota of your account in this region is used up.
400	NoPermission	%s.	This operation is not allowed. Apply for the permissions required to perform the operation.
400	EmptyCommandContent.LABEL	%s.	If the LABEL command exists in the template, you must specify LABEL.
400	EmptyCommandContent.ENV	%s.	If the ENV command exists in the template, you must specify ENV.
400	EmptyCommandContent.ENTRYPOINT	%s.	If the ENTRYPOINT command exists in the template, you must specify ENTRYPOINT.
400	EmptyCommandContent.CMD	%s.	If the CMD command exists in the template, you must specify CMD.
400	EmptyCommandContent.COPY	%s.	If the COPY command exists in the template, you must specify COPY.
400	EmptyCommandContent.WORKDIR	%s.	If the WORKDIR command exists in the template, you must specify WORKDIR.
400	NotEmptyCommandContent.RESTART	%s.	If the RESTART command exists in the template, you must specify RESTART.
400	EmptyCommandContent.USER	%s.	If the USER command exists in the template, you must specify USER.
400	EmptyCommandContent.RUN	%s.	If the RUN command exists in the template, you must specify RUN.
400	InvalidImage.OsTypeUnsupported	The specified base image does not support image building.	The operating system of the specified base image does not support image building.
400	InvalidParameter.BuildContent	%s.	The build content is invalid.
400	InvalidParameter.TestContent	%s.	The test content is invalid.
400	InvalidImageComponent.NotSupported	%s.	The specified image component is not available.
400	InvalidParameterCombination	%s.	Invalid combination of parameters.
400	InvalidParameter.RepairMode	The specified parameter RepairMode is invalid.	The specified repair mode is invalid.
400	InvalidImageFamily.Malformed	The format of the specified image family is invalid.	The format of the specified image family is invalid.
400	InvalidImage.ImageOwnerAliasUnsupported	The specified base image does not support distributing.	The specified base image does not support distributing.
400	InvalidParameter.ImportImageOptionsArchitecture	The specified parameter ImportImageOptions.Architecture is invalid. The correct value should be in [%s].	The specified parameter ImportImageOptionsArchitecture is invalid. The correct value can refer to the error message or the document to fill in.
400	InvalidParameter.ImportImageOptionsOSType	The specified parameter ImportImageOptions.OSType is invalid. The correct value should be in [%s].	The specified parameter ImportImageOptions.OSType is invalid. The correct value can refer to the error message or the document to fill in.
400	InvalidParameter.ImportImageOptionsBootMode	The specified parameter ImportImageOptions.BootMode is invalid. The correct value should be in [%s].	The specified parameter ImportImageOptions.BootMode is invalid. The correct value can refer to the error message or the document to fill in.
400	InvalidImportImageOptionsDiskDeviceMappings.LengthLimitExceeded	The length of the specified parameter ImportImageOptions.DiskDeviceMappings exceeds the limit(17).	The specified parameter ImportImageOptions.DiskDeviceMappings length exceeds the limit, the maximum length is 17.
400	InvalidParameter.ImportImageOptionsDiskDeviceMappingsOSSObject	The specified parameter ImportImageOptions.DiskDeviceMappings.OSSObject is invalid. OSSObject supports up to 1023 characters, and cannot start with http:// or https://.	The specified parameter ImportImageOptions.DiskDeviceMappings.OSSObject is invalid. OSSObject supports up to 1023 characters, and cannot start with "http://" or "https://".
400	InvalidParameter.ImportImageOptionsDiskDeviceMappingsOSSBucket	The specified parameter ImportImageOptions.DiskDeviceMappings.OSSBucket is invalid. OSSBucket supports up to 63 characters, only lowercase letters, numbers, and dashes are allowed, and cannot start or end with a dash.	The specified parameter ImportImageOptions.DiskDeviceMappings.OSSBucket is invalid. OSSBucket supports up to 63 characters, only lowercase letters, numbers, and dashes are allowed, and cannot start or end with a dash.
400	InvalidParameter.ImportImageOptionsPlatform	The specified parameter ImportImageOptions.Platform is invalid. The correct value should be in [%s].	The specified parameter ImportImageOptions.Platform is invalid. The correct value can refer to the error message or the document to fill in.
400	InvalidParameter.ImportImageOptionsLicenseType	The specified parameter ImportImageOptions.LicenseType is invalid. The correct value should be in [%s].	The specified parameter ImportImageOptions.LicenseType is invalid. The correct value can refer to the error message or the document to fill in.
400	InvalidParameter.ImportImageOptionsFeaturesNvmeSupport	The specified parameter ImportImageOptions.Features.NvmeSupport is invalid. The correct value should be in [%s].	The specified parameter ImportImageOptions.Features.NvmeSupport is invalid. The correct value can refer to the error message or the document to fill in.
400	InvalidParameter.NvmeSupport	The specified parameter NvmeSupport is invalid. The correct value should be in [%s].	The specified parameter NvmeSupport is invalid. The correct value can refer to the error message or the document to fill in.
400	InvalidParameter.ImportImageOptionsDiskDeviceMappingsFormat	The specified parameter ImportImageOptions.DiskDeviceMappings.Format is invalid. The correct value should be in [%s].	The specified parameter ImportImageOptions.DiskDeviceMappings.Format is invalid. The correct value can refer to the error message or the document to fill in.
400	InvalidOperation.DiskImageSizeExceeded	The disk size exceeds the limit. Please check the specified parameter ImportImageOptions.DiskDeviceMappings.DiskImageSize and ImportImageOptions.DiskDeviceMappings.OSSObject. Ensure that each of them is between 1 and 2048 in size.	The disk size exceeds the limit. Please check the specified parameter ImportImageOptions.DiskDeviceMappings.DiskImageSize and ImportImageOptions.DiskDeviceMappings.OSSObject. Ensure that each of them is between 1 and 2048 in size.
400	InvalidImageOptions.Description	The specified parameter ImageOptions.Description is invalid. The length should be between 2 to 256 characters, and cannot start with http:// or https://.	The specified parameter ImageOptions.Description is invalid. The length should be between 2 to 256 characters, and cannot start with http:// or https://.
400	InvalidImageName.Duplicated	The specified image name is already in use in the target region. Please try a different one.	The specified image name is already in use in the target region. Please try another one.
400	InvalidImage.NotSupportRepair	The specified base image does not support repair.	The specified base image does not support repair.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	The specified tag key already exists. Tag keys must be unique.
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://".	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://".	The specified Tag.N.Value is not valid. Tag values support up to 128 characters, and cannot contain "http://" or "https://".
400	InvalidAdvancedOptions.ImageNameSuffix	The specified parameter AdvancedOptions.ImageNameSuffix is invalid. The correct value should be in [%s].	The specified parameter AdvancedOptions.ImageNameSuffix is invalid. The correct enumeration value can be obtained by referring to the error message.
400	InvalidImportImageOptions.DockerOptionsImageMalformed	The specified parameter ImportImageOptions.DockerOptions.Image is invalid. The length should be between 1 to 512 characters.	The specified parameter ImportImageOptions.DockerOptions.Image is invalid. The length should be between 1 to 512 characters.
400	InvalidImportImageOptions.DockerOptionsImageSizeMalformed	The specified parameter ImportImageOptions.DockerOptions.ImageSize is invalid. The size should be between 1GB to 2048GB.	The specified parameter ImportImageOptions.DockerOptions.ImageSize is invalid. The size should be between 1GB to 2048GB.
403	ImagePipeline.NotSupportWindowsInstance	Image pipeline does not support windows instance at this time.
403	InvalidOSSObject.NotAuthorized	The specified ImportImageOptions.DiskDeviceMappings.OSSObject is not allowed to be accessed.	The specified ImportImageOptions.DiskDeviceMappings.OSSObject is not allowed to be accessed.
403	InvalidOperation.NoPermissionCreateServiceLinkedRole	You are not authorized to create Service-linked role. The system will automatically create it when the API is called for the first time. Check your RAM policies, and ensure that you are using the correct credentials.	You are not authorized to create Service-linked role. The system will automatically create it when the API is called for the first time. Check your RAM policies, and ensure that you are using the correct credentials.
403	InvalidOSSObject.NeedRestore	The specified ImportImageOptions.DiskDeviceMappings.OSSObject is an archived object and needs to be restored first.	The specified ImportImageOptions.DiskDeviceMappings.OSSObject 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.	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".
403	InvalidOperation.OSSObjectIsImporting	The specified ImportImageOptions.DiskDeviceMappings.OSSObject is importing.	The specified ImportImageOptions.DiskDeviceMappings.OSSObject is importing.
404	InvalidImage.NotFound	%s
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	The specified resource group does not exist.
404	ImageComponent.NotFound	%s.	The specified image component ID is not found.
404	InvalidInstanceType.NotFound	The specified instance type does not exist.	The specified InstanceType parameter does not exist.
404	InvalidVSwitchId.NotFound	The specified VSwitchId does not exist.	The specified VSwitchId does not exist
404	InvalidRegionId.NotFound	%s	The specified region ID does not exist.
404	InvalidImportImageOptionsDiskDeviceMappingsOSSObject.NotFound	The specified ImportImageOptions.DiskDeviceMappings.OSSObject is not found in this region.	The specified ImportImageOptions.DiskDeviceMappings.OSSObject is not found in the current region.
404	MissingParameter.RepairMode	The specified parameter RepairMode is missing.	The specified parameter RepairMode is missing.
404	MissingParameter.ImportImageOptions	The specified parameter ImportImageOptions is missing.	The specified parameter ImportImageOptions is missing.
404	MissingParameter.ImportImageOptionsDiskDeviceMappingsOSSObject	The specified parameter ImportImageOptions.DiskDeviceMappings.OSSObject is missing.	The specified parameter ImportImageOptions.DiskDeviceMappings.OSSObject is missing.
404	MissingParameter.ImportImageOptionsDiskDeviceMappingsOSSBucket	The specified parameter ImportImageOptions.DiskDeviceMappings.OSSBucket is missing.	The specified parameter ImportImageOptions.DiskDeviceMappings.OSSBucket is missing.
404	MissingParameter.ImageOptionsDiskDeviceMappings	The specified parameter ImportImageOptions.DiskDeviceMappings is missing.	The specified parameter ImportImageOptions.DiskDeviceMappings is missing.
404	MissingImportImageOptions.DockerOptions	The specified parameter ImportImageOptions.DockerOptions is missing.	The specified parameter ImportImageOptions.DockerOptions is missing.
404	InvalidOssBucketName.NotFound	The specified parameter OssDeliveryConfig.BucketName does not exist.	The specified OSS bucket does not exist.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.