Tüm Ürünler
Search
Belge Merkezi

:ModifyNetworkInterfaceAttribute

Son Güncelleme:Sep 29, 2026

Elastik ağ arayüzünün (ENI) adı, açıklaması ve güvenlik grupları gibi niteliklerini değiştirir.

Hata Ayıklama

OpenAPI Explorer imza değerini otomatik olarak hesaplar. Kolaylık sağlaması için bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için örnek kodları dinamik olarak oluşturur.

İstek parametreleri

Parameter

Type

Required

Example

Description

Action String Yes ModifyNetworkInterfaceAttribute

Gerçekleştirmek istediğiniz işlem. Değeri ModifyNetworkInterfaceAttribute olarak ayarlayın.

RegionId String Yes cn-hangzhou

ENI'nin bölge kimliği. En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.

NetworkInterfaceName String No eniTestName

ENI'nin adı. Ad 2 ila 128 karakter uzunluğunda olmalıdır. Ad bir harfle başlamalı ve http:// veya https:// ile başlayamaz. Rakamlar, harfler, iki nokta üst üste (:), alt çizgi (_) ve tire (-) içerebilir.

Bu parametre varsayılan olarak boştur.

NetworkInterfaceId String Yes eni-bp67acfmxazb4p****

ENI'nin kimliği.

QueueNumber Integer No 8

ENI tarafından desteklenen kuyruk sayısı. Geçerli değerler: 1 ila 2048.

  • Yalnızca ikincil ENI'lerin desteklediği kuyruk sayısını değiştirebilirsiniz.
  • İkincil bir ENI'nin desteklediği kuyruk sayısını yalnızca ENI Available durumundayken veya ENI Stopped durumundaki bir örneğe ekliyken (InUse) değiştirebilirsiniz.
  • İkincil ENI'nin desteklediği kuyruk sayısı, örnek türünün her bir ENI için izin verdiği maksimum kuyruk sayısını aşamaz. Örnek üzerindeki tüm ENI'lerdeki toplam kuyruk sayısı, örnek türünün desteklediği kuyruk kotasını aşamaz. Bir örnek türü için ENI başına maksimum kuyruk sayısını ve kuyruk kotasını sorgulamak üzere DescribeInstanceTypes işlemini çağırabilir ve yanıtta MaximumQueueNumberPerEni ile TotalEniQueueQuantity değerlerini kontrol edebilirsiniz.
Description String No testDescription

ENI'nin açıklaması. Açıklama 2 ila 255 karakter uzunluğunda olmalı ve http:// veya https:// ile başlayamaz.

Bu parametre varsayılan olarak boştur.

SecurityGroupId.N String No sg-bp67acfmxazb4p****

ENI'nin ekleneceği N. güvenlik grubunun kimliği.

  • N için geçerli değerler, bir ENI'ye eklenebilecek maksimum güvenlik grubu sayısına göre belirlenir. Daha fazla bilgi için bkz. Sınırlamalar.
  • Yalnızca ikincil bir ENI'nin eklendiği güvenlik gruplarını değiştirebilirsiniz.
  • Bu parametreyi belirttiğinizde ikincil ENI belirtilen güvenlik gruplarına eklenir ve orijinal güvenlik gruplarından kaldırılır.
  • Yeni güvenlik grupları kısa bir gecikmeden sonra etkin hale gelir.
DeleteOnRelease Boolean No true

İlişkili örnek serbest bırakıldığında ENI'nin saklanıp saklanmayacağını belirtir. Geçerli değerler:

  • true
  • false

Yanıt parametreleri

Parameter

Type

Example

Description

RequestId

String

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

İsteğin kimliği.

Örnekler

Örnek istekler

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

Örnek başarılı yanıtlar

XML biçimi

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

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

JSON biçimi

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

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

Hata kodları

HTTP status code

Error code

Error message

Description

400

MissingParameter

%s

Gerekli bir parametre belirtilmedi.

400

UnsupportedParameter

%s

Belirtilen bir parametre desteklenmiyor.

400

InvalidParameter

%s

Geçersiz parametre değeri.

400

InvalidInstanceID.Malformed

%s

Geçersiz InstanceId biçimi.

400

InvalidOperation.InvalidEcsState

%s

Bu işlem, mevcut durumdaki örnek üzerinde gerçekleştirilemez.

400

InvalidOperation.InvalidEniState

%s

Bu işlem, mevcut durumdaki ENI üzerinde gerçekleştirilemez.

400

InvalidOperation.DetachPrimaryEniNotAllowed

%s

ENI, örnekten ayrılamaz.

400

InvalidParams.EniId

%s

Geçersiz ENI kimliği.

400

Forbidden.RegionId

%s

Hizmet şu anda bölgede kullanılamıyor.

400

JoinedGroupLimitExceed

%s

Belirtilen kaynağın eklenebileceği maksimum güvenlik grubu sayısı aşıldı. Daha fazla bilgi için hata mesajındaki %s yer tutucusunun dönüş değerine bakın.

403

InvalidUserType.NotSupported

%s

Hesap bu işlemi desteklemiyor.

403

Abs.InvalidAccount.NotFound

%s

Alibaba Cloud hesabınız bulunamadı veya AccessKey çiftinizin süresi doldu.

403

Forbidden.NotSupportRAM

%s

Resource Access Management (RAM) kullanıcılarının bu işlemi gerçekleştirmek için izni yok.

403

Forbidden.SubUser

%s

Kaynağa erişiminiz yok. Alibaba Cloud hesabının sahibiyle iletişime geçin.

403

MaxEniCountExceeded

%s

Yönetilebilecek maksimum ENI sayısı aşıldı.

403

EniPerInstanceLimitExceeded

%s

Örneğe eklenebilecek maksimum ENI sayısı aşıldı.

403

InvalidOperation.AvailabilityZoneMismatch

%s

İşlem geçersiz.

403

InvalidOperation.VpcMismatch

%s

İşlem geçersiz. İşlemdeki sanal özel cloud (VPC) öğesinin diğer parametrelerle eşleşip eşleşmediğini kontrol edin.

403

SecurityGroupInstanceLimitExceed

%s

Güvenlik grubundaki maksimum örnek sayısına ulaşıldı.

403

InvalidSecurityGroupId.NotVpc

%s

Geçersiz güvenlik grubu kimliği. Belirtilen güvenlik grubunun ağ türü VPC değil.

403

InvalidOperation.InvalidEniType

%s

Bu işlem bu ENI türü üzerinde gerçekleştirilemez.

403

InvalidOperation.EniServiceManaged

%s

İşlem geçersiz.

403

InvalidOperation.ResourceManagedByCloudProduct

%s

Bulut hizmetleri tarafından yönetilen güvenlik grupları değiştirilemez.

403

InvalidParameter.InvalidEniQueueNumber

%s

Geçersiz QueueNumber değeri. Daha fazla bilgi için hata mesajındaki %s yer tutucusunun dönüş değerine bakın.

403

InvalidOperation.MaxEniQueueNumberExceeded

%s

ENI'deki maksimum kuyruk sayısı aşıldı. Daha fazla bilgi için hata mesajındaki %s yer tutucusunun dönüş değerine bakın.

403

InvalidOperation.ExceedInstanceTypeQueueNumber

%s

Bir örnekteki tüm ENI'lerdeki maksimum kuyruk sayısı aşıldı. Daha fazla bilgi için hata mesajındaki %s yer tutucusunun dönüş değerine bakın.

403

AclLimitExceed

%s

ENI'ye veya örneğe uygulanabilecek maksimum güvenlik grubu kuralı sayısı aşıldı.

404

InvalidEcsId.NotFound

%s

Örnek kimliği bulunamadı.

404

InvalidEniId.NotFound

%s

ENI kimliği bulunamadı.

404

InvalidVSwitchId.NotFound

%s

vSwitch kimliği bulunamadı.

404

InvalidSecurityGroupId.NotFound

%s

Güvenlik grubu kimliği bulunamadı.

404

InvalidOperation.PrimaryEniOnlySupportModifyNameAndDesc

Primary NetworkInterface is only allowed to modify name and description.

Birincil ENI'lerin yalnızca adları ve açıklamaları değiştirilebilir.

Hata kodlarının listesi için bkz. Hizmet hata kodları.