- What's New
- Function Overview
- Service Overview
- Getting Started
-
User Guide
- Managing Public Images
-
Creating a Private Image
- Introduction
- Creating a System Disk Image from a Windows ECS
- Creating a System Disk Image from a Linux ECS
- Creating a Windows System Disk Image from an External Image File
- Creating a Linux System Disk Image from an External Image File
- Creating a BMS System Disk Image
- Creating a Data Disk Image from an ECS
- Creating a Data Disk Image from an External Image File
- Creating a Full-ECS Image from an ECS
- Creating a Full-ECS Image from a CSBS Backup
- Creating a Full-ECS Image from a CBR Backup
- Creating a Windows System Disk Image from an ISO File
- Creating a Linux System Disk Image from an ISO File
- Importing an Image
- Fast Import of an Image File
-
Managing Private Images
- Modifying an Image
- Exporting Image List
- Checking the Disk Capacity of an Image
- Creating an ECS from an Image
- Deleting Images
- Sharing Images
- Exporting an Image
- Optimizing a Windows Private Image
-
Optimizing a Linux Private Image
- Optimization Process
- Checking Whether a Private Image Needs to be Optimized
- Uninstalling PV Drivers from a Linux ECS
- Changing the Disk Identifier in the GRUB Configuration File to UUID
- Changing the Disk Identifier in the fstab File to UUID
- Installing Native Xen and KVM Drivers
- Installing Native KVM Drivers
- Clearing System Logs
- Encrypting Images
- Replicating Images Within a Region
- Replicating Images Across Regions
- Tagging an Image
- Auditing Key Operations
- Windows Operations
- Linux Operations
- Permissions Management
-
Best Practices
- Overview
- Creating a Linux Image Using VirtualBox and an ISO File
- Cleaning Up the Disk Space of a Windows ECS
- Converting the Image Format
- Creating a Private Image Using Packer
- Configuring an ISO File as a Local Image Source
- Migrating Service Data Across Accounts (Data Disks)
-
API Reference
- Before You Start
- API Overview
- Calling APIs
- Getting Started
- IMS APIs
-
Native OpenStack APIs
-
Image (Native OpenStack APIs)
- Querying Images (Native OpenStack API)
- Querying Image Details (Native OpenStack API)
- Updating Image Information (Native OpenStack API)
- Uploading an Image (Native OpenStack API)
- Deleting an Image (Native OpenStack API)
- Creating Image Metadata (Native OpenStack API)
- Deleting an Image (Native OpenStack API v1.1 - Abandoned and Not Recommended)
- Querying Image Metadata (Native OpenStack API v1 - Abandoned and Not Recommended)
- Querying Image Details (Native OpenStack API v1.1 - Abandoned and Not Recommended)
- Image Tagging (Native OpenStack APIs)
- Image Schema (Native OpenStack APIs)
- Image Sharing (Native OpenStack APIs)
- API Version Query (Native OpenStack API)
-
Image (Native OpenStack APIs)
- Examples
- Permission Policies and Supported Actions
- Common Parameters
- Status Codes
- Error Codes
- SDK Reference
-
FAQs
-
Image Consulting
- Basic Concepts
- How Do I Select an Image?
- Are There Any Public Images Already Containing Certain Applications, Such as OpenVPN or PyTorch?
- How Do I Increase the Image Quota?
- What Are the Differences Between Images and Backups?
- Can I Tailor an Image?
- How Can I Back Up the Current Status of an ECS for Restoration in the Case of a System Fault?
- How Can I Apply a Private Image to an Existing ECS?
- Can I Import Data from a Data Disk Image to a Data Disk?
- Can I Use Private Images of Other Accounts?
- End-of-Support for OSs
-
Image Creation
- General Creation FAQs
- Full-ECS Image FAQs
- How Can I Use a Backup to Create an EVS Disk or ECS?
- Is There Any Difference Between the Image Created from a CSBS/CBR Backup and That Created from an ECS?
- Why Can't I Find an ISO Image When I Want to Use It to Create an ECS or Change the OS of an ECS?
- How Do I Create a Full-ECS Image Using an ECS That Has a Spanned Volume?
- Why Is Sysprep Required for Creating a Private Image from a Windows ECS?
- How Do I Handle the Startup Failure of a Windows ECS Created from a Windows Image Generalized by Sysprep?
- What Do I Do If I Cannot Create an Image in ZVHD2 Format Using an API?
- Image Sharing
- OS
-
Image Import
- Can I Use Images in Formats not Described in This Document?
- What Are the Impacts If I Do Not Pre-configure an ECS Used to Create a Private Image?
- How Do I Import an OVF or OVA File to the Cloud Platform?
- What Do I Do If I Chose the Wrong OS or System Disk Capacity When Registering a Private Image?
- Why Did My VHD Upload Fail? Why Does the System Say the System Disk in the VHD Image File Is Larger Than What I Specified on the Management Console?
-
Image Export
- Can I Download My Private Images to a Local PC?
- Can I Use the System Disk Image of an ECS on a BMS After I Export It from the Cloud Platform?
- Why Is the Image Size in an OBS Bucket Different from That Displayed in IMS?
- Can I Download a Public Image to My PC?
- What Are the Differences Between Import/Export and Fast Import/Export?
- Why the Export Option Is Unavailable for My Image?
-
Image Optimization
- Must I Install Guest OS Drivers on an ECS?
- Why Do I Need to Install and Update VirtIO Drivers for Windows?
- What Will the System Do to an Image File When I Use the File to Register a Private Image?
- How Do I Configure an ECS, a BMS, or an Image File Before I Use It to Create an Image?
- What Do I Do If a Windows Image File Is Not Pre-Configured When I Use It to Register a Private Image?
- What Do I Do If a Linux Image File Is Not Pre-Configured When I Use It to Register a Private Image?
- How Do I Enable NIC Multi-Queue for an Image?
- How Do I Configure an ECS to Use DHCPv6?
- How Do I Clean Up the Disk Space of a Windows ECS?
- How Do I Make a System Disk Image Support Fast ECS Creation?
- Why Did I Fail to Install Guest OS Drivers on a Windows ECS?
- How Do I Install Native Xen and KVM Drivers?
- Image Replication
- Image Deletion
- Image Encryption
- Accounts and Permissions
- Cloud-Init
-
ECS Creation
- Can I Change the Image of a Purchased ECS?
- Can I Change the Specifications Defined by a Private Image When I Use the Image to Create an ECS?
- Can I Specify the System Disk Capacity When I Create an ECS Using an Image?
- What Do I Do If a Partition Is Not Found During the Startup of an ECS Created from an Imported Private Image?
- What Do I Do If the Disks of a CentOS ECS Created from an Image Cannot Be Found?
- What Do I Do If I Enabled Automatic Configuration During Image Registration for an ECS Created from a Windows Image and Now It Won't Start?
- What Do I Do If an Exception Occurs When I Start an ECS Created from an Image Using UEFI Boot?
- Billing
-
Image Consulting
- Videos
Show all
Function Overview
-
Creating a Private Image
-
An image is a server or disk template that contains an operating system (OS) or service data and necessary application software, such as database software. IMS provides public, private, Marketplace, and shared images.
Image Management Service (IMS) allows you to manage the lifecycle of images. You can create ECSs or BMSs from a public, private, or shared image. You can also create a private image from a cloud server or an external image file to easily migrate workloads to the cloud or on the cloud.
The following figure shows the lifecycle of a private image.
-
Creating a System Disk Image
-
A system disk image contains an OS and pre-installed application software. You can do customizations (such as install software and deploy an application environment) on an existing ECS and then use the ECS to create a system disk image. The new ECSs created from the image will all have the same configurations as the customized ECS.
The following figure shows the process of creating an ECS from an image, customizing the ECS, creating a new image from the ECS, and using the new image to create identical ECSs.
Launched regions: all
-
-
Creating a Data Disk Image
-
A data disk image contains only your service data. You can save service data of an ECS data disk by creating a data disk image. Then, the data disk image can be used to create EVS disks to migrate the service data.
The following figure shows the process of attaching a data disk to an ECS, creating a data disk image from the ECS, and using the image to create data disks.
Launched regions: all
-
-
Creating a Full-ECS Image
-
You can use an ECS with data disks to create a full-ECS image, which contains an OS, application software, and your service data. The full-ECS image can be used to quickly provision identical ECSs for data migration.
The following figure shows the process of backing up an ECS and creating a full-ECS image from the backup.
-
-
Creating a Private Image Using Packer
-
Packer is an open-source tool that can be used to create custom images. It simplifies private image creation by changing the image creation process into configurable management code. In this way, you can flexibly customize your images.
Launched regions: all
Creating a Private Image Using Packer
-
-
-
Importing a Private Image
-
A private image can be created from a running ECS or imported from other systems. You can import system disk images, data disk images, and ISO files.
-
Importing a System Disk Image
-
You can import a system disk image from your local PC or other cloud platforms. After an image is imported, you can use it to create new ECSs or reinstall or change the OS of an existing ECS.
The following figure shows the process of importing a system disk image.
-
-
Importing a Data Disk Image
-
You can import a data disk image from your local PC or other cloud platforms. After a data disk image is imported, you can use it to create EVS disks.
The following figure shows the process of importing a data disk image.
Launched regions: all
-
-
Importing an ISO File
-
An ISO file is a disk image of an optical disc that contains a large number of compressed data files. The ISO file can be used only after it is decompressed using a tool, such as UltraISO.
The following figure shows the process of importing a Windows ISO file.
The following figure shows the process of importing a Linux ISO file.
-
-
-
Creating an ECS from an Image
-
After a system disk image or full-ECS image is created, you can click Apply for Server in the row that contains the image to create ECSs.
Launched regions: all
-
-
Modifying an Image
-
You can modify the following information of an image: name, description, minimum memory, maximum memory, NIC multi-queue, and SR-IOV driver.
Launched regions: all
-
-
Sharing Images
-
You can share your images with other tenants. The tenants can use the shared images to quickly create identical ECSs or EVS disks.
Assume that A wants to share an image with B. The process is as follows:
To share the same image with D, A can add D as the tenant who can use the image.
When B has deployed services on the instances created from the shared image and does not need the image any longer, B can reject the shared image.
A can stop the sharing of an image with others.
-
-
Exporting Images
-
You can export private images to your OBS bucket and download them to your local PC for backup.
By exporting an image of a cloud server from the cloud platform, you can reproduce the cloud server and its running environments in on-promises clusters or private clouds. The following figure shows the process of exporting an image.
The following images cannot be exported:
- Public image
- Full-ECS image
- ISO image
- Private image created from a Windows or SUSE public image
- Private image created from a Marketplace image
Launched regions: all
-
-
Encrypting Images
-
You can create encrypted images through KMS envelope encryption to improve data security.
Encrypted images can be created from external image files or encrypted ECSs.
Launched regions: all
-
-
Replicating Images Within a Region
-
You can convert encrypted and unencrypted images into each other or enable some advanced features (such as quick instance provisioning) by replicating an image within a region.
Launched regions: all
-
-
Tagging an Image
-
You can tag your private images for easy management and search.
A maximum of 10 tags can be added for a private image when you create the image or add them on the details page of the image after it is created.
Launched regions: all
-
-
Exporting Image Information
-
You can export information about the public and private images in a region in CSV format, facilitating local maintenance and query.
Launched regions: all
-
-
Converting the Image Format
-
You can import an image file in VMDK, VHD, QCOW2, RAW, VHDX, QED, VDI, QCOW, ZVHD2, or ZVHD format to HUAWEI CLOUD. Image files in other formats need to be converted to any of these formats before being imported. You can use the open-source tool qemu-img or self-developed tool qemu-img-hw to convert the image format.
qemu-img supports the mutual conversion of formats VHD, VMDK, QCOW2, RAW, VHDX, QCOW, VDI, and QED, but cannot covert an image to ZVHD or ZVHD2 format. To convert an image file to any of the two formats, use qemu-img-hw.
Launched regions: all
-
-
Deleting a Private Image
-
You can delete images that are no longer used. Deleting an image does not affect the ECSs or EVS disks created from the image.
Launched regions: all
-
-
Auditing Key Operations
-
Cloud Trace Service (CTS) records operations on cloud resources in your account. You can use the logs to perform security analysis, track resource changes, audit compliance, and locate faults.
Once CTS is enabled, it starts recording IMS operations. You can view the operation records of the last 7 days on the CTS management console.
Launched regions: all
-
-
API
-
IMS provides REST APIs that support HTTPS methods. You can call these APIs to create, register, replicate, and share images.
Launched regions: all
-
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.