AssociateEipAddress - - Alibaba Cloud Dokümantasyon Merkezi

Kullanım notları

Bir EIP'yi aynı bölgedeki bir Elastic Compute Service (ECS) örneği, Classic Load Balancer (CLB) örneği, ikincil bir esnek ağ arabirimi (ENI), NAT ağ geçidi veya yüksek kullanılabilirliğe sahip sanal IP adresi (HAVIP) ile ilişkilendirebilirsiniz. ECS örneği ve CLB örneği bir sanal özel cloud (VPC) içinde dağıtılmalıdır.
AssociateEipAddress eşzamansız bir işlemdir. Bir istek gönderdikten sonra sistem bir istek kimliği döndürür ve görevi arka planda çalıştırır. Bir EIP'nin durumunu sorgulamak için DescribeEipAddresses işlemini çağırabilirsiniz.
- EIP Associating durumundaysa ilişkilendirme işlemi devam ediyordur. Bu durumda yalnızca EIP'yi sorgulayabilir, başka işlem yapamazsınız.
- EIP InUse durumundaysa EIP ilişkilendirilmiş demektir.
Belirtilen süre içinde bir EIP'yi bir örnekle ilişkilendirmek için AssociateEipAddress işlemini art arda çağıramazsınız.

Hata ayıklama

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

İstek parametreleri

Parametre	Tür	Gerekli	Örnek	Açıklama
Action	String	Evet	AssociateEipAddress	Gerçekleştirmek istediğiniz işlem. Değeri AssociateEipAddress olarak ayarlayın.
RegionId	String	Evet	cn-hangzhou	EIP'nin ait olduğu bölgenin ID'si. En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.
AllocationId	String	Evet	eip-2zeerraiwb7ujsxdc****	Bir örnekle ilişkilendirmek istediğiniz EIP'nin ID'si.
InstanceId	String	Evet	i-2zebb08phyczzawe****	EIP'yi ilişkilendirmek istediğiniz örneğin ID'si. Bir NAT ağ geçidi, CLB örneği, ECS örneği, ikincil ENI, HAVIP veya IP adresinin ID'sini girebilirsiniz.
InstanceType	String	Hayır	EcsInstance	EIP'yi ilişkilendirmek istediğiniz örneğin türü. Geçerli değerler: Nat: bir NAT ağ geçidi SlbInstance: bir CLB örneği EcsInstance (varsayılan): bir VPC'deki bir ECS örneği NetworkInterface: bir ikincil ENI HaVip: bir HAVIP IpAddress: bir IP adresi Not Bu parametreyi ayarlamazsanız, EIP'yi ilişkilendirmek istediğiniz örneğin türü EcsInstance olur. EIP'yi ilişkilendirmek istediğiniz örneğin türü EcsInstance değilse bu parametre gereklidir.
InstanceRegionId	String	Hayır	cn-hangzhou	EIP'yi ilişkilendirmek istediğiniz örneğin bölge ID'si. Not Bu parametre yalnızca EIP, paylaşımlı bant genişliğine sahip bir Global Accelerator (GA) örneğiyle ilişkilendirildiğinde gereklidir.
PrivateIpAddress	String	Hayır	192.168.XX.XX	vSwitch'in CIDR bloğundaki bir IP adresi. Bu parametreyi ayarlamazsanız sistem, VPC ID'sine ve vSwitch ID'sine göre özel bir IP adresi atar.
Mode	String	Hayır	NAT	İlişkilendirme modu. Geçerli değerler: NAT (varsayılan): NAT modu MULTI_BINDED: çoklu EIP'den ENI'ye modu BINDED: doğrudan geçiş modu Not Bu parametre yalnızca InstanceType değeri NetworkInterface olarak ayarlandığında gereklidir.
VpcId	String	Hayır	vpc-257gqcdfvx6n****	IPv4 ağ geçitleri etkinleştirilmiş ve EIP ile aynı bölgede dağıtılmış olan VPC'nin ID'si. Bir EIP'yi bir IP adresiyle ilişkilendirdiğinizde sistem, VPC rota yapılandırmalarına göre IP adresinin İnternet'e erişmesini sağlayabilir. Not InstanceType değeri IpAddress olarak ayarlandığında bu parametre gereklidir. Bu durumda EIP bir IP adresiyle ilişkilendirilir.
ClientToken	String	Hayır	0c593ea1-3bea-11e9-b96b-88e9fe63****	İsteğin yinelenebilirliğini (idempotence) sağlamak için kullanılan istemci belirteci. Belirteci istemci aracılığıyla oluşturabilirsiniz ancak tüm istekler arasında benzersiz olduğundan emin olmalısınız. Belirteç yalnızca ASCII karakterleri içerebilir. Not Bu parametreyi ayarlamazsanız sistem ClientToken değerini RequestId değerine ayarlar. Her API isteği için RequestId değeri farklı olabilir.

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
RequestId	String	0ED8D006-F706-4D23-88ED-E11ED28DCAC0	İsteğin ID'si.

Örnekler

Örnek istekler

http(s)://[Endpoint]/?Action=AssociateEipAddress
&RegionId=cn-hangzhou
&AllocationId=eip-2zeerraiwb7ujsxdc****
&InstanceId=i-2zebb08phyczzawe****
&InstanceType=EcsInstance
&InstanceRegionId=cn-hangzhou
&PrivateIpAddress=192.168.XX.XX
&Mode=NAT
&VpcId=vpc-257gqcdfvx6n****
&ClientToken=0c593ea1-3bea-11e9-b96b-88e9fe63****
&Common request parameters

Başarılı yanıt örnekleri

XML formatı

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

<AssociateEipAddressResponse>
    <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
</AssociateEipAddressResponse>

JSON formatı

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

{
  "RequestId" : "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

Hata kodları

HttpCode	Hata kodu	Hata mesajı	Açıklama
400	InvalidAssociation.Duplicated	Specified instance already is associated.	Belirtilen örnekle zaten bir EIP veya GA örneği ilişkilendirildiği için dönen hata mesajı. İşlemi gerçekleştirmeden önce EIP'yi veya GA örneğini belirtilen örnekten ayırmanız gerekir.
400	OperationDenied	Specified instance is not in VPC.	Belirtilen örnek VPC'de bulunmadığı için dönen hata mesajı.
400	InvalidParameter.Mismatch	Specified elastic IP address and ECS instance are not in the same region.	Belirtilen EIP ve ECS örneği aynı bölgeye ait olmadığı için dönen hata mesajı.
400	IncorrectEipStatus	Current elastic IP status does not support this operation	EIP'nin durumu bu işlemi desteklemediği için dönen hata mesajı.
400	IncorrectInstanceStatus	Current instance status does not support this operation.	Örnek mevcut durumdayken bu işlem gerçekleştirilemediği için dönen hata mesajı.
400	InvalidInstanceType.ValueNotSupported	The specified value of InstanceType is not supported.	InstanceType geçerli olmayan bir değere ayarlandığı için dönen hata mesajı.
400	InvalidParameter	The specified parameter is not valid.	Parametre geçerli olmayan bir değere ayarlandığı için dönen hata mesajı.
400	OperationDenied	Eip of default vpc not allow this operation	Varsayılan VPC'deki EIP'ler bu işlemi desteklemediği için dönen hata mesajı.
400	TaskConflict	The eip operate too frequent, TaskConflict.	İşlemler çok sık yapıldığından ve görevler birbirleriyle çakıştığından dönen hata mesajı.
400	InvalidBindingStatus	The eip binding status invalid.	EIP geçersiz bir durumda olduğu için dönen hata mesajı.
400	BIND_INSTANCE_HAVE_PORTMAP_OR_BIND_EIP	The instance may have portMap or already bind eip.	ECS örneği için bir bağlantı noktası iletme kuralı yapılandırıldığı için dönen hata mesajı. Bağlantı noktası iletme kuralını silin ve tekrar deneyin.
400	BIND_INSTANCE_OWENER_ERROR	Cannot operate the eip.	Belirtilen EIP'yi yönetme yetkiniz olmadığı için dönen hata mesajı.
400	QuotaExceeded.NumberOfEip	Binded eip Quota exceed on this NatGw.	NAT ağ geçidiyle ilişkilendirilen EIP sayısı üst sınırı aştığı için dönen hata mesajı.
400	InvalidAction.Denied	Action is denied due to unfinished Eip configuration modification.	EIP yapılandırmaları tamamlanmadığından ve işlem reddedildiğinden dönen hata mesajı.
400	InvalidParams.NotFound	instance not found	Belirtilen örnek mevcut olmadığı için dönen hata mesajı.
400	Eni.Attached	The eni should be detached from ecs when associating with direct eip.	ENI, doğrudan geçiş modunda bir EIP ile ilişkilendirildiği için dönen hata mesajı. ENI'yi ECS örneğinden ayırmanız gerekir.
400	InvalidNexthop.DirectEni	The direct Eni cannot be nexthop.	Doğrudan geçiş modundaki bir ENI sonraki atlayış olarak belirtilemediği için dönen hata mesajı.
400	InvalidEIPStatus.BizDisabled	The EIP has been locked.	EIP kilitlendiği için dönen hata mesajı.
400	InvalidStatus.NotAllow	Bind instance status invalid	İlişkilendirilen örneğin durumu geçersiz olduğu için dönen hata mesajı.
400	OperationDenied.CloudBoxResourceExist	The operation is not allowed because there are resources related to the cloud box in VPC.	VPC CloudBox ile ilgili kaynaklar içerdiğinden ve işlem izin verilmediğinden dönen hata mesajı.
400	OperationDenied.CloudBoxVSwitchExist	The operation is not allowed because a cloud box type vSwitch exists in VPC.	VPC CloudBox türünde bir vSwitch içerdiğinden ve işlem izin verilmediğinden dönen hata mesajı.
400	OperationDenied.NoAvailablePrivateIp	The operation is failed because of VSwitch has not availalbe private ip	vSwitch'te yeterli özel IP adresi olmadığı için işlem başarısız olduğundan dönen hata mesajı.
400	OperationFailed.Ipv4GatewayNotOpenedInVpc	The operation is failed because Ipv4Gateway is not opened in Vpc.	VPC'de IPv4 ağ geçitleri etkinleştirilmediğinden ve IP adresi EIP ile ilişkilendirilemediğinden işlem başarısız olduğu için dönen hata mesajı.
400	Forbidden	The eip instance owner error	EIP'ler size ait olmadığı için dönen hata mesajı. EIP'ler üzerinde işlem yapma yetkiniz olup olmadığını kontrol edin.
400	Forbidden.FinancialLocked	The ip business status is invalid.	Ödemeleriniz geciktiği için dönen hata mesajı.
400	UnsupportedFeature.EipBindIpAddress	The feature of EipBindIpAddress is not supported.	EIP IpAddress parametresini desteklemediği için dönen hata mesajı.
400	OperationFailed.InstanceNotExist	The ECS instance does not exist, or is not a VPC VM.	ECS örneği mevcut olmadığından veya bir VPC sanal makinesi olmadığından EIP ECS örneğiyle ilişkilendirilemediği için dönen hata mesajı.
400	OperationDenied.Ipv4GatewayExist	The operation is not allowed because of Ipv4GatewayExist.	VPC'de IPv4 ağ geçitleri bulunduğundan ve EIP ilişkilendirilemediğinden işlem izin verilmediği için dönen hata mesajı.
400	OperationFailed.EipBindModeConflict	Eips can not bind Eni with NAT mode and MULTI_BINDED mode at the same time.	Bir EIP'yi aynı anda hem NAT modunda hem de çoklu EIP'den ENI'ye modunda bir ENI ile ilişkilendiremeyeceğiniz için dönen hata mesajı.
400	OperationFailed.EcsMigrating	The operation is failed because of ECS is migrating.	ECS örneği geçiş aşamasında olduğu için işlem başarısız olduğundan dönen hata mesajı.
404	InvalidInstanId.NotFound	Specified instance does not exist.	Belirtilen örnek mevcut olmadığı için dönen hata mesajı. Örnek ID'sinin geçerli olup olmadığını kontrol edin.
404	InvalidAllocationId.NotFound	Specified allocation ID is not found	Belirtilen EIP mevcut olmadığı için dönen hata mesajı. Belirtilen değerin geçerli olup olmadığını kontrol edin.
404	Forbidden.RegionNotFound	Specified instance is not found during access authentication.	Bölge desteklenmediği için dönen hata mesajı.
404	OperationDenied.VpcIpv4GatewayEnabled	The operation is not allowed because of the VPC of the NAT gateway has opened IPv4 Gateway.	NAT ağ geçidinin bulunduğu VPC'de IPv4 ağ geçitleri etkinleştirildiğinden ve işlem reddedildiğinden dönen hata mesajı.
503	ServiceUnavailable	The request has failed due to a temporary failure of the server.	Geçici bir sunucu hatası nedeniyle istek başarısız olduğu için dönen hata mesajı.

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