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

Aloca um elastic IP address (EIP) especificado para requisitos de configuração de rede específicos.

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 a ser alocado. 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 a ser alocado. Você precisa especificar apenas um dos parâmetros IpAddress e InstanceId. Se nenhum for especificado, o sistema aloca aleatoriamente um EIP.	192.0.XX.XX
InstanceId	string	Não	O ID da instância do EIP a ser alocado. Você precisa especificar apenas um dos parâmetros IpAddress e InstanceId. Se nenhum for especificado, o sistema aloca aleatoriamente um EIP.	eip-25877c70gddh****
Bandwidth	string	Não	A largura de banda máxima do EIP a ser alocado. Unidade: Mbit/s. Se InstanceChargeType estiver definido como PostPaid e InternetChargeType estiver definido como PayByBandwidth, os valores válidos de Bandwidth são de 1 a 500. Se InstanceChargeType estiver definido como PostPaid e InternetChargeType estiver definido como PayByTraffic, os valores válidos de Bandwidth são de 1 a 200. Se InstanceChargeType estiver definido como PrePaid, os valores válidos de Bandwidth são de 1 a 1000. Valor padrão: 5 Mbit/s.	5
Period	integer	Não	A duração da assinatura. Se PricingCycle estiver definido como Month, os valores válidos de Period são de 1 a 9. Se PricingCycle estiver definido como Year, os valores válidos de Period são de 1 a 3. Este parâmetro é obrigatório se InstanceChargeType estiver definido como PrePaid. Não defina 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). Todas as regiões suportam EIPs BGP (multi-ISP). BGP_PRO: linha BGP (multi-ISP) Pro. Apenas as regiões de Hong Kong (China), Singapura, Malásia (Kuala Lumpur), Filipinas (Manila), Indonésia (Jacarta) e Tailândia (Bangkok) suportam EIPs BGP (multi-ISP) Pro. 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 single-ISP, 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 Finance Cloud na China (Hangzhou), este parâmetro é obrigatório. Defina o valor como BGP_FinanceCloud.	BGP
Netmode	string	Não	O tipo de rede. O valor pode ser apenas public (padrão), que indica a rede pública.	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, acesse o Order Center para concluir o pagamento. true: ativa o pagamento automático. O pedido é pago automaticamente. Este parâmetro é obrigatório se InstanceChargeType estiver definido como PrePaid. Este parâmetro é opcional se InstanceChargeType estiver definido como PostPaid.	true
PricingCycle	string	Não	O ciclo de faturamento da assinatura. Valores válidos: Month (padrão): faturado mensalmente. Year: faturado anualmente. Este parâmetro é obrigatório se InstanceChargeType estiver definido como PrePaid. Este parâmetro é opcional se InstanceChargeType estiver definido como PostPaid.	Month
InstanceChargeType	string	Não	O método de faturamento do EIP a ser alocado. Valores válidos: PrePaid: assinatura. PostPaid (padrão): pay-as-you-go. Se InstanceChargeType estiver definido como PrePaid, InternetChargeType deverá ser definido como PayByBandwidth. Se InstanceChargeType estiver definido como PostPaid, InternetChargeType poderá ser definido como PayByBandwidth ou PayByTraffic.	PostPaid
InternetChargeType	string	Não	O método de medição do EIP a ser alocado. Valores válidos: PayByBandwidth (padrão): pagamento por largura de banda. PayByTraffic: pagamento por transferência de dados. Se InstanceChargeType estiver definido como PrePaid, InternetChargeType deverá ser definido como PayByBandwidth. Se InstanceChargeType estiver definido como PostPaid, InternetChargeType poderá ser definido como PayByBandwidth ou PayByTraffic.	PayByBandwidth
ResourceGroupId	string	Não	O ID do grupo de recursos ao qual o EIP 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. Gere um valor de parâmetro a partir do seu cliente para garantir a exclusividade entre diferentes solicitações. ClientToken suporta apenas caracteres ASCII. Nota Se você não especificar este parâmetro, o sistema usará o RequestId da solicitação de API como o ClientToken. O RequestId pode ser diferente para cada solicitação de API.	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 DDoS Protection (Basic) será usado por padrão. Se este parâmetro for definido como AntiDDoS_Enhanced, o DDoS Protection (Enhanced) será usado.
	string	Não	O nível de proteção de segurança. Se este parâmetro for deixado vazio, o DDoS Protection (Basic) será usado por padrão. Se este parâmetro for definido como AntiDDoS_Enhanced, o DDoS Protection (Enhanced) será usado.
PublicIpAddressPoolId	string	Não	O ID do pool de endereços IP. O EIP é alocado a partir do pool de endereços IP especificado. O recurso de pool de endereços IP não está disponível por padrão. Para usar esse recurso, solicite a cota de privilégio do pool de endereços IP no Quota Center. Para obter mais informações, consulte Aumentar uma cota no Quota Center.	pippool-2vc0kxcedhquybdsz****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação.	4EC47282-1B74-4534-BD0E-403F3EE64CAF
OrderId	integer	O ID do pedido. Este parâmetro é retornado quando InstanceChargeType (o método de faturamento do EIP) está definido como PrePaid (assinatura). Se AutoPay estiver definido como false, o que significa que o pagamento automático não está ativado, acesse o Order Center para concluir o pagamento.	20190000
ResourceGroupId	string	O ID do grupo de recursos. Este parâmetro é retornado apenas quando InstanceChargeType está definido como PostPaid.	rg-resourcegroup****
EipAddress	string	O endereço IP atribuído ao EIP especificado. Este parâmetro é retornado apenas quando InstanceChargeType está 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ê pode especificar apenas um endereço IP que foi usado nos últimos 7 dias ao solicitar um EIP.
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. Continue a verificação através do link no e-mail ou na mensagem do console e reenvie o pedido após a verificação.
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 foi encontrado.
400	OperationDenied.IpBelongToOtherUser	The operation is not allowed because of ip belong to other user.	A solicitação falhou. O endereço IP pertence a outro usuário.
400	IncorrectStatus.Ip	The status of ip is incorrect.	O estado do endereço IP está incorreto.
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.	Falha ao solicitar o endereço IP especificado. Os parâmetros de ISP e endereço IP não correspondem.
400	IncorrectStatus.PublicIpAddressPool	The status of PublicIpAddressPool is incorrect.	A instância do pool de endereços não está em um estado estável. A alocação de EIP não é permitida.
400	IllegalParam.IpAddress	The specified IpAddress (%s) is illegal.	O IpAddress especificado é inválido.
400	OperationFailed.ResourceNotEnough	The resources you have applied for are insufficient.	Os recursos solicitados são insuficientes. Se você ainda precisar solicitar, 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 tipo de proteção de segurança do pool de endereços.
400	IllegalParam.Isp	The param of Isp [%s] is illegal.	O parâmetro Isp é inválido. Insira um valor válido conforme especificado nos parâmetros da solicitação.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocorreu um erro interno do sistema.
403	Forbidden	User not authorized to operate on the specified resource.	O EIP não pertence ao chamador atual. Verifique se você tem permissão para usar este EIP.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.