CreateVpc - : Central de Documentação do Alibaba Cloud

Observações de uso

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

Especifique apenas um bloco CIDR para cada VPC.
Após criar uma VPC, não é possível alterar o bloco CIDR dela. No entanto, você pode adicionar blocos CIDR IPv4 secundários à VPC.
Em cada VPC, 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 gera automaticamente um vRouter e uma tabela de rotas.
Uma VPC aceita no máximo três blocos CIDR de usuário. Se um bloco CIDR de usuário incluir outro, aquele com a máscara de sub-rede mais curta prevalece. Por exemplo, se ambos 10.0.0.0/8 e 10.1.0.0/16 forem especificados, apenas 10.0.0.0/8 terá efeito.
A operação CreateVpc é 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 da tarefa:
- Se a VPC estiver no estado Creating, ela está sendo criada.
- Se a VPC estiver no estado Created, a criação foi concluída.
Não chame repetidamente a operação DeleteRouteEntry para criar VPCs padrão dentro de um período específico. Contudo, chamadas repetidas desta operação são permitidas para criar VPCs personalizadas no mesmo intervalo de tempo.

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

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	CreateVpc	A operação a ser executada. Defina o valor como CreateVpc.
RegionId	String	Sim	cn-hangzhou	O ID da região à qual a VPC pertence. Chame a operação DescribeRegions para obter a lista mais recente de regiões.
CidrBlock	String	Não	172.16.0.0/12	O bloco CIDR da VPC. Especifique um dos seguintes blocos CIDR ou seus subconjuntos como o bloco CIDR IPv4 primário da VPC: 192.168.0.0/16, 172.16.0.0/12 e 10.0.0.0/8. Estes são blocos CIDR privados padrão definidos pelos documentos Request for Comments (RFC). A máscara de sub-rede deve ter entre 8 e 28 bits. Também é possível utilizar 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 e suas sub-redes, como o bloco CIDR IPv4 primário da VPC.
Ipv6CidrBlock	String	Não	2408:XXXX:0:6a::/56	Os blocos CIDR IPv6 da VPC.
VpcName	String	Não	abc	O nome da VPC. O nome deve ter de 1 a 128 caracteres e não pode começar com `http://` ou `https://`.
EnableIpv6	Boolean	Não	false	Define se o IPv6 deve ser ativado. Valores válidos: false (padrão) true: sim
Description	String	Não	This is my first Vpc	A descrição da VPC. A descrição deve ter de 1 a 256 caracteres e não pode começar com `http://` ou `https://`.
ResourceGroupId	String	Não	rg-acfmxazb4ph6aiy****	O ID do grupo de recursos. Para mais informações sobre grupos de recursos, consulte O que é um grupo de recursos?
Tag.N.Key	String	Não	FinanceDept	A chave da tag N a ser adicionada ao recurso. É possível especificar até 20 chaves de tag. A chave da tag não pode ser uma string vazia. A chave da tag pode ter no máximo 128 caracteres. Ela não pode começar com `aliyun` ou `acs:`, nem conter `http://` ou `https://`.
Tag.N.Value	String	Não	FinanceJoshua	O valor da tag N a ser adicionada ao recurso. É possível 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://`. Além disso, não pode começar com `aliyun` ou `acs:`.
DryRun	Boolean	Não	false	Indica se deve ser realizada apenas uma simulação, sem executar a solicitação real. Valores válidos: true: realiza apenas a simulação. O sistema verifica possíveis problemas na solicitação, incluindo valores de parâmetros ausentes, sintaxe incorreta e limites de serviço. Se a simulação falhar, uma mensagem de erro será retornada. Caso contrário, o código de erro `DryRunOperation` será retornado. false (padrão): executa a simulação e, se aprovada, processa a solicitação real. Um código de status HTTP 2xx indica sucesso e a operação é executada.
UserCidr	String	Não	192.168.0.0/12	O bloco CIDR de usuário. Separe múltiplos blocos CIDR de usuário com vírgulas (,). É possível especificar até três blocos. Para mais detalhes sobre blocos CIDR de usuário, consulte a seção `What is a user CIDR block?` no FAQ da VPC.
ClientToken	String	Não	123e4567-e89b-12d3-a456-426655440000	O token de cliente usado para garantir a idempotência da solicitação. Gere o token usando o cliente, garantindo que seja único para cada solicitação distinta. O token deve conter apenas caracteres ASCII. Nota Se este parâmetro não for especificado, o sistema usará automaticamente o ID da solicitação como o token de cliente. O ID da solicitação pode variar a cada chamada.
Ipv6Isp	String	Não	BGP	O tipo do bloco CIDR IPv6 da VPC. Valores válidos: BGP (padrão): Border Gateway Protocol (BGP) da Alibaba Cloud ChinaMobile: China Mobile (ISP único). ChinaUnicom: China Unicom (ISP único). ChinaTelecom: China Telecom (ISP único). Nota Se sua conta Alibaba Cloud tiver permissão para usar largura de banda de ISP único, defina este parâmetro como ChinaTelecom, ChinaUnicom ou ChinaMobile.
Ipv4IpamPoolId	String	Não	ipam-pool-sycmt3p2a9v63i****	O ID do pool do IP Address Manager (IPAM) do tipo IPv4.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
VpcId	String	vpc-bp15zckdt37pq72zv****	O ID da VPC criada.
VRouterId	String	vrt-bp1lhl0taikrteen8****	O ID do vRouter criado automaticamente pelo sistema após a criação da VPC.
RequestId	String	0ED8D006-F706-4D23-88ED-E11ED28DCAC0	O ID da solicitação.
RouteTableId	String	vtb-bp145q7glnuzdv****	O ID da tabela de rotas criada automaticamente pelo sistema após a criação da VPC.
ResourceGroupId	String	rg-acfmxazb4ph6aiy****	O ID do grupo de recursos.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=CreateVpc
&RegionId=cn-hangzhou
&CidrBlock=172.16.0.0/12
&Ipv6CidrBlock=2408:XXXX:0:6a::/56
&VpcName=abc
&EnableIpv6=false
&Description=This is my first Vpc
&ResourceGroupId=rg-acfmxazb4ph6aiy****
&Tag=[{"Key":"FinanceDept","Value":"FinanceJoshua"}]
&DryRun=false
&UserCidr=192.168.0.0/12
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&Ipv6Isp=BGP
&Ipv4IpamPoolId=ipam-pool-sycmt3p2a9v63i****
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

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

<CreateVpcResponse>
    <VpcId>vpc-bp15zckdt37pq72zv****</VpcId>
    <VRouterId>vrt-bp1lhl0taikrteen8****</VRouterId>
    <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
    <RouteTableId>vtb-bp145q7glnuzdv****</RouteTableId>
    <ResourceGroupId>rg-acfmxazb4ph6aiy****</ResourceGroupId>
</CreateVpcResponse>

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-bp145q7glnuzdv****",
  "ResourceGroupId" : "rg-acfmxazb4ph6aiy****"
}

Códigos de erro

HttpCode	Código de erro	Mensagem de erro	Descrição
400	InvalidParameter	Specified CIDR block is not valid	O bloco CIDR especificado é inválido.
400	ResourceNotAvailable	Resource you requested is not available in this region or zone.	Não é possível criar um vSwitch na região ou zona atual.
400	InvalidVpcName.Malformed	Specified VPC name is not valid.	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.	O formato da descrição da VPC é inválido.
400	QuotaExceeded.Vpc	VPC quota exceeded.	A quantidade de VPCs nesta conta atingiu o limite máximo.
400	ResourceNotAvailable.Vpc	Resource you requested is not available in this region or zone.	O recurso solicitado não está disponível nesta região ou zona.
400	InvalidParameter	Specified UserCidr invalid format.	O formato do bloco CIDR de usuário é inválido.
400	InvalidParameter	Specified UserCidr Subnet mask is not valid .	A máscara de sub-rede do bloco CIDR de usuário é inválida.
400	InvalidUserCidr.Quota	Specified UserCidr number is greater than 3.	O número de blocos CIDR de usuário atingiu o limite máximo.
400	InvalidUserCidr.Malformed	Specified UserCidr overlapping in of 100.64.0.0/10.	O bloco CIDR de usuário especificado sobrepõe-se a 100.64.0.0/10.
400	InvalidResourceGroupId	The specified ResourceGroupId does not exist.	O ID do grupo de recursos especificado não existe.
400	OperationUnsupported.ResourceGroupId	ResourceGroup is not supported in this region.	O recurso de grupo de recursos está desativado.
400	UnsupportedFeature.Ipv6Isp	The Ipv6Isp feature is not supported.	O ISP IPv6 especificado não é suportado.
400	ResourceNotEnough.Ipv6Cidr	The specified resource of Ipv6Cidr is not enough.	Endereços IPv6 insuficientes.
400	UnsupportedFeature.IPAM	VPCs cannot be created by using IPAM.	Não é possível usar o IPAM para criar uma VPC.
403	Forbidden	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.
404	InvalidRegionId.NotFound	Specified value of "regionId" is not supported.	O valor de RegionId é 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.	Ocorreram erros desconhecidos durante o processamento.

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