AssociateEipAddress - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Vous pouvez associer une EIP à une instance Elastic Compute Service (ECS), une instance Classic Load Balancer (CLB), une interface réseau élastique secondaire (ENI), une passerelle NAT ou une adresse IP virtuelle haute disponibilité (HAVIP) dans la même région. L'instance ECS et l'instance CLB doivent être déployées dans un cloud privé virtuel (VPC).
L'opération AssociateEipAddress est asynchrone. Le système renvoie un ID de requête après l'envoi de votre demande et exécute la tâche en arrière-plan. Appelez l'opération DescribeEipAddresses pour interroger le statut d'une EIP.
- Si l'EIP est dans l'état Associating, l'association est en cours. Dans cet état, vous pouvez uniquement interroger l'EIP ; aucune autre opération n'est possible.
- Si l'EIP est dans l'état InUse, elle est associée.
Les appels répétés à AssociateEipAddress pour associer une EIP à une instance sont limités dans le temps.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	AssociateEipAddress	Opération à effectuer. Définissez la valeur sur AssociateEipAddress.
RegionId	String	Yes	cn-hangzhou	ID de la région à laquelle appartient l'EIP. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.
AllocationId	String	Yes	eip-2zeerraiwb7ujsxdc****	ID de l'EIP à associer à une instance.
InstanceId	String	Yes	i-2zebb08phyczzawe****	ID de l'instance à laquelle associer l'EIP. Saisissez l'ID d'une passerelle NAT, d'une instance CLB, d'une instance ECS, d'une ENI secondaire, d'une HAVIP ou d'une adresse IP.
InstanceType	String	No	EcsInstance	Type d'instance à laquelle associer l'EIP. Valeurs valides : Nat : passerelle NAT SlbInstance : instance CLB EcsInstance (par défaut) : instance ECS dans un VPC NetworkInterface : ENI secondaire HaVip : HAVIP IpAddress : adresse IP Remarque Si vous ne définissez pas ce paramètre, le type d'instance est par défaut EcsInstance. Si le type d'instance n'est pas EcsInstance, ce paramètre est obligatoire.
InstanceRegionId	String	No	cn-hangzhou	ID de la région de l'instance à laquelle associer l'EIP. Remarque Ce paramètre est obligatoire uniquement lorsque l'EIP est associée à une instance Global Accelerator (GA) à bande passante partagée.
PrivateIpAddress	String	No	192 168.XX.XX	Adresse IP du bloc CIDR du vSwitch. Si vous ne définissez pas ce paramètre, le système alloue une adresse IP privée selon l'ID du VPC et l'ID du vSwitch.
Mode	String	No	NAT	Mode d'association. Valeurs valides : NAT (par défaut) : mode NAT MULTI_BINDED : mode multi-EIP vers ENI BINDED : mode cut-through Remarque Ce paramètre est obligatoire uniquement si InstanceType est défini sur NetworkInterface.
VpcId	String	No	vpc-257gqcdfvx6n****	ID du VPC disposant de passerelles IPv4 activées et déployé dans la même région que l'EIP. Lorsque vous associez une EIP à une adresse IP, le système permet à cette adresse d'accéder à Internet via les configurations de routage du VPC. Remarque Ce paramètre est obligatoire si InstanceType est défini sur IpAddress. Dans ce cas, l'EIP est associée à une adresse IP.
ClientToken	String	No	0c593ea1-3bea-11e9-b96b-88e9fe63****	Jeton client garantissant l'idempotence de la requête. Générez le jeton via le client en veillant à son unicité parmi toutes les requêtes. Le jeton ne doit contenir que des caractères ASCII. Remarque Si vous ne définissez pas ce paramètre, le système attribue à ClientToken la valeur de RequestId. La valeur de RequestId varie pour chaque requête API.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	0ED8D006-F706-4D23-88ED-E11ED28DCAC0	ID de la requête.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

Format XML

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

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

Format JSON

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

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

Codes d'erreur

HttpCode	Error code	Error message	Description
400	InvalidAssociation.Duplicated	Specified instance already is associated.	Une EIP ou une instance GA est déjà associée à l'instance spécifiée. Dissociez l'EIP ou l'instance GA avant de réessayer.
400	OperationDenied	Specified instance is not in VPC.	L'instance spécifiée n'existe pas dans le VPC.
400	InvalidParameter.Mismatch	Specified elastic IP address and ECS instance are not in the same region.	L'EIP spécifiée et l'instance ECS n'appartiennent pas à la même région.
400	IncorrectEipStatus	Current elastic IP status does not support this operation	Le statut de l'EIP ne permet pas cette opération.
400	IncorrectInstanceStatus	Current instance status does not support this operation.	L'état actuel de l'instance ne permet pas cette opération.
400	InvalidInstanceType.ValueNotSupported	The specified value of InstanceType is not supported.	La valeur définie pour InstanceType n'est pas valide.
400	InvalidParameter	The specified parameter is not valid.	La valeur du paramètre n'est pas valide.
400	OperationDenied	Eip of default vpc not allow this operation	Les EIP du VPC par défaut ne prennent pas en charge cette opération.
400	TaskConflict	The eip operate too frequent, TaskConflict.	Opérations trop fréquentes entraînant un conflit de tâches.
400	InvalidBindingStatus	The eip binding status invalid.	L'EIP se trouve dans un état non valide.
400	BIND_INSTANCE_HAVE_PORTMAP_OR_BIND_EIP	The instance may have portMap or already bind eip.	Une règle de transfert de port est configurée pour l'instance ECS. Supprimez la règle et réessayez.
400	BIND_INSTANCE_OWENER_ERROR	Cannot operate the eip.	Vous n'êtes pas autorisé à gérer l'EIP spécifiée.
400	QuotaExceeded.NumberOfEip	Binded eip Quota exceed on this NatGw.	Le nombre d'EIP associées à la passerelle NAT dépasse la limite.
400	InvalidAction.Denied	Action is denied due to unfinished Eip configuration modification.	La configuration de l'EIP est incomplète ; l'opération est refusée.
400	InvalidParams.NotFound	instance not found	L'instance spécifiée n'existe pas.
400	Eni.Attached	The eni should be detached from ecs when associating with direct eip.	L'ENI est associée à une EIP en mode cut-through. Dissociez l'ENI de l'instance ECS.
400	InvalidNexthop.DirectEni	The direct Eni cannot be nexthop.	Une ENI en mode cut-through ne peut pas servir de saut suivant.
400	InvalidEIPStatus.BizDisabled	The EIP has been locked.	L'EIP est verrouillée.
400	InvalidStatus.NotAllow	Bind instance status invalid	Le statut de l'instance associée n'est pas valide.
400	OperationDenied.CloudBoxResourceExist	The operation is not allowed because there are resources related to the cloud box in VPC.	Le VPC contient des ressources liées à CloudBox ; l'opération n'est pas autorisée.
400	OperationDenied.CloudBoxVSwitchExist	The operation is not allowed because a cloud box type vSwitch exists in VPC.	Le VPC contient un vSwitch de type CloudBox ; l'opération n'est pas autorisée.
400	OperationDenied.NoAvailablePrivateIp	The operation is failed because of VSwitch has not availalbe private ip	Le vSwitch ne dispose pas d'adresses IP privées suffisantes.
400	OperationFailed.Ipv4GatewayNotOpenedInVpc	The operation is failed because Ipv4Gateway is not opened in Vpc.	Les passerelles IPv4 ne sont pas activées dans le VPC ; l'association de l'adresse IP à l'EIP a échoué.
400	Forbidden	The eip instance owner error	Les EIP ne vous appartiennent pas. Vérifiez vos autorisations.
400	Forbidden.FinancialLocked	The ip business status is invalid.	L'instance présente des impayés.
400	UnsupportedFeature.EipBindIpAddress	The feature of EipBindIpAddress is not supported.	L'EIP ne prend pas en charge le paramètre IpAddress.
400	OperationFailed.InstanceNotExist	The ECS instance does not exist, or is not a VPC VM.	L'instance ECS n'existe pas ou n'est pas une machine virtuelle VPC ; l'association a échoué.
400	OperationDenied.Ipv4GatewayExist	The operation is not allowed because of Ipv4GatewayExist.	Des passerelles IPv4 existent dans le VPC ; l'association de l'EIP a échoué.
400	OperationFailed.EipBindModeConflict	Eips can not bind Eni with NAT mode and MULTI_BINDED mode at the same time.	Vous ne pouvez pas associer simultanément une EIP à une ENI en mode NAT et en mode multi-EIP vers ENI.
400	OperationFailed.EcsMigrating	The operation is failed because of ECS is migrating.	L'instance ECS est en cours de migration.
404	InvalidInstanId.NotFound	Specified instance does not exist.	L'instance spécifiée n'existe pas. Vérifiez la validité de l'ID.
404	InvalidAllocationId.NotFound	Specified allocation ID is not found	L'EIP spécifiée n'existe pas. Vérifiez la validité de la valeur.
404	Forbidden.RegionNotFound	Specified instance is not found during access authentication.	La région n'est pas prise en charge.
404	OperationDenied.VpcIpv4GatewayEnabled	The operation is not allowed because of the VPC of the NAT gateway has opened IPv4 Gateway.	Les passerelles IPv4 sont activées pour le VPC de la passerelle NAT ; l'opération est refusée.
503	ServiceUnavailable	The request has failed due to a temporary failure of the server.	Échec de la requête dû à une erreur temporaire du serveur.

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur de service.