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

Cria uma nuvem privada virtual (VPC) padrão.

Descrição da operação

Ao chamar esta operação para criar uma VPC padrão, observe os seguintes itens:

Após a criação de uma VPC padrão, você não pode modificar seu bloco CIDR, mas pode adicionar blocos CIDR IPv4 secundários.
Cada VPC padrão suporta até 300.000 endereços de rede privada para recursos de nuvem, e você não pode aumentar essa cota.
Após a criação de uma VPC padrão, o sistema cria automaticamente um vRouter e uma tabela de rotas.
Cada VPC padrão suporta até três blocos CIDR de usuário. Se vários blocos CIDR de usuário se sobrepuserem, o bloco CIDR com a máscara mais curta entrará em vigor. Por exemplo, se você especificar 10.0.0.0/16 e 10.0.0.0/24, 10.0.0.0/16 entrará em vigor.
A operação CreateDefaultVpc é assíncrona. Após o envio da solicitação, o sistema retorna um ID de instância, mas a VPC padrão ainda não foi criada e a tarefa de criação em segundo plano ainda está em execução. Você pode chamar a operação DescribeVpcAttribute para consultar o status de criação da VPC padrão:
- Se a VPC padrão estiver no estado Pending, a VPC padrão está sendo configurada.
- Se a VPC padrão estiver no estado Available, a VPC padrão está disponível.
A operação CreateDefaultVpc não suporta a criação simultânea de VPCs padrão na mesma região.
Cada região pode ter apenas uma VPC padrã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:CreateDefaultVpc

create

*VPC

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região da VPC padrão. Você pode chamar a operação DescribeRegions para consultar o ID da região.	cn-hangzhou
Ipv6CidrBlock	string	Não	O bloco CIDR IPv6 da VPC padrão. Nota Este parâmetro é obrigatório quando EnableIpv6 é definido como true.	2408:XXXX:346:b600::/56
EnableIpv6	boolean	Não	Especifica se o bloco CIDR IPv6 deve ser ativado. Valores válidos: false (padrão): desativado. true: ativado.	false
ResourceGroupId	string	Não	O ID do grupo de recursos.	rg-acfmystnjq4****
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 ele 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 ClientToken. O RequestId de cada solicitação de API é exclusivo.	123e4567-e89b-12d3-a456-426655440000

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O ID da VPC padrão criada.
VpcId	string	O ID da VPC padrão criada.	vpc-bp15zckdt37pq72zv****
VRouterId	string	O ID do vRouter criado automaticamente após a criação da VPC padrão.	vrt-bp1lhl0taikrteen8****
RequestId	string	O ID da solicitação.	0ED8D006-F706-4D23-88ED-E11ED28DCAC0
RouteTableId	string	O ID da tabela de rotas criada automaticamente após a criação da VPC padrão.	vtb-bp1q1uirugzb1x32m****

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	TOKEN_PROCESSING	Action is processing.
400	InvokeError	instance quota rule invoke error.	Falha ao recuperar os dados da regra. Tente novamente mais tarde.
400	InvalidParameter	Specified CIDR block is not valid
400	ResourceNotAvailable	Resource you requested is not available in this region or zone.
400	InvalidVpcName.Malformed	Specified VPC name is not valid.
400	InvalidVpcDiscription.Malformed	Specified VPC description is not valid.
400	QuotaExceeded.Vpc	VPC quota exceeded.	O número de VPCs na sua conta atingiu o limite de cota.
400	ResourceNotAvailable.Vpc	Resource you requested is not available in this region or zone.
400	InvalidUserCidr.Quota	Specified UserCidr number is greater than 3.
400	InvalidUserCidr.Malformed	Specified UserCidr overlapping in of 100.64.0.0/10.	O UserCidr está em um estado inválido.
400	InvalidResourceGroupId	The specified ResourceGroupId does not exist.	O ID do grupo de recursos não existe.
400	IllegalParam.Ipv6CidrBlock	%s
400	OperationFailed.IPv6CidrNotReserved	%s
400	MissingParam.EnableIpv6	%s
400	OperationUnsupported.Ipv6Feature	%s
400	IllegalParam.ZoneId	%s
400	OperationFailed.DefaultVpcExist	%s
400	InvalidRegionId.NotFound	Specified value of "regionId" is not supported.
500	InternalError	The request processing has failed due to some unknown error.
403	Forbbiden	User not authorized to operate on the specified resource.	O EIP não pertence ao chamador atual. Verifique se você tem permissões para usar o EIP.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.