Özel bir görüntü oluşturur. Bu işlemi çağırarak özel bir görüntü oluşturduktan sonra, oluşturulan özel görüntüden Elastic Compute Service (ECS) örnekleri oluşturmak için RunInstances işlemini veya sistem disklerini özel görüntü kullanarak değiştirmek için ReplaceSystemDisk işlemini çağırabilirsiniz.
Kullanım notları
Aşağıdaki hususlara dikkat edin:
Oluşturduğunuz özel görüntüyü yalnızca görüntü Available (Available) durumundayken kullanabilirsiniz.
Örnek bilgilerini sorgularken yanıtlar bir örnek için
{"OperationLocks": {"LockReason" : "security"}}içeriyorsa, bu örnek güvenlik nedeniyle kilitlenmiştir ve üzerinde tüm işlemler yasaktır.Görüntünüzü optimize etmek için görüntüyü oluştururken DetectionStrategy parametresini belirtmenizi öneririz. Daha fazla bilgi için bkz. Görüntü denetimine genel bakış.
CreateImage işlemini çağırarak aşağıdaki yöntemlerden birini kullanarak özel bir görüntü oluşturabilirsiniz. Aşağıdaki istek parametreleri öncelik sırasına göre listelenmiştir: InstanceId > DiskDeviceMapping > SnapshotId. İsteğiniz bu parametrelerin ikisini veya daha fazlasını içeriyorsa, özel görüntü daha yüksek önceliğe sahip parametreye göre oluşturulur.
Yöntem 1: Bir örnekten özel görüntü oluşturun. Yalnızca
InstanceIdparametresini kullanarak örneğin kimliğini belirtmeniz gerekir. Örnek Running (Running) veya Stopped (Stopped) durumunda olmalıdır. CreateImage işlemini çağırdıktan sonra, örneğin her diski için bir anlık görüntü oluşturulur. Çalışan bir örnekten özel görüntü oluşturduğunuzda, önbellek verileri disklere yazılmamış olabilir. Bu durumda, özel görüntünün verileri örnek verilerinden biraz farklı olabilir. Örneklerden özel görüntüler oluşturmadan önce StopInstances işlemini çağırarak örnekleri durdurmanızı öneririz.Yöntem 2: Bir örneğin sistem disk anlık görüntüsünden özel görüntü oluşturun. Yalnızca
SnapshotIdparametresini kullanarak sistem disk anlık görüntüsünün kimliğini belirtmeniz gerekir. Belirtilen sistem disk anlık görüntüsü 15 Temmuz 2013 tarihinden sonra oluşturulmuş olmalıdır.Yöntem 3: Birden çok disk anlık görüntüsünden özel görüntü oluşturun. Diskler ve anlık görüntüler arasındaki veri eşlemesini
DiskDeviceMappingile başlayan parametreleri kullanarak belirtmeniz gerekir.
Özel görüntü oluşturmak için 3. Yöntemi kullanırken aşağıdaki hususlara dikkat edin:
Özel görüntüde sistem diskini oluşturmak için kullanmak üzere yalnızca bir anlık görüntü belirtebilirsiniz. Sistem diskinin cihaz adı /dev/xvda olmalıdır.
Özel görüntüde veri disklerini oluşturmak için kullanmak üzere en fazla 16 anlık görüntü belirtebilirsiniz. Veri disklerinin cihaz adları benzersizdir ve alfabetik sırada /dev/xvdb ile /dev/xvdz arasında değişir.
SnapshotIdbelirtilmeyebilir. Bu durumda, belirli bir boyuta sahip boş bir veri diski oluşturulur.Belirtilen disk anlık görüntüsü 15 Temmuz 2013 tarihinden sonra oluşturulmuş olmalıdır.
Hata ayıklama
İstek parametreleri
Parametre | Tür | Gerekli | Örnek | Açıklama |
Action | String | Evet | CreateImage | Gerçekleştirmek istediğiniz işlem. Değeri CreateImage olarak ayarlayın. |
RegionId | String | Evet | cn-hangzhou | Özel görüntünün oluşturulacağı bölgenin kimliği. En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz. |
SnapshotId | String | Hayır | s-bp17441ohwkdca0**** | Özel görüntüyü oluşturmak için kullanmak istediğiniz anlık görüntünün kimliği. |
InstanceId | String | Hayır | i-bp1g6zv0ce8oghu7**** | Özel görüntüyü oluşturmak için kullanmak istediğiniz örneğin kimliği. |
ImageName | String | Hayır | TestCentOS | Özel görüntü adı. Ad 2 ila 128 karakter uzunluğunda olmalıdır. Bir harfle başlamalı ve http:// veya https:// ile başlayamaz. Rakamlar, harfler, iki nokta üst üste (:), alt çizgi (_) ve tire (-) içerebilir. |
ImageFamily | String | Hayır | hangzhou-daily-update | Özel görüntünün görüntü ailesi adı. Ad 2 ila 128 karakter uzunluğunda olmalıdır. Bir harfle başlamalı ve acs: veya aliyun ile başlayamaz. http:// veya https:// içeremez. Rakamlar, harfler, iki nokta üst üste (:), alt çizgi (_) ve tire (-) içerebilir. |
ImageVersion | String | Hayır | 2017011017 | Görüntü sürümü. Not
|
Description | String | Hayır | ImageTestDescription | Görüntü açıklaması. Açıklama 2 ila 256 karakter uzunluğunda olmalı ve http:// veya https:// ile başlayamaz. |
Platform | String | Hayır | CentOS | Özel görüntüdeki sistem diski için işletim sistemi dağıtımı. Sistem diskini oluşturmak için bir veri diski anlık görüntüsü belirtirseniz, Platform parametresini kullanarak sistem diski için işletim sistemi dağıtımını belirtin. Geçerli değerler:
Varsayılan değer: Others Linux. |
BootMode | String | Hayır | BIOS | Özel görüntünün önyükleme modu. Geçerli değerler:
Not Belirtilen görüntünün hangi önyükleme modlarını desteklediğini bilmeniz gerekir. Bu parametreyi kullanarak görüntünün önyükleme modunu değiştirirken, bu görüntüyü kullanan örneklerin normal şekilde başlatılabilmesini sağlamak için görüntü tarafından desteklenen bir önyükleme modu belirtin. |
Architecture | String | Hayır | x86_64 | Sistem diskinin sistem mimarisi. Sistem diskini oluşturmak için bir veri diski anlık görüntüsü belirtirseniz, Architecture parametresini kullanarak sistem diskinin sistem mimarisini belirtin. Geçerli değerler:
Varsayılan değer: x86_64. |
ClientToken | String | Hayır | 123e4567-e89b-12d3-a456-426655440000 | İsteğin yinelenebilirliğini (idempotence) sağlamak için kullanılan istemci belirteci. Belirteci istemci üzerinden oluşturabilirsiniz ancak farklı isteklerde belirtecin benzersiz olduğundan emin olmanız gerekir. Belirteç yalnızca ASCII karakterleri içerebilir ve 64 karakteri aşamaz. Daha fazla bilgi için bkz. Yinelenebilirlik nasıl sağlanır. |
ResourceGroupId | String | Hayır | rg-bp67acfmxazb4p**** | Özel görüntünün atanacağı kaynak grubunun kimliği. Bu parametreyi belirtmezseniz, görüntü varsayılan kaynak grubuna atanır. Not Varsayılan kaynak grubunu yönetme yetkisine sahip olmayan bir Resource Access Management (RAM) kullanıcısı olarak CreateImage işlemini çağırırsanız ve |
DiskDeviceMapping.N.SnapshotId | String | Hayır | s-bp17441ohwkdca0**** | Özel görüntüde N. diski oluşturmak için kullanılan anlık görüntünün kimliği. |
DiskDeviceMapping.N.Size | Integer | Hayır | 2000 | Özel görüntüdeki N. diskin boyutu. Birim: GiB. DiskDeviceMapping.N.Size parametresinin geçerli değerleri ve varsayılan değeri, DiskDeviceMapping.N.SnapshotId değerine bağlı olarak değişir.
|
DiskDeviceMapping.N.Device | String | Hayır | /dev/vdb | Özel görüntüdeki N. diskin cihaz adı. Geçerli değerler:
|
DiskDeviceMapping.N.DiskType | String | Hayır | system | Özel görüntüdeki N. diskin türü. Özel görüntünün sistem diskini bir veri diski anlık görüntüsünden oluşturmak için bu parametreyi belirtebilirsiniz. Bu parametreyi belirtmezseniz, disk türü karşılık gelen anlık görüntü tarafından belirlenir. Geçerli değerler:
|
Tag.N.key | String | Hayır | null | Özel görüntüye eklenecek N. etiketin anahtarı. Not Bu parametre gelecekte kaldırılacaktır. Gelecekteki uyumluluğu sağlamak için Tag.N.Key parametresini kullanmanızı öneririz. |
Tag.N.Key | String | Hayır | KeyTest | Özel görüntüye eklenecek N. etiketin anahtarı. N için geçerli değerler: 1 ila 20. Etiket anahtarı boş bir dize olamaz. Etiket anahtarı en fazla 128 karakter uzunluğunda olabilir ve |
Tag.N.Value | String | Hayır | ValueTest | Özel görüntüye eklenecek N. etiketin değeri. N için geçerli değerler: 1 ila 20. Etiket değeri boş bir dize olabilir. Etiket değeri en fazla 128 karakter uzunluğunda olabilir. |
Tag.N.value | String | Hayır | null | Özel görüntüye eklenecek N. etiketin değeri. Not Bu parametre gelecekte kaldırılacaktır. Gelecekteki uyumluluğu sağlamak için Tag.N.Value parametresini kullanmanızı öneririz. |
DetectionStrategy | String | Hayır | Standard | Görüntüyü denetleme modu. Bu parametreyi belirtmezseniz, görüntü denetlenmez. Yalnızca standart denetim modu desteklenir. Not Bu parametre çoğu Linux ve Windows görüntüsü için desteklenir. Görüntü denetimi öğeleri ve görüntü denetimi için işletim sistemi sınırları hakkında daha fazla bilgi için bkz. Görüntü denetimine genel bakış ve Görüntü denetimi için işletim sistemi sınırları. |
Yanıt parametreleri
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Örnekler
Örnek istekler
https://ecs.aliyuncs.com/?Action=CreateImage
&RegionId=cn-hangzhou
&DiskDeviceMapping.1.Size=2000
&DiskDeviceMapping.1.SnapshotId=s-bp17441ohwkdca0****
&DiskDeviceMapping.1.DiskType=system
&SnapshotId=s-bp17441ohwkdca0****
&InstanceId=i-bp1g6zv0ce8oghu7****
&ImageName=TestCentOS
&ImageVersion=2017011017
&Description=ImageTestDescription
&Platform=CentOS
&Architecture=x86_64
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&Tag.1.Key=KeyTest
&Tag.1.Value=ValueTest
&<Common request parameters>Başarılı yanıt örnekleri
XML formatı
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateImageResponse>
<RequestId>C8B26B44-0189-443E-9816-*******</RequestId>
<ImageId>m-bp146shijn7hujku****</ImageId>
</CreateImageResponse>JSON formatı
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "C8B26B44-0189-443E-9816-*******",
"ImageId" : "m-bp146shijn7hujku****"
}Hata kodları
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Hata kodlarının listesi için bkz. Hizmet hata kodları.