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

Cria um pool de endereços IPAM.

Descrição da operação

O número máximo padrão de pools de nível superior de IPv6 públicos por tipo de ISP por região é 1.

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 do IPAM. Você pode chamar a API DescribeRegions para obter o ID da região.	cn-hangzhou
IpamScopeId	string	Sim	O ID da instância do escopo do IPAM.	ipam-scope-glfmcyldpm8lsy****
IpamPoolName	string	Não	O nome do pool de endereços IPAM. O nome deve ter de 1 a 128 caracteres e não pode começar com `http://` ou `https://`.	abc
IpamPoolDescription	string	Não	A descrição do pool de endereços IPAM. A descrição deve ter de 1 a 256 caracteres e deve começar com uma letra maiúscula ou minúscula do alfabeto inglês ou um caractere chinês. Não pode começar com `http://` ou `https://`. Se este parâmetro não for especificado, a descrição ficará vazia por padrão.	test description
ResourceGroupId	string	Não	O ID do grupo de recursos do pool de endereços IPAM.	rg-acfmxazb4ph6aiy****
PoolRegionId	string	Não	A região onde o pool de endereços IPAM entra em vigor.	cn-hangzhou
SourceIpamPoolId	string	Não	O ID da instância do pool de endereços IPAM de origem. null Se este parâmetro não for especificado, o pool de endereços criado será um pool de endereços pai.	ipam-pool-6rcq3tobayc20t****
AllocationDefaultCidrMask	integer	Não	A máscara CIDR padrão para alocações do pool de endereços IPAM. null A máscara CIDR IPv4 varia de 0 a 32 bits. A máscara CIDR IPv6 varia de 0 a 128 bits.	28
AllocationMaxCidrMask	integer	Não	A máscara CIDR máxima para alocações do pool de endereços IPAM. null A máscara CIDR IPv4 varia de 0 a 32 bits. A máscara CIDR IPv6 varia de 0 a 128 bits.	32
AllocationMinCidrMask	integer	Não	A máscara CIDR mínima para alocações do pool de endereços IPAM. null A máscara CIDR IPv4 varia de 0 a 32 bits. A máscara CIDR IPv6 varia de 0 a 128 bits.	8
DryRun	boolean	Não	Especifica se deve ser realizado apenas 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 parâmetros obrigatórios ausentes, formato da solicitação e status da instância. Se a solicitação falhar no dry run, uma mensagem de erro será retornada. Se a solicitação passar no dry run, 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 diretamente.	false
ClientToken	string	Não	O token de cliente 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. null Se você não especificar este parâmetro, o sistema usará automaticamente o RequestId da solicitação de API como ClientToken. O RequestId pode ser diferente para cada solicitação de API.	123e4567-e89b-12d3-a456-426655440000
IpVersion	string	Não	A versão do protocolo de endereço IP. Valores válidos: IPv4: IPv4. IPv6: IPv6.	IPv4
Ipv6Isp	string	Não	O tipo de bloco CIDR IPv6. Este parâmetro entra em vigor apenas para pools de endereços IPv6 públicos. Valores válidos: BGP (padrão): Alibaba Cloud BGP IPv6. ChinaMobile: China Mobile (linha única). ChinaUnicom: China Unicom (linha única). ChinaTelecom: China Telecom (linha única). null Se você for um usuário que ativou a lista de permissões de largura de banda de linha única, este campo pode ser definido como ChinaTelecom (China Telecom), ChinaUnicom (China Unicom) ou ChinaMobile (China Mobile).	BGP
AutoImport	boolean	Não	Especifica se o recurso de importação automática deve ser ativado para o pool de endereços.	true
Tag	array<object>	Não	A lista de tags.
	object	Não	As informações da tag.
Key	string	Não	A chave da tag do recurso. Há suporte para no máximo 20 chaves de tag. Depois que este valor for especificado, ele não poderá ser uma string vazia. A chave da tag pode ter até 64 caracteres e deve começar com uma letra ou caractere chinês. Pode conter dígitos, pontos (.), sublinhados (_) e hifens (-). Não pode começar com `aliyun` ou `acs:` e não pode conter `http://` ou `https://`. null Você deve especificar pelo menos um dos parâmetros ResourceId.N e Tag.N (Tag.N.Key e Tag.N.Value).	FinanceDept
Value	string	Não	O valor da tag do recurso. Há suporte para no máximo 20 valores de tag. Depois que este valor for especificado, ele poderá ser uma string vazia. O valor da tag pode ter até 128 caracteres e não pode conter `http://` ou `https://`. null Você deve especificar pelo menos um dos parâmetros ResourceId.N e Tag.N (Tag.N.Key e Tag.N.Value).	FinanceJoshua

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	As informações retornadas.
RequestId	string	O ID da solicitação.	BB2C39DE-CEB8-595A-981A-F2EFCBE7324E
IpamPoolId	string	O ID da instância do pool de endereços IPAM.	ipam-pool-6rcq3tobayc20t****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "BB2C39DE-CEB8-595A-981A-F2EFCBE7324E",
  "IpamPoolId": "ipam-pool-6rcq3tobayc20t****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	ResourceNotFound.IpamScope	The specified resource of IPAM scope is not found.	The input IPAM scope does not exist.
400	ResourceNotFound.SourceIpamPool	The dependent source IPAM pool is not found.	The dependent resource source IPAM Pool does not exist.
400	UnsupportedFeature.PublicIpamScopeType	The feature of PublicIpamScopeType is not supported.	The IPAM you specified does not support the creation of public scope.
400	IllegalParam.AllocationDefaultNetmask	The specified AllocationDefaultNetmask is illegal.	AllocationDefaultNetmask parameter is illegal.
400	IllegalParam.AllocationMaxNetmask	The specified AllocationMaxNetmask is illegal.	AllocationMaxNetmask parameter is illegal.
400	IllegalParam.AllocationMinNetmask	The specified AllocationMinNetmask is illegal.	AllocationMinNetmask parameter is illegal.
400	IllegalParam.IpVersion	The specified IpVersion is illegal.	Invalid IpVersion.
400	QuotaExceeded.IpamPoolQuotaDepth	The quota of IpamPoolQuotaDepth count is exceeded.	Maximum number of IPAM address pool depth allowed exceeds limit
400	ResourceNotFound.Ipam	The specified resource of ipam is not found.	The IPAM entered does not exist.
400	IllegalParam.PoolRegionId	The specified PoolRegionId is illegal.	PoolRegionId parameter is illegal.
400	QuotaExceeded.IpamSubPoolQuotaPerIpamPool	The quota of ipamSubPoolQuotaPerIpamPool count is exceeded.	The number of sub-pools for the IPAM pool exceeds the limit.
400	DryRunOperation	Request validation has been passed with DryRun flag set.
400	IncorrectStatus.IpamPool	The status of the IPAM pool is incorrect.	The status of the IPAM pool is incorrect.
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	UnsupportedFeature.IpamPublicIpv4Pool	The feature of public IPv4 pool is not supported in IPAM.	The feature of public IPv4 pool is not supported in IPAM.
400	OperationDenied.IpamPublicIpv6PoolNeedPoolRegion	The public IPv6 pool cannot be created in IPAM when its pool region is empty.	The public IPv6 pool cannot be created in IPAM when its pool region is empty.
400	IllegalParam.Ipv6Isp	The specified Ipv6Isp is illegal.	The specified Ipv6Isp is illegal.
400	UnsupportedFeature.Ipv6Isp	The Ipv6Isp feature is not supported.	The Ipv6Isp feature is not supported.
400	UnsupportedRegion.Ipv6Isp	The current region does not support this feature.	The current region does not support this feature.
400	QuotaExceeded.IpamPublicIpv6TopPoolQuotaPerRegionIsp	The number of public IPv6 top pool in IPAM for this ISP owned by the user in this region exceeds the limit.	The number of public IPv6 top pool in IPAM for this ISP owned by the user in this region exceeds the limit.
400	Mismatch.IpamScopeAndSourceIpamPool	The input source IPAM pool is not in the input IPAM scope.	The input source IPAM pool is not in the input IPAM scope.
400	Mismatch.Ipv6IspAndSourceIpamPool	The input Ipv6Isp is inconsistent with the Ipv6Isp of the input source IPAM pool.	The input Ipv6Isp is inconsistent with the Ipv6Isp of the input source IPAM pool.
400	UnsupportedFeature.IpamIpv6	The feature of IPv6 is not supported in this region.	The feature of IPv6 is not supported in this region.
400	Mismatch.ChildIpVersionAndParentIpVersion	The ChildIpVersion and ParentIpVersion are mismatched.	The ChildIpVersion and ParentIpVersion are mismatched.
400	Mismatch.ChildPoolRegionAndParentPoolRegion	The ChildPoolRegion and ParentPoolRegion are mismatched.	The ChildPoolRegion and ParentPoolRegion are mismatched.
400	Mismatch.ChildIpamScopeAndParentIpamScope	The ChildIpamScope and ParentIpamScope are mismatched.	The ChildIpamScope and ParentIpamScope are mismatched.
400	Mismatch.ChildIpv6IspAndParentIpv6Isp	The ChildIpv6Isp and ParentIpv6Isp are mismatched.	The ChildIpv6Isp and ParentIpv6Isp are mismatched.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.