CreateInstance - - Alibaba Cloud Dokümantasyon Merkezi

Abonelik örneği oluşturur. Bu işlem RunInstances ile değiştirilebilir. CreateInstance'a yeni özellikler eklenmeyecektir.

Operation description

Kullanıcı başına çağrı sıklığı: Saniyede 10 çağrı.
Örnek oluşturma eşzamansız bir işlem olduğundan, isteğin zaman aşımı süresini gerektiği gibi artırın. API Code=0 değerini döndürdüğünde, bu yalnızca isteğin başarılı olduğunu gösterir, örneğin başarıyla oluşturulduğunu göstermez. Başarılı bir istek üzerine bir örnek kimliği döndürülür. Ardından örneğin oluşturulup oluşturulmadığını kontrol etmek için örneği kimliğiyle sorgulayabilirsiniz.
InvalidUserData.NotInWhiteList kısıtlaması: Yalnızca satın alma izinleriyle ilgili beyaz listeye eklenen hesaplar örnek oluşturabilir. Aksi takdirde bir hata döndürülür.

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

ens:CreateInstance

create

*Instance

acs:ens:*:{#accountId}:instance/*

None

Request parameters

Parameter	Type	Required	Description	Example
InstanceType	string	Yes	Örnek türü. Örnek türleri hakkında ayrıntılı bilgi için Sınırlar konusuna bakın.	ens.se1.tiny
EnsRegionId	string	Yes	Bölge kimliği.	cn-hangzhou
Password	string	No	Örneğin parolası. Parola 8 ila 30 karakter uzunluğunda olmalı ve şu karakter türlerinden en az üçünü içermelidir: büyük harfler, küçük harfler, rakamlar ve özel karakterler. Aşağıdaki özel karakterler desteklenir: ()`~!@#$%^&*-_+=\|{}[]:;'<>,.?/	yourPassword:1
Period	string	Yes	Abonelik süresi. Geçerli değerler: 1 ile 9 arası ve 12. Birim: ay.	12
ImageId	string	No	Örneği başlatmak için kullanılan görüntünün kimliği.	yourImage ID
SystemDisk.Size	string	No	Sistem bulut diskinin boyutu. Birim: GiB. Değer 10'un katı olmalı ve görüntü boyutundan küçük olmamalıdır. Geçerli aralık için DescribeAvailableResourceInfo tarafından döndürülen SystemDiskMinSize ve SystemDiskMaxSize değerlerine bakın. 20 GiB ve 40 GiB yaygın yapılandırmalardır ve yalnızca bu iki değerin desteklendiği anlamına gelmez.	40
Quantity	string	Yes	Örnek sayısı.	1
DataDisk.1.Size	string	No	İlk veri bulut diskinin boyutu. Birim: GiB. Boyut en az 20 GiB olmalı ve 10'un katı olmalıdır.	50
InternetChargeType	string	No	Bu parametre, ilk kez bir örnek oluşturduğunuzda gereklidir. Zaten örnek kaynaklarınız varsa, varsayılan olarak mevcut faturalandırma yöntemi kullanılır. Geçerli değerler: BandwidthByDay: günlük en yüksek bant genişliği. 95BandwidthByMonth: aylık 95. yüzdelik bant genişliği.	95BandwidthByMonth
AutoRenewPeriod	string	No	Otomatik yenileme süresi. Bu parametre, AutoRenew değeri True olarak ayarlandığında gereklidir. Geçerli değerler: 1 ile 12 arası. Birim: ay.	12
AutoRenew	string	No	Otomatik yenilemenin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler: True \| False (varsayılan).	True
IpType	string	No	IP türü. Geçerli değerler: ipv4 (varsayılan): IPv4. ipv6: IPv6. ipv4Andipv6: IPv4 ve IPv6. Valid values: ipv4 : IPv4 ipv6 : IPv6 ipv4Andipv6 : IPv4 ve IPv6	ipv4
KeyPairName	string	No	Anahtar çiftinin adı. Yalnızca tek bir ad desteklenir.	TestKeyPairName
UserData	string	No	Özel veriler. Veriler `#!` ile başlamalıdır. Maksimum uzunluk 256 karakter ve maksimum boyut 16 KB'dir. Yalnızca özel veri komut dosyaları desteklenir. InstanceMetaData işlenmesi desteklenmez. Base64 ile kodlanmış özel veriler iletebilirsiniz. İstek başlatmak için API'yi çağırdığınızda, belirttiğiniz özel veriler şifrelenmez. Parolalar ve özel anahtarlar gibi gizli bilgileri düz metin olarak iletmeyin. Parola veya özel anahtar iletmeniz gerekiyorsa, önce içeriği şifreleyin ve ardından iletmeden önce Base64 ile kodlayın. İçeriğin şifresini örnek içinde aynı şekilde çözün. Daha fazla bilgi için Veri biçimi konusuna bakın.	#!/bin/sh echo "Hello World. The time is now $(date -R)!" \| tee /home/output.txt
VSwitchId	string	No	vSwitch kimliği.	YourVSwitchId
PrivateIpAddress	string	No	Özel IP adresi. Bir özel IP adresi belirtirseniz, VSwitchId parametresini de belirtmeniz gerekir. vSwitch'in önceden oluşturulmuş olması gerekir. Aksi takdirde bir hata döndürülür.	10.10.10.10
PaymentType	string	No	Ödeme yöntemi. Şu anda bu, Subscription (abonelik örneği) sabit değeridir. Değiştirilmesi desteklenmez. Valid values: Subscription : Abonelik.	Subscription
InstanceName	string	No	Örneğin adı. Adlandırma kuralları: Ad 2 ila 128 karakter uzunluğunda olmalı ve harfler ile Çince karakterler içerebilir. Ad büyük harf, küçük harf veya Çince karakter ile başlamalıdır. http:// veya https:// ile başlayamaz. Ad rakamlar, iki nokta üst üste (:), alt çizgiler (_), noktalar (.) veya tireler (-) içerebilir. Bu parametre belirtilmezse, varsayılan değer örneğin InstanceId değeridir.	test：Instance_Name.1-2
HostName	string	No	Örneğin ana bilgisayar adı. Genel adlandırma kuralları: Nokta (.) ve tire (-) ilk veya son karakter olarak kullanılamaz ve art arda kullanılamaz. Özel adlandırma kuralları: Windows örnekleri: Ana bilgisayar adı 2 ila 15 karakter uzunluğunda olmalıdır. Nokta (.) desteklenmez. Ana bilgisayar adı tamamen rakamlardan oluşamaz. Büyük harfler, küçük harfler, rakamlar ve tireler (-) kullanılabilir. Diğer örnekler (Linux gibi): Ana bilgisayar adı 2 ila 64 karakter uzunluğunda olmalıdır. Birden fazla nokta (.) desteklenir. Nokta ile ayrılan her segment büyük harfler, küçük harfler, rakamlar ve tireler (-) içerebilir.	test-HostName
UniqueSuffix	boolean	No	HostName ve InstanceName parametrelerine sıralı son ekler eklenip eklenmeyeceğini belirtir. Sıralı son ekler 001 ile başlar ve 999'u aşamaz. Örnek: LocalHost001, LocalHost002, MyInstance001 ve MyInstance002. Varsayılan değer: false.	false
PublicIpIdentification	boolean	No	Belirtilen örneğe genel IP adresi atanıp atanamayacağını belirtir. Geçerli değerler: true (varsayılan): Genel IP adresi atanabilir. false: Genel IP adresi atanamaz.	true
PasswordInherit	boolean	No	Görüntünün önceden ayarlanmış parolasının kullanılıp kullanılmayacağını belirtir. Geçerli değerler: true: Görüntünün önceden ayarlanmış parolası kullanılır. Password parametresi boş olmalı ve görüntünün önceden ayarlanmış bir parolası olduğundan emin olmalısınız. false: Görüntünün önceden ayarlanmış parolası kullanılmaz.	false

Response elements

Element	Type	Description	Example
	object
RequestId	string	İstek kimliği.	4A431388-2D4B-46F4-A96B-D4E6BD0688C1
InstanceIds	object
InstanceId	array	Örnek kimliklerinin listesi.
	string	Örnek kimliklerinin listesi.	[i-7ecpqvkicnchxccozrp**,i-6ecpqvkicnchxccozrp**]
Code	integer	Dönüş kodu. 0 değeri başarıyı gösterir. Not Bu API işlemini bir SDK kullanarak çağırırsanız, dönüş türü Integer olur. Bu API işlemini genel bir yöntem veya HTTP kullanarak çağırırsanız, dönüş türü String olur.	0

Examples

Success response

JSON format

{
  "RequestId": "4A431388-2D4B-46F4-A96B-D4E6BD0688C1",
  "InstanceIds": {
    "InstanceId": [
      "[i-7ecpqvkicnchxccozrp****,i-6ecpqvkicnchxccozrp****]"
    ]
  },
  "Code": 0
}

Error codes

HTTP status code	Error code	Error message
400	StockNotEnough	The specified instance type has insufficient resource.
400	InvalidUserData.NotInWhiteList	The specified user is not authroized to perform this operation.
400	MissingParameter	The input parameter that is mandatory for processing this request is not supplied.
400	InstanceIdNotFound	The input parameter instancdId that is not found.
400	NoPermission	Permission denied.
400	CallInterface	Call Interface Happen Error.
400	InvalidParameter	The input parameter is Invalid.
400	InvalidParameter.%s	The specified field %s invalid. Please check it again.
400	InvalidDiskSize.ValueNotSupported	The specified disk capacity is invalid. Specify another capacity and try again.
400	InvalidParameter.Bandwidth	The specified parameter InternetChargeType is not valid.
400	InvalidParameter.Image	The specified image does not support.
400	InvalidParameter.InstanceType	The specified parameter InstanceType is not valid.
400	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.
400	unsupported_Ipv6Feature	This ensregion does not support creating instance of the IPv6 type. Select another type.
400	Forbidden.CreateInstance	The user is not in the Goods whitelist of creating instance interface.
400	ENS_OperationUnsupported_KeyPairName	The KeyPairNameis not available or image not support ssh key.
400	ENS_DependencyViolation_WindowsInstance	The instance creating is window, only user password to login.
400	ENS_PASSWORDORKEYPAIRNAME_MODULE_NOT_CHOOSEN	The required module pwd or keyPairName is not inputed
400	InvalidPrivateIpAddress	Specified private IP address is not in the CIDR block of virtual switch.
400	InvalidVSwitchId.NotFound	Specified virtual switch does not exist.
400	InvalidPrivateIpAddress.Duplicated	Specified private IP address is duplicated.
400	InvalidPasswordParam.Mismatch	The input password should be null when passwordInherit is true.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.