CreateNetworkInterface - - Alibaba Cloud Dokümantasyon Merkezi

Birincil özel IP adresi belirtme desteğiyle Elastik Ağ Arabirimi (ENI) oluşturur.

Operation description

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

Bu eş zamanlı bir işlemdir. Yeni oluşturulan Elastik Ağ Arabirimi (ENI) etkin (Available) durumundadır ve hemen eklenebilir.
Yanıtta NetworkInterfaceId boşsa ENI'yi yeniden oluşturmayı deneyin.
Bir ENI yalnızca sanal özel buluttaki (VPC) tek bir örneğe eklenebilir.
Bir ENI başka bir örneğe yeniden eklendiğinde özellikleri değişmeden kalır ve ağ trafiği yeni örneğe yönlendirilir.
Bir ENI oluştururken bu işlemi çağırarak en fazla 49 ikincil özel IP adresi ayırabilirsiniz.
Bir ENI oluştururken IPv6 adresleri yapılandırmak istiyorsanız, belirtilen vSwitch için IPv6'nın etkinleştirildiğinden emin olun. Daha fazla bilgi için IPv6 Ağ Geçidi nedir? konusuna bakın.
Bir bölgede hesap başına oluşturulabilecek ENI sayısı sınırlıdır. Kaynak kotalarını ECS konsolunda görüntüleyebilirsiniz. Daha fazla bilgi için Kaynak kotalarını görüntüleme ve artırma konusuna bakın.

İstek örnekleri

Elastik Ağ Arabirimi (ENI) oluşturma

RegionId:  cn-hangzhou,   //Set the China (Hangzhou) region.
SecurityGroupId:  sg-bp10jztp6b0sdsyl****,   //Set the security group ID.
VSwitchId:  vsw-bp19wo63nleroq22g****,   //Set the vSwitch ID.

Elastik Ağ Arabirimi (ENI) oluşturma ve birincil özel IP adresi belirtme

RegionId:  cn-hangzhou,   //China (Hangzhou) region.
SecurityGroupId:  sg-bp10jztp6b0sdsyl****,   //Security group ID.
VSwitchId:  vsw-bp19wo63nleroq22g****,   //vSwitch ID.
PrimaryIpAddress:  192.168.0.*,   //Primary private IP address.

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

create

*NetworkInterface

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

*SecurityGroup

acs:ecs:{#regionId}:{#accountId}:securitygroup/{#securitygroupId}

*VSwitch

acs:vpc:{#regionId}:{#accountId}:vswitch/{#vswitchId}

vpc:IsDefaultVSwitch
vpc:IsDefaultVpc
vpc:VPC
vpc:tag
vpc:tag
vpc:tag

None

Request parameters

Parameter	Type	Required	Description	Example
RegionId	string	Yes	Oluşturulacak ağ arabirimi denetleyicisinin (NIC) bölge kimliği. En güncel Alibaba Cloud bölgeleri listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.	cn-hangzhou
Tag	array<object>	No	Ağ arabirimi denetleyicisinin (NIC) etiketleri.
	object	No	Ağ arabirimi denetleyicisinin (NIC) etiketi.
Key	string	No	Ağ arabirimi denetleyicisinin (NIC) 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. http:// veya https:// içeremez.	TestKey
Value	string	No	Ağ arabirimi denetleyicisinin (NIC) 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
ResourceGroupId	string	No	Kaynak grubu kimliği. Kaynak grubu bilgilerini sorgulamak için ListResourceGroups işlemini çağırabilirsiniz.	rg-bp67acfmxazb4ph****
VSwitchId	string	Yes	Ağ arabirimi denetleyicisinin (NIC) vSwitch kimliği. ENI'nin özel IP adresi, vSwitch'in CIDR bloğu içindeki boşta olan adreslerden ayrılır. Önemli Ağ arabirimi denetleyicisi (NIC) ve ENI'yi eklemek istediğiniz örnek aynı bölgede olmalıdır ancak farklı vSwitch'lere ait olabilirler.	vsw-bp1s5fnvk4gn2tws03****
PrimaryIpAddress	string	No	Ağ arabirimi denetleyicisinin (NIC) birincil özel IP adresi. Belirtilen IP adresi, vSwitch'in CIDR bloğu içindeki boşta olan bir adres olmalıdır. Bu parametreyi belirtmezseniz, varsayılan olarak vSwitch CIDR bloğundaki boşta olan bir özel IP adresi rastgele ayrılır.	172.17..
SecurityGroupId	string	No	Ağ arabirimi denetleyicisinin (NIC) ait olduğu güvenlik grubunun kimliği. Güvenlik grubu ve ENI aynı VPC'de olmalıdır. Not Bu işlemi çağırırken SecurityGroupId veya SecurityGroupIds.N parametrelerinden birini ayarlamalısınız, ancak ikisini birden ayarlayamazsınız.	sg-bp1fg655nh68xyz9i****
NetworkInterfaceName	string	No	Ağ arabirimi denetleyicisinin (NIC) adı. Ad 2 ila 128 karakter uzunluğunda olmalıdır ve Unicode harf kategorizasyonundaki karakterleri (İngilizce ve Çince karakterler dahil) ile ASCII rakamlarını (0-9) içerebilir. Ad iki nokta üst üste (:), alt çizgi (_), nokta (.) veya tire (-) içerebilir. Varsayılan değer: boş.	testNetworkInterfaceName
Description	string	No	Ağ arabirimi denetleyicisinin (NIC) açıklaması. Açıklama 2 ila 256 karakter uzunluğunda olmalıdır ve http:// veya https:// ile başlayamaz. Varsayılan değer: boş.	testDescription
Visible	boolean	No	Not Bu parametre kullanımdan kaldırılmıştır.	null
InstanceType	string	No	Elastik Ağ Arabiriminin (ENI) türü. Geçerli değerler: Secondary: İkincil ENI. Trunk: Gövde ağ arabirimi denetleyicisi (NIC) (davetiye ile ön izlemede). Varsayılan değer: Secondary.	Secondary
BusinessType	string	No	Not Bu parametre kullanımdan kaldırılmıştır.	null
SecondaryPrivateIpAddressCount	integer	No	ECS tarafından otomatik olarak oluşturulacak özel IP adresi sayısı. Geçerli değerler: 1 ile 49 arası.	1
QueueNumber	integer	No	Ağ arabirimi denetleyicisinin (NIC) kuyruk sayısı. Geçerli değerler: 1 ile 2048 arası. ENI'yi bir örneğe eklediğinizde, değer örnek türü tarafından desteklenen ağ arabirimi denetleyicisi (NIC) başına maksimum kuyruk sayısından az olmalıdır. MaximumQueueNumberPerEni alanını sorgulamak için DescribeInstanceTypes işlemini çağırabilirsiniz. Varsayılan değer: boş. ENI eklendiğinde, örnek türü için varsayılan kuyruk sayısı kullanılır. SecondaryEniQueueNumber alanını sorgulamak için DescribeInstanceTypes işlemini çağırabilirsiniz.	1
ClientToken	string	No	İsteğin idempotent olmasını sağlamak için kullanılan istemci belirteci. Belirteci oluşturmak için istemciyi kullanabilirsiniz, ancak belirtecin farklı istekler arasında benzersiz olduğundan emin olun. ClientToken yalnızca ASCII karakterleri içerebilir ve uzunluğu 64 karakteri aşamaz. Daha fazla bilgi için İdempotans nasıl sağlanır konusuna bakın.	123e4567-e89b-12d3-a456-426655440000
NetworkInterfaceTrafficMode	string	No	Ağ arabirimi denetleyicisinin (NIC) iletişim deseni. Geçerli değerler: Standard: TCP iletişim desenini kullanır. HighPerformance: Elastik RDMA Arabirimini (ERI) etkinleştirir ve RDMA iletişim desenini kullanır. Not RDMA iletişim desenine sahip bir ağ arabirimi denetleyicisi (NIC) yalnızca örnek türü ERI'yi destekleyen bir örneğe eklenebilir. RDMA desenindeki ENI sayısı, örnek ailesinin sınırını aşamaz. Daha fazla bilgi için Örnek aileleri ve Kurumsal düzeydeki örneklerde eRDMA yapılandırma konularına bakın. Varsayılan değer: Standard.	Standard
QueuePairNumber	integer	No	RDMA ENI'nin kuyruk sayısı. Bir örneğe birden fazla RDMA ENI'si eklemek istiyorsanız, örnek türü tarafından desteklenen QueuePairNumber üst sınırına ve kullanmayı planladığınız ENI sayısına göre her ENI için QueuePairNumber değerini manuel olarak belirtmenizi öneririz. Tüm ENI'lerin toplam QueuePairNumber değerinin örnek türü tarafından izin verilen maksimum değeri aşmadığından emin olun. Örnek türü için üst sınırı sorgulamak üzere DescribeInstanceTypes işlemini çağırın. Önemli Bir RDMA ENI için QueuePairNumber belirtilmezse, varsayılan olarak örnek türü tarafından desteklenen tüm RDMA ENI'leri için QueuePairNumber üst sınırı kullanılır. Bu nedenle, QueuePairNumber değeri belirtilmemiş bir RDMA ENI eklendikten sonra daha fazla RDMA ENI'si eklenemez (normal ENI'ler bu sınırdan etkilenmez).	22
SecurityGroupIds	array	No	Ağ arabirimi denetleyicisinin (NIC) ait olduğu bir veya daha fazla güvenlik grubunun kimlikleri. Güvenlik grupları ve ENI aynı VPC'de olmalıdır. N için geçerli değerler, bir ENI'nin ait olabileceği maksimum güvenlik grubu sayısı kotasına bağlıdır. Daha fazla bilgi için Sınırlar konusuna bakın. Not Bu işlemi çağırırken SecurityGroupId veya SecurityGroupIds.N parametrelerinden birini ayarlamalısınız, ancak ikisini birden ayarlayamazsınız.	sg-bp1fg655nh68xyz9i****
	string	No	Ağ arabirimi denetleyicisinin (NIC) ait olduğu bir veya daha fazla güvenlik grubunun kimlikleri. Güvenlik grupları ve ENI aynı VPC'de olmalıdır. N için geçerli değerler, bir ENI'nin ait olabileceği maksimum güvenlik grubu sayısı kotasına bağlıdır. Daha fazla bilgi için Sınırlar konusuna bakın. Not Bu işlemi çağırırken SecurityGroupId veya SecurityGroupIds.N parametrelerinden birini ayarlamalısınız, ancak ikisini birden ayarlayamazsınız.	sg-bp1fg655nh68xyz9i****
PrivateIpAddress	array	No	Ağ arabirimi denetleyicisinin (NIC) ait olduğu vSwitch'in CIDR bloğu içindeki boşta olan adreslerden seçilen bir veya daha fazla ikincil özel IP adresi. N için geçerli değerler: 0 ile 10 arası. Not İkincil özel IP adresları ayırırken, aynı anda hem PrivateIpAddress.N parametresini hem de SecondaryPrivateIpAddressCount parametresini belirtemezsiniz.	172.17..
	string	No	Ağ arabirimi denetleyicisinin (NIC) ait olduğu vSwitch'in CIDR bloğu içindeki boşta olan adreslerden seçilen bir veya daha fazla ikincil özel IP adresi. N için geçerli değerler: 0 ile 10 arası. Not İkincil özel IP adresları ayırırken, aynı anda hem PrivateIpAddress.N parametresini hem de SecondaryPrivateIpAddressCount parametresini belirtemezsiniz.	172.17..
Ipv6Address	array	No	Ağ arabirimi denetleyicisine (NIC) atanacak bir veya daha fazla IPv6 adresi. En fazla 10 IPv6 adresi belirtebilirsiniz. N için geçerli değerler: 1 ile 10 arası. Örnek: Ipv6Address.1=2001:db8:1234:1a00::** Not** Ağ arabirimi denetleyicisi (NIC) için IPv6 adresları ayarlamak istiyorsanız, Ipv6Addresses.N parametresini veya Ipv6AddressCount parametresini ayarlamalısınız, ancak ikisini birden ayarlayamazsınız.	2001:db8:1234:1a00::****
	string	No	Ağ arabirimi denetleyicisine (NIC) atanacak bir veya daha fazla IPv6 adresi. En fazla 10 IPv6 adresi belirtebilirsiniz. N için geçerli değerler: 1 ile 10 arası. Örnek: Ipv6Address.1=2001:db8:1234:1a00::** Not** Ağ arabirimi denetleyicisi (NIC) için IPv6 adresları ayarlamak istiyorsanız, Ipv6Addresses.N parametresini veya Ipv6AddressCount parametresini ayarlamalısınız, ancak ikisini birden ayarlayamazsınız.	2001:db8:1234:1a00::****
Ipv6AddressCount	integer	No	Ağ arabirimi denetleyicisi (NIC) için rastgele oluşturulacak IPv6 adresi sayısı. Geçerli değerler: 1 ile 10 arası. Not Ağ arabirimi denetleyicisi (NIC) için IPv6 adresleri ayarlamak istiyorsanız, Ipv6Addresses.N parametresini veya Ipv6AddressCount parametresini ayarlamalısınız, ancak ikisini birden ayarlayamazsınız.	1
Ipv4Prefix	array	No	Ağ arabirimi denetleyicisine (NIC) atanacak bir veya daha fazla IPv4 ön eki. N için geçerli değerler: 1 ile 10 arası. Not Ağ arabirimi denetleyicisi (NIC) için IPv4 ön ekleri ayarlamak istiyorsanız, Ipv4Prefix.N parametresini veya Ipv4PrefixCount parametresini ayarlamalısınız, ancak ikisini birden ayarlayamazsınız.
	string	No	Ağ arabirimi denetleyicisine (NIC) atanacak bir veya daha fazla IPv4 ön eki. N için geçerli değerler: 1 ile 10 arası. Not Ağ arabirimi denetleyicisi (NIC) için IPv4 ön ekleri ayarlamak istiyorsanız, Ipv4Prefix.N parametresini veya Ipv4PrefixCount parametresini ayarlamalısınız, ancak ikisini birden ayarlayamazsınız.	192.168../28
Ipv4PrefixCount	integer	No	Ağ arabirimi denetleyicisine (NIC) atanacak IPv4 ön eklerinin sayısı. Geçerli değerler: 1 ile 10 arası. Not Ağ arabirimi denetleyicisi (NIC) için IPv4 ön ekleri ayarlamak istiyorsanız, Ipv4Prefix.N parametresini veya Ipv4PrefixCount parametresini ayarlamalısınız, ancak ikisini birden ayarlayamazsınız.	1
Ipv6Prefix	array	No	Ağ arabirimi denetleyicisine (NIC) atanacak bir veya daha fazla IPv6 ön eki. N için geçerli değerler: 1 ile 10 arası. Not Ağ arabirimi denetleyicisi (NIC) için IPv6 ön ekleri ayarlamak istiyorsanız, Ipv6Prefix.N parametresini veya Ipv6PrefixCount parametresini ayarlamalısınız, ancak ikisini birden ayarlayamazsınız.
	string	No	Ağ arabirimi denetleyicisine (NIC) atanacak bir veya daha fazla IPv6 ön eki. N için geçerli değerler: 1 ile 10 arası. Not Ağ arabirimi denetleyicisi (NIC) için IPv6 ön ekleri ayarlamak istiyorsanız, Ipv6Prefix.N parametresini veya Ipv6PrefixCount parametresini ayarlamalısınız, ancak ikisini birden ayarlayamazsınız.	2001:db8:1234:1a00:****::/80
Ipv6PrefixCount	integer	No	Ağ arabirimi denetleyicisine (NIC) atanacak IPv6 ön eklerinin sayısı. Geçerli değerler: 1 ile 10 arası. Not Ağ arabirimi denetleyicisi (NIC) için IPv6 ön ekleri ayarlamak istiyorsanız, Ipv6Prefix.N parametresini veya Ipv6PrefixCount parametresini ayarlamalısınız, ancak ikisini birden ayarlayamazsınız.	1
DeleteOnRelease	boolean	No	İlişkili örnek serbest bırakıldığında ENI'nin tutulup tutulmayacağını belirtir. Geçerli değerler: true: ENI tutulmaz. false: ENI tutulur.	true
TxQueueSize	integer	No	Ağ arabirimi denetleyicisinin (NIC) giden kuyruk derinliği. Aşağıdaki hususlara dikkat edin: Ağ arabirimi denetleyicisinin (NIC) giden kuyruk derinliği, gelen kuyruk derinliğine eşit olmalıdır. Geçerli değerler: 8192 ile 16384 arası. Değer 2'nin kuvveti olmalıdır. Daha büyük bir giden kuyruk derinliği giden verimi artırır ancak daha fazla bellek tüketir. Not Bu parametre herkese açık değildir.	8192
RxQueueSize	integer	No	Ağ arabirimi denetleyicisinin (NIC) gelen kuyruk derinliği. Aşağıdaki hususlara dikkat edin: Ağ arabirimi denetleyicisinin (NIC) gelen kuyruk derinliği, giden kuyruk derinliğine eşit olmalıdır. Geçerli değerler: 8192 ile 16384 arası. Değer 2'nin kuvveti olmalıdır. Daha büyük bir gelen kuyruk derinliği gelen verimi artırır ancak daha fazla bellek tüketir. Not Bu parametre herkese açık değildir.	8192
NetworkInterfaceTrafficConfig	object	No	Ağ arabirimi denetleyicisinin (NIC) trafik yapılandırma parametresi kümesi.
QueueNumber	integer	No	Ağ arabirimi denetleyicisinin (NIC) kuyruk sayısı.	8
NetworkInterfaceTrafficMode	string	No	Ağ arabirimi denetleyicisinin (NIC) iletişim deseni.	HighPerformance
QueuePairNumber	integer	No	RDMA ENI'nin kuyruk sayısı.	8
TxQueueSize	integer	No	Ağ arabirimi denetleyicisinin (NIC) giden kuyruk derinliği. Not Bu parametre davetiye ile ön izlemededir ve herkese açık değildir. Bu parametreyi kullanmak istiyorsanız, erişim talep etmek için bir talep gönderin. Aşağıdaki hususlara dikkat edin: Bu parametre yalnızca yedinci nesil ve sonraki ECS örnek türleri için geçerlidir. Bu parametre şu anda yalnızca Linux görüntüleri için geçerlidir. Ağ arabirimi denetleyicisinin (NIC) daha büyük bir giden kuyruk derinliği, giden verimi artırır ve paket kaybı olasılığını azaltır ancak daha fazla bellek tüketir.	8192
RxQueueSize	integer	No	Ağ arabirimi denetleyicisinin (NIC) gelen kuyruk derinliği. Not Bu parametre davetiye ile ön izlemededir ve herkese açık değildir. Bu parametreyi kullanmak istiyorsanız, erişim talep etmek için bir talep gönderin. Aşağıdaki hususlara dikkat edin: Bu parametre yalnızca yedinci nesil ve sonraki ECS örnek türleri için geçerlidir. Bu parametre şu anda yalnızca Linux görüntüleri için geçerlidir. Ağ arabirimi denetleyicisinin (NIC) daha büyük bir gelen kuyruk derinliği, gelen verimi artırır ve paket kaybı olasılığını azaltır ancak daha fazla bellek tüketir.	8192
ConnectionTrackingConfiguration	object	No	Ağ bağlantısı izleme yapılandırması. Bu parametreyi kullanmadan önce Bağlantı zaman aşımı yönetimi konusunu okuyun.
TcpEstablishedTimeout	integer	No	Kurulmuş TCP bağlantıları için zaman aşımı süresi. Birim: saniye. Geçerli değerler: [30, 60, 80, 100, 200, 300, 500, 700, 910]. Varsayılan değer: 910.	910
TcpClosedAndTimeWaitTimeout	integer	No	TIME_WAIT ve CLOSED durumlarındaki TCP bağlantıları için zaman aşımı süresi. Birim: saniye. Geçerli değerler: 3 ile 15 arası tam sayılar. Varsayılan değer: 3. Not ECS örneğiniz NLB/CLB ile kullanılıyorsa, TIME_WAIT durumundaki bağlantılar için varsayılan zaman aşımı süresi 15 saniyedir.	3
UdpTimeout	integer	No	UDP akışları için zaman aşımı süresi. Birim: saniye. Geçerli değerler: [10, 20, 30, 60, 80, 100]. Varsayılan değer: 30. Not ECS örneğiniz NLB/CLB ile kullanılıyorsa, varsayılan değer 100 saniyedir.	30
EnhancedNetwork	object	No	Not Bu parametre herkese açık değildir.
EnableSriov	boolean	No	Not Bu parametre herkese açık değildir.	true
EnableRss	boolean	No	Not Bu parametre herkese açık değildir.	true
VirtualFunctionTotalQueueNumber	integer	No
VirtualFunctionQuantity	integer	No
EnableExpress	boolean	No
SourceDestCheck	boolean	No	Kaynak/hedef denetiminin etkinleştirilip etkinleştirilmeyeceğini belirtir. Ağ güvenliğini artırmak için bu özelliği etkinleştirmenizi öneririz. Geçerli değerler: true: etkin. false: devre dışı. Varsayılan değer: false. Not Bu özellik yalnızca belirli bölgelerde desteklenir. Bu özelliği kullanmadan önce Kaynak/hedef denetimi konusunu okuyun.	false
EnablePrimaryIPv6	boolean	No

Response elements

Element	Type	Description	Example
	object
Status	string	Ağ arabirimi denetleyicisinin (NIC) durumu.	Available
Type	string	Ağ arabirimi denetleyicisinin (NIC) türü.	Secondary
VpcId	string	ENI'nin ait olduğu VPC'nin kimliği.	vpc-bp1j7w3gc1cexjqd****
NetworkInterfaceName	string	Ağ arabirimi denetleyicisinin (NIC) adı.	my-eni-name
MacAddress	string	Ağ arabirimi denetleyicisinin (NIC) MAC adresi.	00:16:3e:12::
NetworkInterfaceId	string	Ağ arabirimi denetleyicisinin (NIC) kimliği.	eni-bp14v2sdd3v8htln****
ServiceID	integer	Ağ arabirimi denetleyicisinin (NIC) karşılık geldiği Sanal Ağ Operatörünün (VNO) kimliği.	12345678910
OwnerId	string	Ağ arabirimi denetleyicisine (NIC) sahip olan hesabın kimliği.	123456****
ServiceManaged	boolean	Ağ arabirimi denetleyicisinin (NIC) kullanıcısının bir Alibaba Cloud hizmeti mi yoksa bir VNO mu olduğunu gösterir.	true
VSwitchId	string	VPC'deki vSwitch'in kimliği.	vsw-bp16usj2p27htro3****
RequestId	string	İstek kimliği.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
Description	string	Ağ arabirimi denetleyicisinin (NIC) açıklaması.	testDescription
ResourceGroupId	string	Kaynak grubu kimliği.	rg-2ze88m67qx5z****
ZoneId	string	Bölge kimliği.	cn-hangzhou-e
PrivateIpAddress	string	Ağ arabirimi denetleyicisinin (NIC) özel IP adresi.	172.17..
SecurityGroupIds	object
SecurityGroupId	array	ENI'nin ait olduğu güvenlik grupları.
	string	Güvenlik grubu kimliği.	sg-bp18kz60mefsicfg****
PrivateIpSets	object
PrivateIpSet	array<object>	PrivateIpSet nesnelerinin koleksiyonu.
	object
PrivateIpAddress	string	Örneğin özel IP adresi.	172.17..
Primary	boolean	IP adresinin birincil özel IP adresi olup olmadığını gösterir.	true
Tags	object
Tag	array<object>	Etiketler.
	object
TagValue	string	Etiket değeri.	TestValue
TagKey	string	Etiket anahtarı.	TestKey
Ipv6Sets	object
Ipv6Set	array<object>	Ağ arabirimi denetleyicisine (NIC) ayrılan IPv6 adresleri.
	object	Bu parametre davetiyeli ön izlemededir ve herkese açık değildir.
Ipv6Address	string	IPv6 adresi.	2001:db8:1234:1a00::****
Primary	boolean
Ipv4PrefixSets	object
Ipv4PrefixSet	array<object>	Ağ arabirimi denetleyicisine (NIC) ayrılan IPv4 ön ekleri.
	object
Ipv4Prefix	string	The IPv4 prefix.	192.168../28
Ipv6PrefixSets	object
Ipv6PrefixSet	array<object>	Ağ arabirimi denetleyicisine (NIC) ayrılan IPv6 ön ekleri.
	object
Ipv6Prefix	string	The IPv6 prefix.	2001:db8:1234:1a00:****::/80
SourceDestCheck	boolean	Bu parametre davetiyeli ön izlemededir ve herkese açık değildir.	false

Examples

Success response

JSON format

{
  "Status": "Available",
  "Type": "Secondary",
  "VpcId": "vpc-bp1j7w3gc1cexjqd****",
  "NetworkInterfaceName": "my-eni-name",
  "MacAddress": "00:16:3e:12:**:**",
  "NetworkInterfaceId": "eni-bp14v2sdd3v8htln****",
  "ServiceID": 12345678910,
  "OwnerId": "123456****",
  "ServiceManaged": true,
  "VSwitchId": "vsw-bp16usj2p27htro3****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "Description": "testDescription",
  "ResourceGroupId": "rg-2ze88m67qx5z****",
  "ZoneId": "cn-hangzhou-e",
  "PrivateIpAddress": "172.17.**.**",
  "SecurityGroupIds": {
    "SecurityGroupId": [
      "sg-bp18kz60mefsicfg****"
    ]
  },
  "PrivateIpSets": {
    "PrivateIpSet": [
      {
        "PrivateIpAddress": "172.17.**.**",
        "Primary": true
      }
    ]
  },
  "Tags": {
    "Tag": [
      {
        "TagValue": "TestValue",
        "TagKey": "TestKey"
      }
    ]
  },
  "Ipv6Sets": {
    "Ipv6Set": [
      {
        "Ipv6Address": "2001:db8:1234:1a00::****",
        "Primary": false
      }
    ]
  },
  "Ipv4PrefixSets": {
    "Ipv4PrefixSet": [
      {
        "Ipv4Prefix": "192.168.**.**/28"
      }
    ]
  },
  "Ipv6PrefixSets": {
    "Ipv6PrefixSet": [
      {
        "Ipv6Prefix": "2001:db8:1234:1a00:****::/80"
      }
    ]
  },
  "SourceDestCheck": false
}

Error codes

HTTP status code	Error code	Error message	Description
400	MissingParameter	%s	A parameter is not specified.
400	UnsupportedParameter	%s	The parameter is not supported.
400	InvalidParameter	%s	The specified parameter is invalid.
400	InvalidInstanceID.Malformed	%s	The specified InstanceId parameter is invalid.
400	InvalidOperation.InvalidEcsState	%s	This operation is not allowed in the current cloud service status.
400	InvalidOperation.InvalidEniState	%s	The current state of the ENI does not allow this operation.
400	InvalidOperation.DetachPrimaryEniNotAllowed	%s	Detaching the primary ENI from an instance is not allowed.
400	Forbidden.RegionId	%s	The service is unavailable in the current region.
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	JoinedGroupLimitExceed	%s	The maximum number of security groups to which the specified resource can be added has been reached. For more information, see the return value of the %s placeholder in the error message.
400	InvalidParameter.SecurityGroupIdRepeated	%s	The security group ID passed in is duplicate.
400	InvalidSecurityGroupId.SingleIdAndMultiIdConflict	%s
400	InvalidParameter.Conflict	%s	The specified parameter is invalid. Check whether parameter conflicts exist. %s is a variable. An error message is dynamically returned based on call conditions.
400	InvalidConnectionTrackingConfiguration.RegionOrUserNotSupported	The specified parameter ConnectionTrackingConfiguration is not supported in this region, or this account is not in the whitelist of using network interface ConnectionTrackingConfiguration.	The specified parameter ConnectionTrackingConfiguration is not supported in this region, or this account is not in the whitelist of using network interface ConnectionTrackingConfiguration.
400	InvalidOperation.EniCountExceeded	%s.	The maximum number of NICs in the Enterprise Security Group has been reached.
400	InvalidPrivateIpAddress.Duplicated	The specified private IP address "%s" is duplicated.	The specified IP address is already in use.
400	IncorrectVSwitchStatus	The operation is not allowed in the current VSwitch state. Expecting state includes "Created Available", but current state is "%s".	The operation is not supported in the current state of the vSwitch.
400	InvalidEniQueueSize.RegionOrUserNotSupported	The specified parameter "RxQueueSize" or "TxQueueSize" is not supported in this region or this account is not allowed to use ENI QueueSize.	You are not authorized to specify the length of NIC queues or cannot specify the length of NIC queues in the current region.
400	InvalidParameter.EniQueueSize	The specified parameter "TxQueueSize" and "RxQueueSize" are not equal or the value must be 8192 or 16384.	The specified parameter TxQueueSize and RxQueueSize are not equal or not the allowed value.
400	InvalidParameter.EniConnectionTrackingConfiguration	The specified ENI connection tracking configuration "%s" must be between %s and %s.	The network connection configuration specified by the network card exceeds the allowable range
400	QuotaExceeded.PrivateIpAddress	There are not enough private IPs in the specified VSwitch.	The current VSwitch does not have enough Ip
400	Throttling	Request was denied due to request throttling.	The request is throttled.
400	InvalidVSwitch.IllegalStatus	The operation is not allowed in the current VSwitch state. Expecting state includes "Created", but current state is "%s".	The current VSwitch status does not support this operation.
400	InvalidParameter.EniEnhancedNetwork	The input parameter "EnhancedNetwork" is illegal, when EnableSriov is true, VirtualFunctionTotalQueueNumber must not be empty, and VirtualFunctionQuantity must be 1 to 256. When EnableSriov is empty or false, VirtualFunctionTotalQueueNumber and VirtualFunctionQuantity must be empty.	The specified network enhancement function parameter is illegal. When the EnableSriov is set to true, the VirtualFunctionTotalQueueNumber must not be empty and the VirtualFunctionQuantity value range is 1-256; When the EnableSriov is empty or set to false, the VirtualFunctionTotalQueueNumber and VirtualFunctionQuantity must be empty
400	InvalidOperation.EnablePrimaryIPv6	The specified ENI can not enable primary IPv6 or already has primary IPv6.	The specified ENI can not enable primary IPv6 or already has primary IPv6.
400	InvalidVSwitch.Ipv4NotEnabled	The specify VSwitch of ECS does not support IPv4.
401	InvalidOperation.SecurityGroupNotAuthorized	The specified security group is not authorized to operate.	You do not have permission to operate the current security group.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	An internal error has occurred. Try again later.
500	InvalidOperation.RegionNotSupportIpPrefix	The current region does not support IP prefix feature.	The region does not support IP prefix allocation.
500	ServiceUnavailable	The request processing has failed due to some unknown error.	Request timed out, please try again.
403	InvalidUserType.NotSupported	%s	Your account does not support this operation.
403	Abs.InvalidAccount.NotFound	%s	Your Alibaba Cloud account does not exist or your AccessKey pair has expired.
403	Forbidden.NotSupportRAM	%s	RAM users are not authorized to perform this operation.
403	Forbidden.SubUser	%s	You are not authorized to manage this resource. Contact the owner of the Alibaba Cloud account for authorization.
403	InValidParameter	%s
403	MaxEniCountExceeded	%s	The maximum number of ENIs that can be managed has been reached.
403	EniPerInstanceLimitExceeded	%s	The maximum number of ENIs that can be attached to the specified instance has been reached.
403	InvalidOperation.AvailabilityZoneMismatch	%s	The operation is invalid.
403	InvalidOperation.VpcMismatch	%s	The operation is invalid. Check whether the VPC in the operation corresponds to other parameters.
403	SecurityGroupInstanceLimitExceed	%s	The maximum number of instances in the security group has been reached.
403	InvalidSecurityGroupId.NotVpc	%s	The specified SecurityGroupId parameter is invalid and the network type of the security group is not VPC.
403	InvalidOperation.InvalidEniType	%s	This operation is not allowed for the current network interface type.
403	InvalidVSwitchId.IpNotEnough	%s	The number of available IP addresses on the specified vSwitch is insufficient.
403	InvalidVSwitchId.IpInvalid	%s	The specified private IP address is invalid.
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	InvalidIp.Address	%s	The IP entered is not in the correct format or is not in the optional CIDR range.
403	InvalidIp.IpRepeated	%s	The specified IP address already exists.
403	MaxEniPrivateIpsCountExceeded	%s	The maximum number of secondary private IP addresses that can be assigned to the specified ENI has been exceeded. For more information, see the return value of the %s placeholder in the error message.
403	InvalidOperation.ResourceManagedByCloudProduct	%s	You cannot modify security groups managed by cloud services.
403	InvalidOperation.TrunkingIsNotAllowed	%s	The trunk network card is not operational.
403	InvalidParameter.InvalidEniQueueNumber	%s	The number of Elastic Network Interface (ENI) queues is incorrect. For more information, see the actual return result of the %s placeholder in the error message.
403	InvalidOperation.MaxEniQueueNumberExceeded	%s	The number of Elastic Network Interface (ENI) queues exceeds the upper limit. For more information, see the actual return result of the %s placeholder in the error message.
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s	The maximum number of queues for all ENIs on an instance has been exceeded. For more information, see the return value of the %s placeholder in the error message.
403	InvalidParameter.EniTrafficMode	%s
403	InvalidOperation.HighPerformanceTrafficModeIsNotAllowed	%s
403	InvalidParameter.QueuePairNumberMustEmpty	%s
403	InvalidParameter.InvalidQueuePairNumber	%s
403	InvalidParams.NetworkInterfaceName	%s
403	InvalidIp.IpPrefixIllegal	The ip prefixes %s is/are illegal.	The IP address prefix is invalid and is not in the CIDR format.
403	InvalidIp.IpPrefixMustInReserveSegment	The ip prefix must in vswitch reserve segment.	The IP address prefix is invalid and is not in the reserved CIDR block of the vSwitch.
403	InvalidOperation.Ipv4CountExceeded	%s	The operation is valid because the maximum number of IPv4 addresses has been reached.
403	InvalidOperation.Ipv6CountExceeded	%s	The operation is valid because the maximum number of IPv6 addresses has been reached.
403	InvalidOperation.HighPerformanceTrafficModeEniUnsupported	High performance traffic mode does not support the current ENI type. Expected ENI type is "%s" but the current ENI type is "%s".	High performance traffic mode does not support the current ENI type.
403	AclLimitExceed	%s	The number of ACL rules for an ENI or instance exceeds the upper limit.
403	InvalidIp.IpPrefixMaskInvalid	The IP prefix mask %s is illegal which must be between %s and %s.	The IP prefix mask is invalid and is not in the valid range.
403	InvalidVSwitchId.IpPrefixNotEnough	The specified VSwitch does not have enough IP prefixes.	The number of IP prefixes in the specified switch is insufficient.
403	InvalidIp.IpPrefixMaskNotSame	The IP prefixes %s are illegal.The IP prefix mask must be the same.	The IP prefix masks are not the same.
403	EnterpriseGroupLimited.MutliGroupType	The specified instance can't associate security group of different types.	The specified instance cannot be added to both a common security group and an enterprise security group. You can call the DescribeSecurityGroups query to specify the type of security group.
403	InvalidOperation.BoundingEniSlaveQuotaExceed	The number of Slave ENIs exceeds the limit of Bond ENI.	The number of Slave ENIs exceeds the limit of Bond ENI.
403	InvalidIp.IpPrefixNotAvailable	The IP prefix is not available.	The IP prefix is not free.
403	InvalidIp.IpPrefixMaskIllegal	The current IP prefix mask is illegal.	Illegal IP prefix mask.
403	InvalidIp.IpPrefixNotStrict	The IP prefix "%s" must be strict CIDR format.	Invalid IP prefix, not strictly cidr.
403	InvalidOperation.NotSupport	The specified region does not support allocating IPv6 when creating ENI.	The specified region does not support allocating IPv6 when creating ENI.
404	InvalidEcsId.NotFound	%s	The specified instance ID does not exist.
404	InvalidEniId.NotFound	%s
404	InvalidVSwitchId.NotFound	%s	The specified vSwitch does not exist.
404	InvalidSecurityGroupId.NotFound	%s	The specified security group ID does not exist.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	The specified resource group does not exist.
404	InvalidOperation.MaxEniIpv6IpsCountExceeded	The ipv6 address count exceed limitation.
404	InvalidOperation.VSwitchIpv6Disabled	The specified VSwitch does not support Ipv6 feature.	The specified VSwitch does not support IPv6.
404	InvalidOperation.EnableIpv6Failed	The specified VSwitch does not support Ipv6 feature.
404	InvalidOperation.AddressAlreadyAllocated	The specified ipv6 has been already allocated.
404	InvalidOperation.AddressNotInVSwitchCidr	The specified ipv6 does not match VSwitch cidr scope.
404	InvalidOperation.SlaveEniMustHaveBondingEni	Ensure you create the corresponding Bond ENI before creating Slave ENI.	You must create a Bond network card before creating a Slave network card.
404	InvalidOperation.EniTrafficModeNotSupportIpv6	The High Performance(RDMA) traffic mode does not support IPv6.	ENIs that use the RDMA communication mode do not support IPv6.
404	InvalidOperation.VSwitchCidrReservationNotExist	The specified VSwitch does not have CIDR reservation.	The specified switch does not have a reserved segment available.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.