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

Adiciona um bloco CIDR a um pool de endereços IP.

Descrição da operação

Antes de chamar esta operação, observe os seguintes limites:

O bloco CIDR e o pool de endereços IP devem pertencer à mesma região.
O bloco CIDR e o pool de endereços IP devem usar o mesmo tipo de linha.
AddPublicIpAddressPoolCidrBlock é uma operação assíncrona. Depois que uma solicitação é enviada, o sistema retorna um ID de solicitação e executa a tarefa em segundo plano. Você pode chamar a operação ListPublicIpAddressPoolCidrBlocks para consultar o status da tarefa.
- Se o bloco CIDR estiver no estado Modifying, o bloco CIDR está sendo adicionado. Nesse estado, você pode apenas consultar o bloco CIDR e não pode executar outras operações.
- Se o bloco CIDR estiver no estado Created, o bloco CIDR foi adicionado.
Você não pode chamar repetidamente a operação AddPublicIpAddressPoolCidrBlock para adicionar um bloco CIDR a um pool de endereços IP dentro do período de tempo especificado.

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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
PublicIpAddressPoolId	string	Sim	O ID do pool de endereços IP.	pippool-6wetvn6fumkgycssx****
CidrBlock	string	Não	O bloco CIDR. Nota Você pode especificar apenas um entre CidrBlock e CidrMask.	47.0.XX.XX/24
ClientToken	string	Não	O token do cliente que é usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas deve garantir que o token seja exclusivo entre diferentes solicitações. O token pode conter apenas caracteres ASCII. Nota Se você não especificar este parâmetro, o sistema usará automaticamente o ID da solicitação como o token do cliente. O ID da solicitação pode ser diferente para cada solicitação.	02fb3da4-130e-11****
DryRun	boolean	Não	Especifica se deve ser realizado um dry run, sem executar a solicitação real. Valores válidos: true: realiza apenas um dry run. O sistema verifica a solicitação quanto a possíveis problemas, incluindo valores de parâmetros ausentes, sintaxe de solicitação incorreta e limites de serviço. Se a solicitação falhar no dry run, uma mensagem de erro será retornada. Se a solicitação passar no dry run, o código de erro DryRunOperation será retornado. false (padrão): realiza um dry run e executa a solicitação real. Se a solicitação passar no dry run, um código de status HTTP 2xx será retornado e a operação será executada.	false
RegionId	string	Sim	O ID da região do pool de endereços IP ao qual você deseja adicionar o bloco CIDR.	cn-chengdu
CidrMask	integer	Não	A máscara de sub-rede do bloco CIDR. Depois de inserir a máscara de sub-rede, o sistema aloca automaticamente os endereços IP. Valores válidos: 24 a 28. Nota Você pode especificar apenas um entre CidrBlock e CidrMask.	24

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
CidrBlock	string	O bloco CIDR.	47.0.XX.XX/28

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "4EC47282-1B74-4534-BD0E-403F3EE64CAF",
  "CidrBlock": "47.0.XX.XX/28"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	IllegalParam.CidrBlock	The param of CidrBlock [%s] is illegal.	The CidrBlock parameter is set to an invalid value.
400	IllegalParam.CidrBlockMask	The param of CidrBlock Mask [%s] is illegal.	The subnet mask of the CIDR block is invalid.
400	IncorrectStatus.PublicIpAddressPool	The status of PublicIpAddressPool [%s] is incorrect.
400	OperationDenied.CidrBlockBelongToOtherUser	The operation is not allowed because of CidrBlock belong to other user.
400	ResourceNotFound.PublicIpAddressPool	The specified resource ofPublicIpAddressPool [%s] is not found.
400	QuotaExceeded.PoolIpQuantity	The quota of PoolIpQuantity is exceeded.	The number of IP addresses in the pool has reached the upper limit.
400	OperationDenied.OperateSharedResource	The operation is not allowed because of the PublicIpAddressPool is a shared resource.	The public IP address pool is a shared resource and cannot be modified.
400	MissingParam.CidrBlockOrCidrMask	CidrBlock or CidrMask is not specified.	The system failed to add the CIDR block to the address pool because the CIDR block or the subnet mask is not specified.
400	DuplicatedParam.CidrBlockAndCidrMask	CidrBlock and CidrMask cannot be specified at the same time.	The system failed to add the CIDR block to the address pool because you cannot specify the CIDR block and the subnet mask at the same time.
400	Forbidden.FinancialLocked	The instance is locked due to outstanding payments.	The instance has overdue payments.
400	ResourceNotEnough.CidrBlock	The specified resource is not enough.	The specified resource is not enough.
400	MissingParam.PublicIpAddressPoolId	The parameter PublicIpAddressPoolId is missing.	The parameter PublicIpAddressPoolId is missing.
400	OperationFailed.ResourceNotEnough	Insufficient resources.	The resources that you request are insufficient. If you still want to request the resources, submit a ticket.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.