All Products
Search

This Product

    Elastic Compute Service:ModifyNetworkInterfaceAttribute

    Document Center

    Elastic Compute Service:ModifyNetworkInterfaceAttribute

    Last Updated:Jun 12, 2026

    Mengubah atribut antarmuka jaringan elastis (ENI), termasuk jumlah antrean, grup keamanan tempat ENI berada, kedalaman antrean, mode komunikasi, dan apakah ENI dipertahankan saat instance terkait dilepaskan.

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

    update

    *NetworkInterface

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

    *SecurityGroup

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

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID region tempat ENI berada. Anda dapat memanggil DescribeRegions untuk menanyakan daftar region Alibaba Cloud terbaru.

    cn-hangzhou
    RegionId

    string

    Yes

    ID region tempat ENI berada. Anda dapat memanggil DescribeRegions untuk menanyakan daftar region Alibaba Cloud terbaru.

    cn-hangzhou
    NetworkInterfaceName

    string

    No

    Nama ENI. Panjang harus 2 hingga 128 karakter. Harus dimulai dengan huruf atau karakter Tionghoa dan tidak boleh dimulai dengan http:// atau https://. Mendukung karakter Unicode dalam kategori letter (termasuk huruf Inggris, karakter Tionghoa, dan digit). Dapat berisi titik dua (:), garis bawah (_), titik (.), atau tanda hubung (-).

    Nilai default: kosong.

    eniTestName
    NetworkInterfaceId

    string

    Yes

    ID ENI.

    eni-bp67acfmxazb4p****
    QueueNumber

    integer

    No

    Jumlah antrean untuk ENI. Rentang nilai: 1 hingga 2048.

    • Anda dapat mengubah jumlah antrean untuk ENI yang berada dalam status Available (Available), atau ENI yang terpasang (InUse) ke instance yang berada dalam status Stopped (Stopped).

    • Jumlah antrean untuk ENI tidak boleh melebihi jumlah antrean maksimum per ENI yang diizinkan oleh tipe instance. Pada saat yang sama, jumlah total antrean di semua ENI pada sebuah instance tidak boleh melebihi kuota total antrean yang diizinkan oleh tipe instance. Anda dapat menanyakan jumlah antrean maksimum per ENI dan kuota total untuk tipe instance dengan memanggil operasi DescribeInstanceTypes dan memeriksa field MaximumQueueNumberPerEni dan TotalEniQueueQuantity.

    8
    Description

    string

    No

    Deskripsi ENI. Deskripsi harus memiliki panjang 2 hingga 255 karakter (Inggris atau Tionghoa), dan tidak boleh dimulai dengan http:// atau https://.

    Nilai default: kosong.

    testDescription
    SecurityGroupId

    array

    No

    Daftar SecurityGroupIds. ENI sekunder pada akhirnya akan bergabung ke grup keamanan ini, dan akan dikeluarkan dari grup keamanan yang ada.

    • Rentang nilai N yang valid bergantung pada kuota jumlah grup keamanan yang dapat diikuti setiap ENI. Untuk informasi selengkapnya, lihat Batasan.

    • Modifikasi grup keamanan berlaku dengan cepat tetapi mungkin ada sedikit penundaan.

    string

    No

    Daftar SecurityGroupIds.

    • Rentang nilai N yang valid bergantung pada kuota jumlah grup keamanan yang dapat diikuti setiap ENI. Untuk informasi selengkapnya, lihat Batasan.

    • Hanya grup keamanan ENI sekunder yang dapat dimodifikasi.

    • Setelah grup keamanan diatur, ENI sekunder bergabung ke grup keamanan ini dan dikeluarkan dari grup keamanan yang ada.

    • Modifikasi grup keamanan berlaku dengan cepat tetapi mungkin ada sedikit penundaan.

    sg-bp67acfmxazb4p****
    DeleteOnRelease

    boolean

    No

    Menentukan apakah ENI dipertahankan saat instance terkait dilepaskan. Rentang nilai:

    • true: Tidak dipertahankan.

    • false: Dipertahankan.

    true
    RxQueueSize

    integer

    No

    Kedalaman antrean arah masuk (inbound) ENI.

    Catatan

    Parameter ini sedang dalam invitational preview dan belum tersedia untuk penggunaan umum. Jika Anda membutuhkannya, silakan ajukan tiket untuk ditambahkan ke whitelist.

    Catatan:

    • Hanya didukung pada tipe instance ECS generasi ke-7 dan yang lebih baru.

    • Saat ini hanya didukung pada image Linux.

    • Kedalaman antrean arah masuk yang lebih besar dapat meningkatkan throughput arah masuk dan mengurangi kemungkinan packet loss, tetapi mengonsumsi lebih banyak memori.

    8192
    TxQueueSize

    integer

    No

    Kedalaman antrean arah keluar (outbound) ENI.

    Catatan

    Parameter ini sedang dalam invitational preview dan belum tersedia untuk penggunaan umum. Jika Anda membutuhkannya, silakan ajukan tiket untuk ditambahkan ke whitelist.

    Catatan:

    • Hanya didukung pada tipe instance ECS generasi ke-7 dan yang lebih baru.

    • Saat ini hanya didukung pada image Linux.

    • Kedalaman antrean arah keluar yang lebih besar dapat meningkatkan throughput arah keluar dan mengurangi kemungkinan packet loss, tetapi mengonsumsi lebih banyak memori.

    8192
    NetworkInterfaceTrafficConfig

    object

    No

    Parameter komunikasi ENI.

    NetworkInterfaceTrafficMode

    string

    No

    Mode komunikasi ENI. Rentang nilai:

    • Standard: Menggunakan mode komunikasi TCP.

    • HighPerformance: Mengaktifkan ERI (Elastic RDMA Interface) dan menggunakan mode komunikasi RDMA.

    Ketika ENI dalam status terpasang, perhatikan:

    • Jumlah total ENI RDMA pada instance tidak boleh melebihi kuota ENI RDMA yang diizinkan oleh tipe instance. Anda dapat menanyakan kuota ENI RDMA yang diizinkan oleh tipe instance dengan memanggil operasi DescribeInstanceTypes dan memeriksa field EriQuantity.

    Catatan

    Parameter ini sedang dalam invitational preview dan belum tersedia untuk penggunaan umum.

    HighPerformance
    QueueNumber

    integer

    No

    Jumlah antrean untuk ENI. Ketika ENI dalam status terpasang, perhatikan:

    • Tidak boleh melebihi jumlah antrean maksimum per ENI yang diizinkan oleh tipe instance.

    • Jumlah total antrean di semua ENI pada instance tidak boleh melebihi kuota total antrean yang diizinkan oleh tipe instance. Anda dapat menanyakan jumlah antrean maksimum per ENI dan kuota total untuk tipe instance dengan memanggil operasi DescribeInstanceTypes dan memeriksa field MaximumQueueNumberPerEni dan TotalEniQueueQuantity.

    Catatan

    Parameter ini sedang dalam invitational preview dan belum tersedia untuk penggunaan umum.

    8
    QueuePairNumber

    integer

    No

    Jumlah antrean untuk ENI RDMA. Ketika ENI dalam status terpasang, perhatikan:

    • Tidak boleh melebihi jumlah antrean maksimum per ENI RDMA yang diizinkan oleh tipe instance. Anda dapat menanyakan jumlah antrean maksimum per ENI RDMA yang diizinkan oleh tipe instance dengan memanggil operasi DescribeInstanceTypes dan memeriksa field QueuePairNumber.

    Catatan

    Parameter ini sedang dalam invitational preview dan belum tersedia untuk penggunaan umum.

    8
    RxQueueSize

    integer

    No

    Kedalaman antrean arah masuk (inbound) ENI.

    Catatan

    Parameter ini sedang dalam invitational preview dan belum tersedia untuk penggunaan umum. Jika Anda membutuhkannya, silakan ajukan tiket untuk ditambahkan ke whitelist.

    Catatan:

    • Hanya didukung pada tipe instance ECS generasi ke-7 dan yang lebih baru.

    • Saat ini hanya didukung pada image Linux.

    • Kedalaman antrean arah masuk yang lebih besar dapat meningkatkan throughput arah masuk dan mengurangi kemungkinan packet loss, tetapi mengonsumsi lebih banyak memori.

    8192
    TxQueueSize

    integer

    No

    Kedalaman antrean arah keluar (outbound) ENI.

    Catatan

    Parameter ini sedang dalam invitational preview dan belum tersedia untuk penggunaan umum. Jika Anda membutuhkannya, silakan ajukan tiket untuk ditambahkan ke whitelist.

    Catatan:

    • Hanya didukung pada tipe instance ECS generasi ke-7 dan yang lebih baru.

    • Saat ini hanya didukung pada image Linux.

    • Kedalaman antrean arah keluar yang lebih besar dapat meningkatkan throughput arah keluar dan mengurangi kemungkinan packet loss, tetapi mengonsumsi lebih banyak memori.

    8192
    ConnectionTrackingConfiguration

    object

    No

    Koleksi konfigurasi pelacakan koneksi jaringan.

    Sebelum menggunakan parameter ini, baca dengan cermat Manajemen Timeout Koneksi.

    TcpEstablishedTimeout

    integer

    No

    Periode timeout untuk koneksi TCP yang sudah established, dalam detik. Rentang nilai: [30, 60, 80, 100, 200, 300, 500, 700, 910].

    Nilai default: 910.

    910
    TcpClosedAndTimeWaitTimeout

    integer

    No

    Periode timeout untuk koneksi TCP dalam status TIME_WAIT dan CLOSED, dalam detik. Rentang nilai: bilangan bulat dalam rentang 3 hingga 15.

    Nilai default: 3.

    Catatan

    Jika instance ECS Anda digunakan dengan NLB/CLB, timeout default untuk koneksi dalam status TIME_WAIT adalah 15 detik.

    3
    UdpTimeout

    integer

    No

    Timeout aliran UDP, dalam detik. Rentang nilai: [10, 20, 30, 60, 80, 100].

    Nilai default: 30.

    Catatan

    Jika instance ECS Anda digunakan dengan NLB/CLB, nilai default adalah 100 detik.

    30
    EnhancedNetwork

    object

    No

    Parameter ini belum tersedia untuk penggunaan umum.

    EnableSriov

    boolean

    No

    Parameter ini belum tersedia untuk penggunaan umum.

    true
    EnableRss

    boolean

    No

    Catatan

    Parameter ini belum tersedia untuk penggunaan umum.

    false
    VirtualFunctionTotalQueueNumber

    integer

    No

    VirtualFunctionQuantity

    integer

    No

    SourceDestCheck

    boolean

    No

    Menentukan apakah mengaktifkan fitur pemeriksaan source/destination. Kami menyarankan Anda mengaktifkan fitur ini untuk meningkatkan keamanan jaringan. Rentang nilai:

    • true: Ya.

    • false: Tidak.

    Nilai default: false.

    Catatan

    Fitur ini hanya didukung di beberapa region. Sebelum menggunakannya, baca dengan cermat Pemeriksaan Source/Destination.

    false

    Elemen respons

    Element

    Type

    Description

    Example

    object

    ID permintaan.

    RequestId

    string

    ID permintaan.

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidOperation.NotSupportModifyQueueNumber %s
    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 InvalidParams.EniId %s
    400 Forbidden.RegionId %s
    400 JoinedGroupLimitExceed %s
    400 InvalidEniQueueSize.RegionOrUserNotSupported The specified parameter RxQueueSize or TxQueueSize is not supported in this region, or this account is not in the whitelist of using eni QueueSize.
    400 InvalidParameter.EniQueueSize The specified parameter TxQueueSize and RxQueueSize are not equal or exceed limit.
    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 InvalidParameter.InvalidQueuePairNumber The specified parameter QueuePairNumber exceeds limit.
    400 InvalidParameter.EniConnectionTrackingConfiguration The specify network interface connection tracking configuration exceeds limit.
    400 InvalidOperation.MaxEniQueuePairNumberExceed The QueuePairNumber on the RDMA ENI exceeds the upper limit allowed for a single ENI.
    400 InvalidOperation.HighPerformanceEniPerInstanceLimitExceeded The number of RDMA ENIs attached to the ECS instance exceeds the upper limit.
    400 InvalidOperation.InstanceTypeNotSupportHighPerformance The ECS instance type where the ENI is located does not support the RDMA mode.
    400 InvalidTrafficMode.ModifyToStandardNotSupported The specified parameter NetworkInterfaceTrafficMode is not supported to modify to Standard.
    400 InvalidOperation.EniTrafficModeNotSupportIPv6 The ENI using High Performance traffic mode does not support IPv6.
    400 InvalidOperation.EniQueuePairNumberOverflow The RDMA QueuePairNumber of the ECS instance associated with the specified ENI exceeds the limit.
    400 InvalidParameter.QueuePairNumberMustEmpty When the traffic mode is set to Standard, the QueuePairNumber must be empty.
    400 InvalidParameter.EniTrafficMode The ENI traffic mode is set incorrectly, it must be either Standard or HighPerformance.
    400 InvalidOperation.InstanceTypeNotSupportRss The ECS instance type does not support Rss.
    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.
    400 InvalidOperation.NotSupportModifyVFQueueNumberAndVFQuantity The ENI not support modify VirtualFunctionTotalQueueNumber and VirtualFunctionQuantity when EnableSriov is true.
    400 InvalidOperation.TrunkAttachmentMustEmpty The Attachment of the current Trunk type Network Interface must be empty when modify EnableSriov to true.
    400 Throttling Request was denied due to request throttling, try again later.
    400 InvalidOperation.SourceDestCheckUnsupported Modifying sourceDestCheck attribute for network interface is not allowed in the %s region.
    500 InternalError The request processing has failed due to some unknown error, exception or failure.
    403 InvalidUserType.NotSupported %s
    403 Abs.InvalidAccount.NotFound %s
    403 Forbidden.NotSupportRAM %s
    403 Forbidden.SubUser %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 InvalidOperation.EniServiceManaged %s
    403 InvalidOperation.MultiGroupType The specified instance can't join different types of security group.
    403 InvalidOperation.EniCountExceeded The maximum number of eni in a enterprise level security group is exceeded.
    403 InvalidParams.NetworkInterfaceName %s
    403 InvalidOperation.ModifyPrimaryEniQueueNumber Primary NetworkInterface is not allowed to modify queue number.
    403 InvalidOperation.InvalidEniState Available status or ECS instance attached is Stopped is allowed to modify network interface queue number.
    403 InvalidOperation.ResourceManagedByCloudProduct %s
    403 InvalidParameter.InvalidEniQueueNumber %s
    403 InvalidOperation.MaxEniQueueNumberExceeded %s
    403 InvalidOperation.ExceedInstanceTypeQueueNumber %s
    403 AclLimitExceed %s
    403 InvalidOperation.EniTypeUnsupported The specified eni type does not supported.
    404 InvalidEcsId.NotFound %s
    404 InvalidEniId.NotFound %s
    404 InvalidVSwitchId.NotFound %s
    404 InvalidSecurityGroupId.NotFound %s
    404 InvalidOperation.PrimaryEniOnlySupportModifyNameAndDesc Primary NetworkInterface is only allowed to modify name and description.
    404 InvalidParameter.SecurityGroupIdRepeated The specified security group ids has repeated.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.