ModifyNetworkInterfaceAttribute - - Alibaba Cloud Documentation Center

Memodifikasi atribut antarmuka jaringan elastis (elastic network interface/ENI), seperti nama, deskripsi, dan security group yang terkait.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi ini untuk berbagai SDK.

Parameter permintaan

Parameter	Type	Required	Example	Description
Action	String	Yes	ModifyNetworkInterfaceAttribute	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ModifyNetworkInterfaceAttribute.
RegionId	String	Yes	cn-hangzhou	ID wilayah dari ENI. Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar wilayah terbaru.
NetworkInterfaceName	String	No	eniTestName	Nama ENI. Panjang nama harus antara 2 hingga 128 karakter. Nama harus dimulai dengan huruf dan tidak boleh dimulai dengan http:// atau https://. Nama dapat berisi angka, huruf, titik dua (:), garis bawah (_), dan tanda hubung (-). Parameter ini kosong secara default.
NetworkInterfaceId	String	Yes	eni-bp67acfmxazb4p****	ID ENI.
QueueNumber	Integer	No	8	Jumlah antrian yang didukung oleh ENI. Nilai yang valid: 1 hingga 2048. Anda hanya dapat mengubah jumlah antrian yang didukung oleh secondary ENI. Anda hanya dapat mengubah jumlah antrian yang didukung oleh secondary ENI ketika ENI berada dalam status `Available` atau ENI telah disambungkan (`InUse`) ke instans yang berstatus `Stopped`. Jumlah antrian yang didukung oleh secondary ENI tidak boleh melebihi jumlah maksimum antrian yang diizinkan oleh tipe instans untuk setiap ENI. Total jumlah antrian pada semua ENI di instans tidak boleh melebihi kuota antrian yang didukung oleh tipe instans tersebut. Untuk mengetahui jumlah maksimum antrian per ENI dan kuota antrian untuk suatu tipe instans, Anda dapat memanggil operasi DescribeInstanceTypes dan memeriksa nilai `MaximumQueueNumberPerEni` dan `TotalEniQueueQuantity` dalam respons.
Description	String	No	testDescription	Deskripsi ENI. Panjang deskripsi harus antara 2 hingga 255 karakter dan tidak boleh dimulai dengan http:// atau https://. Parameter ini kosong secara default.
SecurityGroupId.N	String	No	sg-bp67acfmxazb4p****	ID security group N tempat ENI akan ditambahkan. Nilai valid untuk N ditentukan berdasarkan jumlah maksimum security group yang dapat ditambahkan ke sebuah ENI. Untuk informasi selengkapnya, lihat Limits. Anda hanya dapat mengubah security group yang ditambahkan ke secondary ENI. Setelah Anda menentukan parameter ini, secondary ENI akan ditambahkan ke security group yang ditentukan dan dihapus dari security group asalnya. Security group baru akan berlaku setelah jeda singkat.
DeleteOnRelease	Boolean	No	true	Menentukan apakah ENI akan dipertahankan saat instans terkait dirilis. Nilai yang valid: true false

Parameter respons

Parameter	Type	Example	Description
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****	ID permintaan.

Contoh

Contoh permintaan

http(s)://ecs.aliyuncs.com/?Action=ModifyNetworkInterfaceAttribute
&RegionId=cn-hangzhou
&NetworkInterfaceName=eniTestName
&NetworkInterfaceId=eni-bp67acfmxazb4p****
&Description=testDescription
&SecurityGroupId=["sg-bp67acfmxazb4p****"]
&<Common request parameters>

Contoh respons sukses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyNetworkInterfaceAttributeResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</ModifyNetworkInterfaceAttributeResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

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

Kode kesalahan

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	MissingParameter	%s	Parameter yang diperlukan tidak ditentukan.
400	UnsupportedParameter	%s	Parameter yang ditentukan tidak didukung.
400	InvalidParameter	%s	Nilai parameter tidak valid.
400	InvalidInstanceID.Malformed	%s	Format InstanceId tidak valid.
400	InvalidOperation.InvalidEcsState	%s	Operasi ini tidak dapat dilakukan pada instans dalam status saat ini.
400	InvalidOperation.InvalidEniState	%s	Operasi ini tidak dapat dilakukan pada ENI dalam status saat ini.
400	InvalidOperation.DetachPrimaryEniNotAllowed	%s	ENI tidak dapat dilepas dari instans.
400	InvalidParams.EniId	%s	ID ENI tidak valid.
400	Forbidden.RegionId	%s	Layanan tidak tersedia di wilayah ini untuk sementara.
400	JoinedGroupLimitExceed	%s	Jumlah maksimum security group tempat resource yang ditentukan dapat ditambahkan telah terlampaui. Untuk informasi selengkapnya, lihat nilai kembali dari placeholder %s dalam pesan kesalahan.
403	InvalidUserType.NotSupported	%s	Akun tidak mendukung operasi ini.
403	Abs.InvalidAccount.NotFound	%s	Akun Alibaba Cloud Anda tidak ditemukan, atau Pasangan Kunci Akses (AccessKey pair) Anda telah kedaluwarsa.
403	Forbidden.NotSupportRAM	%s	Pengguna Manajemen Akses Sumber Daya (RAM) tidak memiliki izin untuk melakukan operasi ini.
403	Forbidden.SubUser	%s	Anda tidak memiliki akses ke resource tersebut. Hubungi pemilik Akun Alibaba Cloud.
403	MaxEniCountExceeded	%s	Jumlah maksimum ENI yang dapat dikelola telah terlampaui.
403	EniPerInstanceLimitExceeded	%s	Jumlah maksimum ENI yang dapat disambungkan ke instans telah terlampaui.
403	InvalidOperation.AvailabilityZoneMismatch	%s	Operasi tidak valid.
403	InvalidOperation.VpcMismatch	%s	Operasi tidak valid. Periksa apakah virtual private cloud (VPC) dalam operasi sesuai dengan parameter lainnya.
403	SecurityGroupInstanceLimitExceed	%s	Jumlah maksimum instans dalam security group telah tercapai.
403	InvalidSecurityGroupId.NotVpc	%s	ID security group tidak valid. Jenis jaringan dari security group yang ditentukan bukan VPC.
403	InvalidOperation.InvalidEniType	%s	Operasi ini tidak dapat dilakukan pada jenis ENI ini.
403	InvalidOperation.EniServiceManaged	%s	Operasi tidak valid.
403	InvalidOperation.ResourceManagedByCloudProduct	%s	Security group yang dikelola oleh layanan cloud tidak dapat dimodifikasi.
403	InvalidParameter.InvalidEniQueueNumber	%s	Nilai QueueNumber tidak valid. Untuk informasi selengkapnya, lihat nilai kembali dari placeholder %s dalam pesan kesalahan.
403	InvalidOperation.MaxEniQueueNumberExceeded	%s	Jumlah maksimum antrian pada ENI telah terlampaui. Untuk informasi selengkapnya, lihat nilai kembali dari placeholder %s dalam pesan kesalahan.
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s	Jumlah maksimum antrian pada semua ENI di sebuah instans telah terlampaui. Untuk informasi selengkapnya, lihat nilai kembali dari placeholder %s dalam pesan kesalahan
403	AclLimitExceed	%s	Jumlah maksimum aturan security group yang dapat diterapkan ke ENI atau instans telah terlampaui.
404	InvalidEcsId.NotFound	%s	ID instans tidak ditemukan.
404	InvalidEniId.NotFound	%s	ID ENI tidak ditemukan.
404	InvalidVSwitchId.NotFound	%s	ID vSwitch tidak ditemukan.
404	InvalidSecurityGroupId.NotFound	%s	ID security group tidak ditemukan.
404	InvalidOperation.PrimaryEniOnlySupportModifyNameAndDesc	Primary NetworkInterface is only allowed to modify name and description.	ENI primer hanya dapat memodifikasi nama dan deskripsinya.

Untuk daftar kode kesalahan, lihat Kode kesalahan layanan.