AssociateEipAddress - : Central de Documentação do Alibaba Cloud

Observações de uso

Você pode associar um EIP a uma instância do Elastic Compute Service (ECS), a uma instância do Classic Load Balancer (CLB), a uma interface de rede elástica secundária (ENI), a um NAT gateway ou a um endereço IP virtual de alta disponibilidade (HAVIP) na mesma região. As instâncias ECS e CLB devem estar implantadas em uma Virtual Private Cloud (VPC).
A operação AssociateEipAddress é assíncrona. Após o envio da solicitação, o sistema retorna um ID de solicitação e executa a tarefa em segundo plano. Para consultar o status de um EIP, chame a operação DescribeEipAddresses.
- Se o EIP estiver no estado Associating, ele está sendo associado. Nesse estado, apenas consultas são permitidas; outras operações ficam bloqueadas.
- Quando o EIP estiver no estado InUse, significa que a associação foi concluída com sucesso.
Não chame a operação AssociateEipAddress repetidamente para associar um EIP a uma instância dentro de um curto período de tempo.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	AssociateEipAddress	A operação a ser executada. Defina o valor como AssociateEipAddress.
RegionId	String	Sim	cn-hangzhou	O ID da região à qual o EIP pertence. Chame a operação DescribeRegions para obter a lista mais recente de regiões.
AllocationId	String	Sim	eip-2zeerraiwb7ujsxdc****	O ID do EIP a ser associado a uma instância.
InstanceId	String	Sim	i-2zebb08phyczzawe****	O ID da instância à qual associar o EIP. Insira o ID de um NAT gateway, instância CLB, instância ECS, ENI secundária, HAVIP ou endereço IP.
InstanceType	String	Não	EcsInstance	O tipo de instância à qual associar o EIP. Valores válidos: Nat: um NAT gateway SlbInstance: uma instância CLB EcsInstance (padrão): uma instância ECS em uma VPC NetworkInterface: uma ENI secundária HaVip: um HAVIP IpAddress: um endereço IP Nota Se este parâmetro não for definido, o tipo da instância será considerado EcsInstance. Caso o tipo da instância seja diferente de EcsInstance, este parâmetro torna-se obrigatório.
InstanceRegionId	String	Não	cn-hangzhou	O ID da região da instância à qual associar o EIP. Nota Este parâmetro é necessário apenas quando o EIP é associado a uma instância do Global Accelerator (GA) com largura de banda compartilhada.
PrivateIpAddress	String	Não	192.168.XX.XX	Um endereço IP dentro do bloco CIDR do vSwitch. Caso este parâmetro não seja especificado, o sistema aloca automaticamente um endereço IP privado com base no ID da VPC e no ID do vSwitch.
Mode	String	Não	NAT	O modo de associação. Valores válidos: NAT (padrão): modo NAT MULTI_BINDED: modo multi-EIP-to-ENI BINDED: modo cut-through Nota Este parâmetro é obrigatório somente quando InstanceType estiver definido como NetworkInterface.
VpcId	String	Não	vpc-257gqcdfvx6n****	O ID da VPC com gateways IPv4 habilitados e implantada na mesma região do EIP. Ao associar um EIP a um endereço IP, o sistema permite que esse endereço acesse a Internet com base nas configurações de rota da VPC. Nota Este parâmetro é necessário se InstanceType estiver definido como IpAddress. Nesse cenário, o EIP é associado diretamente a um endereço IP.
ClientToken	String	Não	0c593ea1-3bea-11e9-b96b-88e9fe63****	O token do cliente usado para garantir a idempotência da solicitação. Gere o token usando o cliente, mas certifique-se de que ele seja único entre todas as solicitações. O token pode conter apenas caracteres ASCII. Nota Se você não definir este parâmetro, o sistema definirá ClientToken com o mesmo valor de RequestId. O valor de RequestId pode variar a cada solicitação de API.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	0ED8D006-F706-4D23-88ED-E11ED28DCAC0	O ID da solicitação.

Exemplos

Exemplos de solicitações

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

Exemplos de respostas de sucesso

Formato XML

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

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

Formato JSON

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

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

Códigos de erro

HttpCode	Código de erro	Mensagem de erro	Descrição
400	InvalidAssociation.Duplicated	Specified instance already is associated.	Erro retornado porque um EIP ou uma instância GA já está associado à instância especificada. Desassocie o EIP ou a instância GA antes de executar a operação.
400	OperationDenied	Specified instance is not in VPC.	Erro retornado porque a instância especificada não existe na VPC.
400	InvalidParameter.Mismatch	Specified elastic IP address and ECS instance are not in the same region.	Erro retornado porque o EIP e a instância ECS especificados não pertencem à mesma região.
400	IncorrectEipStatus	Current elastic IP status does not support this operation	Erro retornado porque o status atual do EIP não suporta esta operação.
400	IncorrectInstanceStatus	Current instance status does not support this operation.	Erro retornado porque esta operação não pode ser executada enquanto a instância estiver no estado atual.
400	InvalidInstanceType.ValueNotSupported	The specified value of InstanceType is not supported.	Erro retornado porque InstanceType foi definido com um valor inválido.
400	InvalidParameter	The specified parameter is not valid.	Erro retornado porque o parâmetro foi definido com um valor inválido.
400	OperationDenied	Eip of default vpc not allow this operation	Erro retornado porque a operação não é suportada por EIPs na VPC padrão.
400	TaskConflict	The eip operate too frequent, TaskConflict.	Erro retornado devido à frequência excessiva de operações, causando conflito entre tarefas.
400	InvalidBindingStatus	The eip binding status invalid.	Erro retornado porque o EIP está em um estado inválido.
400	BIND_INSTANCE_HAVE_PORTMAP_OR_BIND_EIP	The instance may have portMap or already bind eip.	Erro retornado porque há uma regra de encaminhamento de porta configurada na instância ECS. Exclua a regra de encaminhamento de porta e tente novamente.
400	BIND_INSTANCE_OWENER_ERROR	Cannot operate the eip.	Erro retornado porque você não tem autorização para gerenciar o EIP especificado.
400	QuotaExceeded.NumberOfEip	Binded eip Quota exceed on this NatGw.	Erro retornado porque o número de EIPs associados ao NAT gateway excedeu o limite máximo.
400	InvalidAction.Denied	Action is denied due to unfinished Eip configuration modification.	Erro retornado porque as configurações do EIP estão incompletas e a operação foi negada.
400	InvalidParams.NotFound	instance not found	Erro retornado porque a instância especificada não existe.
400	Eni.Attached	The eni should be detached from ecs when associating with direct eip.	Erro retornado porque a ENI está associada a um EIP no modo cut-through. É necessário desassociar a ENI da instância ECS.
400	InvalidNexthop.DirectEni	The direct Eni cannot be nexthop.	Erro retornado porque uma ENI no modo cut-through não pode ser especificada como próximo salto (next hop).
400	InvalidEIPStatus.BizDisabled	The EIP has been locked.	Erro retornado porque o EIP está bloqueado.
400	InvalidStatus.NotAllow	Bind instance status invalid	Erro retornado porque o status da instância associada é inválido.
400	OperationDenied.CloudBoxResourceExist	The operation is not allowed because there are resources related to the cloud box in VPC.	Erro retornado porque a VPC contém recursos relacionados ao CloudBox e a operação não é permitida.
400	OperationDenied.CloudBoxVSwitchExist	The operation is not allowed because a cloud box type vSwitch exists in VPC.	Erro retornado porque a VPC contém um vSwitch do tipo CloudBox e a operação não é permitida.
400	OperationDenied.NoAvailablePrivateIp	The operation is failed because of VSwitch has not availalbe private ip	Erro retornado porque o vSwitch não possui endereços IP privados disponíveis.
400	OperationFailed.Ipv4GatewayNotOpenedInVpc	The operation is failed because Ipv4Gateway is not opened in Vpc.	Erro retornado porque os gateways IPv4 não estão habilitados na VPC e a associação do endereço IP ao EIP falhou.
400	Forbidden	The eip instance owner error	Erro retornado porque os EIPs não pertencem a você. Verifique se você tem permissão para realizar a operação nesses EIPs.
400	Forbidden.FinancialLocked	The ip business status is invalid.	Erro retornado porque a instância possui pagamentos pendentes.
400	UnsupportedFeature.EipBindIpAddress	The feature of EipBindIpAddress is not supported.	Erro retornado porque o EIP não suporta o parâmetro IpAddress.
400	OperationFailed.InstanceNotExist	The ECS instance does not exist, or is not a VPC VM.	Erro retornado porque a instância ECS não existe ou não é uma máquina virtual da VPC, impedindo a associação do EIP.
400	OperationDenied.Ipv4GatewayExist	The operation is not allowed because of Ipv4GatewayExist.	Erro retornado porque existem gateways IPv4 na VPC e a associação do EIP falhou.
400	OperationFailed.EipBindModeConflict	Eips can not bind Eni with NAT mode and MULTI_BINDED mode at the same time.	Erro retornado porque não é possível associar um EIP a uma ENI nos modos NAT e multi-EIP-to-ENI simultaneamente.
400	OperationFailed.EcsMigrating	The operation is failed because of ECS is migrating.	Erro retornado porque a instância ECS está em processo de migração.
404	InvalidInstanId.NotFound	Specified instance does not exist.	Erro retornado porque a instância especificada não existe. Verifique se o ID da instância é válido.
404	InvalidAllocationId.NotFound	Specified allocation ID is not found	Erro retornado porque o EIP especificado não existe. Verifique se o valor informado é válido.
404	Forbidden.RegionNotFound	Specified instance is not found during access authentication.	Erro retornado porque a região não é suportada.
404	OperationDenied.VpcIpv4GatewayEnabled	The operation is not allowed because of the VPC of the NAT gateway has opened IPv4 Gateway.	Erro retornado porque os gateways IPv4 estão habilitados na VPC onde reside o NAT gateway e a operação foi negada.
503	ServiceUnavailable	The request has failed due to a temporary failure of the server.	Erro retornado porque a solicitação falhou devido a uma indisponibilidade temporária do servidor.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.