Todos os produtos
Search
Central de documentação

:AssociateVpcCidrBlock

Última atualização: Jul 03, 2026

Adiciona blocos CIDR secundários a uma Virtual Private Cloud (VPC).

Observações de uso

  • Os limites para adição de blocos CIDR secundários são:

    • É possível adicionar até cinco blocos CIDR IPv4 secundários por VPC.

    • É possível adicionar até três blocos CIDR IPv6 secundários por VPC.

  • Não chame a operação AssociateVpcCidrBlock repetidamente em um curto período.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer, que gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros da solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
RegionId String Sim ch-hangzhou

ID da região da VPC à qual você deseja adicionar um bloco CIDR secundário.

Chame a operação DescribeRegions para consultar a lista mais recente de regiões.

VpcId String Sim vpc-o6wrloqsdqc9io3mg****

ID da VPC.

SecondaryCidrBlock String Não 192.168.0.0/16

Bloco CIDR IPv4 secundário. Observe os seguintes requisitos:

  • Especifique um dos seguintes blocos CIDR IPv4 padrão ou suas sub-redes como bloco CIDR IPv4 secundário: 192.168.0.0/16, 172.16.0.0/12 e 10.0.0.0/8.
  • Também é possível usar um bloco CIDR personalizado, exceto 100.64.0.0/10, 224.0.0.0/4, 127.0.0.0/8, 169.254.0.0/16 ou suas sub-redes, como bloco CIDR IPv4 secundário da VPC.

Além disso, atenda aos seguintes requisitos:

  • O bloco CIDR não pode começar com 0. A máscara de sub-rede deve ter entre 8 e 28 bits.
  • O bloco CIDR secundário não pode se sobrepor ao bloco CIDR primário ou a um bloco CIDR secundário existente.
Nota Especifique SecondaryCidrBlock ou Ipv6CidrBlock.
IPv6CidrBlock String Não 2408:XXXX:0:6a::/56

Bloco CIDR IPv6.

Nota Especifique SecondaryCidrBlock ou Ipv6CidrBlock.
Ipv6Isp String Não BGP

Tipo do bloco CIDR IPv6. Valores válidos:

  • BGP (padrão): IPv6 BGP (Border Gateway Protocol) da Alibaba Cloud
  • ChinaMobile: China Mobile (linha única)
  • ChinaUnicom: China Unicom (linha única)
  • ChinaTelecom: China Telecom (linha única)
Nota Se sua conta Alibaba Cloud tiver permissão para usar largura de banda de ISP único, os valores válidos são: ChinaTelecom, ChinaUnicom e ChinaMobile.
IpVersion String Não IPV4

Versão do IP. Valores válidos:

  • IPV4
  • IPV6: IPv6. Se você definir IpVersion como IPV6 sem especificar SecondaryCidrBlock, será possível adicionar blocos CIDR IPv6 à VPC.
IpamPoolId String Não ipam-pool-wxfq2iawjyfizg****

ID do pool de endereços do IP Address Management (IPAM).

Action String Sim AssociateVpcCidrBlock

Operação a ser executada. Defina o valor como AssociateVpcCidrBlock.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

C1221A1F-2ACD-4592-8F27-474E02883159

ID da solicitação.

Exemplos

Solicitações de exemplo

http(s)://[Endpoint]/?RegionId=ch-hangzhou
&VpcId=vpc-o6wrloqsdqc9io3mg****
&SecondaryCidrBlock=192.168.0.0/16
&IPv6CidrBlock=2408:XXXX:0:6a::/56
&Ipv6Isp=BGP
&IpVersion=IPV4
&IpamPoolId=ipam-pool-wxfq2iawjyfizg****
&Action=AssociateVpcCidrBlock
&Common request parameters

Respostas de sucesso de exemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<AssociateVpcCidrBlockResponse>
    <RequestId>C1221A1F-2ACD-4592-8F27-474E02883159</RequestId>
</AssociateVpcCidrBlockResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "C1221A1F-2ACD-4592-8F27-474E02883159"
}

Códigos de erro

HttpCode

Código de erro

Mensagem de erro

Descrição

400

InvalidCidrBlock.Malformed

Specified CIDR block is not valid.

O formato do bloco CIDR especificado é inválido.

400

MissingParam.SecondaryCidrBlockOrIpv6CidrBlock

Either SecondaryCidrBlock or Ipv6CidrBlock must be specified.

O bloco CIDR secundário ou o bloco CIDR IPv6 não foi especificado.

400

MissingParam.VpcId

You must specify VpcId.

VpcId não foi especificado.

403

Forbbiden

User not authorized to operate on the specified resource.

Você não tem autorização para executar esta operação no recurso especificado. Solicite as permissões necessárias e tente novamente.

500

OperationFailed.ResourceNotEnough

Insufficient resources.

Os recursos solicitados são insuficientes. Caso ainda precise desses recursos, envie um ticket.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.