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

Endereços IP elásticos (EIPs) contíguos são um grupo de EIPs organizados sequencialmente. Durante o design de rede, você pode solicitar e usar esses endereços IP em lotes para recursos de nuvem que exigem endereços IP públicos contíguos. Você pode chamar a operação AllocateEipSegmentAddress para solicitar EIPs contíguos.

Nota

Esta API foi descontinuada sem substituto. Embora o acesso temporário seja mantido, nenhuma atualização ou correção de bugs será fornecida. Para garantir a continuidade da funcionalidade, planeje sua migração e entre em contato com seu gerente de conta para obter suporte.

Descrição da operação

A operação AllocateEipSegmentAddress é assíncrona. O sistema primeiro retorna o ID da instância do grupo de EIPs contíguos, mas o grupo ainda não foi totalmente criado e a tarefa de criação ainda está sendo executada em segundo plano. Você pode chamar a operação DescribeEipSegment para consultar o status do grupo de EIPs contíguos.

Quando o grupo de EIPs contíguos está no estado Allocating, o grupo está sendo alocado. Nesse estado, você pode realizar apenas operações de consulta.
Quando o grupo de EIPs contíguos está no estado Allocated, o grupo está alocado.

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:AllocateEipSegmentAddress

create

*SegmentAddress

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Você pode gerar o valor a partir do seu cliente e garantir que o valor seja exclusivo em diferentes solicitações. O parâmetro ClientToken aceita 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 é diferente.	02fb3da4-130e-11e9-8e44-001****
Bandwidth	string	Não	A largura de banda de pico do EIP. Unidade: Mbit/s. Quando InternetChargeType está definido como PayByBandwidth, os valores válidos para Bandwidth são de 1 a 500. Quando InternetChargeType está definido como PayByTraffic, os valores válidos para Bandwidth são de 1 a 200. Valor padrão: 5 Mbit/s.	5
RegionId	string	Sim	O ID da região dos EIPs contíguos. Você pode chamar a operação DescribeRegions para consultar os IDs de região.	cn-hangzhou
EipMask	string	Sim	A máscara de sub-rede dos EIPs contíguos. Valores válidos: 28: O sistema aloca 16 EIPs contíguos por chamada. 27: O sistema aloca 32 EIPs contíguos por chamada. 26: O sistema aloca 64 EIPs contíguos por chamada. 25: O sistema aloca 128 EIPs contíguos por chamada. 24: O sistema aloca 256 EIPs contíguos por chamada. Nota Devido à reserva de endereços IP, o número real de EIPs contíguos alocados pode ser 1, 3 ou 4 a menos do que o número esperado.	28
Netmode	string	Não	O tipo de rede. Defina o valor como public, que indica a Internet.	public
InternetChargeType	string	Não	O método de cobrança dos EIPs contíguos. Valores válidos: PayByBandwidth (padrão): cobrança por largura de banda. PayByTraffic: cobrança por transferência de dados.	PayByBandwidth
ResourceGroupId	string	Não	O ID do grupo de recursos.	rg-bp67acfmxazb4ph****
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), Singapura, Japão (Tóquio), 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 incluído na 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
Zone	string	Não	A zona do grupo de EIPs contíguos.	cn-hangzhou-a

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A lista de informações retornadas.
RequestId	string	O ID da solicitação.	F7A6301A-64BA-41EC-8284-8F4838C15D1F
EipSegmentInstanceId	string	O ID da instância do grupo de EIPs contíguos.	eipsg-2zett8ba055tbsxme****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "F7A6301A-64BA-41EC-8284-8F4838C15D1F",
  "EipSegmentInstanceId": "eipsg-2zett8ba055tbsxme****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	QuotaExceeded.Eip	Elastic IP address quota exceeded
400	InsufficientBalance	Your account does not have enough balance.
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	TokenVerfiy.Failed	token verify failed.
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	OperationFailed.InsufficientEIP	Eip resource is not enough.
400	FrequentPurchase.EIP	eip frequent purchase
400	OperationFailed.ChargeTypeInvalid	Operation failed because hybrid netmode do not support PayByTraffic.
400	IllegalParam.EipMask	EipMask is illegal.
400	IllegalParam.Name	Name is illegal.
400	IllegalParam.Description	Description is illegal.
400	InstanceExist.EipSegment	The eipSegment instance already exists.
400	OperationFailed.QuotaExceed	Operation failed because over threshold bandwidth quota exceed.
400	OperationFailed.FrequentPurchase	Operation failed because eip frequent purchase.
400	OperationFailed.AllocateEipSegment	Operation failed because eip segment is out of stock.	O estoque de EIPs consecutivos é insuficiente.
400	OperationFailed.CreateOrderFailed	Operation failed because create order failed.
400	MissingParam.Bandwidth	The parameter Bandwidth is mandatory when allocate hybrid EipSegment.
400	OperationFailed.EipQuotaExceed	Operation failed because eip quota exceed.
400	Forbidden	User not authorized to operate on the specified resource.
400	UnsupportedFeature.AllocateEipAddressWithZone	The feature of AllocateEipAddressWithZone is not supported.	A região atual não oferece suporte à criação de instâncias na zona especificada.
400	IllegalParam.Zone	The specified zone is invalid.	O parâmetro Zone é inválido.
400	Forbidden.AllocateEipSegmentAddress	Authentication is failed for allocating eip segment address.	Falha ao solicitar EIPs consecutivos porque o serviço está offline. Use o serviço de pool de endereços IP como alternativa.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.