Tüm Ürünler
Search
Belge Merkezi

:CreateLaunchTemplate

Son Güncelleme:Oct 02, 2026

Bir ECS örneği başlatma şablonu oluşturur. Başlatma şablonu, her örnek oluşturduğunuzda çok sayıda parametreyi yapılandırma ihtiyacını ortadan kaldırır.

Operation description

CreateLaunchTemplate çağrısı yaparak bir şablon oluşturduktan sonra, sürüm numarası 1 olan varsayılan bir sürüm otomatik olarak oluşturulur. Daha sonra bu şablona dayalı olarak birden fazla sürüm oluşturabilirsiniz (CreateLaunchTemplateVersion); sürüm numaraları 1'den başlayarak sıralı olarak artar. Örnek oluştururken (RunInstances) bir şablon sürümü belirtmezseniz, varsayılan sürüm kullanılır.

Bir başlatma şablonu sürümü; bölge, görüntü kimliği, örnek türü, güvenlik grubu kimliği ve genel bant genişliği gibi örnekleri oluşturmak için kullanılan yapılandırmaları içerir. Sürümde belirli bir örnek yapılandırması belirtilmemişse, örnekleri oluştururken bunu belirtmeniz gerekir.

Bu işlemi çağırırken aşağıdaki hususlara dikkat edin:

  • Her hesap, bölge başına en fazla 30 başlatma şablonu oluşturabilir ve her şablon en fazla 30 sürüme sahip olabilir.

  • Bir başlatma şablonundaki parametrelerin çoğu isteğe bağlıdır. Bir şablon oluşturduğunuzda Alibaba Cloud, parametre değerlerinin varlığını veya geçerliliğini doğrulamaz. Parametre değerlerinin geçerliliği yalnızca gerçek örnekleri oluşturduğunuzda doğrulanır.

  • Başlatma şablonunda belirli bir yapılandırma ayarlanmışsa, örnekler oluşturulurken (RunInstances) bu yapılandırma filtrelenemez. Örneğin, şablon HostName=LocalHost olarak ayarlanmışsa ve RunInstances içinde HostName değeri boş bırakılmışsa, örneğin ana bilgisayar adı yine de LocalHost olur. HostName=LocalHost yapılandırmasını geçersiz kılmak için RunInstances içinde HostName=MyHost veya başka bir değer ayarlayın.

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:CreateLaunchTemplate

create

*LaunchTemplate

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

None None

Request parameters

Parameter

Type

Required

Description

Example

RegionId

string

Yes

Bölge kimliği. En son bölge listesini sorgulamak için DescribeRegions çağrısı yapabilirsiniz.

cn-hangzhou

TemplateTag

array<object>

No

Başlatma şablonunun kendisine ait etiket bilgileri.

Not

Şu anda, başlatma şablonları için etiketleri yalnızca API işlemlerini çağırarak oluşturabilir ve sorgulayabilirsiniz. Bu etiketleri konsolda oluşturamaz veya görüntüleyemezsiniz.

object

No

Başlatma şablonunun kendisine ait etiket anahtar-değer çiftleri.

Key

string

No

Başlatma şablonunun etiket anahtarı. N için geçerli değerler: 1 ile 20 arası. Etiket anahtarı boş bir dize olamaz. Etiket anahtarı en fazla 128 karakter uzunluğunda olabilir ve aliyun veya acs: ile başlayamaz. Etiket anahtarı http:// veya https:// içeremez.

TestKey

Value

string

No

Başlatma şablonunun etiket değeri. N için geçerli değerler: 1 ile 20 arası. Etiket değeri boş bir dize olabilir. Etiket değeri en fazla 128 karakter uzunluğunda olabilir ve aliyun veya acs: ile başlayamaz. Etiket değeri http:// veya https:// içeremez.

TestValue

LaunchTemplateName

string

Yes

Başlatma şablonunun adı. Ad, 2 ila 128 karakter uzunluğunda olmalıdır. Bir harfle başlamalıdır ve http:// veya https:// ile başlayamaz. Ad; rakamlar, iki nokta üst üste (:), alt çizgiler (_) ve tireler (-) içerebilir.

testLaunchTemplateName

VersionDescription

string

No

Başlatma şablonu sürümünün açıklaması. Açıklama 2 ila 256 karakter uzunluğunda olmalıdır ve http:// veya https:// ile başlayamaz.

testVersionDescription

ImageId

string

No

Görüntü kimliği. Kullanılabilir görüntü kaynaklarını sorgulamak için DescribeImages çağrısı yapabilirsiniz.

win2008r2_64_ent_sp1_en-us_40G_alibase_20170915.vhd

ImageOwnerAlias

string

No

Görüntünün kaynağı. Geçerli değerler:

  • system: Alibaba Cloud tarafından sağlanan genel görüntüler.

  • self: Oluşturduğunuz özel görüntüler.

  • others: Diğer Alibaba Cloud hesaplarından paylaşılan görüntüler.

  • marketplace: Alibaba Cloud Marketplace tarafından sağlanan görüntüler. Alibaba Cloud Marketplace görüntülerini önce abone olmadan doğrudan kullanabilirsiniz. Alibaba Cloud Marketplace görüntülerinin faturalandırma ayrıntılarını kendiniz kontrol edin.

system

PasswordInherit

boolean

No

Görüntünün önceden ayarlanmış parolasının kullanılıp kullanılmayacağını belirtir.

Not

Bu parametreyi kullandığınızda, Password parametresi boş olmalıdır. Kullandığınız görüntünün önceden ayarlanmış bir parolası olduğundan emin olun.

false

InstanceType

string

No

Örnek türü. Daha fazla bilgi için Örnek ailesi konusuna bakın. En son örnek türü listesini sorgulamak için DescribeInstanceTypes çağrısı da yapabilirsiniz.

ecs.g5.large

SecurityGroupId

string

No

Yeni örneğin ait olduğu güvenlik grubunun kimliği. Aynı güvenlik grubundaki örnekler birbirleriyle iletişim kurabilir. Bir güvenlik grubu en fazla 1.000 örnek içerebilir.

Not

Aynı anda hem SecurityGroupId hem de SecurityGroupIds.N değerlerini belirtemezsiniz.

sg-bp15ed6xe1yxeycg****

VpcId

string

No

Sanal özel bulutun (VPC) kimliği.

vpc-bp12433upq1y5scen****

VSwitchId

string

No

vSwitch kimliği. Bu parametre, VPC'ye bağlı bir örnek oluşturduğunuzda gereklidir.

vsw-bp1s5fnvk4gn2tws0****

InstanceName

string

No

Örneğin adı. Ad 2 ila 128 karakter uzunluğunda olmalıdır ve Unicode harf kategorisindeki karakterleri (İngilizce ve Çince harfler ile rakamlar dahil) içerebilir. Ad; iki nokta üst üste (:), alt çizgiler (_), noktalar (.) ve tireler (-) içerebilir. Varsayılan değer, örneğin InstanceId değeridir.

Birden fazla ECS örneği oluştururken, köşeli parantez ([]) ve virgül (,) içeren sıralı örnek adları ayarlayabilirsiniz. Daha fazla bilgi için Birden fazla örnek için sıralı adları veya ana bilgisayar adlarını toplu olarak yapılandırma konusuna bakın.

k8s-node-[1,4]-alibabacloud

Description

string

No

Örneğin açıklaması. Açıklama 2 ila 256 karakter uzunluğunda olmalıdır ve http:// veya https:// ile başlayamaz.

testECSDescription

InternetMaxBandwidthIn

integer

No

Maksimum gelen genel bant genişliği. Birim: Mbit/s. Geçerli değerler:

  • Satın alınan giden genel bant genişliği 10 Mbit/s'den az veya ona eşitse: 1 ila 10. Varsayılan değer: 10.

  • Satın alınan giden genel bant genişliği 10 Mbit/s'den fazlaysa: 1 ile InternetMaxBandwidthOut değeri arası. Varsayılan değer: InternetMaxBandwidthOut değeri.

10

InternetMaxBandwidthOut

integer

No

Maksimum giden genel bant genişliği. Birim: Mbit/s. Geçerli değerler: 0 ila 100.

10

HostName

string

No

Elastic Compute Service sunucusunun ana bilgisayar adı.

  • Ana bilgisayar adı nokta (.) veya tire (-) ile başlayamaz veya bitemez. Ardışık noktalar (.) veya tireler (-) içeremez.

  • Windows örnekleri için: Ana bilgisayar adı 2 ila 15 karakter uzunluğunda olmalıdır ve nokta (.) içeremez veya tamamen rakamlardan oluşamaz. Harfler, rakamlar ve tireler (-) içerebilir.

  • Linux gibi diğer örnekler için: Ana bilgisayar adı 2 ila 64 karakter uzunluğunda olmalıdır. Ana bilgisayar adını birden fazla bölüme ayırmak için noktalar (.) kullanabilirsiniz. Her bölüm harfler, rakamlar ve tireler (-) içerebilir.

testHostName

ZoneId

string

No

Örneğin kullanılabilirlik bölgesi kimliği.

cn-hangzhou-g

SystemDisk.Category

string

No

Sistem diskinin kategorisi. Geçerli değerler:

  • cloud: temel disk.

  • cloud_efficiency: ultra disk.

  • cloud_ssd: standart SSD.

  • cloud_essd: kurumsal SSD (ESSD). Diskin performans düzeyini yapılandırmak için SystemDisk.PerformanceLevel parametresini kullanabilirsiniz.

  • cloud_auto: ESSD AutoPL disk.

  • cloud_essd_entry: ESSD Entry disk.

I/O optimize edilmemiş örnekler olan kullanımdan kaldırılmış örnek türleri için varsayılan değer cloud'dur. Diğer örnek türleri için varsayılan değer cloud_efficiency'dir.

cloud_ssd

SystemDisk.Size

integer

No

Sistem diskinin boyutu. Birim: GiB. Geçerli değerler:

  • cloud: 20 ila 500.

  • Diğer disk kategorileri: 20 ila 2048.

Bu parametrenin değeri max{20, ImageSize} değerinden büyük veya ona eşit olmalıdır.

40

SystemDisk.DiskName

string

No

Sistem diskinin adı. Ad, 2 ila 128 karakter uzunluğunda olmalıdır. Bir harfle başlamalıdır ve http:// veya https:// ile başlayamaz. Ad; rakamlar, iki nokta üst üste (:), alt çizgiler (_) ve tireler (-) içerebilir.

testSystemDiskName

SystemDisk.Description

string

No

Sistem diskinin açıklaması. Açıklama 2 ila 256 karakter uzunluğunda olmalıdır ve http:// veya https:// ile başlayamaz.

testSystemDiskDescription

SystemDisk.Iops

integer

No

Not

Bu parametre davetiyeli önizleme aşamasındadır ve herkese açık değildir.

null

SystemDisk.PerformanceLevel

string

No

Sistem diski olarak kullanılan ESSD'nin performans düzeyi. Diskin performans düzeyi ayarları. Geçerli değerler:

  • PL0 (varsayılan): Tek bir disk, 10.000'e kadar rastgele okuma/yazma IOPS değeri sunabilir.

  • PL1: Tek bir disk, 50.000'e kadar rastgele okuma/yazma IOPS değeri sunabilir.

  • PL2: Tek bir disk, 100.000'e kadar rastgele okuma/yazma IOPS değeri sunabilir.

  • PL3: Tek bir disk, 1.000.000'a kadar rastgele okuma/yazma IOPS değeri sunabilir.

ESSD performans düzeylerinin nasıl seçileceği hakkında bilgi için Kurumsal SSD'ler konusuna bakın.

PL0

SystemDisk.DeleteWithInstance

boolean

No

Örnek serbest bırakıldığında sistem diskinin serbest bırakılıp bırakılmayacağını belirtir. Geçerli değerler:

  • true: Sistem diski örnekle birlikte serbest bırakılır.

  • false: Sistem diski örnekle birlikte serbest bırakılmaz.

Varsayılan değer: true.

true

SystemDisk.AutoSnapshotPolicyId

string

No

Sistem diskine uygulanan otomatik anlık görüntü ilkesinin kimliği.

sp-gc7c37d4ylw7mtnk****

SystemDisk.ProvisionedIops

integer

No

ESSD AutoPL diskinin sağlanan okuma/yazma IOPS değeri. Geçerli değerler: 0 ile min{50000, 1000 × Capacity - Baseline performance} arası.

Temel performans = min{1.800 + 50 × Capacity, 50.000}

Not

Bu parametre yalnızca DiskCategory değeri cloud_auto olarak ayarlandığında kullanılabilir. Daha fazla bilgi için ESSD AutoPL diskleri ve ESSD AutoPL diskinin sağlanan performansını değiştirme konularına bakın.

50000

SystemDisk.BurstingEnabled

boolean

No

Performans artışı özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

  • true: Performans artışı özelliğini etkinleştirir.

  • false: Performans artışı özelliğini devre dışı bırakır.

true

IoOptimized

string

No

Örneğin I/O optimize edilip edilmediğini belirtir. Geçerli değerler:

  • none: Örnek I/O optimize edilmemiştir.

  • optimized: Örnek I/O optimize edilmiştir.

optimized

InstanceChargeType

string

No

Örneğin faturalandırma yöntemi. Geçerli değerler:

  • PrePaid: abonelik. Bu parametreyi PrePaid olarak ayarlarsanız, hesabınızın kredi ödemelerini desteklediğini onaylayın. Aksi takdirde, bir InvalidPayMethod hatası döndürülür.

  • PostPaid: kullandıkça öde.

PrePaid

Period

integer

No

Kaynağın abonelik süresi. Birim: ay. Bu parametre yalnızca InstanceChargeType değeri PrePaid olarak ayarlandığında geçerli olur ve gereklidir. Geçerli değerler: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48 ve 60.

1

InternetChargeType

string

No

Ağ kullanımı için faturalandırma yöntemi. Geçerli değerler:

  • PayByBandwidth: bant genişliğine göre ödeme.

  • PayByTraffic: trafiğe göre ödeme.

Not

Trafiğe göre ödeme modunda, garanti edilen performans özellikleri yerine bant genişliklerinin üst sınırları olarak en yüksek gelen ve giden bant genişlikleri kullanılır. Kaynak çekişmesi meydana geldiğinde, bu en yüksek bant genişlikleri sınırlandırılabilir. İşletmeniz için garanti edilen bant genişlikleri istiyorsanız, bant genişliğine göre ödeme faturalandırma modunu kullanın.

PayByTraffic

EnableVmOsConfig

boolean

No

Örneğin işletim sistemi yapılandırmasının etkinleştirilip etkinleştirilmeyeceğini belirtir.

Not

Bu parametre kullanımdan kaldırılacaktır. Daha iyi uyumluluk için diğer parametreleri kullanın.

false

NetworkType

string

No

Örneğin ağ türü. Geçerli değerler:

vpc

UserData

string

No

Örneğin örnek kullanıcı verileri. Örnek kullanıcı verileri Base64 ile kodlanmalıdır. Ham veriler en fazla 32 KB boyutunda olabilir.

ZWNobyBoZWxsbyBlY3Mh

KeyPairName

string

No

Anahtar çiftinin adı.

  • Windows örnekleri için bu parametre yoksayılır. Bu parametreyi belirtseniz bile, yalnızca Password içeriği kullanılır.

  • Linux örnekleri için, başlatma sırasında parola oturum açma yöntemi devre dışı bırakılır.

testKeyPairName

RamRoleName

string

No

Örnek RAM rolünün adı. Oluşturduğunuz örnek RAM rollerini sorgulamak için RAM API'si ListRoles çağrısı yapabilirsiniz.

testRamRoleName

AutoReleaseTime

string

No

Otomatik serbest bırakma zamanı. Zamanı ISO 8601 standardında yyyy-MM-ddTHH:mm:ssZ biçiminde belirtin. Zaman UTC olmalıdır.

  • Saniye (ss) değeri 00 değilse, zaman otomatik olarak geçerli dakikanın (mm) başına yuvarlanır.

  • En erken serbest bırakma zamanı, geçerli zamandan en az yarım saat sonra olmalıdır.

  • En son serbest bırakma zamanı, geçerli zamandan üç yıldan fazla olamaz.

2018-01-01T12:05:00Z

SpotStrategy

string

No

Kullandıkça öde örneği için ön alma politikası. Bu parametre, InstanceChargeType değeri PostPaid olarak ayarlandığında geçerli olur. Geçerli değerler:

  • NoSpot: Örnek, normal bir kullandıkça öde örneğidir.

  • SpotWithPriceLimit: Örnek, kullanıcı tanımlı maksimum saatlik fiyata sahip bir spot örneğidir.

  • SpotAsPriceGo: Örnek, satın alma anındaki piyasa fiyatının teklif fiyatı olarak otomatik kullanıldığı bir spot örneğidir.

NoSpot

SpotPriceLimit

number

No

Örneğin maksimum saatlik fiyatı. Bu parametre en fazla üç ondalık basamağı destekler ve SpotStrategy değeri SpotWithPriceLimit olarak ayarlandığında geçerli olur.

0.97

SpotDuration

integer

No

Spot örneğinin koruma süresi. Birim: saat. Varsayılan değer: 1. Geçerli değerler:

  • 1: Bir spot örnek oluşturulduktan sonra Alibaba Cloud, örneğin 1 saat içinde otomatik olarak serbest bırakılmamasını sağlar. 1 saatlik koruma süresi sona erdikten sonra sistem, teklif fiyatını piyasa fiyatıyla karşılaştırır ve örneği otomatik olarak serbest bırakıp bırakmayacağını belirlemek için kaynak envanterini kontrol eder.

  • 0: Bir spot örnek oluşturulduktan sonra Alibaba Cloud, örneğin 1 saat çalışmasını garanti etmez. Sistem, teklif fiyatını piyasa fiyatıyla karşılaştırır ve örneği otomatik olarak serbest bırakıp bırakmayacağını belirlemek için kaynak envanterini kontrol eder.

Alibaba Cloud, örnek serbest bırakılmadan 5 dakika önce bir ECS sistem olayı bildirimi gönderir. Spot örnekler saniye bazında faturalandırılır. Beklenen görev yürütme süresine göre uygun bir koruma süresi seçin.

Not

Bu parametre, SpotStrategy değeri SpotWithPriceLimit veya SpotAsPriceGo olarak ayarlandığında geçerli olur.

1

ResourceGroupId

string

No

Örnek, blok depolama ve ağ arabirim denetleyicisinin (NIC) ait olduğu kurumsal kaynak grubunun kimliği.

rg-bp67acfmxazb4p****

TemplateResourceGroupId

string

No

Başlatma şablonunun ait olduğu kurumsal kaynak grubunun kimliği.

rg-bp67acfmxazb4p****

SecurityEnhancementStrategy

string

No

İşletim sistemi için güvenlik güçlendirmesinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

  • Active: Güvenlik güçlendirmesini etkinleştirir. Bu değer yalnızca genel görüntüler için geçerlidir.

  • Deactive: Güvenlik güçlendirmesini devre dışı bırakır. Bu değer tüm görüntü türleri için geçerlidir.

Deactive

PrivateIpAddress

string

No

Örneğin özel IP adresi.

VPC'ye bağlı bir ECS örneğine özel bir IP adresi atamak için, vSwitch'in (VSwitchId) CIDR bloğundan kullanılabilir bir IP adresi seçin.

10.1.**.**

DeploymentSetId

string

No

Dağıtım kümesinin kimliği.

ds-bp1brhwhoqinyjd6****

Ipv6AddressCount

integer

No

Birincil ENI'ye atanacak rastgele oluşturulmuş IPv6 adreslerinin sayısı. Geçerli değerler: 1 ila 10.

1

DataDisk

array<object>

No

Veri diski yapılandırmalarının listesi.

object

No

Veri diski yapılandırmalarının listesi.

PerformanceLevel

string

No

Veri diski olarak kullanılan ESSD'nin performans düzeyi. N değeri, DataDisk.N.Category=cloud_essd içindeki değerle aynı olmalıdır. Diskin performans düzeyi ayarları. Geçerli değerler:

  • PL0: Tek bir disk, 10.000'e kadar rastgele okuma/yazma IOPS değeri sunabilir.

  • PL1 (varsayılan): Tek bir disk, 50.000'e kadar rastgele okuma/yazma IOPS değeri sunabilir.

  • PL2: Tek bir disk, 100.000'e kadar rastgele okuma/yazma IOPS değeri sunabilir.

  • PL3: Tek bir disk, 1.000.000'a kadar rastgele okuma/yazma IOPS değeri sunabilir.

ESSD performans düzeylerinin nasıl seçileceği hakkında bilgi için Kurumsal SSD'ler konusuna bakın.

PL1

Description

string

No

Veri diskinin açıklaması. Açıklama 2 ila 256 karakter uzunluğunda olmalıdır ve http:// veya https:// ile başlayamaz.

testDataDiskDescription

SnapshotId

string

No

N veri diskini oluşturmak için kullanılan anlık görüntünün kimliği. N için geçerli değerler: 1 ila 16. DataDisk.N.SnapshotId değerini belirttikten sonra DataDisk.N.Size yoksayılır. Oluşturulan diskin gerçek boyutu, belirtilen anlık görüntünün boyutudur.

Not

15 Temmuz 2013 tarihinde veya öncesinde oluşturulan anlık görüntüler kullanılamaz. Bu tür anlık görüntüleri kullanan istekler reddedilir.

s-bp17441ohwka0yuh****

Size

integer

No

N veri diskinin boyutu. N için geçerli değerler: 1 ila 16. Birim: GiB. Geçerli değerler:

  • cloud: 5 ila 2000

  • cloud_efficiency: 20 ila 32768

  • cloud_ssd: 20 ila 32768

  • cloud_essd: Geçerli değer aralığı, DataDisk.N.PerformanceLevel değerine göre değişir.
    • PL0: 1 ila 32768.

    • PL1: 20 ila 32768.

    • PL2: 461 ila 32768.

    • PL3: 1261 ila 32768.

  • cloud_auto: 1 ila 32.768.

  • cloud_essd_entry: 10 ila 32.768.

Bu parametrenin değeri, SnapshotId tarafından belirtilen anlık görüntünün boyutundan büyük veya ona eşit olmalıdır.

2000

Device

string

No

Veri diskinin bağlama noktası. Adlandırma kuralı, bağlanan veri disklerinin sayısına göre değişir:

  • 1 ila 25 veri diski: /dev/xvd[b-z]

  • 25'ten fazla veri diski: /dev/xvd[aa-zz]. Örneğin, 26. veri diski /dev/xvdaa, 27. veri diski /dev/xvdab olarak adlandırılır ve bu şekilde devam eder.

Not

Bu parametre yalnızca tam görüntü (bütün makine görüntüsü) senaryoları için geçerlidir. Tam görüntüdeki veri diskinin disk kategorisini ve boyutunu değiştirmek için bu parametreyi tam görüntüdeki veri diskinin bağlama noktası olarak ayarlayabilir ve ilgili DataDisk.N.Size ile DataDisk.N.Category parametrelerini değiştirebilirsiniz.

/dev/xvdb

DiskName

string

No

Veri diskinin adı. Ad, 2 ila 128 karakter uzunluğunda olmalıdır. Bir harfle başlamalıdır ve http:// veya https:// ile başlayamaz. Ad; rakamlar, iki nokta üst üste (:), alt çizgiler (_) ve tireler (-) içerebilir.

testDataDiskName

Category

string

No

N veri diskinin kategorisi. Geçerli değerler:

  • cloud_efficiency: ultra disk.

  • cloud_ssd: standart SSD.

  • cloud_essd: kurumsal SSD (ESSD).

  • cloud: temel disk.

  • cloud_auto: ESSD AutoPL disk.

  • cloud_regional_disk_auto: bölgesel ESSD.

  • cloud_essd_entry: ESSD Entry disk.
    Not

    cloud_essd_entry değeri yalnızca InstanceType değeri ecs.u1 veya ecs.e ailesindeki bir örnek türü olarak ayarlandığında desteklenir.

  • elastic_ephemeral_disk_standard: elastik geçici disk - Standart.

  • elastic_ephemeral_disk_premium: elastik geçici disk - Premium Sürüm.

I/O optimize edilmiş örnekler için varsayılan değer cloud_efficiency'dir. I/O optimize edilmemiş örnekler için varsayılan değer cloud'dur. Varsayılan değer optimizasyonu ayrıntıları:

  • InstanceType, I/O optimize edilmemiş kullanımdan kaldırılmış bir örnek türü olarak ayarlanırsa, varsayılan parametre değeri cloud olur.

  • Diğer durumlarda, varsayılan değer cloud_efficiency olur.

cloud_ssd

DeleteWithInstance

boolean

No

Örnek serbest bırakıldığında veri diskinin serbest bırakılıp bırakılmayacağını belirtir. Geçerli değerler:

  • true: Veri diski örnekle birlikte serbest bırakılır.

  • false: Veri diski örnekle birlikte serbest bırakılmaz.

Varsayılan değer: true.

true

Encrypted

string

No

Veri diskinin şifrelenip şifrelenmeyeceğini belirtir.

false

AutoSnapshotPolicyId

string

No

Veri diskine uygulanan otomatik anlık görüntü ilkesinin kimliği.

sp-m5e7fa9ute44ssa****

ProvisionedIops

integer

No

ESSD AutoPL diskinin sağlanan okuma/yazma IOPS değeri. Geçerli değerler: 0 ile min{50000, 1000 × Capacity - Baseline performance} arası.

Temel performans = min{1.800 + 50 × Capacity, 50.000}

Not

Bu parametre yalnızca DiskCategory değeri cloud_auto olarak ayarlandığında kullanılabilir. Daha fazla bilgi için ESSD AutoPL diskleri ve ESSD AutoPL diskinin sağlanan performansını değiştirme konularına bakın.

50000

BurstingEnabled

boolean

No

Performans artışı özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

  • true: Performans artışı özelliğini etkinleştirir.

  • false: Performans artışı özelliğini devre dışı bırakır.

true

KMSKeyId

string

No

Veri diski için KMS anahtar kimliği.

0e478b7a-4262-4802-b8cb-00d****

NetworkInterface

array<object>

No

Elastik Ağ Arabirimi (ENI) bilgileri.

object

No

Elastik Ağ Arabirimi (ENI) bilgileri.

VSwitchId

string

No

Elastik Ağ Arabiriminin (ENI) ait olduğu vSwitch'in kimliği.

Aşağıdaki hususlara dikkat edin:

  • N için geçerli değerler: 1 ile 2 arası. Bir ENI yapılandırdığınızda, birincil ENI veya ikincil ENI yapılandırabilirsiniz. İki ENI yapılandırdığınızda, aynı anda yalnızca bir birincil ENI ve bir ikincil ENI yapılandırabilirsiniz.

  • NetworkInterface.N.InstanceType, Primary olarak ayarlanırsa bu parametreyi yapılandırmalısınız. Bu durumda, bu parametre VSwitchId ile aynı etkiye sahiptir. Ancak hem bu parametreyi hem de VSwitchId değerini belirtemezsiniz.

  • NetworkInterface.N.InstanceType, Secondary olarak ayarlanırsa veya boş bırakılırsa bu parametre isteğe bağlıdır. Varsayılan değer: ECS örneğinin ait olduğu vSwitch.

vsw-bp1s5fnvk4gn2tws0****

NetworkInterfaceName

string

No

Elastik Ağ Arabiriminin (ENI) adı.

Aşağıdaki hususlara dikkat edin:

  • N için geçerli değerler: 1 ile 2 arası. Bir ENI yapılandırdığınızda, birincil ENI veya ikincil ENI yapılandırabilirsiniz. İki ENI yapılandırdığınızda, aynı anda yalnızca bir birincil ENI ve bir ikincil ENI yapılandırabilirsiniz.

  • NetworkInterface.N.InstanceType, Primary olarak ayarlanırsa bu parametreyi yapılandırmanıza gerek yoktur.

testEniName

Description

string

No

İkincil Elastik Ağ Arabiriminin (ENI) açıklaması. Açıklama 2 ila 256 karakter uzunluğunda olmalı ve http:// veya https:// ile başlamamalıdır. NetworkInterface.N içindeki N değeri 1'den büyük olamaz.

testEniDescription

SecurityGroupId

string

No

Elastik Ağ Arabiriminin (ENI) ait olduğu güvenlik grubunun kimliği.

Aşağıdaki hususlara dikkat edin:

  • N için geçerli değerler: 1 ile 2 arası. Bir ENI yapılandırdığınızda, birincil ENI veya ikincil ENI yapılandırabilirsiniz. İki ENI yapılandırdığınızda, aynı anda yalnızca bir birincil ENI ve bir ikincil ENI yapılandırabilirsiniz.

  • NetworkInterface.N.InstanceType, Primary olarak ayarlanırsa bu parametreyi yapılandırmalısınız. Bu durumda, bu parametre SecurityGroupId ile aynı etkiye sahiptir. Ancak SecurityGroupId, SecurityGroupIds.N veya NetworkInterface.N.SecurityGroupIds.N değerlerini belirtemezsiniz.

  • NetworkInterface.N.InstanceType, Secondary olarak ayarlanırsa veya boş bırakılırsa bu parametre isteğe bağlıdır. Varsayılan değer: ECS örneğinin güvenlik grubu.

sg-bp15ed6xe1yxeycg****

PrimaryIpAddress

string

No

Bir Elastik Ağ Arabirimi (ENI) ekler ve birincil IP adresını ayarlar.

Aşağıdaki hususlara dikkat edin:

  • N için geçerli değerler: 1 ile 2 arası:

    • Bir ENI yapılandırırsanız, bir birincil ENI veya bir ikincil ENI yapılandırabilirsiniz. Amount parametresi 1'den büyük bir değere ayarlanırsa ve bu parametre belirtilerek bir birincil ENI yapılandırırsanız, toplu oluşturma sırasında belirtilen IP adresından başlayarak ardışık birincil IP adresları birden fazla ECS örneğine tahsis edilir. Bu durumda, örneklere ikincil bir ENI bağlayamazsınız.

    • İki ENI yapılandırırsanız, aynı anda bir birincil ENI ve bir ikincil ENI yapılandırmalısınız. Amount parametresi 1'den büyük bir değere ayarlanırsa ve bu parametre birincil ENI için belirtilirse, ikincil bir ENI yapılandıramazsınız (yani NetworkInterface.2.InstanceType=Secondary olarak ayarlayamazsınız).

  • NetworkInterface.N.InstanceType, Primary olarak ayarlanırsa, bu parametre PrivateIpAddress ile aynı etkiye sahiptir. Ancak hem bu parametreyi hem de PrivateIpAddress değerini belirtemezsiniz.

  • NetworkInterface.N.InstanceType, Secondary olarak ayarlanırsa veya boş bırakılırsa, bu parametre ikincil ENI'nin birincil IP adresını belirtir. Varsayılan olarak, ENI'nin ait olduğu vSwitch CIDR bloğundan rastgele bir IP adresı seçilir.

Not

Bir ECS örneği oluştururken en fazla bir ikincil ENI bağlayabilirsiniz. Örnek oluşturulduktan sonra, daha fazla ikincil ENI bağlamak için CreateNetworkInterface ve AttachNetworkInterface işlemlerini çağırabilirsiniz.

192.168.**.**

SecurityGroupIds

array

No

Elastik Ağ Arabiriminin (ENI) ait olduğu bir veya daha fazla güvenlik grubunun kimlikleri.

  • İlk N, ENI dizinini belirtir. Geçerli değerler: 1 ile 2 arası. Bir ENI yapılandırdığınızda, birincil ENI veya ikincil ENI yapılandırabilirsiniz. İki ENI yapılandırdığınızda, aynı anda yalnızca bir birincil ENI ve bir ikincil ENI yapılandırabilirsiniz.

  • İkinci N, bir veya daha fazla güvenlik grubu kimliğini belirtir. N için geçerli değerler, bir örneğin ait olabileceği maksimum güvenlik grubu sayısına bağlıdır. Daha fazla bilgi için Güvenlik grubu sınırları konusuna bakın.

Aşağıdaki hususlara dikkat edin:

  • NetworkInterface.N.InstanceType, Primary olarak ayarlanırsa, bu parametreyi veya NetworkInterface.N.SecurityGroupId değerini yapılandırmalısınız. Bu durumda, bu parametre SecurityGroupIds.N ile aynı etkiye sahiptir. Ancak SecurityGroupId, SecurityGroupIds.N veya NetworkInterface.N.SecurityGroupId değerlerini belirtemezsiniz.

  • NetworkInterface.N.InstanceType, Secondary olarak ayarlanırsa veya boş bırakılırsa bu parametre isteğe bağlıdır. Varsayılan değer: ECS örneğinin güvenlik grubu.

sg-bp67acfmxazb4p****

string

No

Elastik Ağ Arabiriminin (ENI) ait olduğu bir veya daha fazla güvenlik grubunun kimlikleri.

  • İlk N, ENI dizinini belirtir. Geçerli değerler: 1 ile 2 arası. Bir ENI yapılandırdığınızda, birincil ENI veya ikincil ENI yapılandırabilirsiniz. İki ENI yapılandırdığınızda, aynı anda yalnızca bir birincil ENI ve bir ikincil ENI yapılandırabilirsiniz.

  • İkinci N, bir veya daha fazla güvenlik grubu kimliğini belirtir. N için geçerli değerler, bir örneğin ait olabileceği maksimum güvenlik grubu sayısına bağlıdır. Daha fazla bilgi için Güvenlik grubu sınırları konusuna bakın.

Aşağıdaki hususlara dikkat edin:

  • NetworkInterface.N.InstanceType, Primary olarak ayarlanırsa, bu parametreyi veya NetworkInterface.N.SecurityGroupId değerini yapılandırmalısınız. Bu durumda, bu parametre SecurityGroupIds.N ile aynı etkiye sahiptir. Ancak SecurityGroupId, SecurityGroupIds.N veya NetworkInterface.N.SecurityGroupId değerlerini belirtemezsiniz.

  • NetworkInterface.N.InstanceType, Secondary olarak ayarlanırsa veya boş bırakılırsa bu parametre isteğe bağlıdır. Varsayılan değer: ECS örneğinin güvenlik grubu.

sg-bp67acfmxazb4p****

InstanceType

string

No

Elastik Ağ Arabiriminin (ENI) türü. N için geçerli değerler: 1 ile 2 arası. Bir ENI yapılandırdığınızda, birincil ENI veya ikincil ENI yapılandırabilirsiniz. İki ENI yapılandırdığınızda, aynı anda yalnızca bir birincil ENI ve bir ikincil ENI yapılandırabilirsiniz.

Geçerli değerler:

  • Primary: birincil ENI.

  • Secondary: ikincil ENI.

Varsayılan değer: Secondary.

Secondary

NetworkInterfaceTrafficMode

string

No

Birincil ENI'nin iletişim modu. Geçerli değerler:

  • Standard: TCP iletişim modunu kullanır.

  • HighPerformance: Elastik RDMA Arabirimini (ERI) etkinleştirir ve RDMA iletişim modunu kullanır.

Standard

DeleteOnRelease

boolean

No

Örnek serbest bırakıldığında ENI'nin tutulup tutulmayacağını belirtir. Geçerli değerler:

  • true: ENI tutulmaz.

  • false: ENI tutulur.

Varsayılan değer: true.

Not

Bu parametre yalnızca ikincil ENI'ler için geçerlidir.

true

Tag

array<object>

No

Bu şablon sürümü kullanılarak oluşturulan örneklerin, disklerin ve birincil ENI'lerin etiketleri.

Senaryolar

Bir şablon oluşturmak için CreateLaunchTemplate işlemini çağırdıktan sonra, örnekleri oluşturmak için otomatik olarak oluşturulan varsayılan sürüm kullanılır. Bu etiketler örneklere, disklere ve birincil ENI'lere uygulanır.

object

No

Bu şablon sürümü kullanılarak oluşturulan örneklerin, disklerin ve birincil ENI'lerin etiketleri.

Key

string

No

Bu şablon sürümü kullanılarak oluşturulan örneklerin, disklerin ve birincil ENI'lerin etiket anahtarı. N için geçerli değerler: 1 ile 20 arası. Etiket anahtarı boş bir dize olamaz. Etiket anahtarı en fazla 128 karakter uzunluğunda olabilir ve aliyun veya acs: ile başlayamaz. Etiket anahtarı http:// veya https:// içeremez.

TestKey

Value

string

No

Bu şablon sürümü kullanılarak oluşturulan örneklerin, disklerin ve birincil ENI'lerin etiket değeri. N için geçerli değerler: 1 ile 20 arası. Etiket değeri boş bir dize olabilir. Etiket değeri en fazla 128 karakter uzunluğunda olabilir ve http:// veya https:// içeremez.

TestValue

SecurityGroupIds

array

No

Örneğin ait olduğu bir veya daha fazla güvenlik grubunun kimlikleri. N için geçerli değerler, bir örneğin ait olabileceği maksimum güvenlik grubu sayısına bağlıdır. Daha fazla bilgi için Sınırlar konusuna bakın.

Not

Hem SecurityGroupId hem de SecurityGroupIds.N değerlerini aynı anda belirtemezsiniz.

sg-bp15ed6xe1yxeycg7****

string

No

Örneğin ait olduğu bir veya daha fazla güvenlik grubunun kimlikleri. N için geçerli değerler, bir örneğin ait olabileceği maksimum güvenlik grubu sayısına bağlıdır. Daha fazla bilgi için Sınırlar konusuna bakın.

Not

Hem SecurityGroupId hem de SecurityGroupIds.N değerlerini aynı anda belirtemezsiniz.

sg-bp15ed6xe1yxeycg7****

SystemDisk.Encrypted

string

No

Sistem diskinin şifrelenip şifrelenmeyeceğini belirtir. Geçerli değerler:

  • true: Sistem diskini şifreler.

  • false: Sistem diskini şifrelemez.

Varsayılan değer: false.

Not

Hong Kong (Çin)'daki D Bölgesi ve Singapur'daki A Bölgesi, bir örnek oluştururken sistem diski şifrelemesini desteklemez.

false

DeletionProtection

boolean

No

Örneğin serbest bırakma koruması özniteliği. Örneğin ECS konsolundan veya DeleteInstance işlemi çağrılarak serbest bırakılıp bırakılamayacağını belirtir. Geçerli değerler:

  • true: Örnek için serbest bırakma korumasını etkinleştirir.

  • false: Örnek için serbest bırakma korumasını devre dışı bırakır.

Varsayılan değer: false.

Not

Bu öznitelik yalnızca kullandıkça öde örnekleri için geçerlidir. Yalnızca manuel serbest bırakma işlemlerini önleyebilir, sistem tarafından başlatılan serbest bırakma işlemlerini önleyemez.

false

CreditSpecification

string

No

Ani yükseltilebilir örneğin çalışma modu. Geçerli değerler:

Standard

AutoRenew

boolean

No

Otomatik yenilemenin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

  • true: Otomatik yenilemeyi etkinleştirir.

  • false: Otomatik yenilemeyi etkinleştirmez.

Varsayılan değer: false.

Not

Bu parametre yalnızca InstanceChargeType, PrePaid olarak ayarlandığında geçerlidir.

true

AutoRenewPeriod

integer

No

Tek bir yenileme için otomatik yenileme süresi. Geçerli değerler:

PeriodUnit, Month olarak ayarlanırsa: 1, 2, 3, 6, 12, 24, 36, 48 ve 60.

Varsayılan değer: 1.

1

PeriodUnit

string

No

Abonelik süresinin birimi. Geçerli değerler:

Month (varsayılan).

Month

HttpEndpoint

string

No

Örnek meta verileri için erişim kanalının etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

  • enabled: Erişim kanalını etkinleştirir.

  • disabled: Erişim kanalını devre dışı bırakır.

Varsayılan değer: enabled.

Not

Örnek meta verileri hakkında daha fazla bilgi için Örnek meta verilerine genel bakış konusuna bakın.

enabled

HttpTokens

string

No

Örnek meta verilerine erişmek için güvenlik açısından güçlendirilmiş modun (IMDSv2) zorunlu olarak kullanılıp kullanılmayacağını belirtir. Geçerli değerler:

  • optional: Güvenlik açısından güçlendirilmiş modu zorunlu olarak kullanmaz.

  • required: Güvenlik açısından güçlendirilmiş modu zorunlu olarak kullanır. Bu parametreyi required olarak ayarladıktan sonra, örnek meta verilerine normal modda erişemezsiniz.

Varsayılan değer: optional.

Not

Örnek meta verilerine erişim modları hakkında daha fazla bilgi için Örnek meta verilerine genel bakış konusuna bakın.

optional

HttpPutResponseHopLimit

integer

No

Not

Bu parametre kullanıma sunulmamıştır.

3

SystemDisk.KMSKeyId

string

No

Sistem diskinin KMS anahtar kimliği.

0e478b7a-4262-4802-b8cb-00d3fb40****

ImageOptions

object

No

Görüntüyle ilgili özellik bilgileri.

LoginAsNonRoot

boolean

No

Bu görüntüyü kullanan örneklerin ecs-user kullanıcısıyla oturum açmayı destekleyip desteklemediğini belirtir. Geçerli değerler:

  • true: desteklenir.

  • false: desteklenmez.

false

SecurityOptions

object

No

Güvenlik seçenekleri.

TrustedSystemMode

string

No

Güvenilir sistem modu. Değeri vTPM olarak ayarlayın.

Aşağıdaki örnek aileleri güvenilir sistem modunu destekler:

  • g7, c7 ve r7.

  • Güvenliği güçlendirilmiş örnek aileleri (g7t, c7t ve r7t).

Yukarıdaki örnek ailelerine ait ECS örnekleri oluştururken bu parametreyi yapılandırmalısınız. Aşağıdaki hususlara dikkat edin:

  • Alibaba Cloud Güvenilir Sistemini kullanmak için bu parametreyi vTPM olarak ayarlayın. Ardından, Alibaba Cloud Güvenilir Sistemi, örnek başlatıldığında güvenilirlik doğrulaması gerçekleştirir.

  • Alibaba Cloud Güvenilir Sistemini kullanmak istemiyorsanız, bu parametreyi boş bırakabilirsiniz. Ancak, oluşturduğunuz ECS örneği Enclave tabanlı gizli bilgi işlem modunu (SecurityOptions.ConfidentialComputingMode=Enclave) kullanıyorsa, örnek için güvenilir sistem de etkinleştirilir.

  • Bir OpenAPI işlemi çağırarak güvenilir bir ECS örneği oluştururken yalnızca RunInstances işlemini kullanabilirsiniz. CreateInstance, SecurityOptions.TrustedSystemMode parametresini desteklemez.

Not

Oluşturma sırasında bir örneği güvenilir örnek olarak belirtirseniz, sistem diskini yalnızca güvenilir sistemi destekleyen bir görüntüyle değiştirebilirsiniz.

Güvenilir sistem hakkında daha fazla bilgi için Güvenliği güçlendirilmiş örnekler için güvenilir özelliklere genel bakış konusuna bakın.

vTPM

EnableSecureBoot

boolean

No

Response elements

Element

Type

Description

Example

object

LaunchTemplateId

string

Başlatma şablonunun kimliği.

lt-m5eiaupmvm2op9d****

RequestId

string

İstek kimliği.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

LaunchTemplateVersionNumber

integer

Başlatma şablonunun sürüm numarası.

20

Examples

Success response

JSON format

{
  "LaunchTemplateId": "lt-m5eiaupmvm2op9d****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "LaunchTemplateVersionNumber": 20
}

Error codes

HTTP status code

Error code

Error message

Description

400 InvalidRegion.NotExist %s The specified region does not exist.
400 MissingParameter %s A parameter is not specified.
400 InvalidParameter %s The specified parameter is invalid.
400 InvalidLaunchTemplateName.Malformed The specified parameter LaunchTemplateName is not valid. The specified LaunchTemplateName parameter is invalid.
400 InvalidDescription.Malformed The specified parameter "VersionDescription" is not valid.
400 InvalidUserData.SizeExceeded %s The size of your specified user data exceeds the maximum allowed value.
400 InvalidUserData.Base64FormatInvalid %s The specified user data is invalid.
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. The specified Tag.N.Key parameter is invalid.
400 InvalidTagValue.Malformed The specified Tag.n.Value is not valid. The specified tag value is invalid.
400 InvalidHostName.Malformed The specified parameter "HostName" is not valid. The specified HostName parameter is invalid.
400 InvalidParams.CreateEniParams %s
500 InternalError The request processing has failed due to some unknown error.
403 LaunchTemplateLimitExceed %s The maximum number of launch templates has been reached.
403 LaunchTemplateName.Duplicated %s The specified launch template name already exists.
403 QuotaExceed.Tags %s The number of specified tags exceeds the upper limit. %s is a variable. An error message is dynamically returned based on call conditions.
403 InvalidOperation.InstanceTypeSecureBootUnsupported The instance type does not support secure boot. The instance type does not support secure boot.
403 InvalidOperation.SecureBootRegionNotSupported Secure Boot is not available in the specified region. The current region does not support enabling Secure Boot.
404 InvalidResourceGroup.NotFound The ResourceGroup provided does not exist in our records. The specified resource group does not exist.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.