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 IP de rede privada para recursos de nuvem, e essa cota não pode ser aumentada.
Após a criação de uma VPC padrão, um vRouter e uma tabela de rotas são criados automaticamente.
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 existirem tanto 10.0.0.0/16 quanto 10.0.0.0/24, 10.0.0.0/16 entrará em vigor.
A operação CreateDefaultVpc é assíncrona. Após o envio de uma solicitação, o sistema retorna um ID de instância enquanto a VPC padrão ainda está sendo criada em segundo plano. Você pode chamar 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.
Apenas uma VPC padrão pode existir em uma regiã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 DescribeRegions para consultar a lista de regiões mais recente.	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): não ativa o bloco CIDR IPv6. true: ativa o bloco CIDR IPv6.	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 token, mas deve garantir que o token seja exclusivo entre diferentes solicitações. O valor de ClientToken pode conter apenas caracteres ASCII. Nota Se você não especificar este parâmetro, o sistema usará o RequestId da solicitação de API como o ClientToken. O RequestId pode ser diferente para cada solicitação de API.	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 que o sistema cria 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 que o sistema cria 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.	Failed to get rule data, please wait zai shi
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.	The number of VPCs in this account has reached the upper limit.
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.	The user CIDR block that you specify overlaps with 100.64.0.0/10.
400	InvalidResourceGroupId	The specified ResourceGroupId does not exist.	The specified resource group ID does not exist.
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.	User not authorized to operate on the specified resource.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.