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

Cria um bloco CIDR reservado personalizado a partir de um pool IPAM.

Descrição da operação

Antes de criar um bloco CIDR reservado personalizado, certifique-se de ter criado um pool IPAM e adicionado um bloco CIDR a ele. Você pode chamar a operação CreateIpamPool para criar um pool IPAM e a operação AddIpamPoolCidr para adicionar um bloco CIDR ao pool.
Ao especificar o parâmetro Cidr ou CidrMask para criar um bloco CIDR reservado personalizado, a máscara deve estar dentro do intervalo especificado para o pool IPAM.
Se um pool IPAM tiver um atributo de região, a solicitação para criar um bloco CIDR reservado personalizado deve ser iniciada a partir da região onde o pool está localizado.
O bloco CIDR reservado personalizado não deve entrar em conflito com as alocações de blocos CIDR existentes no pool IPAM.

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 onde você deseja criar o bloco CIDR reservado personalizado. Você pode chamar DescribeRegions para obter o ID da região.	cn-hangzhou
IpamPoolId	string	Sim	O ID do pool IPAM.	ipam-pool-6rcq3tobayc20t****
Cidr	string	Não	O bloco CIDR a ser alocado a partir do pool IPAM. Nota Você deve especificar o parâmetro Cidr ou CidrMask.	192.168.1.0/24
CidrMask	integer	Não	A máscara do bloco CIDR a ser alocado a partir do pool IPAM. Nota Você deve especificar o parâmetro Cidr ou CidrMask.	24
DryRun	boolean	Não	Especifica se deve ser realizado um dry run. Valores válidos: true: Envia uma solicitação de verificação. O bloco CIDR reservado personalizado não é criado. O sistema verifica os parâmetros obrigatórios, o formato da solicitação e os limites do serviço. Se a verificação falhar, um erro será retornado. Se a verificação for bem-sucedida, o código de erro DryRunOperation será retornado. false (padrão): Envia uma solicitação normal. Após a solicitação passar na verificação, um código de status HTTP 2xx é retornado e o bloco CIDR reservado personalizado é criado.	false
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Gere um valor em seu cliente para garantir que o valor 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 RequestId da solicitação como ClientToken. O RequestId pode ser diferente para cada solicitação.	123e4567-e89b-12d3-a456-426655440000
IpamPoolAllocationDescription	string	Não	A descrição do bloco CIDR reservado personalizado. A descrição deve ter de 1 a 256 caracteres. Deve começar com uma letra ou um caractere chinês e não pode começar com `http://` ou `https://`. O valor padrão é uma string vazia.	test description
IpamPoolAllocationName	string	Não	O nome do bloco CIDR reservado personalizado. O nome deve ter de 1 a 128 caracteres e não pode começar com `http://` ou `https://`.	test name

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação.	CE9CDAE5-341E-5D0B-AC8A-2BAC707D3EB2
IpamPoolAllocationId	string	O ID do bloco CIDR reservado personalizado.	ipam-pool-alloc-112za33e4****
Cidr	string	O bloco CIDR alocado.	192.168.1.0/24
SourceCidr	string	O bloco CIDR de origem.	192.168.0.0/16

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "CE9CDAE5-341E-5D0B-AC8A-2BAC707D3EB2",
  "IpamPoolAllocationId": "ipam-pool-alloc-112za33e4****",
  "Cidr": "192.168.1.0/24",
  "SourceCidr": "192.168.0.0/16"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	OperationDenied.ResourceTypeIsNotCustom	The operation is not allowed because the resource type is not Custom.	The operation is not allowed because the resource type is not Custom.
400	MissingParam.CidrOrCidrMask	The CIDR or CIDR Mask must be input.	The CIDR or CIDR Mask must be input.
400	OperationDenied.IpamPoolNotInRegion	The operation is not allowed because the IPAM pool not in specific region does not support creating VPC or associating CIDR for VPC.	The operation is not allowed because the IPAM pool not in specific region does not support creating VPC or associating CIDR for VPC.
400	OperationDenied.RequestRegionInvalid	The operation is not allowed because the request is not invoked in the region of the IPAM pool.	The operation is not called in the region of the pool.
400	IllegalParam.Cidr	The specified CIDR is illegal.	The CIDR block is invalid.
400	IllegalParam.CidrMask	The specified CidrMask is illegal.	Invalid CidrMask.
400	DryRunOperation	Request validation has been passed with DryRun flag set.
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.CidrInExcludeCidrs	The operation is not allowed because the input CIDR is within the illegal CIDRs.	The operation is not allowed because the input CIDR is within the illegal 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.CidrMaskTooLarge	The operation is denied because the CIDR mask %s is larger than the allocationMaxNetmask %s of the pool.	The operation is denied because the CIDR mask %s is larger than the allocationMaxNetmask %s of the pool.
400	OperationDenied.CidrMaskTooSmall	The operation is denied because the CIDR mask %s is less than the allocationMinNetmask %s of the pool.	The operation is denied because the CIDR mask %s is less than the allocationMinNetmask %s of the pool.
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.