CreateNetworkInterface - Elastic Compute Service - Alibaba Cloud Documentation Center

Membuat Elastic Network Interface (ENI) dengan dukungan untuk menentukan alamat IP privat utama.

Deskripsi operasi

Perhatikan hal-hal berikut saat Anda memanggil operasi ini:

Ini adalah operasi sinkron. ENI yang baru dibuat berada dalam status aktif (Available) dan dapat segera disambungkan.
Jika NetworkInterfaceId kosong dalam tanggapan, coba buat ENI lagi.
ENI hanya dapat disambungkan ke satu Instans dalam virtual private cloud (VPC).
Saat ENI disambungkan kembali ke Instans lain, propertinya tetap tidak berubah dan lalu lintas jaringan dialihkan ke Instans baru.
Saat membuat ENI, Anda dapat mengalokasikan hingga 49 alamat IP privat sekunder dengan memanggil operasi ini.
Saat membuat ENI, jika Anda ingin mengonfigurasi alamat IPv6, pastikan IPv6 diaktifkan untuk vSwitch yang ditentukan. Untuk informasi lebih lanjut, lihat Apa itu IPv6 Gateway?.
Jumlah ENI yang dapat dibuat per akun di suatu wilayah dibatasi. Anda dapat melihat Kuota Sumber daya di Konsol ECS. Untuk informasi lebih lanjut, lihat Melihat dan meningkatkan kuota resource.

Contoh permintaan

Membuat Elastic Network Interface (ENI)

RegionId:  cn-hangzhou,   //Atur wilayah China (Hangzhou).
SecurityGroupId:  sg-bp10jztp6b0sdsyl****,   //Atur ID kelompok keamanan.
VSwitchId:  vsw-bp19wo63nleroq22g****,   //Atur ID vSwitch.

Membuat Elastic Network Interface (ENI) dan menentukan alamat IP privat utama

RegionId:  cn-hangzhou,   //Wilayah China (Hangzhou).
SecurityGroupId:  sg-bp10jztp6b0sdsyl****,   //ID kelompok keamanan.
VSwitchId:  vsw-bp19wo63nleroq22g****,   //ID vSwitch.
PrimaryIpAddress:  192.168.0.*,   //Alamat IP privat utama.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

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

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah dari antarmuka jaringan yang akan dibuat. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah Alibaba Cloud terbaru.	cn-hangzhou
Tag	array<object>	No	Tag dari antarmuka jaringan.
	object	No	Tag dari antarmuka jaringan.
Key	string	No	Kunci tag dari antarmuka jaringan. Nilai valid N: 1 hingga 20. Kunci tag tidak boleh berupa string kosong. Panjang kunci tag maksimal 128 karakter dan tidak boleh dimulai dengan aliyun atau acs:. Tidak boleh mengandung `http://` atau `https://`.	TestKey
Value	string	No	Nilai tag dari antarmuka jaringan. Nilai valid N: 1 hingga 20. Nilai tag dapat berupa string kosong. Panjang nilai tag maksimal 128 karakter dan tidak boleh mengandung `http://` atau `https://`.	TestValue
ResourceGroupId	string	No	ID kelompok sumber daya. Anda dapat memanggil ListResourceGroups untuk mengkueri informasi kelompok sumber daya.	rg-bp67acfmxazb4ph****
VSwitchId	string	Yes	ID vSwitch dari antarmuka jaringan. Alamat IP privat ENI dialokasikan dari alamat idle dalam blok CIDR vSwitch. Penting Antarmuka jaringan dan Instans yang ingin Anda sambungkan dengan ENI harus berada di zona yang sama, tetapi dapat berasal dari vSwitch yang berbeda.	vsw-bp1s5fnvk4gn2tws03****
PrimaryIpAddress	string	No	Alamat IP privat utama dari antarmuka jaringan. Alamat IP yang ditentukan harus merupakan alamat idle dalam blok CIDR vSwitch. Jika Anda tidak menentukan parameter ini, alamat IP privat idle dalam blok CIDR vSwitch akan dialokasikan secara acak sebagai default.	172.17..
SecurityGroupId	string	No	ID grup keamanan tempat antarmuka jaringan berada. Grup keamanan dan ENI harus berada di VPC yang sama. Catatan Saat memanggil operasi ini, Anda harus mengatur `SecurityGroupId` atau `SecurityGroupIds.N`, tetapi tidak keduanya.	sg-bp1fg655nh68xyz9i****
NetworkInterfaceName	string	No	Nama dari antarmuka jaringan. Panjang nama harus 2 hingga 128 karakter dan dapat berisi karakter dari Kategorisasi huruf Unicode (termasuk karakter Inggris dan Tiongkok) serta digit ASCII (0-9). Nama dapat berisi titik dua (:), garis bawah (_), titik (.), atau tanda hubung (-). Nilai default: kosong.	testNetworkInterfaceName
Description	string	No	Deskripsi dari antarmuka jaringan. Panjang deskripsi harus 2 hingga 256 karakter dan tidak boleh dimulai dengan `http://` atau `https://`. Nilai default: kosong.	testDescription
Visible	boolean	No	Catatan Parameter ini sudah tidak digunakan lagi.	null
InstanceType	string	No	Tipe dari Elastic Network Interface (ENI). Nilai valid: Secondary: ENI sekunder. Trunk: antarmuka jaringan trunk (dalam pratinjau undangan). Nilai default: Secondary.	Secondary
BusinessType	string	No	Catatan Parameter ini sudah tidak digunakan lagi.	null
SecondaryPrivateIpAddressCount	integer	No	Jumlah alamat IP privat untuk pembuatan otomatis oleh ECS. Nilai valid: 1 hingga 49.	1
QueueNumber	integer	No	Jumlah antrian untuk antarmuka jaringan. Nilai valid: 1 hingga 2048. Saat menyambungkan ENI ke Instans, nilainya harus kurang dari jumlah antrian maksimum per antarmuka jaringan yang didukung oleh Tipe instans. Anda dapat memanggil DescribeInstanceTypes untuk mengkueri bidang `MaximumQueueNumberPerEni`. Nilai default: kosong. Saat ENI disambungkan, nomor antrian default untuk Tipe instans digunakan. Anda dapat memanggil DescribeInstanceTypes untuk mengkueri bidang `SecondaryEniQueueNumber`.	1
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi pastikan token tersebut unik di antara permintaan yang berbeda. ClientToken hanya dapat berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter. Untuk informasi lebih lanjut, lihat Cara memastikan idempotensi.	123e4567-e89b-12d3-a456-426655440000
NetworkInterfaceTrafficMode	string	No	Pola komunikasi dari antarmuka jaringan. Nilai valid: Jenis Penyimpanan Standar: menggunakan pola komunikasi TCP. HighPerformance: mengaktifkan Elastic RDMA Interface (ERI) dan menggunakan pola Elastis RDMA. Catatan Antarmuka jaringan dalam pola Elastis RDMA hanya dapat disambungkan ke Instans yang Tipe instansnya mendukung ERI. Jumlah ENI dalam pola RDMA tidak boleh melebihi batas family Instans. Untuk informasi lebih lanjut, lihat Keluarga instans dan Mengonfigurasi eRDMA pada Instans tingkat enterprise. Nilai default: Jenis Penyimpanan Standar.	Jenis Penyimpanan Standar
QueuePairNumber	integer	No	Jumlah antrian untuk RDMA ENI. Jika Anda ingin menyambungkan beberapa RDMA ENI ke sebuah instans, kami menyarankan Anda menentukan QueuePairNumber secara manual untuk setiap ENI berdasarkan batas atas `QueuePairNumber` yang didukung oleh tipe instans dan jumlah ENI yang rencananya akan digunakan. Pastikan total QueuePairNumber dari semua ENI tidak melebihi nilai maksimum yang diizinkan oleh tipe instans. Panggil DescribeInstanceTypes untuk mengkueri batas atas untuk tipe instans. Penting Jika QueuePairNumber tidak ditentukan untuk RDMA ENI, batas atas QueuePairNumber untuk semua RDMA ENI yang didukung oleh tipe instans digunakan secara default. Oleh karena itu, setelah RDMA ENI tanpa QueuePairNumber yang ditentukan disambungkan, tidak ada lagi RDMA ENI yang dapat ditambahkan (ENI reguler tidak terpengaruh oleh batas ini).	22
SecurityGroupIds	array	No	ID dari satu atau beberapa grup keamanan tempat antarmuka jaringan berada. Grup keamanan dan ENI harus berada di VPC yang sama. Nilai valid N bergantung pada kuota untuk jumlah maksimum grup keamanan tempat ENI dapat berada. Untuk informasi lebih lanjut, lihat Batasan. Catatan Saat memanggil operasi ini, Anda harus mengatur `SecurityGroupId` atau `SecurityGroupIds.N`, tetapi tidak keduanya.	sg-bp1fg655nh68xyz9i****
	string	No	ID dari satu atau beberapa grup keamanan tempat antarmuka jaringan berada. Grup keamanan dan ENI harus berada di VPC yang sama. Nilai valid N bergantung pada kuota untuk jumlah maksimum grup keamanan tempat ENI dapat berada. Untuk informasi lebih lanjut, lihat Batasan. Catatan Saat memanggil operasi ini, Anda harus mengatur `SecurityGroupId` atau `SecurityGroupIds.N`, tetapi tidak keduanya.	sg-bp1fg655nh68xyz9i****
PrivateIpAddress	array	No	Satu atau beberapa alamat IP privat sekunder yang dipilih dari alamat idle dalam blok CIDR vSwitch tempat antarmuka jaringan berada. Nilai valid N: 0 hingga 10. Catatan Saat mengalokasikan alamat IP privat sekunder, Anda tidak dapat menentukan parameter `PrivateIpAddress.N` dan parameter `SecondaryPrivateIpAddressCount` secara bersamaan.	172.17..
	string	No	Satu atau beberapa alamat IP privat sekunder yang dipilih dari alamat idle dalam blok CIDR vSwitch tempat antarmuka jaringan berada. Nilai valid N: 0 hingga 10. Catatan Saat mengalokasikan alamat IP privat sekunder, Anda tidak dapat menentukan parameter `PrivateIpAddress.N` dan parameter `SecondaryPrivateIpAddressCount` secara bersamaan.	172.17..
Ipv6Address	array	No	Satu atau beberapa alamat IPv6 untuk ditetapkan ke antarmuka jaringan. Anda dapat menentukan hingga 10 alamat IPv6. Nilai valid N: 1 hingga 10. Contoh: Ipv6Address.1=2001:db8:1234:1a00::** Catatan** Jika Anda ingin mengatur alamat IPv6 untuk antarmuka jaringan, Anda harus mengatur parameter `Ipv6Addresses.N` atau parameter `Ipv6AddressCount`, tetapi tidak keduanya.	2001:db8:1234:1a00::****
	string	No	Satu atau beberapa alamat IPv6 untuk ditetapkan ke antarmuka jaringan. Anda dapat menentukan hingga 10 alamat IPv6. Nilai valid N: 1 hingga 10. Contoh: Ipv6Address.1=2001:db8:1234:1a00::** Catatan** Jika Anda ingin mengatur alamat IPv6 untuk antarmuka jaringan, Anda harus mengatur parameter `Ipv6Addresses.N` atau parameter `Ipv6AddressCount`, tetapi tidak keduanya.	2001:db8:1234:1a00::****
Ipv6AddressCount	integer	No	Jumlah alamat IPv6 yang akan dihasilkan secara acak untuk antarmuka jaringan. Nilai valid: 1 hingga 10. Catatan Jika Anda ingin mengatur alamat IPv6 untuk antarmuka jaringan, Anda harus mengatur parameter `Ipv6Addresses.N` atau parameter `Ipv6AddressCount`, tetapi tidak keduanya.	1
Ipv4Prefix	array	No	Satu atau beberapa awalan IPv4 untuk ditetapkan ke antarmuka jaringan. Nilai valid N: 1 hingga 10. Catatan Jika Anda ingin mengatur awalan IPv4 untuk antarmuka jaringan, Anda harus mengatur parameter Ipv4Prefix.N atau parameter Ipv4PrefixCount, tetapi tidak keduanya.
	string	No	Satu atau beberapa awalan IPv4 untuk ditetapkan ke antarmuka jaringan. Nilai valid N: 1 hingga 10. Catatan Jika Anda ingin mengatur awalan IPv4 untuk antarmuka jaringan, Anda harus mengatur parameter Ipv4Prefix.N atau parameter Ipv4PrefixCount, tetapi tidak keduanya.	192.168../28
Ipv4PrefixCount	integer	No	Jumlah awalan IPv4 untuk ditetapkan ke antarmuka jaringan. Nilai valid: 1 hingga 10. Catatan Jika Anda ingin mengatur awalan IPv4 untuk antarmuka jaringan, Anda harus mengatur parameter Ipv4Prefix.N atau parameter Ipv4PrefixCount, tetapi tidak keduanya.	1
Ipv6Prefix	array	No	Satu atau beberapa awalan IPv6 untuk ditetapkan ke antarmuka jaringan. Nilai valid N: 1 hingga 10. Catatan Jika Anda ingin mengatur awalan IPv6 untuk antarmuka jaringan, Anda harus mengatur parameter Ipv6Prefix.N atau parameter Ipv6PrefixCount, tetapi tidak keduanya.
	string	No	Satu atau beberapa awalan IPv6 untuk ditetapkan ke antarmuka jaringan. Nilai valid N: 1 hingga 10. Catatan Jika Anda ingin mengatur awalan IPv6 untuk antarmuka jaringan, Anda harus mengatur parameter Ipv6Prefix.N atau parameter Ipv6PrefixCount, tetapi tidak keduanya.	2001:db8:1234:1a00:****::/80
Ipv6PrefixCount	integer	No	Jumlah awalan IPv6 untuk ditetapkan ke antarmuka jaringan. Nilai valid: 1 hingga 10. Catatan Jika Anda ingin mengatur awalan IPv6 untuk antarmuka jaringan, Anda harus mengatur parameter Ipv6Prefix.N atau parameter Ipv6PrefixCount, tetapi tidak keduanya.	1
DeleteOnRelease	boolean	No	Apakah akan mempertahankan ENI saat Instansi terkait dilepaskan. Nilai valid: true: tidak mempertahankan ENI. false: mempertahankan ENI.	true
TxQueueSize	integer	No	Kedalaman antrian arah keluar dari antarmuka jaringan. Perhatikan hal-hal berikut: Kedalaman antrian arah keluar dari antarmuka jaringan harus sama dengan kedalaman antrian arah masuk. Nilai valid: 8192 hingga 16384. Nilainya harus merupakan pangkat dari 2. Kedalaman antrian arah keluar yang lebih besar meningkatkan throughput arah keluar tetapi mengonsumsi lebih banyak memori. Catatan Parameter ini tidak tersedia untuk umum.	8192
RxQueueSize	integer	No	Kedalaman antrian arah masuk dari antarmuka jaringan. Perhatikan hal-hal berikut: Kedalaman antrian arah masuk dari antarmuka jaringan harus sama dengan kedalaman antrian arah keluar. Nilai valid: 8192 hingga 16384. Nilainya harus merupakan pangkat dari 2. Kedalaman antrian arah masuk yang lebih besar meningkatkan throughput arah masuk tetapi mengonsumsi lebih banyak memori. Catatan Parameter ini tidak tersedia untuk umum.	8192
NetworkInterfaceTrafficConfig	object	No	Set parameter konfigurasi Trafik dari antarmuka jaringan.
QueueNumber	integer	No	Jumlah antrian untuk antarmuka jaringan.	8
NetworkInterfaceTrafficMode	string	No	Pola komunikasi dari antarmuka jaringan.	HighPerformance
QueuePairNumber	integer	No	Jumlah antrian untuk RDMA ENI.	8
TxQueueSize	integer	No	Kedalaman antrian arah keluar dari antarmuka jaringan. Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia untuk umum. Jika Anda ingin menggunakan parameter ini, ajukan tiket untuk meminta akses. Perhatikan hal-hal berikut: Parameter ini hanya berlaku untuk Tipe instans ECS generasi ketujuh dan yang lebih baru. Parameter ini saat ini hanya berlaku untuk image Linux. Kedalaman antrian arah keluar yang lebih besar dari antarmuka jaringan meningkatkan throughput arah keluar dan mengurangi probabilitas kehilangan paket, tetapi mengonsumsi lebih banyak memori.	8192
RxQueueSize	integer	No	Kedalaman antrian arah masuk dari antarmuka jaringan. Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia untuk umum. Jika Anda ingin menggunakan parameter ini, ajukan tiket untuk meminta akses. Perhatikan hal-hal berikut: Parameter ini hanya berlaku untuk Tipe instans ECS generasi ketujuh dan yang lebih baru. Parameter ini saat ini hanya berlaku untuk image Linux. Kedalaman antrian arah masuk yang lebih besar dari antarmuka jaringan meningkatkan throughput arah masuk dan mengurangi probabilitas kehilangan paket, tetapi mengonsumsi lebih banyak memori.	8192
ConnectionTrackingConfiguration	object	No	Konfigurasi pelacakan konektivitas jaringan. Sebelum menggunakan parameter ini, baca Manajemen waktu tunggu koneksi.
TcpEstablishedTimeout	integer	No	Periode pengatur waktu untuk koneksi TCP yang telah terbentuk. Unit: detik. Nilai valid: [30, 60, 80, 100, 200, 300, 500, 700, 910]. Nilai default: 910.	910
TcpClosedAndTimeWaitTimeout	integer	No	Pengatur waktu tunggu untuk koneksi TCP dalam status TIME_WAIT dan CLOSED. Unit: detik. Nilai valid: bilangan bulat dari 3 hingga 15. Nilai default: 3. Catatan Jika Instans ECS Anda digunakan dengan NLB/CLB, pengatur waktu tunggu default untuk koneksi dalam status `TIME_WAIT` adalah 15 detik.	3
UdpTimeout	integer	No	Periode pengatur waktu untuk aliran UDP. Unit: detik. Nilai valid: [10, 20, 30, 60, 80, 100]. Nilai default: 30. Catatan Jika Instans ECS Anda digunakan dengan NLB/CLB, nilai defaultnya adalah 100 detik.	30
EnhancedNetwork	object	No	Catatan Parameter ini tidak tersedia untuk umum.
EnableSriov	boolean	No	Catatan Parameter ini tidak tersedia untuk umum.	true
EnableRss	boolean	No	Catatan Parameter ini tidak tersedia untuk umum.	true
VirtualFunctionTotalQueueNumber	integer	No
VirtualFunctionQuantity	integer	No
EnableExpress	boolean	No
SourceDestCheck	boolean	No	Apakah akan mengaktifkan pemeriksaan sumber/tujuan. Kami menyarankan Anda mengaktifkan fitur ini untuk meningkatkan keamanan jaringan. Nilai valid: true: diaktifkan. false: dinonaktifkan. Nilai default: false. Catatan Fitur ini hanya didukung di wilayah tertentu. Sebelum menggunakan fitur ini, baca Pemeriksaan sumber/tujuan.	false
EnablePrimaryIPv6	boolean	No

Elemen respons

Element	Type	Description	Example
	object
Status	string	Status pengontrol antarmuka jaringan (NIC).	Available
Type	string	Tipe pengontrol antarmuka jaringan (NIC).	Secondary
VpcId	string	ID VPC tempat ENI berada.	vpc-bp1j7w3gc1cexjqd****
NetworkInterfaceName	string	Nama pengontrol antarmuka jaringan (NIC).	my-eni-name
MacAddress	string	Alamat MAC pengontrol antarmuka jaringan (NIC).	00:16:3e:12::
NetworkInterfaceId	string	ID pengontrol antarmuka jaringan (NIC).	eni-bp14v2sdd3v8htln****
ServiceID	integer	ID Virtual Network Operator (VNO) yang bersesuaian dengan pengontrol antarmuka jaringan (NIC).	12345678910
OwnerId	string	ID akun pemilik pengontrol antarmuka jaringan (NIC).	123456****
ServiceManaged	boolean	Apakah pengguna pengontrol antarmuka jaringan (NIC) adalah layanan Alibaba Cloud atau VNO.	true
VSwitchId	string	ID vSwitch di VPC.	vsw-bp16usj2p27htro3****
RequestId	string	ID permintaan.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
Description	string	Deskripsi pengontrol antarmuka jaringan (NIC).	testDescription
ResourceGroupId	string	ID kelompok sumber daya.	rg-2ze88m67qx5z****
ZoneId	string	ID zona.	cn-hangzhou-e
PrivateIpAddress	string	Alamat IP privat pengontrol antarmuka jaringan (NIC).	172.17..
SecurityGroupIds	object
SecurityGroupId	array	Grup keamanan tempat ENI berada.
	string	ID grup keamanan.	sg-bp18kz60mefsicfg****
PrivateIpSets	object
PrivateIpSet	array<object>	Kumpulan objek PrivateIpSet.
	object
PrivateIpAddress	string	Alamat IP privat instans.	172.17..
Primary	boolean	Apakah alamat IP tersebut adalah alamat IP privat primer.	true
Tags	object
Tag	array<object>	Tag.
	object
TagValue	string	Nilai tag.	TestValue
TagKey	string	Kunci tag.	TestKey
Ipv6Sets	object
Ipv6Set	array<object>	Alamat IPv6 yang dialokasikan ke pengontrol antarmuka jaringan (NIC).
	object	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.
Ipv6Address	string	Alamat IPv6.	2001:db8:1234:1a00::****
Primary	boolean
Ipv4PrefixSets	object
Ipv4PrefixSet	array<object>	Awalan IPv4 yang dialokasikan ke pengontrol antarmuka jaringan (NIC).
	object
Ipv4Prefix	string	Awalan IPv4.	192.168../28
Ipv6PrefixSets	object
Ipv6PrefixSet	array<object>	Awalan IPv6 yang dialokasikan ke pengontrol antarmuka jaringan (NIC).
	object
Ipv6Prefix	string	Awalan IPv6.	2001:db8:1234:1a00:****::/80
SourceDestCheck	boolean	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.	false

Contoh

Respons sukses

JSONformat

{
  "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
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	MissingParameter	%s	Setidaknya satu dari parameter yang ditentukan harus disediakan. Parameter-parameter tersebut tidak boleh semuanya kosong.
400	UnsupportedParameter	%s	Parameter yang ditentukan tidak didukung.
400	InvalidParameter	%s	Kombinasi parameter yang ditentukan tidak valid.
400	InvalidInstanceID.Malformed	%s
400	InvalidOperation.InvalidEcsState	%s	Status instans saat ini tidak mendukung operasi ini.
400	InvalidOperation.InvalidEniState	%s	Status ENI saat ini tidak mengizinkan pengubahan atribut ENI.
400	InvalidOperation.DetachPrimaryEniNotAllowed	%s	Melepaskan ENI primer dari instans tidak diizinkan.
400	Forbidden.RegionId	%s	Layanan ini sementara tidak tersedia di wilayah saat ini.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	Terdapat kunci duplikat dalam tag. Pastikan kunci bersifat unik.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Kunci tag yang ditentukan tidak valid. Kunci tag tidak boleh kosong atau null, dapat berisi hingga 128 karakter, dan tidak boleh dimulai dengan "aliyun" atau "acs:" atau mengandung "http://" atau "https://".
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Nilai tag yang ditentukan tidak valid. Nilai tag dapat berisi hingga 128 karakter dan tidak boleh mengandung "http://" atau "https://".
400	JoinedGroupLimitExceed	%s	Jumlah maksimum grup keamanan yang dapat diikuti oleh resource tertentu telah tercapai. Untuk informasi lebih lanjut, lihat hasil pengembalian aktual dari placeholder %s dalam pesan error.
400	InvalidParameter.SecurityGroupIdRepeated	%s	Grup keamanan duplikat.
400	InvalidSecurityGroupId.SingleIdAndMultiIdConflict	%s
400	InvalidParameter.Conflict	%s	Operasi saat ini tidak mengizinkan diskId dan imageId ditentukan pada waktu yang sama. Pastikan diskId atau imageId tidak kosong.
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.	Wilayah atau pengguna tidak mendukung konfigurasi pengaturan koneksi antarmuka jaringan.
400	InvalidOperation.EniCountExceeded	%s.	Jumlah Elastic Network Interface (ENI) yang menyambungkan ke Instans ECS saat ini melebihi batas Elastic Network Interface (ENI) untuk tipe instans target.
400	InvalidPrivateIpAddress.Duplicated	The specified private IP address "%s" is duplicated.	Alamat IP yang ditentukan sudah digunakan.
400	IncorrectVSwitchStatus	The operation is not allowed in the current VSwitch state. Expecting state includes "Created Available", but current state is "%s".	Status saat ini dari vSwitch tidak mendukung operasi ini.
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.	Wilayah atau pengguna tidak mendukung pengaturan kedalaman antrian antarmuka jaringan.
400	InvalidParameter.EniQueueSize	The specified parameter "TxQueueSize" and "RxQueueSize" are not equal or the value must be 8192 or 16384.	Kedalaman antrian ENI arah keluar dan arah masuk tidak sama atau tidak berada dalam rentang nilai yang diizinkan.
400	InvalidParameter.EniConnectionTrackingConfiguration	The specified ENI connection tracking configuration "%s" must be between %s and %s.	Konfigurasi konektivitas jaringan yang ditentukan untuk pengontrol antarmuka jaringan (NIC) melebihi rentang yang diizinkan.
400	QuotaExceeded.PrivateIpAddress	There are not enough private IPs in the specified VSwitch.	Alamat IP pribadi yang tersedia di bawah vSwitch yang ditentukan tidak mencukupi.
400	Throttling	Request was denied due to request throttling.	Permintaan dibatasi kecepatannya. Gunakan metode paginasi berbasis NextToken alih-alih metode paginasi berbasis PageNumber untuk kueri.
400	InvalidVSwitch.IllegalStatus	The operation is not allowed in the current VSwitch state. Expecting state includes "Created", but current state is "%s".	Status vSwitch saat ini tidak mendukung operasi ini.
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.	Parameter peningkatan jaringan yang ditentukan tidak valid. Ketika EnableSriov diatur ke true, VirtualFunctionTotalQueueNumber tidak boleh kosong, dan VirtualFunctionQuantity harus berada dalam rentang 1 hingga 256. Ketika EnableSriov kosong atau diatur ke false, VirtualFunctionTotalQueueNumber dan VirtualFunctionQuantity harus kosong.
400	InvalidOperation.EnablePrimaryIPv6	The specified ENI can not enable primary IPv6 or already has primary IPv6.	ENI yang ditentukan tidak dapat mengaktifkan IPv6 primer atau sudah memiliki alamat IPv6 primer.
400	InvalidVSwitch.Ipv4NotEnabled	The specify VSwitch of ECS does not support IPv4.
401	InvalidOperation.SecurityGroupNotAuthorized	The specified security group is not authorized to operate.	Anda tidak memiliki izin untuk beroperasi pada grup keamanan saat ini.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Terjadi kesalahan saat mengirim permintaan. Coba lagi nanti.
500	InvalidOperation.RegionNotSupportIpPrefix	The current region does not support IP prefix feature.	Wilayah ini tidak mendukung penetapan awalan IP.
500	ServiceUnavailable	The request processing has failed due to some unknown error.	Permintaan mengalami waktu habis pengatur waktu. Coba lagi.
403	InvalidUserType.NotSupported	%s	Parameter tipe pengguna tidak valid.
403	Abs.InvalidAccount.NotFound	%s	Akun Alibaba Cloud Anda tidak ada, atau AccessKey Anda telah kedaluwarsa.
403	Forbidden.NotSupportRAM	%s	Pengguna Resource Access Management (RAM) tidak didukung untuk menjalankan operasi ini.
403	Forbidden.SubUser	%s	Akun Anda tidak memiliki izin untuk mengoperasikan resource ini. Minta izin yang diperlukan dari akun Alibaba Cloud.
403	InValidParameter	%s
403	MaxEniCountExceeded	%s	Jumlah maksimum Elastic Network Interface (ENI) yang dapat dioperasikan telah terlampaui.
403	EniPerInstanceLimitExceeded	%s	Jumlah Elastic Network Interface (ENI) yang menyambungkan ke instans telah mencapai batas maksimum. Tidak ada lagi Elastic Network Interface (ENI) yang dapat disambungkan ke instans.
403	InvalidOperation.AvailabilityZoneMismatch	%s	Antarmuka jaringan (NIC) dan Instans ECS tidak berada di zona yang sama karena vSwitch mereka berada di zona yang berbeda.
403	InvalidOperation.VpcMismatch	%s	VPC dari pengontrol antarmuka jaringan (NIC) tidak cocok dengan VPC dari grup keamanan.
403	SecurityGroupInstanceLimitExceed	%s	Jumlah instans dalam grup keamanan telah mencapai batas maksimum.
403	InvalidSecurityGroupId.NotVpc	%s	Parameter SecurityGroupId tidak valid. Jenis jaringan grup keamanan bukan VPC.
403	InvalidOperation.InvalidEniType	%s	Tipe Elastic Network Interface (ENI) saat ini tidak mendukung operasi ini.
403	InvalidVSwitchId.IpNotEnough	%s	Jumlah alamat IP yang tersedia di vSwitch yang ditentukan tidak mencukupi.
403	InvalidVSwitchId.IpInvalid	%s	Parameter IP tidak valid.
403	QuotaExceed.Tags	%s	Kuota parameter tag telah terlampaui. Nilai maksimum adalah 20.
403	InvalidIp.Address	%s	Format alamat IP salah atau alamat IP tidak berada dalam rentang blok CIDR yang tersedia.
403	InvalidIp.IpRepeated	%s	Alamat IP yang ditentukan duplikat.
403	MaxEniPrivateIpsCountExceeded	%s	Jumlah alamat IP privat sekunder yang ditetapkan ke ENI yang ditentukan melebihi batas. Untuk informasi lebih lanjut, lihat hasil pengembalian aktual dari placeholder %s dalam Paket error.
403	InvalidOperation.ResourceManagedByCloudProduct	%s	Operasi ini tidak didukung karena Sumber daya dikelola oleh layanan cloud. Hubungi layanan cloud terkait untuk mengonfirmasi alasannya.
403	InvalidOperation.TrunkingIsNotAllowed	%s	ENI trunk tidak dapat dioperasikan.
403	InvalidParameter.InvalidEniQueueNumber	%s	Jumlah antrian pengontrol antarmuka jaringan (NIC) salah. Untuk informasi lebih lanjut, lihat hasil pengembalian aktual dari placeholder %s dalam pesan error.
403	InvalidOperation.MaxEniQueueNumberExceeded	%s	Jumlah Antrian Elastic Network Interface (ENI) melebihi batas atas. Untuk informasi lebih lanjut, lihat hasil pengembalian aktual dari placeholder %s dalam Paket error.
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s	Jumlah Antrian Elastic Network Interface (ENI) yang menyambungkan ke Instans ECS saat ini melebihi batas Antrian pengontrol antarmuka jaringan (NIC) dari tipe instans target.
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.	Awalan IP tidak valid karena bukan dalam format CIDR.
403	InvalidIp.IpPrefixMustInReserveSegment	The ip prefix must in vswitch reserve segment.	Awalan IP tidak valid karena tidak berada dalam blok CIDR yang dicadangkan dari vSwitch.
403	InvalidOperation.Ipv4CountExceeded	%s	Jumlah alamat IPv4 pada Elastic Network Interfaces (ENI) yang tersambung ke Instance ECS saat ini melebihi batas Tipe instans target.
403	InvalidOperation.Ipv6CountExceeded	%s	Jumlah alamat IPv6 pada Elastic Network Interfaces (ENI) yang tersambung ke Instance ECS saat ini melebihi batas Tipe instans target.
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".	Mode komunikasi RDMA tidak mendukung tipe Elastic Network Interface (ENI) saat ini.
403	AclLimitExceed	%s	Jumlah aturan grup keamanan untuk ENI atau instans melebihi kuota.
403	InvalidIp.IpPrefixMaskInvalid	The IP prefix mask %s is illegal which must be between %s and %s.	Masker awalan IP tidak valid karena berada di luar rentang nilai valid.
403	InvalidVSwitchId.IpPrefixNotEnough	The specified VSwitch does not have enough IP prefixes.	Jumlah awalan IP yang tersedia di vSwitch yang ditentukan tidak mencukupi.
403	InvalidIp.IpPrefixMaskNotSame	The IP prefixes %s are illegal.The IP prefix mask must be the same.	Masker awalan IP tidak sama.
403	EnterpriseGroupLimited.MutliGroupType	The specified instance can't associate security group of different types.	Instans yang ditentukan tidak dapat ditambahkan ke beberapa tipe grup keamanan.
403	InvalidOperation.BoundingEniSlaveQuotaExceed	The number of Slave ENIs exceeds the limit of Bond ENI.	Jumlah NIC slave melebihi batas untuk NIC slave di bawah NIC bond.
403	InvalidIp.IpPrefixNotAvailable	The IP prefix is not available.	Awalan IP tidak idle.
403	InvalidIp.IpPrefixMaskIllegal	The current IP prefix mask is illegal.	Masker awalan IP tidak valid.
403	InvalidIp.IpPrefixNotStrict	The IP prefix "%s" must be strict CIDR format.	Awalan IP tidak valid karena bukan blok CIDR yang ketat.
403	InvalidOperation.NotSupport	The specified region does not support allocating IPv6 when creating ENI.	Penugasan alamat IPv6 tidak didukung saat membuat ENI di wilayah saat ini.
404	InvalidEcsId.NotFound	%s	ID instans yang ditentukan tidak ada.
404	InvalidEniId.NotFound	%s
404	InvalidVSwitchId.NotFound	%s	vSwitch yang ditentukan tidak ada.
404	InvalidSecurityGroupId.NotFound	%s	Grup keamanan yang ditentukan tidak ada.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	Kelompok sumber daya terkait tidak ditemukan.
404	InvalidOperation.MaxEniIpv6IpsCountExceeded	The ipv6 address count exceed limitation.
404	InvalidOperation.VSwitchIpv6Disabled	The specified VSwitch does not support Ipv6 feature.	vSwitch yang ditentukan tidak mendukung 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.	Bond ENI harus dibuat sebelum membuat Slave ENI.
404	InvalidOperation.EniTrafficModeNotSupportIpv6	The High Performance(RDMA) traffic mode does not support IPv6.	Elastic Network Interface (ENI) yang menggunakan mode komunikasi berkinerja tinggi RDMA tidak mendukung IPv6.
404	InvalidOperation.VSwitchCidrReservationNotExist	The specified VSwitch does not have CIDR reservation.	vSwitch yang ditentukan tidak memiliki blok CIDR reservasi yang tersedia.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.