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

Descrição

Ao chamar esta operação, observe os seguintes pontos:

A instância que receberá o endereço IP público deve estar no estado Running(Running) ou Stopped(Stopped).
Se OperationLocks na resposta de DescribeInstances contiver "LockReason" : "security" para uma instância, ela estará bloqueada por motivos de segurança e não poderá receber um endereço IP público.
É possível atribuir apenas um endereço IP público por instância. Se a instância já possuir um endereço IP público, o sistema retornará o código de erro AllocatedAlready.
Após atribuir um endereço IP público a uma instância, reinicie-a (RebootInstance) ou inicie-a (StartInstance) para que o novo endereço entre em vigor.

Para instâncias em uma Virtual Private Cloud (VPC), atribua um endereço IP público ou associe um Elastic IP Address (EIP). Para mais informações, consulte AssociateEipAddress.

Nota

Após associar um EIP a uma instância em uma VPC, não é mais possível atribuir endereços IP públicos a essa instância.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação diretamente no OpenAPI Explorer. A ferramenta também gera dinamicamente exemplos de código para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	AllocatePublicIpAddress	A operação a ser executada. Defina o valor como AllocatePublicIpAddress.
InstanceId	String	Sim	i-bp1gtjxuuvwj17zr****	ID da instância que receberá o endereço IP público.
IpAddress	String	Não	112.124..	Endereço IP público a ser atribuído à instância. Se este parâmetro estiver vazio, o sistema atribuirá aleatoriamente um endereço IP público à instância especificada.
VlanId	String	Não	720	ID da rede local virtual (VLAN) da instância. Nota Este parâmetro será removido futuramente. Use outros parâmetros para garantir compatibilidade futura.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
IpAddress	String	112.124..	Endereço IP público atribuído à instância.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID da solicitação.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=AllocatePublicIpAddress
&InstanceId=i-bp1gtjxuuvwj17zr****
&IpAddress=112.124.**.**
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<AllocatePublicIpAddressResponse>
    <RequestId>F2EF6A3B-E345-46B9-931E-0EA094818567</RequestId>
    <IpAddress>112.124.**.**</IpAddress>
</AllocatePublicIpAddressResponse>

Formato JSON

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

{
  "RequestId" : "F2EF6A3B-E345-46B9-931E-0EA094818567",
  "IpAddress" : "112.124.**.**"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	OperationDenied	Specified operation is denied as your instance is in VPC.	Mensagem retornada porque a operação não é suportada quando a instância reside em uma VPC.
400	AllocateIpInvalidInstanceBandwidth	OperationDenied The InternetMaxBandwidthOut of the specified instance cannot be less than 0.	Mensagem retornada porque a operação não é suportada quando a largura de banda pública de saída máxima não é superior a 0 Mbit/s.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.	Mensagem retornada porque a operação não é suportada no estado atual do recurso.
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	Mensagem retornada porque a operação não é suportada enquanto a instância estiver bloqueada por motivos de segurança.
403	InstanceExpiredOrInArrears	The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).	Mensagem retornada porque a instância por assinatura expirou. Renove a instância e tente novamente.
403	IpInUse	The specified IP is already in use.	Mensagem retornada porque o IP especificado já está em uso.
403	AllocatedAlready	There is an IpAddress allocated already for the specified instance.	Mensagem retornada porque a instância já possui outro endereço IP atribuído.
403	NAT_PUBLIC_IP_ALLOCATE_FAILED	Nat public ip binding failed.	Mensagem retornada porque não foi possível atribuir o endereço IP público.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	Mensagem retornada porque o parâmetro InstanceId especificado é inválido.
404	InvalidVlanId.NotFound	The VlanId provided does not exist in our records.	Mensagem retornada porque o parâmetro VlanId especificado não existe.
404	InvalidIpAddress.NotFound	The specified IP is not in the specified vlan.	Mensagem retornada porque o IP especificado não pertence à VLAN indicada.

Para obter uma lista completa de códigos de erro, visite o API Error Center.