Todos os produtos
Search
Central de documentação

:CreateDefaultVpc

Última atualização: Jul 03, 2026

Cria uma virtual private cloud (VPC) padrão.

Observações de uso

Ao chamar esta operação, observe os seguintes limites:

  • Após criar uma VPC padrão, não é possível alterar o bloco CIDR dela. No entanto, você pode adicionar blocos CIDR IPv4 secundários.

  • Em cada VPC padrão, os serviços em nuvem podem usar no máximo 60.000 endereços IP privados. Não é possível aumentar essa cota.

  • A criação de uma VPC padrão gera automaticamente um vRouter e uma tabela de rotas para a VPC.

  • É possível adicionar até três blocos CIDR de usuário a uma VPC. Se um bloco CIDR de usuário incluir outro, prevalece aquele com a máscara de sub-rede mais curta. Por exemplo, se 10.0.0.0/8 e 10.1.0.0/16 forem especificados, apenas 10.0.0.0/8 terá efeito.

  • CreateDefaultVpcé uma operação assíncrona. Após o envio da solicitação, o sistema retorna um ID de solicitação e executa a tarefa em segundo plano. Chame a operação DescribeVpcAttribute para consultar o status de uma VPC padrão:

    • Se a VPC padrão estiver no estado Pending, ela está sendo configurada.

    • Se a VPC padrão estiver no estado Available, ela está disponível para uso.

  • Não chame a operação CreateDefaultVpc repetidamente dentro de um curto período.

  • Crie apenas uma VPC padrão por região.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parameter Type Required Example Description
RegionId String Yes cn-hangzhou

ID da região à qual a VPC padrão pertence.

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

Ipv6CidrBlock String No 2408:XXXX:346:b600::/56

Bloco CIDR IPv6 da VPC padrão.

Nota Este parâmetro é obrigatório se você definir EnableIpv6 como true.
EnableIpv6 Boolean No false

Define se o IPv6 deve ser ativado. Valores válidos:

  • false (padrão): não
  • true: sim
ResourceGroupId String No rg-acfmystnjq4****

ID do grupo de recursos.

Action String Yes CreateDefaultVpc

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

ClientToken String No 123e4567-e89b-12d3-a456-426655440000

Token do cliente usado para garantir a idempotência da solicitação.

Use o cliente para gerar o token, mas certifique-se de que ele seja exclusivo entre diferentes solicitações. O token pode conter apenas caracteres ASCII.

Nota Se você não definir este parâmetro, ClientToken assumirá o valor de RequestId. O valor de RequestId pode variar para cada solicitação de API.

Parâmetros de resposta

Parameter

Type

Example

Description

VpcId

String

vpc-bp15zckdt37pq72zv****

ID da VPC padrão.

VRouterId

String

vrt-bp1lhl0taikrteen8****

ID do vRouter criado automaticamente pelo sistema após a criação da VPC padrão.

RequestId

String

0ED8D006-F706-4D23-88ED-E11ED28DCAC0

ID da solicitação.

RouteTableId

String

vtb-bp1q1uirugzb1x32m****

ID da tabela de rotas da VPC criada automaticamente pelo sistema após a criação da VPC padrão.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?RegionId=cn-hangzhou
&Ipv6CidrBlock=2408:XXXX:346:b600::/56
&EnableIpv6=false
&ResourceGroupId=rg-acfmystnjq4****
&Action=CreateDefaultVpc
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

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

<CreateDefaultVpcResponse>
    <VpcId>vpc-bp15zckdt37pq72zv****</VpcId>
    <VRouterId>vrt-bp1lhl0taikrteen8****</VRouterId>
    <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
    <RouteTableId>vtb-bp1q1uirugzb1x32m****</RouteTableId>
</CreateDefaultVpcResponse>

Formato JSON

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

{
  "VpcId" : "vpc-bp15zckdt37pq72zv****",
  "VRouterId" : "vrt-bp1lhl0taikrteen8****",
  "RequestId" : "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
  "RouteTableId" : "vtb-bp1q1uirugzb1x32m****"
}

Códigos de erro

HttpCode

Error code

Error message

Description

400

InvalidParameter

Specified CIDR block is not valid

Mensagem retornada porque o bloco CIDR especificado é inválido.

400

ResourceNotAvailable

Resource you requested is not available in this region or zone.

Mensagem retornada porque não é possível criar um vSwitch na região ou zona atual.

400

InvalidVpcName.Malformed

Specified VPC name is not valid.

Mensagem retornada porque o formato do nome da VPC é inválido. Insira um nome válido e tente novamente.

400

InvalidVpcDiscription.Malformed

Specified VPC description is not valid.

Mensagem retornada porque o formato da descrição da VPC é inválido.

400

QuotaExceeded.Vpc

VPC quota exceeded.

Mensagem retornada porque o número de VPCs nesta conta atingiu o limite superior.

400

ResourceNotAvailable.Vpc

Resource you requested is not available in this region or zone.

Mensagem retornada porque o recurso solicitado não está disponível nesta região ou zona.

400

InvalidParameter

Specified UserCidr invalid format.

Mensagem retornada porque o formato do bloco CIDR de usuário é inválido.

400

InvalidParameter

Specified UserCidr Subnet mask is not valid .

Mensagem retornada porque a máscara de sub-rede do bloco CIDR de usuário é inválida.

400

InvalidUserCidr.Quota

Specified UserCidr number is greater than 3.

Mensagem retornada porque o número de blocos CIDR de usuário especificados atingiu o limite superior.

400

InvalidUserCidr.Malformed

Specified UserCidr overlapping in of 100.64.0.0/10.

Mensagem retornada porque o bloco CIDR de usuário especificado se sobrepõe a 100.64.0.0/10.

400

InvalidResourceGroupId

The specified ResourceGroupId does not exist.

Mensagem retornada porque o ID do grupo de recursos especificado não existe.

400

OperationFailed.DefaultVpcExist

A default VPC already exists in the region.

Mensagem retornada porque já existe uma VPC padrão na região atual.

403

Forbbiden

User not authorized to operate on the specified resource.

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

404

InvalidRegionId.NotFound

Specified value of "regionId" is not supported.

Mensagem retornada porque RegionId foi definido com um valor inválido. Verifique se o serviço está disponível na região especificada.

500

InternalError

The request processing has failed due to some unknown error.

Mensagem retornada devido à ocorrência de erros desconhecidos durante o processamento da solicitação.

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