Esnek bir ağ arabirimi (ENI) oluşturur.
Kullanım notları
Aşağıdaki hususlara dikkat edin:
Bu işlem senkron bir işlemdir. Bir ENI oluşturulduktan sonra doğrudan Available (Kullanılabilir) durumuna geçer ve bir Elastic Compute Service (ECS) örneğine eklenebilir.
Yanıta NetworkInterfaceId parametresi boş dönerse ENI oluşturulmamış demektir. ENI oluşturmak için işlemi yeniden çağırın.
Bir ENI yalnızca bir Virtual Private Cloud (VPC) içinde bulunan tek bir örneğe eklenebilir.
Bir ENI bir örnekten ayrılıp başka bir örneğe yeniden eklendiğinde ENI'nin nitelikleri değişmez ve ağ trafiği yeni örneğe yönlendirilir.
Bu işlemi çağırarak bir ENI oluştururken ENI'ye en fazla 49 ikincil özel IP adresi atayabilirsiniz.
ENI oluştururken IPv6 adresleri atamak istiyorsanız ENI'yi ilişkilendireceğiniz vSwitch'te IPv6'nın etkinleştirildiğinden emin olun. Daha fazla bilgi için bkz. IPv6 ağ geçidi nedir?
Hesap başına Alibaba Cloud bölgesi başına oluşturulabilecek ENI sayısı üzerinde bir kota uygulanır. Kotayı ECS konsolunda görüntüleyebilirsiniz. Daha fazla bilgi için bkz. Kaynak kotalarını görüntüleme ve artırma.
Bu işlemin nasıl çağrılacağına ilişkin örnekler için bkz. ENI oluşturma.
Hata ayıklama
İstek parametreleri
Parametre | Tür | Gerekli | Örnek | Açıklama |
Action | String | Evet | CreateNetworkInterface | Gerçekleştirmek istediğiniz işlem. Değeri CreateNetworkInterface olarak ayarlayın. |
RegionId | String | Evet | cn-hangzhou | ENI'yi oluşturacağınız bölgenin ID'si. En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz. |
Tag.N.Key | String | Hayır | TestKey | ENI'ye eklemek üzere 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 | TestValue | ENI'ye eklemek üzere 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 ve |
ResourceGroupId | String | Hayır | rg-bp67acfmxazb4ph**** | ENI'yi atayacağınız kaynak grubunun ID'si. En güncel kaynak grubu listesini sorgulamak için ListResourceGroups işlemini çağırabilirsiniz. |
VSwitchId | String | Evet | vsw-bp1s5fnvk4gn2tws03**** | Belirtilen VPC'deki vSwitch'in ID'si. ENI'ye özel IP adresleri, vSwitch'in CIDR bloğu içinden atanır. |
PrimaryIpAddress | String | Hayır | 172.17.. | ENI'ye atanacak birincil özel IP adresi. Belirtilen IP adresi, vSwitch'in CIDR bloğu içindeki kullanılmayan bir IP adresi olmalıdır. Bu parametre belirtilmezse vSwitch CIDR bloğu içinden rastgele bir kullanılmayan IP adresi atanır. |
SecurityGroupId | String | Hayır | sg-bp1fg655nh68xyz9i**** | Güvenlik grubunun ID'si. Güvenlik grubu ve ENI aynı VPC'ye ait olmalıdır. Not
|
NetworkInterfaceName | String | Hayır | testNetworkInterfaceName | ENI'nin adı. Ad 2 ila 128 karakter uzunluğunda olmalıdır. Ad bir harfle başlamalı ve Bu parametre varsayılan olarak boştur. |
Description | String | Hayır | testDescription | ENI'nin açıklaması. Açıklama 2 ila 256 karakter uzunluğunda olmalı ve Bu parametre varsayılan olarak boştur. |
Visible | Boolean | Hayır | null | Not Bu parametre artık kullanılmamaktadır. |
InstanceType | String | Hayır | null | Not Bu parametre artık kullanılmamaktadır. |
BusinessType | String | Hayır | null | Not Bu parametre artık kullanılmamaktadır. |
SecondaryPrivateIpAddressCount | Integer | Hayır | 1 | ECS tarafından otomatik olarak oluşturulacak özel IP adreslerinin sayısı. Geçerli değerler: 1 ila 49. |
QueueNumber | Integer | Hayır | 1 | ENI tarafından desteklenen kuyruk sayısı. Geçerli değerler: 1 ila 2048. ENI'yi bir örneğe eklerken bu parametrenin değerinin, örnek türü için izin verilen ENI başına maksimum kuyruk sayısından az olduğundan emin olun. Bir örnek türü için izin verilen ENI başına maksimum kuyruk sayısını görüntülemek üzere DescribeInstanceTypes işlemini çağırıp Bu parametre varsayılan olarak boştur. Bu parametreyi belirtmezseniz ENI'yi örneğe eklediğinizde örneğin örnek türü için ENI başına varsayılan kuyruk sayısı kullanılır. Bir örnek türü için ENI başına varsayılan kuyruk sayısını öğrenmek üzere DescribeInstanceTypes işlemini çağırıp |
ClientToken | String | Hayır | 123e4567-e89b-12d3-a456-426655440000 | İsteğin yinelenebilirliğini (idempotence) sağlamak için kullanılan istemci belirteci. Belirteci istemci aracılığıyla oluşturabilirsiniz ancak belirtecin farklı istekler arasında benzersiz olduğundan emin olmalısınız. Belirteç yalnızca ASCII karakterleri içerebilir ve uzunluğu 64 karakteri aşamaz. Daha fazla bilgi için bkz. Yinelenebilirlik nasıl sağlanır. |
NetworkInterfaceTrafficMode | String | Hayır | Standard | ENI'nin iletişim modu. Geçerli değerler:
Not HighPerformance değeri yalnızca c7re RDMA ile geliştirilmiş örnek ailesini destekler. Bir c7re örneğine RDMA modunda eklenebilecek maksimum ENI sayısı örnek türüne göre belirlenir. c7re örnek ailesi Pekin K Alanı'nda davetli ön izleme aşamasındadır. Daha fazla bilgi için bkz. Örnek ailelerine genel bakış. Varsayılan değer: Standard. |
QueuePairNumber | Integer | Hayır | 22 | Not Bu parametre davetli ön izleme aşamasındadır ve herkese açık değildir. |
SecurityGroupIds.N | String | Hayır | sg-bp1fg655nh68xyz9i**** | ENI'yi atayacağınız N. güvenlik grubunun ID'si. Güvenlik grubu ve ENI aynı VPC'ye ait olmalıdır. N için geçerli değerler, bir ENI'ye atanabilecek maksimum güvenlik grubu sayısına göre belirlenir. Daha fazla bilgi için bkz. Sınırlar. Not
|
PrivateIpAddress.N | String | Hayır | 172.17.. | ENI'ye atanacak N. ikincil özel IP adresi. Bu IP adresi, ENI'yi ilişkilendireceğiniz vSwitch'in CIDR bloğu içindeki kullanılmayan bir IP adresi olmalıdır. N için geçerli değerler: 0 ila 10. Not ENI'ye ikincil özel IP adresleri atamak için |
Ipv6Address.N | String | Hayır | 2001:db8:1234:1a00::**** | ENI'ye atanacak N. IPv6 adresi. N için geçerli değerler: 1 ila 10. Örnek: Ipv6Address.1=2001:db8:1234:1a00::**** Not ENI'ye IPv6 adresleri atamak için |
Ipv6AddressCount | Integer | Hayır | 1 | ENI'ye atanacak rastgele oluşturulan IPv6 adreslerinin sayısı. Geçerli değerler: 1 ila 10. Not ENI'ye IPv6 adresleri atamak için |
Ipv4Prefix.N | String | Hayır | 192.168../28 | ENI'ye atanacak N. IPv4 ön eki. N için geçerli değerler: 1 ila 10. Not ENI'ye IPv4 ön ekleri atamak için Ipv4Prefix.N veya Ipv4PrefixCount parametrelerinden birini belirtmelisiniz, ikisini birden belirtmeyin. |
Ipv4PrefixCount | Integer | Hayır | 1 | ENI'ye atanacak IPv4 ön eklerinin sayısı. Geçerli değerler: 1 ila 10. Not ENI'ye IPv4 ön ekleri atamak için Ipv4Prefix.N veya Ipv4PrefixCount parametrelerinden birini belirtmelisiniz, ikisini birden belirtmeyin. |
Ipv6Prefix.N | String | Hayır | 2001:db8:1234:1a00:****::/80 | ENI'ye atanacak N. IPv6 ön eki. N için geçerli değerler: 1 ila 10. Not ENI'ye IPv6 ön ekleri atamak için Ipv6Prefix.N veya Ipv6PrefixCount parametrelerinden birini belirtmelisiniz, ikisini birden belirtmeyin. |
Ipv6PrefixCount | Integer | Hayır | 1 | ENI'ye atanacak IPv6 ön eklerinin sayısı. Geçerli değerler: 1 ila 10. Not ENI'ye IPv6 ön ekleri atamak için Ipv6Prefix.N veya Ipv6PrefixCount parametrelerinden birini belirtmelisiniz, ikisini birden belirtmeyin. |
DeleteOnRelease | Boolean | Hayır | true | İlişkili örnek serbest bırakıldığında ENI'nin de serbest bırakılıp bırakılmayacağını belirtir. Geçerli değerler:
|
Yanıt parametreleri
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|||
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|||
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|||
|
|
|
|
|
|
|
|
|
|
|
|
|||
|
|
|
|
|
|
|
|
|
|
|
|
|||
|
|
|
|
|
Örnekler
Örnek istekler
https://ecs.aliyuncs.com/?Action=CreateNetworkInterface
&RegionId=cn-hangzhou
&SecurityGroupIds.1=sg-bp18kz60mefsicfg****
&VSwitchId=vsw-bp1s5fnvk4gn2tws03****
&Tag.1.Key=TestKey
&Tag.1.Value=TestValue
&ResourceGroupId=rg-bp67acfmxazb4ph****
&PrimaryIpAddress=172.17.**.**
&NetworkInterfaceName=testNetworkInterfaceName
&Description=testDescription
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&Ipv6AddressCount=1
&<Common request parameters>
Başarılı yanıt örnekleri
XML biçimi
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateNetworkInterfaceResponse>
<Description>testDescription</Description>
<Status>Available</Status>
<PrivateIpAddress>172.17.**.**</PrivateIpAddress>
<ServiceManaged>false</ServiceManaged>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
<ResourceGroupId>rg-2ze88m67qx5z****</ResourceGroupId>
<ZoneId>cn-hangzhou-e</ZoneId>
<VSwitchId>vsw-bp16usj2p27htro3****</VSwitchId>
<NetworkInterfaceName>my-eni-name</NetworkInterfaceName>
<MacAddress>00:16:3e:12:**:**</MacAddress>
<NetworkInterfaceId>eni-bp14v2sdd3v8htln****</NetworkInterfaceId>
<SecurityGroupIds>
<SecurityGroupId>sg-bp18kz60mefsicfg****</SecurityGroupId>
</SecurityGroupIds>
<Type>Secondary</Type>
<Ipv6Sets>
<Ipv6Set>
<Ipv6Address>2001:db8:1234:1a00::****</Ipv6Address>
</Ipv6Set>
</Ipv6Sets>
<VpcId>vpc-bp1j7w3gc1cexjqd****</VpcId>
<OwnerId>123456****</OwnerId>
<Tags>
<Tag>
<TagKey>TestKey</TagKey>
<TagValue>TestValue</TagValue>
</Tag>
</Tags>
<PrivateIpSets>
<PrivateIpSet>
<PrivateIpAddress>172.17.**.**</PrivateIpAddress>
<Primary>true</Primary>
</PrivateIpSet>
</PrivateIpSets>
</CreateNetworkInterfaceResponse>
JSON biçimi
HTTP/1.1 200 OK
Content-Type:application/json
{
"Description" : "testDescription",
"Status" : "Available",
"PrivateIpAddress" : "172.17.**.**",
"ServiceManaged" : false,
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"ResourceGroupId" : "rg-2ze88m67qx5z****",
"ZoneId" : "cn-hangzhou-e",
"VSwitchId" : "vsw-bp16usj2p27htro3****",
"NetworkInterfaceName" : "my-eni-name",
"MacAddress" : "00:16:3e:12:**:**",
"NetworkInterfaceId" : "eni-bp14v2sdd3v8htln****",
"SecurityGroupIds" : {
"SecurityGroupId" : [ "sg-bp18kz60mefsicfg****" ]
},
"Type" : "Secondary",
"Ipv6Sets" : {
"Ipv6Set" : [ {
"Ipv6Address" : "2001:db8:1234:1a00::****"
} ]
},
"VpcId" : "vpc-bp1j7w3gc1cexjqd****",
"OwnerId" : "123456****",
"Tags" : {
"Tag" : [ {
"TagKey" : "TestKey",
"TagValue" : "TestValue"
} ]
},
"PrivateIpSets" : {
"PrivateIpSet" : [ {
"PrivateIpAddress" : "172.17.**.**",
"Primary" : true
} ]
}
}
Hata kodları
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Hata kodlarının listesi için bkz. Hizmet hata kodları.