All Products
Search

This Product

    Elastic Compute Service:CreateNetworkInterface

    Document Center

    Elastic Compute Service:CreateNetworkInterface

    Last Updated:Jun 12, 2026

    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 langsung menyambungkan.

    • Jika bidang NetworkInterfaceId dalam tanggapan kosong, coba buat ENI lagi.

    • ENI hanya dapat menyambungkan ke satu Instans yang terhubung ke VPC.

    • Saat ENI dilepas dan menyambungkan 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 Tampilan kuota sumber daya di Konsol ECS. Untuk informasi lebih lanjut, lihat Tampilan dan meningkatkan kuota sumber daya.

    Contoh permintaan

    Membuat ENI

    RegionId:  ap-southeast-1,   //Atur wilayah ke Singapura.
SecurityGroupId:  sg-bp10jztp6b0sdsyl****,   //Atur ID grup keamanan.
VSwitchId:  vsw-bp19wo63nleroq22g****,   //Atur ID vSwitch.

    Membuat ENI dan menentukan alamat IP privat utama

    RegionId:  ap-southeast-1,   //Wilayah Singapura.
SecurityGroupId:  sg-bp10jztp6b0sdsyl****,   //ID grup 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 tempat ENI yang akan dibuat berada. Anda dapat memanggil DescribeRegions untuk melihat daftar wilayah Alibaba Cloud terbaru.

    cn-hangzhou
    Tag

    array<object>

    No

    Tag ENI.

    object

    No

    Tag ENI.

    Key

    string

    No

    Kunci tag ENI. Nilai valid N: 1 hingga 20. Kunci tag tidak boleh berupa string kosong. Panjang kunci tag dapat mencapai 128 karakter dan tidak boleh diawali dengan aliyun atau acs:. Tidak boleh mengandung http:// atau https://.

    TestKey
    Value

    string

    No

    Nilai tag ENI. Nilai valid N: 1 hingga 20. Nilai tag dapat berupa string kosong. Panjang nilai tag dapat mencapai 128 karakter dan tidak boleh mengandung http:// atau https://.

    TestValue
    RegionId

    string

    Yes

    要创建的弹性网卡所在地域的 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

    cn-hangzhou
    ResourceGroupId

    string

    No

    ID kelompok sumber daya. Anda dapat memanggil ListResourceGroups untuk mengkueri informasi kelompok sumber daya.

    rg-bp67acfmxazb4ph****
    VSwitchId

    string

    Yes

    ID vSwitch ENI. Alamat IP privat ENI mengalokasikan dari alamat IP yang tidak terpakai dalam blok CIDR vSwitch.

    Penting ENI dan Instans tempat Anda ingin menyambungkan ENI harus berada di zona yang sama, tetapi dapat berada di vSwitch yang berbeda.
    .

    vsw-bp1s5fnvk4gn2tws03****
    PrimaryIpAddress

    string

    No

    Alamat IP privat utama ENI.

    Alamat IP yang ditentukan harus berupa alamat yang tidak terpakai dalam blok CIDR vSwitch. Jika Anda tidak menentukan parameter ini, alamat IP privat yang tidak terpakai dalam blok CIDR vSwitch akan mengalokasikan secara acak secara default.

    172.17.**.**
    SecurityGroupId

    string

    No

    ID grup keamanan tempat ENI ditambahkan. Grup keamanan dan ENI harus berada di VPC yang sama.

    Catatan

    Saat memanggil operasi ini, Anda harus menentukan SecurityGroupId atau SecurityGroupIds.N, tetapi tidak keduanya.

    sg-bp1fg655nh68xyz9i****
    NetworkInterfaceName

    string

    No

    Nama ENI. Panjang nama harus 2 hingga 128 karakter dan dapat berisi karakter dari kategorisasi huruf Unicode (termasuk karakter bahasa Inggris dan Tionghoa) serta digit ASCII (0-9). Nama dapat berisi titik dua (:), garis bawah (_), periode (.), atau tanda hubung (-).

    Nilai default: kosong.

    testNetworkInterfaceName
    Description

    string

    No

    Deskripsi ENI. Panjang deskripsi harus 2 hingga 256 karakter dan tidak boleh diawali dengan http:// atau https://.

    Nilai default: kosong.

    testDescription
    Visible

    boolean

    No

    Catatan

    Parameter ini tidak digunakan lagi.

    null
    InstanceType

    string

    No

    Tipe ENI. Nilai valid:

    • Secondary: ENI sekunder.

    • Trunk: pengontrol antarmuka jaringan (NIC) trunk (dalam pratinjau undangan).

    Nilai default: Secondary.

    Secondary
    BusinessType

    string

    No

    Catatan

    Parameter ini 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 ENI. Nilai valid: 1 hingga 2048.

    Saat menyambungkan ENI ke instans, nilai harus kurang dari jumlah antrian maksimum per pengontrol antarmuka jaringan (NIC) yang didukung oleh tipe instans. Anda dapat memanggil DescribeInstanceTypes dan memeriksa bidang MaximumQueueNumberPerEni untuk mengkueri jumlah maksimum.

    Nilai default: kosong. Saat ENI disambungkan, jumlah antrian default untuk tipe instans akan digunakan. Anda dapat memanggil DescribeInstanceTypes dan memeriksa bidang SecondaryEniQueueNumber untuk mengkueri nilai default.

    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

    Mode komunikasi ENI. Nilai valid:

    • Standard: menggunakan mode komunikasi TCP.

    • HighPerformance: mengaktifkan Elastic RDMA Interface (ERI) dan menggunakan mode Elastis RDMA.

    Catatan

    ENI dalam mode Elastis RDMA hanya dapat menyambungkan ke Instans yang Tipe instans-nya mendukung ERI. Jumlah ENI dalam mode RDMA tidak boleh melebihi batas keluarga instans. Untuk informasi lebih lanjut, lihat keluarga instans dan Mengonfigurasi eRDMA pada Instans tingkat enterprise.

    Nilai default: Standard.

    Standard
    QueuePairNumber

    integer

    No

    Jumlah antrian untuk ENI RDMA.

    Jika Anda ingin menyambungkan beberapa ENI RDMA ke 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 tipe instans.

    Penting Jika QueuePairNumber tidak ditentukan untuk ENI RDMA, batas atas QueuePairNumber untuk semua ENI RDMA yang didukung oleh tipe instans akan digunakan secara default. Oleh karena itu, setelah ENI RDMA tanpa QueuePairNumber yang ditentukan disambungkan, tidak ada lagi ENI RDMA yang dapat ditambahkan. Pembatasan ini tidak berlaku untuk ENI standar.
    .

    22
    SecurityGroupIds

    array

    No

    ID satu atau beberapa grup keamanan tempat ENI ditambahkan. 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 Batas.

    Catatan

    Saat memanggil operasi ini, Anda harus menentukan SecurityGroupId atau SecurityGroupIds.N, tetapi tidak keduanya.

    sg-bp1fg655nh68xyz9i****

    string

    No

    ID satu atau beberapa grup keamanan tempat ENI ditambahkan. 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 Batas.

    Catatan

    Saat memanggil operasi ini, Anda harus menentukan SecurityGroupId atau SecurityGroupIds.N, tetapi tidak keduanya.

    sg-bp1fg655nh68xyz9i****
    PrivateIpAddress

    array

    No

    Satu atau beberapa alamat IP privat sekunder yang dipilih dari alamat yang tidak terpakai dalam blok CIDR vSwitch tempat ENI 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 yang tidak terpakai dalam blok CIDR vSwitch tempat ENI 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 ENI. Anda dapat menentukan hingga 10 alamat IPv6. Nilai valid N: 1 hingga 10.

    Contoh: Ipv6Address.1=2001:db8:1234:1a00::****

    Catatan

    Jika Anda ingin mengonfigurasi alamat IPv6 untuk ENI, Anda harus menentukan parameter Ipv6Addresses.N atau parameter Ipv6AddressCount, tetapi tidak keduanya.

    2001:db8:1234:1a00::****

    string

    No

    Satu atau beberapa alamat IPv6 untuk ditetapkan ke ENI. Anda dapat menentukan hingga 10 alamat IPv6. Nilai valid N: 1 hingga 10.

    Contoh: Ipv6Address.1=2001:db8:1234:1a00::****

    Catatan

    Jika Anda ingin mengonfigurasi alamat IPv6 untuk ENI, Anda harus menentukan 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 ENI. Nilai valid: 1 hingga 10.

    Catatan

    Jika Anda ingin mengonfigurasi alamat IPv6 untuk ENI, Anda harus menentukan parameter Ipv6Addresses.N atau parameter Ipv6AddressCount, tetapi tidak keduanya.

    1
    Ipv4Prefix

    array

    No

    Satu atau beberapa awalan IPv4 untuk ditetapkan ke ENI. Nilai valid N: 1 hingga 10.

    Catatan

    Jika Anda ingin mengonfigurasi awalan IPv4 untuk ENI, Anda harus menentukan parameter Ipv4Prefix.N atau Ipv4PrefixCount, tetapi tidak keduanya.

    string

    No

    Satu atau beberapa awalan IPv4 untuk ditetapkan ke ENI. Nilai valid N: 1 hingga 10.

    Catatan

    Jika Anda ingin mengonfigurasi awalan IPv4 untuk ENI, Anda harus menentukan parameter Ipv4Prefix.N atau Ipv4PrefixCount, tetapi tidak keduanya.

    192.168.**.**/28
    Ipv4PrefixCount

    integer

    No

    Jumlah awalan IPv4 untuk ditetapkan ke ENI. Nilai valid: 1 hingga 10.

    Catatan

    Jika Anda ingin mengonfigurasi awalan IPv4 untuk ENI, Anda harus menentukan parameter Ipv4Prefix.N atau Ipv4PrefixCount, tetapi tidak keduanya.

    1
    Ipv6Prefix

    array

    No

    Satu atau beberapa awalan IPv6 untuk ditetapkan ke ENI. Nilai valid N: 1 hingga 10.

    Catatan

    Jika Anda ingin mengonfigurasi awalan IPv6 untuk ENI, Anda harus menentukan parameter Ipv6Prefix.N atau Ipv6PrefixCount, tetapi tidak keduanya.

    string

    No

    Satu atau beberapa awalan IPv6 untuk ditetapkan ke ENI. Nilai valid N: 1 hingga 10.

    Catatan

    Jika Anda ingin mengonfigurasi awalan IPv6 untuk ENI, Anda harus menentukan parameter Ipv6Prefix.N atau Ipv6PrefixCount, tetapi tidak keduanya.

    2001:db8:1234:1a00:****::/80
    Ipv6PrefixCount

    integer

    No

    Jumlah awalan IPv6 untuk ditetapkan ke ENI. Nilai valid: 1 hingga 10.

    Catatan

    Jika Anda ingin mengonfigurasi awalan IPv6 untuk ENI, Anda harus menentukan parameter Ipv6Prefix.N atau Ipv6PrefixCount, tetapi tidak keduanya.

    1
    DeleteOnRelease

    boolean

    No

    Apakah akan mempertahankan ENI saat Instansi terkait dilepas. Nilai valid:

    • true: tidak mempertahankan ENI.

    • false: mempertahankan ENI.

    true
    TxQueueSize

    integer

    No

    Kedalaman antrian arah keluar ENI.

    Perhatikan hal-hal berikut:

    • Kedalaman antrian arah keluar pengontrol antarmuka jaringan (NIC) harus sama dengan kedalaman antrian arah masuk. Nilai valid: 8192 hingga 16384. Nilai harus berupa pangkat 2.

    • Kedalaman antrian arah keluar yang lebih besar meningkatkan throughput arah keluar tetapi mengonsumsi lebih banyak memori.

    Catatan

    Parameter ini tidak tersedia secara publik.

    8192
    RxQueueSize

    integer

    No

    Kedalaman antrian arah masuk ENI.

    Perhatikan hal-hal berikut:

    • Kedalaman antrian arah masuk pengontrol antarmuka jaringan (NIC) harus sama dengan kedalaman antrian arah keluar. Nilai valid: 8192 hingga 16384. Nilai harus berupa pangkat 2.

    • Kedalaman antrian arah masuk yang lebih besar meningkatkan throughput arah masuk tetapi mengonsumsi lebih banyak memori.

    Catatan

    Parameter ini tidak tersedia secara publik.

    8192
    NetworkInterfaceTrafficConfig

    object

    No

    Kumpulan parameter komunikasi ENI.

    QueueNumber

    integer

    No

    Jumlah antrian untuk ENI.

    8
    NetworkInterfaceTrafficMode

    string

    No

    Mode komunikasi ENI.

    HighPerformance
    QueuePairNumber

    integer

    No

    Jumlah antrian untuk ENI RDMA.

    8
    TxQueueSize

    integer

    No

    Kedalaman antrian arah keluar ENI.

    Catatan

    Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik. Untuk menggunakan parameter ini, kirim 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 pengontrol antarmuka jaringan (NIC) yang lebih besar meningkatkan throughput arah keluar dan mengurangi kehilangan paket tetapi mengonsumsi lebih banyak memori.

    8192
    RxQueueSize

    integer

    No

    Kedalaman antrian arah masuk ENI.

    Catatan

    Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik. Untuk menggunakan parameter ini, kirim 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 pengontrol antarmuka jaringan (NIC) yang lebih besar meningkatkan throughput arah masuk dan mengurangi kehilangan paket tetapi mengonsumsi lebih banyak memori.

    8192
    ConnectionTrackingConfiguration

    object

    No

    Konfigurasi pelacakan konektivitas jaringan.

    Sebelum menggunakan parameter ini, baca Manajemen pengatur waktu tunggu koneksi.

    TcpEstablishedTimeout

    integer

    No

    Periode pengatur waktu tunggu 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

    Periode 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 tunggu 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 default adalah 100 detik.

    30
    EnhancedNetwork

    object

    No

    Catatan

    Parameter ini tidak tersedia secara publik.

    EnableSriov

    boolean

    No

    Catatan

    Parameter ini tidak tersedia secara publik.

    true
    EnableRss

    boolean

    No

    Catatan

    Parameter ini tidak tersedia secara publik.

    true
    VirtualFunctionTotalQueueNumber

    integer

    No

    VirtualFunctionQuantity

    integer

    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

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Status

    string

    Status ENI.

    Available
    Type

    string

    Tipe ENI.

    Secondary
    VpcId

    string

    ID VPC tempat ENI berada.

    vpc-bp1j7w3gc1cexjqd****
    NetworkInterfaceName

    string

    Nama ENI.

    my-eni-name
    MacAddress

    string

    Alamat MAC ENI.

    00:16:3e:12:**:**
    NetworkInterfaceId

    string

    ID ENI.

    eni-bp14v2sdd3v8htln****
    ServiceID

    integer

    ID Virtual Network Operator (VNO) yang terkait dengan ENI.

    12345678910
    OwnerId

    string

    ID akun yang memiliki ENI.

    123456****
    ServiceManaged

    boolean

    Apakah pengguna ENI adalah layanan Alibaba Cloud atau VNO.

    true
    VSwitchId

    string

    ID vSwitch VPC.

    vsw-bp16usj2p27htro3****
    RequestId

    string

    ID permintaan.

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
    Description

    string

    Deskripsi ENI.

    testDescription
    ResourceGroupId

    string

    ID kelompok sumber daya.

    rg-2ze88m67qx5z****
    ZoneId

    string

    ID zona.

    cn-hangzhou-e
    PrivateIpAddress

    string

    Alamat IP privat ENI.

    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

    The private IP address of the instance.

    172.17.**.**
    Primary

    boolean

    Indicates whether the private IP address is the primary private IP address.

    true
    Tags

    object

    Tag

    array<object>

    Tag.

    object

    TagValue

    string

    The tag value.

    TestValue
    TagKey

    string

    The tag key.

    TestKey
    Ipv6Sets

    object

    Ipv6Set

    array<object>

    Alamat IPv6 yang mengalokasikan ke ENI.

    object
    Catatan

    Parameter ini berada dalam pratinjau undangan dan tidak tersedia secara publik.

    Ipv6Address

    string

    The IPv6 address assigned to the ENI.

    2001:db8:1234:1a00::****
    Ipv4PrefixSets

    object

    Ipv4PrefixSet

    array<object>

    Awalan IPv4 yang mengalokasikan ke ENI.

    object

    Ipv4Prefix

    string

    The IPv4 prefix assigned to the ENI.

    192.168.**.**/28
    Ipv6PrefixSets

    object

    Ipv6PrefixSet

    array<object>

    Awalan IPv6 yang mengalokasikan ke ENI.

    object

    Ipv6Prefix

    string

    The IPv6 prefix assigned to the ENI.

    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::****"
      }
    ]
  },
  "Ipv4PrefixSets": {
    "Ipv4PrefixSet": [
      {
        "Ipv4Prefix": "192.168.**.**/28"
      }
    ]
  },
  "Ipv6PrefixSets": {
    "Ipv6PrefixSet": [
      {
        "Ipv6Prefix": "2001:db8:1234:1a00:****::/80"
      }
    ]
  },
  "SourceDestCheck": false
}

    Respons error

    JSONformat

    {
    "RequestId": "04F0F334-1335-436C-A1D7-6C044FExxxxx",
    "NetworkInterfaceId": "eni-enixxxxx"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 MissingParameter %s
    400 UnsupportedParameter %s
    400 InvalidParameter %s
    400 InvalidInstanceID.Malformed %s
    400 InvalidOperation.InvalidEcsState %s
    400 InvalidOperation.InvalidEniState %s
    400 InvalidOperation.DetachPrimaryEniNotAllowed %s
    400 Forbidden.RegionId %s
    400 Duplicate.TagKey The Tag.N.Key contain duplicate key.
    400 InvalidTagKey.Malformed The specified Tag.n.Key is not valid.
    400 InvalidTagValue.Malformed The specified Tag.n.Value is not valid.
    400 JoinedGroupLimitExceed %s
    400 InvalidParameter.SecurityGroupIdRepeated %s
    400 InvalidSecurityGroupId.SingleIdAndMultiIdConflict %s
    400 InvalidParameter.Conflict %s
    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.
    400 InvalidOperation.EniCountExceeded %s.
    400 InvalidPrivateIpAddress.Duplicated The specified private IP address "%s" is duplicated.
    400 IncorrectVSwitchStatus The operation is not allowed in the current VSwitch state. Expecting state includes "Created Available", but current state is "%s".
    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.
    400 InvalidParameter.EniQueueSize The specified parameter "TxQueueSize" and "RxQueueSize" are not equal or the value must be 8192 or 16384.
    400 InvalidParameter.EniConnectionTrackingConfiguration The specified ENI connection tracking configuration "%s" must be between %s and %s.
    400 QuotaExceeded.PrivateIpAddress There are not enough private IPs in the specified VSwitch.
    400 Throttling Request was denied due to request throttling.
    400 InvalidVSwitch.IllegalStatus The operation is not allowed in the current VSwitch state. Expecting state includes "Created", but current state is "%s".
    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.
    401 InvalidOperation.SecurityGroupNotAuthorized The specified security group is not authorized to operate.
    500 InternalError The request processing has failed due to some unknown error, exception or failure.
    500 InvalidOperation.RegionNotSupportIpPrefix The current region does not support IP prefix feature.
    500 ServiceUnavailable The request processing has failed due to some unknown error.
    403 InvalidUserType.NotSupported %s
    403 Abs.InvalidAccount.NotFound %s
    403 Forbidden.NotSupportRAM %s
    403 Forbidden.SubUser %s
    403 InValidParameter %s
    403 MaxEniCountExceeded %s
    403 EniPerInstanceLimitExceeded %s
    403 InvalidOperation.AvailabilityZoneMismatch %s
    403 InvalidOperation.VpcMismatch %s
    403 SecurityGroupInstanceLimitExceed %s
    403 InvalidSecurityGroupId.NotVpc %s
    403 InvalidOperation.InvalidEniType %s
    403 InvalidVSwitchId.IpNotEnough %s
    403 InvalidVSwitchId.IpInvalid %s
    403 QuotaExceed.Tags %s
    403 InvalidIp.Address %s
    403 InvalidIp.IpRepeated %s
    403 MaxEniPrivateIpsCountExceeded %s
    403 InvalidOperation.ResourceManagedByCloudProduct %s
    403 InvalidOperation.TrunkingIsNotAllowed %s
    403 InvalidParameter.InvalidEniQueueNumber %s
    403 InvalidOperation.MaxEniQueueNumberExceeded %s
    403 InvalidOperation.ExceedInstanceTypeQueueNumber %s
    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.
    403 InvalidIp.IpPrefixMustInReserveSegment The ip prefix must in vswitch reserve segment.
    403 InvalidOperation.Ipv4CountExceeded %s
    403 InvalidOperation.Ipv6CountExceeded %s
    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".
    403 AclLimitExceed %s
    403 InvalidIp.IpPrefixMaskInvalid The IP prefix mask %s is illegal which must be between %s and %s.
    403 InvalidVSwitchId.IpPrefixNotEnough The specified VSwitch does not have enough IP prefixes.
    403 InvalidIp.IpPrefixMaskNotSame The IP prefixes %s are illegal.The IP prefix mask must be the same.
    403 EnterpriseGroupLimited.MutliGroupType The specified instance can't associate security group of different types.
    403 InvalidOperation.BoundingEniSlaveQuotaExceed The number of Slave ENIs exceeds the limit of Bond ENI.
    403 InvalidIp.IpPrefixNotAvailable The IP prefix is not available.
    403 InvalidIp.IpPrefixMaskIllegal The current IP prefix mask is illegal.
    403 InvalidIp.IpPrefixNotStrict The IP prefix "%s" must be strict CIDR format.
    403 InvalidOperation.NotSupport The specified region does not support allocating IPv6 when creating ENI.
    404 InvalidEcsId.NotFound %s
    404 InvalidEniId.NotFound %s
    404 InvalidVSwitchId.NotFound %s
    404 InvalidSecurityGroupId.NotFound %s
    404 InvalidResourceGroup.NotFound The ResourceGroup provided does not exist in our records.
    404 InvalidOperation.MaxEniIpv6IpsCountExceeded The ipv6 address count exceed limitation.
    404 InvalidOperation.VSwitchIpv6Disabled The specified VSwitch does not support Ipv6 feature.
    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.
    404 InvalidOperation.EniTrafficModeNotSupportIpv6 The High Performance(RDMA) traffic mode does not support IPv6.
    404 InvalidOperation.VSwitchCidrReservationNotExist The specified VSwitch does not have CIDR reservation.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.