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

Adiciona um bloco CIDR secundário a uma VPC.

Descrição da operação

O número máximo de blocos CIDR secundários que podem ser adicionados a uma VPC é o seguinte:
- No máximo 5 blocos CIDR IPv4 secundários podem ser adicionados a uma VPC.
- No máximo 5 blocos CIDR IPv6 secundários podem ser adicionados a uma VPC.
A operação AssociateVpcCidrBlock não suporta a adição simultânea de blocos CIDR secundários à mesma VPC.

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

create

*VPC.

acs:vpc:{#regionId}:{#accountId}:vpc/{#VpcId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região da VPC à qual você deseja adicionar um bloco CIDR secundário. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.	ch-hangzhou
VpcId	string	Sim	O ID da VPC à qual você deseja adicionar um bloco CIDR secundário.	vpc-o6wrloqsdqc9io3mg****
SecondaryCidrBlock	string	Não	O bloco CIDR IPv4 secundário a ser adicionado. O bloco CIDR deve atender aos seguintes requisitos: Use endereços IPv4 privados especificados na RFC 1918 como o bloco CIDR IPv4 secundário da nuvem privada virtual (VPC). A máscara de sub-rede deve ter de 16 a 28 bits de comprimento. Exemplos: 10.0.0.0/16, 172.16.0.0/16 e 192.168.0.0/16. Você pode usar um bloco CIDR personalizado diferente de 100.64.0.0/10, 224.0.0.0/4, 127.0.0.0/8 ou 169.254.0.0/16 e suas sub-redes como o bloco CIDR IPv4 secundário da nuvem privada virtual (VPC). Limites de configuração: O bloco CIDR não pode começar com 0. A máscara de sub-rede deve ter de 16 a 28 bits de comprimento. O bloco CIDR secundário não pode se sobrepor ao bloco CIDR primário ou aos blocos CIDR secundários existentes da VPC. Nota Se você não usar um pool IPAM para adicionar um bloco CIDR secundário à VPC, deverá especificar o parâmetro SecondaryCidrBlock ou o parâmetro Ipv6CidrBlock, mas não ambos.	192.168.0.0/16
SecondaryCidrMask	integer	Não	A máscara de sub-rede usada para adicionar um bloco CIDR IPv4 secundário de um pool IPAM à VPC. Nota Ao usar um pool IPAM para adicionar um bloco CIDR IPv4 secundário à VPC, você deve especificar pelo menos um entre SecondaryCidrBlock ou SecondaryCidrMask.	16
IPv6CidrBlock	string	Não	O bloco CIDR IPv6 especificado da VPC. Nota Você não pode especificar SecondaryCidrBlock e Ipv6CidrBlock simultaneamente.	2408:XXXX:0:6a::/56
Ipv6Isp	string	Não	O tipo do bloco CIDR IPv6 da VPC. Valores válidos: BGP (padrão): BGP IPv6 do Alibaba Cloud. ChinaMobile: China Mobile (ISP único). ChinaUnicom: China Unicom (ISP único). ChinaTelecom: China Telecom (ISP único). Nota Se sua conta estiver incluída na lista de permissões de largura de banda de ISP único da China, você poderá definir este parâmetro como ChinaTelecom (China Telecom), ChinaUnicom (China Unicom) ou ChinaMobile (China Mobile).	BGP
IpVersion	string	Não	A versão do endereço IP. Valores válidos: IPV4: Endereço IPv4. IPV6: Endereço IPv6. Quando IpVersion está definido como IPV6 e SecondaryCidrBlock não é especificado, um bloco CIDR IPv6 secundário é adicionado à VPC.	IPV4
IpamPoolId	string	Não	O ID da instância do pool IPAM.	ipam-pool-sycmt3p2a9v63i****
Ipv6CidrMask	integer	Não	A máscara de sub-rede usada para adicionar um bloco CIDR IPv6 de um pool IPAM à VPC. Nota Ao usar um pool IPAM para adicionar um bloco CIDR IPv6 secundário à VPC, você deve especificar pelo menos um entre IPv6CidrBlock ou Ipv6CidrMask.	56

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O ID da solicitação.
RequestId	string	O ID da solicitação.	C1221A1F-2ACD-4592-8F27-474E02883159
CidrBlock	string	O bloco CIDR secundário adicionado à VPC.	192.168.0.0/16
IpVersion	string	A versão do endereço IP do bloco CIDR secundário.	IPV4

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "C1221A1F-2ACD-4592-8F27-474E02883159",
  "CidrBlock": "192.168.0.0/16",
  "IpVersion": "IPV4"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidVpc.NotFound	%s
400	IncorrectStatus.Vpc	%s
400	ParamExclusive.SecondaryCidrAndIpv6Cidr	%s
400	OperationUnsupported.VpcMultiCidr	%s
400	MissingParam.SecondaryCidrOrIpv6Cidr	%s
400	OperationUnsupported.IPv6ULA	%s
400	OperationFailed.Ipv6CidrBlockExisted	%s
400	InvalidIpv6ULACidrBlock.Malformed	%s
400	QuotaExceeded.GUAIpv6CidrBlock	%s
400	IllegalParam.Ipv6CidrType	%s
400	OperationUnsupported.OnlyULA	%s
400	InvalidCidrBlock.Malformed	Specified CIDR block is not valid.
400	IllegalParam.SecondaryCidrBlock	%s
400	Duplicated.SecondaryCidrBlock	%s
400	OperationFailed.ConflictWithEntry	%s
400	QuotaExceeded.VpcMultiCidr	%s
400	MissingParam.SecondaryCidrBlockOrIpv6CidrBlock	Either SecondaryCidrBlock or Ipv6CidrBlock must be specified.	O parâmetro obrigatório bloco CIDR secundário ou bloco CIDR IPv6 está ausente.
400	MissingParam.VpcId	You must specify VpcId.	O parâmetro obrigatório VpcId está ausente.
400	UnsupportedFeature.Ipv6Isp	The Ipv6Isp feature is not supported.	O recurso Ipv6Isp especificado não é suportado.
400	IllegalParam.IpVersion	%s
400	OperationDenied.GUAIpv6CidrBlock	The operation is not allowed because this ipv6 CIDR is not reserved.
400	OperationFailed.IPv6CidrNotReserved	Operation failed because this ipv6 cidr is not reserved.
400	InvalidCidrBlock	Specified CIDR block is already exists.
400	IllegalParam.IpamPool	The specified IPAM pool cannot be empty.	O pool IPAM não pode estar vazio.
400	MissingParam.SecondaryCidrMask	The parameter SecondaryCidrMask must be input.	O parâmetro SecondaryCidrMask é obrigatório.
400	IllegalParam.SecondaryCidrMask	The specified Secondary CIDR Mask is illegal.	O SecondaryCidrMask especificado é inválido.
400	OperationDenied.RequestRegionInvalid	The operation is not allowed because the request is not invoked in the region of the IPAM pool.	A operação foi rejeitada porque a solicitação não foi chamada na região onde o pool IPAM reside.
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.	A operação foi rejeitada porque não é possível criar uma VPC ou adicionar um bloco CIDR secundário a uma VPC a partir de um pool IPAM que não possui um atributo de região.
400	MissingParam.CidrOrCidrMask	The CIDR or CIDR Mask must be input.	Especifique o parâmetro Cidr ou CidrMask ao criar um recurso a partir de um pool IPAM.
400	OperationDenied.CidrInExcludeCidrs	The operation is not allowed because the input CIDR is within the illegal CIDRs.	A operação foi rejeitada porque o bloco CIDR especificado está dentro de um intervalo de bloco CIDR inválido.
400	OperationDenied.AvailableCidrInsufficient	The operation is not allowed because available CIDR is insufficient.	A operação foi rejeitada porque os recursos de bloco CIDR disponíveis são insuficientes.
400	UnsupportedFeature.Ipam	IPAM is not supported in this region.
400	UnsupportedFeature.VpcIpamIpv6	The specified IPAM pool does not support the IPv6 feature.	O pool IPAM especificado não suporta IPv6.
400	OperationDenied.CidrUnavailableInPool	The operation is not allowed because the CIDR is unavailable in the IPAM pool.	A operação foi rejeitada porque o bloco CIDR não está disponível no pool IPAM.
400	InvalidIpv6CidrBlock.Malformed	Param Ipv6CidrBlock is malformed.	O parâmetro do bloco CIDR IPv6 é inválido.
400	MissingParam.IpVersion	The parameter IpVersion is missing.	O parâmetro IpVersion está ausente.
400	Mismatch.IpVersionAndIpamPoolIpVersion	The input IpVersion is inconsistent with the IpVersion of the input IPAM pool.	O IpVersion especificado não corresponde ao IpVersion do pool de endereços especificado.
400	IllegalParam.Ipv6CidrBlock	The parameter of Ipv6CidrBlock is illegal.	O bloco CIDR IPv6 é inválido.
400	OperationFailed.Ipv6CidrBlockOverLapped	The input IPv6 CIDR block overlaps with the existing ones.	O bloco CIDR IPv6 especificado se sobrepõe a um bloco CIDR existente.
400	QuotaExceeded.IPv6CidrBlock	The number of IPv6 CIDR blocks in the VPC exceeds the limit.	O número de blocos CIDR IPv6 na VPC excedeu o limite.
400	OperationDenied.MaskOfCidrIsNotAllowed	The input mask or mask of the input CIDR is not allowed.	A máscara ou máscara de bloco CIDR especificada não está dentro do intervalo permitido.
400	IllegalParam.Ipv6Isp	The specified Ipv6Isp is illegal.	O parâmetro Ipv6Isp especificado é inválido.
400	IllegalParam.CidrMask	The input CIDR mask is illegal.	A máscara do bloco CIDR especificada é inválida.
400	OperationDenied.CidrMaskTooLarge	The operation is denied because the CIDR mask %s is larger than the allocationMaxNetmask %s of the pool.	A máscara do parâmetro Cidr ou do parâmetro CidrMask excede o comprimento máximo de máscara de rede especificado na regra de conformidade do pool IPAM.
500	OperationFailed.ResourceNotEnough	Insufficient resources.
403	Forbbiden	User not authorized to operate on the specified resource.	O EIP não pertence ao chamador atual. Verifique se você tem permissão para chamar este EIP.
404	ResourceNotFound.IpamPool	The dependent IPAM pool is not found.	O pool IPAM dependente não existe.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.