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

Cria um pool IPAM.

Descrição da operação

Por padrão, você pode criar no máximo um pool público de nível superior IPv6 para cada tipo de ISP em cada região.

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

create

*IpamPool.

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região hospedada para o IPAM. Você pode chamar a operação DescribeRegions para consultar os IDs das regiões.	cn-hangzhou
IpamScopeId	string	Sim	O ID da instância do escopo IPAM.	ipam-scope-glfmcyldpm8lsy****
IpamPoolName	string	Não	O nome do pool 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 IPAM. A descrição deve ter de 1 a 256 caracteres e deve começar com uma letra ou um caractere chinês. Não pode começar com `http://` ou `https://`. Se você não especificar este parâmetro, a descrição ficará vazia. O valor padrão é vazio.	test description
ResourceGroupId	string	Não	O ID do grupo de recursos ao qual o pool IPAM pertence.	rg-acfmxazb4ph6aiy****
PoolRegionId	string	Não	A região onde o pool IPAM entra em vigor.	cn-hangzhou
SourceIpamPoolId	string	Não	O ID da instância do pool IPAM de origem. Nota Se você não especificar este parâmetro, o pool a ser criado será um pool pai.	ipam-pool-6rcq3tobayc20t****
AllocationDefaultCidrMask	integer	Não	A máscara de rede padrão a ser alocada a partir do pool IPAM. Nota Valores válidos para uma máscara de rede IPv4: 0 a 32. Valores válidos para uma máscara de rede IPv6: 0 a 128.	28
AllocationMaxCidrMask	integer	Não	A máscara de rede máxima a ser alocada a partir do pool IPAM. Nota Valores válidos para uma máscara de rede IPv4: 0 a 32. Valores válidos para uma máscara de rede IPv6: 0 a 128.	32
AllocationMinCidrMask	integer	Não	A máscara de rede mínima a ser alocada a partir do pool IPAM. Nota Valores válidos para uma máscara de rede IPv4: 0 a 32. Valores válidos para uma máscara de rede IPv6: 0 a 128.	8
DryRun	boolean	Não	Especifica se deve ser realizada apenas uma pré-verificação da solicitação. Valores válidos: true: realiza a pré-verificação da solicitação sem criar o pool IPAM. O sistema verifica se os parâmetros obrigatórios foram especificados, o formato da solicitação e o status da instância. Se a solicitação falhar na pré-verificação, uma mensagem de erro será retornada. Se a solicitação passar na pré-verificação, o código de erro DryRunOperation será retornado. false (padrão): envia a solicitação. Se a solicitação passar na pré-verificação, um código de status HTTP 2xx será retornado e a operação será executada.	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 valor, mas deve garantir que o valor seja exclusivo entre diferentes solicitações. O token de cliente pode conter 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 token de cliente. O RequestId de cada solicitação de API é exclusivo.	123e4567-e89b-12d3-a456-426655440000
IpVersion	string	Não	A versão do IP. Valores válidos: IPv4: IPv4. IPv6: IPv6.	IPv4
Ipv6Isp	string	Não	O tipo de ISP do bloco CIDR IPv6. Este parâmetro entra em vigor apenas para pools 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). Nota Se você for adicionado à lista de permissões para largura de banda de linha única, poderá definir este parâmetro como ChinaTelecom, ChinaUnicom ou ChinaMobile.	BGP
AutoImport	boolean	Não	Especifica se o recurso de importação automática deve ser ativado para o pool.	true
Tag	array<object>	Não	As tags.
	object	Não	As tags.
Key	string	Não	A chave da tag do recurso. Você pode especificar até 20 chaves de tag. A chave da tag não pode ser uma string vazia. A chave da tag pode ter até 64 caracteres e deve começar com uma letra ou um 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://`. Nota 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. Você pode especificar até 20 valores de tag. O valor da tag pode ser uma string vazia. O valor da tag pode ter até 128 caracteres e não pode conter `http://` ou `https://`. Nota 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 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.	O escopo do IPAM especificado não existe.
400	ResourceNotFound.SourceIpamPool	The dependent source IPAM pool is not found.	O pool de origem IPAM dependente não existe.
400	UnsupportedFeature.PublicIpamScopeType	The feature of PublicIpamScopeType is not supported.	Atualmente, o IPAM especificado não oferece suporte à criação de escopos públicos.
400	IllegalParam.AllocationDefaultNetmask	The specified AllocationDefaultNetmask is illegal.	O parâmetro AllocationDefaultNetmask é inválido.
400	IllegalParam.AllocationMaxNetmask	The specified AllocationMaxNetmask is illegal.	O parâmetro AllocationMaxNetmask é inválido.
400	IllegalParam.AllocationMinNetmask	The specified AllocationMinNetmask is illegal.	O parâmetro AllocationMinNetmask é inválido.
400	IllegalParam.IpVersion	The specified IpVersion is illegal.	O parâmetro IpVersion é inválido.
400	QuotaExceeded.IpamPoolQuotaDepth	The quota of IpamPoolQuotaDepth count is exceeded.	A profundidade máxima permitida para pools do IPAM foi excedida.
400	ResourceNotFound.Ipam	The specified resource of ipam is not found.	O IPAM especificado não existe.
400	IllegalParam.PoolRegionId	The specified PoolRegionId is illegal.	O parâmetro PoolRegionId é inválido.
400	QuotaExceeded.IpamSubPoolQuotaPerIpamPool	The quota of ipamSubPoolQuotaPerIpamPool count is exceeded.	O número de subpools que podem ser criados em um único pool do IPAM excede a cota.
400	DryRunOperation	Request validation has been passed with DryRun flag set.	A validação DryRun foi aprovada.
400	IncorrectStatus.IpamPool	The status of the IPAM pool is incorrect.	O status do pool de endereços do IPAM está incorreto.
400	OperationDenied.OperateShareResource	The operation is not allowed because the instance is a shared resource.	Esta instância é um recurso compartilhado. Você não pode realizar esta operação.
400	UnsupportedFeature.IpamPublicIpv4Pool	The feature of public IPv4 pool is not supported in IPAM.	Atualmente, o IPAM não oferece suporte à criação de pools de endereços IPv4 públicos.
400	OperationDenied.IpamPublicIpv6PoolNeedPoolRegion	The public IPv6 pool cannot be created in IPAM when its pool region is empty.	Não há suporte para a criação de um pool de endereços IPv6 público com uma região efetiva vazia.
400	IllegalParam.Ipv6Isp	The specified Ipv6Isp is illegal.	O parâmetro Ipv6Isp especificado é inválido.
400	UnsupportedFeature.Ipv6Isp	The Ipv6Isp feature is not supported.	O recurso Ipv6Isp especificado não é suportado.
400	UnsupportedRegion.Ipv6Isp	The current region does not support this feature.	Este recurso não é suportado na região atual.
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.	Para o tipo de ISP atual, o número de pools do IPAM de nível superior para IPv6 público criados na região atual excede a cota.
400	Mismatch.IpamScopeAndSourceIpamPool	The input source IPAM pool is not in the input IPAM scope.	O pool pai do IPAM especificado não está dentro do escopo do IPAM especificado.
400	Mismatch.Ipv6IspAndSourceIpamPool	The input Ipv6Isp is inconsistent with the Ipv6Isp of the input source IPAM pool.	O Ipv6Isp especificado é inconsistente com o Ipv6Isp do pool pai.
400	UnsupportedFeature.IpamIpv6	The feature of IPv6 is not supported in this region.	O recurso IPv6 no IPAM não é suportado nesta região.
400	Mismatch.ChildIpVersionAndParentIpVersion	The ChildIpVersion and ParentIpVersion are mismatched.	A versão IP do subpool não corresponde à versão IP do pool pai.
400	Mismatch.ChildPoolRegionAndParentPoolRegion	The ChildPoolRegion and ParentPoolRegion are mismatched.	A região efetiva do subpool não corresponde à região efetiva do pool pai.
400	Mismatch.ChildIpamScopeAndParentIpamScope	The ChildIpamScope and ParentIpamScope are mismatched.	O ScopeId do subpool não corresponde ao ScopeId do pool pai.
400	Mismatch.ChildIpv6IspAndParentIpv6Isp	The ChildIpv6Isp and ParentIpv6Isp are mismatched.	O ISP IPv6 do subpool não corresponde ao ISP IPv6 do pool pai.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.