AddIpamPoolCidr - Virtual Private Cloud: Central de Documentação do Alibaba Cloud

Provisiona um bloco CIDR para um pool IPAM.

Descrição da operação

Antes de provisionar um bloco CIDR, certifique-se de que você criou um pool IPAM. Você pode chamar CreateIpamPool para criar um pool IPAM.
Se o pool pai não tiver um bloco CIDR provisionado, o subpool não suportará o provisionamento de blocos CIDR.
Se o pool pai tiver um bloco CIDR provisionado, o subpool poderá ter um bloco CIDR provisionado, e o bloco CIDR provisionado deverá ser um subconjunto do bloco CIDR provisionado do pool pai.
Se o pool pai tiver um bloco CIDR provisionado e também tiver alocações de CIDR, o bloco CIDR provisionado para o subpool não deverá entrar em conflito com as alocações de CIDR existentes.
A solicitação para provisionar um bloco CIDR para um pool IPAM deve ser iniciada a partir da região hospedada do IPAM.
O bloco CIDR provisionado para um pool IPAM não deve entrar em conflito com blocos CIDR provisionados para outros pools dentro do mesmo escopo.
O número de blocos CIDR que podem ser provisionados para um pool é limitado. O máximo padrão para um pool de nível superior IPv6 público é 1. O máximo padrão para outros tipos de pools é 50.

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
RegionId	string	Sim	O ID da região hospedada do IPAM. Você pode chamar DescribeRegions para obter o ID da região.	cn-hangzhou
IpamPoolId	string	Sim	O ID da instância do pool IPAM.	ipam-pool-6rcq3tobayc20t****
Cidr	string	Não	O bloco CIDR a ser provisionado. null Pools de nível superior privados suportam provisionamento apenas pela especificação de um bloco CIDR.	192.168.1.0/24
NetmaskLength	integer	Não	Provisiona um bloco CIDR especificando um comprimento de máscara de rede. null Pools de nível superior IPv6 públicos suportam provisionamento apenas pela especificação de um comprimento de máscara de rede.	24
DryRun	boolean	Não	Especifica se deve ser realizada uma simulação. Valores válidos: true: realiza uma simulação sem provisionar um bloco CIDR para o pool IPAM. O sistema verifica os parâmetros obrigatórios, o formato da solicitação e os limites de negócio. Se a verificação falhar, o erro correspondente será retornado. Se a verificação for bem-sucedida, o código de erro DryRunOperation será retornado. false (padrão): envia a solicitação. Após a verificação ser bem-sucedida, um código de status HTTP 2xx será retornado e a operação será realizada.	false
ClientToken	string	Não	O token do cliente usado para garantir a idempotência da solicitação. Um valor gerado pelo cliente que é único entre diferentes solicitações. O ClientToken suporta apenas caracteres ASCII. null Se você não especificar este parâmetro, o sistema usará o RequestId da solicitação da API como ClientToken. O RequestId é diferente para cada solicitação de API.	123e4567-e89b-12d3-a456-426655440000

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	BaseResult
RequestId	string	O ID da solicitação.	558BC336-8B88-53B0-B4AD-980EE900AB01
Cidr	string	O bloco CIDR que foi provisionado com sucesso para o pool IPAM.	192.168.1.0/24

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "558BC336-8B88-53B0-B4AD-980EE900AB01",
  "Cidr": "192.168.1.0/24"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	IllegalParam.IpVersion	The specified IpVersion is illegal.	Invalid IpVersion.
400	UnsupportedFeature.PublicIpamScopeType	The feature of PublicIpamScopeType is not supported.	The IPAM you specified does not support the creation of public scope.
400	IllegalParam.IpamPool	The specified IPAM pool cannot be empty.	The IPAM pool cannot be empty.
400	OperationDenied.PoolRegionNotSupportAddPoolCidr	The operation is not allowed because pool region does not support adding CIDR.	The operation was not allowed because the operation to add CIDR could not be performed in the region.
400	OperationDenied.CidrConflictWithTopCidrs	The operation is not allowed because the input CIDR conflicts with existing top CIDRs.	The operation is not allowed because the input CIDR conflicts with existing top CIDRs.
400	OperationDenied.SourceCidrIsNull	The operation is not allowed because the source CIDR is null.	The parent pool does not have a CIDR block.
400	OperationDenied.CidrNotInSourceCidr	The operation is not allowed because the input CIDR is not in source CIDR.	The specified CIDR block does not fall within the CIDR range of the parent pool.
400	ResourceNotFound.SourceIpamPool	The dependent source IPAM pool is not found.	The dependent resource source IPAM Pool does not exist.
400	OperationDenied.CidrConflictWithExistAllocation	The operation is not allowed because the input CIDR conflicts with the existing allocation.	The specified CIDR block conflicts with an existing CIDR block.
400	DryRunOperation	Request validation has been passed with DryRun flag set.
400	IllegalParam.Cidr	The specified CIDR is illegal.	The CIDR block is invalid.
400	QuotaExceeded.IpamCidrQuotaPerIpamPool	The quota of ipamCidrQuotaPerIpamPool count is exceeded.	The number of CIDR blocks in the IPAM pool exceeds the upper limit.
400	OperationDenied.OperateShareResource	The operation is not allowed because the instance is a shared resource.	The operation is not allowed because the instance is a shared resource.
400	IncorrectStatus.IpamPool	The status of the IPAM pool is incorrect.	The status of the IPAM pool is incorrect.
400	MissingParam.CidrOrNetmaskLength	The Cidr or NetmaskLength must be input.	The Cidr or NetmaskLength must be input.
400	Mismatch.CidrAndPoolIpVersion	The ip verion of input Cidr is inconsistent with that of the input IPAM pool.	The ip verion of input Cidr is inconsistent with that of the input IPAM pool.
400	Mismatch.CidrAndNetmaskLength	The mask of the input Cidr is inconsistent with the input NetmaskLength.	The mask of the input Cidr is inconsistent with the input NetmaskLength.
400	MissingParam.Cidr	The Cidr must be input when adding CIDR for IPAM private top pool.	The Cidr must be input when adding CIDR for IPAM private top pool.
400	UnsupportedFeature.AddCidrForIpamPrivateIpv6Pool	Adding CIDR for IPAM private IPv6 pool is not supported for this user.	Adding CIDR for IPAM private IPv6 pool is not supported for this user.
400	UnsupportedFeature.AddUlaCidrForIpamPublicIpv6Pool	Adding ULA CIDR for IPAM public IPv6 pool is not supported.	Adding ULA CIDR for IPAM public IPv6 pool is not supported.
400	IllegalParam.NetmaskLength	The specified NetmaskLength is illegal.	The specified NetmaskLength is illegal.
400	OperationDenied.CidrConflictWithOfficialGuaCidrs	The operation is not allowed because the input CIDR conflicts with official GUA CIDRs.	The operation is not allowed because the input CIDR conflicts with official GUA CIDRs.
400	OperationDenied.CidrUnavailableInPool	The operation is not allowed because the CIDR is unavailable in the IPAM pool.	The operation is not allowed because the CIDR is unavailable in the IPAM pool.
400	OperationDenied.AvailableCidrInsufficient	The operation is not allowed because available CIDR is insufficient.	The operation is not allowed because available CIDR is insufficient.
400	OperationDenied.OfficialCidrInsufficient	The operation is not allowed because the official CIDR is insufficient.	The operation is not allowed because the official CIDR is insufficient.
400	OperationDenied.OfficialCidrUnavailable	The operation is not allowed because the official CIDR is unavailable.	The operation is not allowed because the official CIDR is unavailable.
400	OperationDenied.OfficialCidrTmpUnavailable	The operation is not allowed because the official CIDR is temporarily unavailable.	The operation is not allowed because the official CIDR is temporarily unavailable.
400	UnsupportedFeature.AddUlaCidrForIpamPrivateIpv6Pool	Adding ULA CIDR for IPAM private IPv6 pool is not supported for this user.
400	UnsupportedFeature.AddByoipCidrForIpamPrivateIpv6Pool	Adding BYOIP CIDR for IPAM private IPv6 pool is not supported for this user.
400	OperationDenied.CidrMaskTooSmall	The operation is not allowed because the CIDR mask length %s is smaller than the minimum allowed %s.	The CIDR mask length %s is smaller than the minimum allowed value %s.
400	OperationDenied.CidrMaskTooLarge	The operation is not allowed because the CIDR mask length %s is larger than the maximum allowed %s.	The CIDR mask length %s is larger than the maximum allowed value %s.
404	ResourceNotFound.IpamPool	The dependent IPAM pool is not found.	The IPAM pool does not exist.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.