:ImportImage

Catatan penggunaan

Perhatikan hal-hal berikut:

• Sebelum mengimpor gambar, unggah terlebih dahulu gambar tersebut ke bucket Object Storage Service (OSS). Untuk informasi selengkapnya, lihat Upload objects.
• Dalam beberapa skenario, Anda mungkin ingin membuat gambar berdasarkan data sistem operasi dari server sumber, mengimpornya ke ECS, lalu membuat instance ECS dari gambar tersebut. Server sumber dapat berupa server fisik, mesin virtual, atau cloud host. Jika driver virtio belum diinstal pada server sumber, instance ECS yang dibuat mungkin tidak dapat dijalankan. Untuk mencegah masalah ini, pastikan driver virtio telah diinstal pada server sumber sebelum mengimpor gambar. Untuk informasi selengkapnya, lihat Install the virtio driver.

• Sebelum mengimpor gambar untuk pertama kalinya, Anda harus memberikan otorisasi kepada ECS melalui Resource Access Management (RAM) agar dapat mengakses Bucket OSS Anda. Jika ECS tidak diberi otorisasi untuk mengakses Bucket OSS Anda, operasi ImportImage akan mengembalikan kode kesalahan NoSetRoletoECSServiceAcount. Anda dapat menyelesaikan otorisasi ini dengan satu klik di halaman Otorisasi Akses Sumber Daya Cloud pada konsol RAM. Alternatif lain, Anda dapat menyelesaikan otorisasi menggunakan Peran RAM dan kebijakan RAM. Contoh berikut menunjukkan kebijakan dan izin yang diperlukan dalam prosedur otorisasi. Untuk informasi selengkapnya, lihat Kontrol akses ke sumber daya dengan menggunakan Pengguna RAM.

  1. Buat peran bernama AliyunECSImageImportDefaultRole. Nama peran ini harus digunakan secara tepat; jika tidak, gambar tidak dapat diimpor. Konfigurasikan kebijakan kepercayaan berikut untuk peran tersebut:

          {
  			"Statement": [
  			{
  				"Action": "sts:AssumeRole",
  				"Effect": "Allow",
  				"Principal": {
  				"Service": [
  					"ecs.aliyuncs.com"
  				]
  				}
  			}
          ],
  			"Version": "1"
          }
          

  2. Lampirkan kebijakan sistem AliyunECSImageImportRolePolicy ke peran tersebut. Anda juga dapat membuat kebijakan kustom yang berisi konten berikut dan melampirkannya ke peran tersebut:

          {
  			"Version": "1",
  			"Statement": [
  			{
  				"Action": [
          				"oss:GetObject",
          				"oss:GetBucketLocation",
          				"oss:GetBucketInfo"
  			],
          			"Resource": "*",
          			"Effect": "Allow"
          			}
  			]
          }
          

• Anda tidak dapat menghapus gambar yang sedang dalam proses impor. Namun, Anda dapat membatalkan tugas impor gambar dengan memanggil operasi CancelTask.
• Anda hanya dapat mengimpor gambar ke wilayah yang sama dengan bucket OSS tempat file gambar diunggah.
• Nilai N yang valid dalam DiskDeviceMapping.N berkisar dari 1 hingga 17. Saat N diatur ke 1, disk tersebut merupakan disk sistem. Saat N diatur ke nilai antara 2 hingga 17, disk tersebut merupakan disk data. Jika N lebih dari 17, parameter yang diawali dengan DiskDeviceMapping.N akan diabaikan.
• Saat Anda mengatur Architecture ke arm64 atau mengatur Platform ke CentOS Stream, Anolis, AlmaLinux, UOS, Kylin, atau Rocky Linux, perhatikan hal-hal berikut:
  • Untuk memastikan password dapat diatur atau pasangan kunci dapat dimodifikasi pada gambar yang diimpor, pastikan gambar tersebut memenuhi persyaratan berikut sebelum diimpor:
    • Kernel sistem operasi mendukung fitur CONFIG_FW_CFG_SYSFS. Secara default, kernel komunitas Linux versi 4.6 ke atas dan kernel CentOS versi 3.10.0-826.el7 ke atas mendukung fitur ini. Anda dapat menjalankan perintah grep -nr CONFIG_FW_CFG_SYSFS /boot/config-$(uname -r) pada server sumber gambar. Jika output perintah tersebut berisi CONFIG_FW_CFG_SYSFS=y, berarti kernel gambar tersebut mendukung fitur CONFIG_FW_CFG_SYSFS.
    • Alibaba Cloud cloud-init versi terbaru telah diinstal pada sistem operasi. Jika versi cloud-init adalah 19.1, versi minor harus 19.1.3 atau lebih baru. Jika versi cloud-init adalah 0.7.6a pada beberapa versi awal sistem operasi, versi minor harus 0.7.6a15 atau lebih baru. Untuk informasi selengkapnya, lihat Install cloud-init.
    • Sistem operasi mendukung algoritma enkripsi SHA-512.
  • Jika Anda ingin gambar yang diimpor mendukung pengubahan ukuran disk dan sistem file, pastikan gambar tersebut memenuhi persyaratan berikut sebelum diimpor:
    • Versi kernel sistem operasi lebih baru dari 3.6.
    • Gambar mendukung perintah growpart. Untuk mendukung perintah ini, instal paket cloud-utils-growpart. Metode instalasi paket ini bervariasi tergantung sistem operasi. Untuk informasi selengkapnya, lihat Extend the partitions and file systems of disks on a Linux instance.
    • Gambar mendukung perintah resize2fs. Untuk mendukung perintah ini, instal paket e2fsprogs. Secara default, paket ini telah diinstal pada sistem operasi. Jika belum, instal paket tersebut.
    • Alibaba Cloud cloud-init versi terbaru telah diinstal pada sistem operasi. Jika versi cloud-init adalah 19.1, versi minor harus 19.1.3 atau lebih baru. Jika versi cloud-init adalah 0.7.6a pada beberapa versi awal sistem operasi, versi minor harus 0.7.6a15 atau lebih baru. Untuk informasi selengkapnya, lihat Install cloud-init.
• Jika gambar yang ingin Anda impor menggunakan arsitektur ARM64, konfigurasikan real-time clock (RTC) agar menggunakan standar waktu Coordinated Universal Time (UTC). Untuk informasi selengkapnya, lihat Linux time and time zones.
• Saat mengimpor gambar, disarankan untuk menentukan DetectionStrategy agar gambar dapat dioptimalkan berdasarkan hasil pemeriksaan. Untuk informasi selengkapnya, lihat Image check items.

Parameter permintaan

Parameter respons

Contoh

Permintaan contoh

http(s)://ecs.aliyuncs.com/?Action=ImportImage
&RegionId=cn-hangzhou
&DiskDeviceMapping.1.Format=QCOW2
&DiskDeviceMapping.1.OSSBucket=ecsimageos
&DiskDeviceMapping.1.OSSObject=CentOS_5.4_32.raw
&DiskDeviceMapping.1.DiskImageSize=80
&ImageName=Test
&Description=Test
&Architecture=x86_64
&OSType=linux
&Platform=Aliyun
&LicenseType=Aliyun
&DetectionStrategy=Standard
&<Common request parameters>

Respons sukses contoh

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<ImportImageResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
    <ImageId>m-bp67acfmxazb4p****</ImageId>
    <TaskId>t-bp67acfmxazb4p****</TaskId>
    <RegionId>cn-hangzhou</RegionId>
</ImportImageResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "ImageId" : "m-bp67acfmxazb4p****",
  "TaskId" : "t-bp67acfmxazb4p****",
  "RegionId" : "cn-hangzhou"
}

Kode kesalahan

Untuk daftar kode kesalahan, lihat Kode kesalahan layanan.