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

Atribui um endereço IP público a uma instância ECS. Recomendamos que você chame a operação ModifyInstanceNetworkSpec para atribuir um endereço IP público.

Descrição da operação

Antes de começar

Antes de atribuir um endereço IP público, a instância deve estar no estado Running (Running) ou Stopped (Stopped).
Se "LockReason" : "security" estiver incluído em OperationLocks de uma instância bloqueada por motivos de segurança, você não poderá atribuir um endereço IP público à instância.
Certifique-se de que a largura de banda pública da instância seja maior que 0 antes de chamar esta operação. Você pode chamar a operação ModifyInstanceNetworkSpec para ajustar a largura de banda.

Precauções

Apenas usuários na lista de permissões podem especificar o endereço IP público usando o parâmetro IpAddress. Se a largura de banda pública for maior que 0, você pode definir InstanceId para alocar um endereço IP público aleatório. Se a largura de banda pública for 0, chame a operação ModifyInstanceNetworkSpec para ajustar a largura de banda antes de chamar esta operação para alocar um endereço IP público.
Apenas um endereço IP público pode ser alocado a uma instância. Se a instância já possuir um endereço IP público, o endereço IP público anexado existente IpAddress será retornado.
O novo endereço IP público entra em vigor após você reiniciar a instância (RebootInstance) ou iniciar a instância (StartInstance).

Além de atribuir um endereço IP público, você pode associar um Elastic IP Address (EIP) a uma instância ECS conectada à VPC. Para mais informações, consulte AssociateEipAddress.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ecs:AllocatePublicIpAddress

create

*Instance.

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
InstanceId	string	Sim	O ID da instância à qual você deseja alocar um endereço IP público. Nota A largura de banda pública da instância deve ser maior que 0.	i-bp1gtjxuuvwj17zr****
IpAddress	string	Não	O endereço IP público da instância. Se este parâmetro for deixado vazio, o sistema atribuirá aleatoriamente um endereço IP. Nota Apenas usuários na lista de permissões podem especificar este parâmetro. Usuários comuns não podem especificar um endereço IP.	112.124..
VlanId	string	Não	O ID da VLAN da instância. Nota Este parâmetro será descontinuado. Para melhor compatibilidade, use outros parâmetros.	720

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
IpAddress	string	O endereço IP público da instância.	112.124..
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Exemplos

Resposta de sucesso

JSON formato

{
  "IpAddress": "112.124.**.**",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidOperation.AllocateFailed	The current instance failed to allocate public IP, please try again later.
400	InvalidIpAddress.Malformed	The specified parameter "IpAddress" is not valid.
400	OperationDenied	Specified operation is denied as your instance is in VPC.	O EIP especificado está indisponível ou não autorizado.
400	InsufficientPublicIp	Ip address not found.
400	AllocateIpInvalidInstanceBandwidth	OperationDenied The InternetMaxBandwidthOut of the specified instance cannot be less than 0.	A operação atual é inválida. Certifique-se de que a largura de banda de saída máxima seja maior que 0.
400	OperationDenied.CloudboxNotSupport	This operation is denied, because the specified ECS instance which is in the Cloudbox dose not support PublicIp or Eip.
400	OperationDenied.DedicatedRegionNotSupported	This operation is denied, because the specified ECS instance which is in the dedicated region dose not support PublicIp or Eip.	Esta operação de API não é suportada pela nuvem dedicada.
500	InternalError	The request processing has failed due to some unknown error.
500	InvalidOperation.AllocateIpFailed	Failed to allocate the specific IP, please ensure the IP is available.	Falha ao atribuir o endereço IP especificado. Certifique-se de que o endereço IP esteja disponível.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	A instância está bloqueada por motivos de segurança. Entre em contato com o suporte técnico de segurança para obter assistência.
403	InstanceExpiredOrInArrears	The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).
403	IpInUse	The specified IP is already in use.	O endereço IP especificado já está em uso em outra instância.
403	AllocatedAlready	There is an IpAddress allocated already for the specified instance.	Ao tentar vincular a instância ao endereço IP especificado, a instância já recebeu outro endereço IP.
403	AllocateIp.Fail	The specified instance fails to allocate ip, please try again.
403	NAT_PUBLIC_IP_BINDING_FAILED	Binding nat public ip failed.
403	NAT_PUBLIC_IP_ALLOCATE_FAILED	Nat public ip binding failed.	Falha ao vincular o endereço IP público.
403	InvalidIpAddress.NotPublic	The specified IP is not public address.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	O ID da instância especificado é inválido.
404	InvalidVlanId.NotFound	The VlanId provided does not exist in our records.	O ID da rede local virtual especificado não existe.
404	InvalidIpAddress.NotFound	The specified IP is not in the specified vlan.	O endereço IP especificado foi liberado.
409	OperationConflict	Request was denied due to conflict with a previous request,please try again later.	O recurso solicitado entra em conflito com uma solicitação anterior.
409	TokenProcessing	The previous token request is still processing. Please try again later.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.