AllocateEipAddressPro - Elastic IP Address: Central de Documentação do Alibaba Cloud

Solicita um endereço IP elástico (EIP) especificado para atender a requisitos específicos de configuração de rede.

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

vpc:AllocateEipAddressPro

create

*Address

acs:vpc:{#regionId}:{#accountId}:eip/*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região do EIP especificado. Você pode chamar a operação DescribeRegions para consultar os IDs das regiões.	cn-hangzhou
IpAddress	string	Não	O endereço IP do EIP especificado. Você precisa especificar apenas um dos parâmetros IpAddress e InstanceId. Se nenhum for especificado, o sistema aloca um EIP aleatoriamente.	192.0.XX.XX
InstanceId	string	Não	O ID da instância do EIP especificado. Você precisa especificar apenas um dos parâmetros IpAddress e InstanceId. Se nenhum for especificado, o sistema aloca um EIP aleatoriamente.	eip-25877c70gddh****
Bandwidth	string	Não	A largura de banda máxima do EIP especificado. Unidade: Mbit/s. Se InstanceChargeType estiver definido como PostPaid e InternetChargeType estiver definido como PayByBandwidth, os valores válidos para Bandwidth são de 1 a 500. Se InstanceChargeType estiver definido como PostPaid e InternetChargeType estiver definido como PayByTraffic, os valores válidos para Bandwidth são de 1 a 200. Se InstanceChargeType estiver definido como PrePaid, os valores válidos para Bandwidth são de 1 a 1000. Valor padrão: 5.	5
Period	integer	Não	A duração da assinatura. Se PricingCycle estiver definido como Month, os valores válidos para Period são de 1 a 9. Se PricingCycle estiver definido como Year, os valores válidos para Period são de 1 a 3. Este parâmetro é obrigatório se InstanceChargeType estiver definido como PrePaid. Não especifique este parâmetro se InstanceChargeType estiver definido como PostPaid.	1
ISP	string	Não	O tipo de linha. Valores válidos: BGP (padrão): linha BGP (multi-ISP). Os EIPs BGP (multi-ISP) são suportados em todas as regiões. BGP_PRO: linha BGP (multi-ISP) Pro. Os EIPs BGP (multi-ISP) Pro são suportados apenas nas regiões de Hong Kong (China), Cingapura, Malásia (Kuala Lumpur), Filipinas (Manila), Indonésia (Jacarta) e Tailândia (Bangkok). Para obter mais informações sobre as linhas BGP (multi-ISP) e BGP (multi-ISP) Pro, consulte Tipos de linha de EIP. Se você for um usuário da lista de permissões de largura de banda de ISP único, também poderá selecionar os seguintes tipos: ChinaTelecom: China Telecom ChinaUnicom: China Unicom ChinaMobile: China Mobile ChinaTelecom_L2: China Telecom L2 ChinaUnicom_L2: China Unicom L2 ChinaMobile_L2: China Mobile L2 Se você for um usuário do Alibaba Finance Cloud na região da China (Hangzhou), este parâmetro é obrigatório. Defina o valor como BGP_FinanceCloud.	BGP
Netmode	string	Não	O tipo de rede. Defina o valor como public (padrão), que indica a Internet.	public
AutoPay	boolean	Não	Especifica se o pagamento automático deve ser ativado. Valores válidos: false: desativa o pagamento automático. Após a geração de um pedido, você deve acessar o User Center para concluir o pagamento. true: ativa o pagamento automático. O sistema paga automaticamente pelo pedido. Este parâmetro é obrigatório se InstanceChargeType estiver definido como PrePaid. Você pode deixar este parâmetro vazio se InstanceChargeType estiver definido como PostPaid.	true
PricingCycle	string	Não	O ciclo de cobrança da assinatura. Valores válidos: Month (padrão): cobrança mensal. Year: cobrança anual. Este parâmetro é obrigatório se InstanceChargeType estiver definido como PrePaid. Você pode deixar este parâmetro vazio se InstanceChargeType estiver definido como PostPaid.	Month
InstanceChargeType	string	Não	O método de cobrança do EIP especificado. Valores válidos: PrePaid: assinatura. PostPaid (padrão): método de cobrança pay-as-you-go. Se InstanceChargeType estiver definido como PrePaid, InternetChargeType deve ser definido como PayByBandwidth. Se InstanceChargeType estiver definido como PostPaid, InternetChargeType pode ser definido como PayByBandwidth ou PayByTraffic.	PostPaid
InternetChargeType	string	Não	O método de medição do EIP especificado. Valores válidos: PayByBandwidth (padrão): cobrança por largura de banda. PayByTraffic: cobrança por transferência de dados. Se InstanceChargeType estiver definido como PrePaid, InternetChargeType deve ser definido como PayByBandwidth. Se InstanceChargeType estiver definido como PostPaid, InternetChargeType pode ser definido como PayByBandwidth ou PayByTraffic.	PayByBandwidth
ResourceGroupId	string	Não	O ID do grupo de recursos ao qual o EIP especificado pertence.	rg-resourcegroup****
Tag	array<object>	Não
	object	Não
Key	string	Não
Value	string	Não
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o valor, mas deve garantir que ele seja exclusivo entre diferentes solicitações. O token de cliente pode conter apenas caracteres ASCII. Nota Se você não especificar este parâmetro, o sistema usará automaticamente o RequestId da solicitação de API como o ClientToken. O RequestId de cada solicitação de API é exclusivo.	0c593ea1-3bea-11e9-b96b-88e9fe6****
SecurityProtectionTypes	array	Não	O nível de proteção de segurança. Se este parâmetro for deixado vazio, o Anti-DDoS Basic será usado por padrão. AntiDDoS_Enhanced: Anti-DDoS (Enhanced).
	string	Não	O nível de proteção de segurança. Se este parâmetro for deixado vazio, o Anti-DDoS Basic será usado por padrão. AntiDDoS_Enhanced: Anti-DDoS (Enhanced).
PublicIpAddressPoolId	string	Não	O ID do pool de endereços IP. O EIP é alocado a partir deste pool de endereços IP. Por padrão, o recurso de pool de endereços IP não está disponível. Para usar este recurso, solicite a cota do recurso de pool de endereços IP no Centro de Cotas de Privilégios. Para obter mais informações, consulte Aumentar cotas no Centro de Cotas de Privilégios.	pippool-2vc0kxcedhquybdsz****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	As informações retornadas.
RequestId	string	O ID da solicitação.	4EC47282-1B74-4534-BD0E-403F3EE64CAF
OrderId	integer	O ID do pedido. Este parâmetro é retornado se InstanceChargeType (o método de cobrança do EIP especificado) estiver definido como PrePaid (assinatura). Se AutoPay estiver definido como false, o que significa que o pagamento automático está desativado, acesse o User Center para concluir o pagamento.	20190000
ResourceGroupId	string	O ID do grupo de recursos. Este parâmetro é retornado apenas se InstanceChargeType estiver definido como PostPaid.	rg-resourcegroup****
EipAddress	string	O endereço IP alocado para o EIP especificado. Este parâmetro é retornado apenas se InstanceChargeType estiver definido como PostPaid.	192.0.XX.XX
AllocationId	string	O ID do EIP.	eip-25877c70gddh****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "4EC47282-1B74-4534-BD0E-403F3EE64CAF",
  "OrderId": 20190000,
  "ResourceGroupId": "rg-resourcegroup****",
  "EipAddress": "192.0.XX.XX",
  "AllocationId": "eip-25877c70gddh****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	FrequentPurchase.EIP	eip frequent purchase
400	QuotaExceeded.Eip	Elastic IP address quota exceeded
400	InvalidParameter	Specified value of "InternetChargeType" is not valid
400	ReserveIpFail	Reserve eip failed.
400	InvalidBandwidth.Malformed	The specified Bandwidth is invalid.
400	INSTANCE_TYPE_NOT_SUPPORT	The instance type is invalid.
400	QueryParameter.Illegal	query parameter illegal
400	QuotaExceeded.LargeSpecEip	Elastic IP address with large spec quota exceeded.
400	InvalidResourceGroupId	The specified ResourceGroupId does not exist.	O ID do grupo de recursos não existe.
400	Invalid.Reserve.Ip	The reserve ip is invalid.
400	Ip.Allocated	The reserve ip has been allocated.	O endereço IP reservado já foi alocado.
400	Ip.Keeped	The reserve ip been keeped in an hour.
400	OperationFailed.AllocateUnfamiliarIp	The operation failed because only IP addresses used within the last seven days can be allocated.	Você só pode solicitar um EIP que foi usado nos últimos 7 dias.
400	INVALID_INSTANCE_STATUS	The instance status is invalid.
400	OperationFailed.InstanceNotExist	Eip instanceId does not exist.
400	InvalidStatus.ValueNotSupported	The specified status is not supported.
400	OperationFailed.RiskControl	Risk control check failed.	Um risco de segurança foi detectado com seu método de pagamento. Conclua a verificação usando o link no e-mail ou na mensagem do console e, em seguida, reenvie o pedido.
400	ResourceNotEnough.PublicIpAddressPool	The specified resource of PublicIpAddressPool is not enough.
400	Mismatch.IpAndPublicIpAddressPool	The Ip and PublicIpAddressPool are mismatched.
400	ResourceNotFound.PublicIpAddressPool	The specified resource of PublicIpAddressPool is not found.
400	ResourceNotFound.Ip	The specified ip is not found.	O endereço IP especificado não existe.
400	OperationDenied.IpBelongToOtherUser	The operation is not allowed because of ip belong to other user.	A solicitação falhou porque o endereço IP pertence a outro usuário.
400	IncorrectStatus.Ip	The status of ip is incorrect.	O endereço IP está em um estado inválido.
400	OperationFailed.IpIsLocked	The operation is failed because of ip is locked.	A solicitação falhou porque o endereço IP está bloqueado.
400	Mismatch.IpAndIsp	The specified IP address does not match the ISP.
400	IncorrectStatus.PublicIpAddressPool	The status of PublicIpAddressPool is incorrect.	Você não pode alocar um EIP porque o pool de endereços IP está em um estado inválido.
400	IllegalParam.IpAddress	The specified IpAddress (%s) is illegal.	O endereço IP é inválido.
400	OperationFailed.ResourceNotEnough	The resources you have applied for are insufficient.	Os recursos solicitados são insuficientes. Para solicitar mais recursos, abra um ticket.
400	Mismatch.EipSecurityProtectionTypeAndPoolSecurityProtectionType	The EipSecurityProtectionType and PoolSecurityProtectionType are mismatched.	O tipo de proteção de segurança do EIP não corresponde ao do pool de endereços.
400	IllegalParam.Isp	The param of Isp [%s] is illegal.	Você não pode alocar um EIP porque o parâmetro ISP é inválido.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	O processamento da solicitação falhou devido a um erro desconhecido.
403	Forbidden	User not authorized to operate on the specified resource.	Você não tem as permissões para gerenciar o recurso especificado. Solicite as permissões necessárias e tente novamente.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.