AttachNetworkInterface - - Alibaba Cloud Dokümantasyon Merkezi

Açıklama

Bu işlemi çağırırken aşağıdaki hususlara dikkat edin:

ENI, Available (Available) durumunda olmalıdır. Her ENI, yalnızca kendisiyle aynı alan ve VPC içinde bulunan tek bir örneğe bağlanabilir.
Örnek, Çalışıyor (Running) veya Durduruldu (Stopped) durumunda olmalıdır. Bazı örnek türlerine sahip örneklere ENI bağlarken, örneklerin Durduruldu (Stopped) durumunda olduğundan emin olun. Daha fazla bilgi için bkz.

ENI Bağlama

belgesindeki "Durduruldu (Stopped) durumunda olması gereken ECS örneklerinin örnek türleri" bölümü.

Not
Örneğin son başlatma zamanı (yeni satın alındığı durumdaki ilk başlatma, son yeniden başlatma veya son yeniden etkinleştirme zamanı dahil) 1 Nisan 2018 tarihinden önceyse ve örnek Çalışıyor durumundaysa, RebootInstance işlemini çağırarak örneği yeniden başlatmanız gerekir. Aksi takdirde ENI, örneğe bağlanamaz.
Tek bir örneğe birden fazla ENI bağlayabilirsiniz. Daha fazla bilgi için bkz. ENI'ye genel bakış.
ENI'nin bağlı olduğu vSwitch, örneğin bağlı olduğu vSwitch ile aynı alan ve VPC içinde bulunmalıdır.
Bu işlem eşzamansızdır. Bir ENI'yi bağlamak için bu işlemi çağırdıktan sonra, ENI'nin bağlanıp bağlanmadığını belirlemek amacıyla durumunu veya olaylarını kontrol edebilirsiniz. Aşağıdaki şekil, ENI durumları arasındaki geçişleri göstermektedir.
- ENI Attaching durumuna geçerse, işlem başarıyla çağrılmış demektir ve ENI bir örneğe bağlanmaktadır.
- ENI InUse durumuna geçerse, ENI bir örneğe bağlanmış demektir.
- ENI Available durumuna geçerse, ENI bir örneğe bağlanamamış demektir.

Bu işlemin nasıl çağrılacağına ilişkin örnekler için bkz. ECS örneğine ENI bağlama.

Hata Ayıklama

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

İstek parametreleri

Parametre	Tür	Zorunlu	Örnek	Açıklama
Action	String	Evet	AttachNetworkInterface	Gerçekleştirmek istediğiniz işlem. Değeri AttachNetworkInterface olarak ayarlayın.
RegionId	String	Evet	cn-hangzhou	Örneğin bölge kimliği. En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.
NetworkInterfaceId	String	Evet	eni-bp17pdijfczax1huji****	ENI'nin kimliği.
InstanceId	String	Evet	i-bp16qstyvxj9gpqw****	Örneğin kimliği.
TrunkNetworkInstanceId	String	Hayır	eni-f8zapqwj1v1j4ia3****	Gövde ENI'nin kimliği. Not Bu parametre kullanılamaz.
WaitForNetworkConfigurationReady	Boolean	Hayır	null	Not Bu parametre artık kullanılmamaktadır.
NetworkCardIndex	Integer	Hayır	0	Ağ arayüz denetleyicisinin (NIC) dizini. Not NetworkCardIndex değeri örnek türüne göre değişir. Örnek türü NIC'leri desteklemiyorsa bu parametreyi belirtemezsiniz. Örnek türü NIC'leri destekliyorsa bu parametreyi belirtebilirsiniz. NetworkCardIndex değerleri hakkında bilgi için bkz. Örnek aileleri.

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	İsteğin kimliği.

Örnekler

Örnek istekler

http(s)://ecs.aliyuncs.com/?Action=AttachNetworkInterface
&RegionId=cn-hangzhou
&NetworkInterfaceId=eni-bp17pdijfczax1huji****
&InstanceId=i-bp16qstyvxj9gpqw****
&WaitForNetworkConfigurationReady=false
&Common request parameters

Başarılı yanıt örnekleri

XML formatı

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

<AttachNetworkInterfaceResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</AttachNetworkInterfaceResponse>

JSON formatı

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

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

Hata kodları

HTTP durum kodu	Hata kodu	Hata iletisi	Açıklama
400	MissingParameter	%s	Zorunlu bir parametre belirtilmediği için dönen hata iletisi.
400	UnsupportedParameter	%s	Belirtilen parametre desteklenmediği için dönen hata iletisi.
400	InvalidParameter	%s	Belirtilen parametre geçersiz olduğu için dönen hata iletisi.
400	InvalidInstanceID.Malformed	%s	Belirtilen InstanceId parametresi geçersiz olduğu için dönen hata iletisi.
400	InvalidOperation.InvalidRegion	%s	Belirtilen RegionId parametresi geçersiz olduğu için dönen hata iletisi.
400	InvalidOperation.InvalidEcsState	%s	Örnek mevcut durumdayken işlem desteklenmediği için dönen hata iletisi.
400	InvalidOperation.InvalidEniState	%s	ENI mevcut durumdayken işlem desteklenmediği için dönen hata iletisi.
400	InvalidOperation.DetachPrimaryEniNotAllowed	%s	Birincil ENI örnekten ayrılamadığı için dönen hata iletisi.
400	Forbidden.RegionId	%s	Hizmet şu anda geçerli bölgede kullanılamadığı için dönen hata iletisi.
400	InvalidOperation.InvalidGeneration	%s	İşlem geçersiz olduğu için dönen hata iletisi.
400	InvalidParams.EniId	%s	Belirtilen NetworkInterfaceId parametresi geçersiz olduğu için dönen hata iletisi.
403	InvalidUserType.NotSupported	%s	Hesabınız bu işlemi desteklemediği için dönen hata iletisi.
403	Abs.InvalidAccount.NotFound	%s	Alibaba Cloud hesabınız mevcut olmadığı veya AccessKey çiftinizin süresi dolduğu için dönen hata iletisi.
403	Forbidden.NotSupportRAM	%s	Resource Access Management (RAM) kullanıcıları bu işlemi gerçekleştirmek için yetkilendirilmediği için dönen hata iletisi.
403	Forbidden.SubUser	%s	Bu kaynağı yönetmek için yetkilendirilmediğiniz için dönen hata iletisi. Yetkilendirme için Alibaba Cloud hesabının sahibiyle iletişime geçin.
403	MaxEniCountExceeded	%s	Yönetilebilecek maksimum ENI sayısına ulaşıldığı için dönen hata iletisi.
403	EniPerInstanceLimitExceeded	%s	Belirtilen örneğe bağlanabilecek maksimum ENI sayısına ulaşıldığı için dönen hata iletisi.
403	InvalidOperation.AvailabilityZoneMismatch	%s	İşlem geçersiz olduğu için dönen hata iletisi.
403	InvalidOperation.VpcMismatch	%s	İşlem geçersiz olduğu için dönen hata iletisi. İşlemdeki VPC'nin 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ığı için dönen hata iletisi.
403	InvalidSecurityGroupId.NotVpc	%s	Belirtilen güvenlik grubu kimliği geçersiz olduğu ve güvenlik grubunun ağ türü VPC olmadığı için dönen hata iletisi.
403	InvalidOperation.InvalidEniType	%s	ENI mevcut türdeyken işlem desteklenmediği için dönen hata iletisi.
403	InvalidInstanceId.NotFound	%s	Belirtilen InstanceId parametresi mevcut olmadığı için dönen hata iletisi.
403	InvalidEni.NotSameVpc	%s	Belirtilen kaynak ve belirtilen ENI aynı VPC'ye ait olmadığı için dönen hata iletisi. Daha fazla bilgi için hata iletisindeki %s yer tutucusunun dönüş değerine bakın.
403	InvalidOperation.Ipv4CountExceeded	%s	Maksimum IPv4 adresi sayısına ulaşıldığı için dönen hata iletisi.
403	InvalidOperation.EniServiceManaged	%s	İşlem geçersiz olduğu için dönen hata iletisi.
403	InvalidOperation.Ipv6NotSupport	%s	IPv6 adresleri bu işlemi desteklemediği için dönen hata iletisi.
403	InvalidOperation.HotPlugNotSupport	%s	Belirtilen kaynak çalışırken işlem desteklenmediği için dönen hata iletisi. Daha fazla bilgi için hata iletisindeki %s yer tutucusunun dönüş değerine bakın.
403	InvalidOperation.InvalidTrunkEniStatus	%s	Gövde modundaki belirtilen ENI mevcut durumdayken işlem desteklenmediği için dönen hata iletisi. Daha fazla bilgi için hata iletisindeki %s yer tutucusunun dönüş değerine bakın.
403	InvalidOperation.InstanceTypeNotSupportEniTrunking	%s	İşlem desteklenmediği için dönen hata iletisi. Daha fazla bilgi için hata iletisindeki %s yer tutucusunun dönüş değerine bakın.
403	InvalidOperation.EniTypeNotSupportTrunking	%s	ENI mevcut türdeyken gövde moduyla ilgili işlemler desteklenmediği için dönen hata iletisi. Daha fazla bilgi için hata iletisindeki %s yer tutucusunun dönüş değerine bakın.
403	InvalidParameter.EniNotBelongTrunk	%s	Belirtilen ENI gövde modunda olmadığı için dönen hata iletisi. Daha fazla bilgi için hata iletisindeki %s yer tutucusunun dönüş değerine bakın.
403	InvalidParameter.EniNotBelongEcs	%s	Belirtilen ENI belirtilen ECS örneğine bağlı olmadığı için dönen hata iletisi. Daha fazla bilgi için hata iletisindeki %s yer tutucusunun dönüş değerine bakın. Belirtilen ECS örneğine bağlı ENI'lerin kimliklerini sorgulamak için DescribeInstances işlemini çağırabilirsiniz.
403	InvalidParameter.InvalidEniQueueNumber	%s	ENI başına belirtilen kuyruk sayısı geçersiz olduğu için dönen hata iletisi. Daha fazla bilgi için hata iletisindeki %s yer tutucusunun dönüş değerine bakın.
403	InvalidOperation.MaxEniQueueNumberExceeded	%s	ENI başına maksimum kuyruk sayısına ulaşıldığı için dönen hata iletisi. Daha fazla bilgi için hata iletisindeki %s yer tutucusunun dönüş değerine bakın.
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s	Bir örnekteki tüm ENI'ler için maksimum kuyruk sayısına ulaşıldığı için dönen hata iletisi. Daha fazla bilgi için hata iletisindeki %s yer tutucusunun dönüş değerine bakın.
404	InvalidEcsId.NotFound	%s	Belirtilen InstanceId parametresi mevcut olmadığı için dönen hata iletisi.
404	InvalidEniId.NotFound	%s	Belirtilen NetworkInterfaceId parametresi mevcut olmadığı için dönen hata iletisi.
404	InvalidVSwitchId.NotFound	%s	Belirtilen vSwitch mevcut olmadığı için dönen hata iletisi.
404	InvalidSecurityGroupId.NotFound	%s	Belirtilen güvenlik grubu kimliği mevcut olmadığı için dönen hata iletisi.

Hata kodlarının listesi için API Hata Merkezi adresini ziyaret edin.