:ImportImage

Kullanım notları

Aşağıdaki hususlara dikkat edin:

• Görüntüyü aktarmadan önce, görüntüyü bir Object Storage Service (OSS) paketinde depolamanız gerekir. Daha fazla bilgi için bkz.Nesne yükleme.

• Bazı senaryolarda, kaynak sunucunun işletim sistemi verilerine dayalı bir görüntü oluşturmak, bu görüntüyü ECS'e aktarmak ve ardından aktarılan görüntüden bir ECS örneği oluşturmak isteyebilirsiniz. Kaynak sunucu fiziksel bir sunucu, sanal makine veya bulut ana bilgisayarı olabilir. Kaynak sunucuda virtio sürücüsü yüklü değilse, oluşturulan ECS örneği başlatılamayabilir. Bu sorunu önlemek için, görüntü aktarmadan önce kaynak sunucuda virtio sürücüsünün yüklü olduğunu doğrulamanız gerekir. Daha fazla bilgi için bkz.virtio sürücüsünü yükleme.

• İlk kez görüntü aktarmadan önce, Resource Access Management (RAM) kullanarak ECS'in OSS paketlerinize erişmesine izin vermeniz gerekir. ECS'in OSS paketlerinize erişim izni yoksa, ImportImage işlemini çağırdığınızda NoSetRoletoECSServiceAcount hata kodu döndürülür. Yetkilendirmeyi RAM konsolundaki Cloud Kaynak Erişimi Yetkilendirme sayfasında tek tıkla tamamlayabilirsiniz. Yetkilendirmeyi bir RAM rolü ve RAM ilkeleri kullanarak da tamamlayabilirsiniz. Aşağıdaki örnekler, yetkilendirme yordamındaki bazı adımlar için gereken ilkeleri ve izinleri göstermektedir. Daha fazla bilgi için bkz. RAM kullanıcılarını kullanarak kaynaklara erişimi kontrol etme.

  1. AliyunECSImageImportDefaultRole adlı bir rol oluşturun. Bu tam rol adını kullanmanız gerekir. Aksi takdirde görüntü aktarılamaz. Rol için aşağıdaki güven ilkesini yapılandırın: { "Statement": [ { "Action": "sts:AssumeRole", "Effect": "Allow", "Principal": { "Service": [ "ecs.aliyuncs.com" ] } } ], "Version": "1" }

  2. AliyunECSImageImportRolePolicy sistem ilkesini role ekleyin. Ayrıca aşağıdaki içeriği içeren özel bir ilke oluşturup bu ilkeyi role ekleyebilirsiniz: { "Version": "1", "Statement": [ { "Action": [ "oss:GetObject", "oss:GetBucketLocation", "oss:GetBucketInfo" ], "Resource": "*", "Effect": "Allow" } ] }

• Aktarılmakta olan bir görüntüyü silemezsiniz. Ancak, görüntü aktarma görevini iptal etmek için CancelTask işlemini çağırabilirsiniz.

• Bir görüntüyü yalnızca görüntü dosyasının yüklendiği OSS paketi ile aynı bölgeye aktarabilirsiniz.

• DiskDeviceMapping.N içindeki N parametresinin geçerli değerleri 1 ile 17 arasındadır. N değeri 1 olarak ayarlandığında, disk bir sistem diskidir. N değeri 2 ile 17 arasında bir değer olarak ayarlandığında, disk bir veri diskidir. N değeri 17'den büyük olarak ayarlandığında, DiskDeviceMapping.N önekli parametreler yoksayılır.

• Architecture parametresini arm64 olarak ayarladığınızda veya Platform parametresini CentOS Stream, Anolis, AlmaLinux, UOS, Kylin veya Rocky Linux olarak ayarladığınızda aşağıdaki hususlara dikkat edin:

  • Aktarılan bir görüntü için parolanın ayarlanabilmesini veya anahtar çiftinin değiştirilebilmesini sağlamak amacıyla, görüntüyü aktarmadan önce görüntünün aşağıdaki gereksinimleri karşıladığından emin olun:

    • İşletim sisteminin çekirdeği CONFIG_FW_CFG_SYSFS özelliğini destekler. Varsayılan olarak Linux topluluğu çekirdeği %4,6 ve sonraki sürümler ile CentOS çekirdeği %3,10.0-826.el7 ve sonraki sürümler bu özelliği destekler. Görüntünün kaynak sunucusunda grep -nr CONFIG_FW_CFG_SYSFS /boot/config-$(uname -r) komutunu çalıştırabilirsiniz. Komut çıktısı CONFIG_FW_CFG_SYSFS=y içeriyorsa, görüntünün çekirdeği CONFIG_FW_CFG_SYSFS özelliğini destekler.

    • İşletim sisteminde en son sürüm Alibaba Cloud cloud-init yüklüdür. cloud-init sürümü %19,1 ise, alt sürüm %19,1.3 veya üzeri olmalıdır. İşletim sisteminin bazı erken sürümlerinde cloud-init sürümü %0,7.6a ise, alt sürüm %0,7.6a15 veya üzeri olmalıdır. Daha fazla bilgi için bkz.cloud-init yükleme.

    • İşletim sistemi SHA-512 şifreleme algoritmasını destekler.

  • Aktarılan bir görüntünün disklerin ve dosya sistemlerinin yeniden boyutlandırılmasını desteklemesini istiyorsanız, görüntüyü aktarmadan önce görüntünün aşağıdaki gereksinimleri karşıladığından emin olun:

    • İşletim sisteminin çekirdek sürümü %3,6'dan sonradır.

    • Görüntü growpart komutunu destekler. Bu komutu desteklemek için cloud-utils-growpart paketini yüklemeniz gerekir. Paketi yükleme yöntemleri işletim sistemlerine göre değişir. Daha fazla bilgi için bkz.Linux örneğindeki disklerin bölümlerini ve dosya sistemlerini genişletme.

    • Görüntü resize2fs komutunu destekler. Bu komutu desteklemek için e2fsprogs paketini yüklemeniz gerekir. Paket varsayılan olarak işletim sisteminde yüklüdür. Paket yüklü değilse yükleyin.

    • İşletim sisteminde en son sürüm Alibaba Cloud cloud-init yüklüdür. cloud-init sürümü %19,1 ise, alt sürüm %19,1.3 veya üzeri olmalıdır. İşletim sisteminin bazı erken sürümlerinde cloud-init sürümü %0,7.6a ise, alt sürüm %0,7.6a15 veya üzeri olmalıdır. Daha fazla bilgi için bkz.cloud-init yükleme.

• Aktarmak istediğiniz görüntü ARM64 mimarisini kullanıyorsa, gerçek zamanlı saati (RTC) Eşgüdümlü Evrensel Saat (UTC) zaman standardını kullanacak şekilde yapılandırmanız gerekir. Daha fazla bilgi için bkz.Linux zamanı ve saat dilimleri.

• Görüntüleri aktarırken DetectionStrategy parametresini belirtmenizi öneririz. Bu sayede görüntü denetimi sonuçlarına göre görüntüleri optimize edebilirsiniz. Daha fazla bilgi için bkz.Görüntü denetimi öğeleri.

İstek parametreleri

Yanıt parametreleri

Örnekler

Örnek istekler

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>

Örnek başarılı yanıtlar

XML biçimi

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 biçimi

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

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

Hata kodları

Hata kodlarının listesi için bkz. Hizmet hata kodları.