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

Cria um vSwitch padrão.

Descrição da operação

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

O primeiro e os três últimos endereços IP em cada bloco CIDR do vSwitch padrão são endereços IP reservados pelo sistema. Por exemplo, os endereços IP reservados pelo sistema para 192.168.1.0/24 são 192.168.1.0, 192.168.1.253, 192.168.1.254 e 192.168.1.255.
O número de instâncias de serviço em nuvem em um vSwitch padrão não pode exceder o número de instâncias de serviço em nuvem disponíveis restantes na VPC (15.000 menos o número atual de instâncias de serviço em nuvem).
Os vSwitches padrão não suportam multicast ou broadcast.
Após a criação de um vSwitch padrão, você não pode modificar seu bloco CIDR.
A operação CreateDefaultVSwitch é assíncrona. Após chamar esta operação, o sistema retorna um ID de instância, mas o vSwitch padrão ainda não foi criado e uma tarefa em segundo plano ainda está em andamento. Você pode chamar a operação DescribeVSwitchAttributes para consultar o status de criação do vSwitch padrão:
- Se o vSwitch padrão estiver no estado Pending, o vSwitch padrão está sendo configurado.
- Se o vSwitch padrão estiver no estado Available, o vSwitch padrão está disponível.
Se já existir um vSwitch padrão na zona especificada da região especificada, a chamada para criar um vSwitch padrão falhará.
Para criar um vSwitch padrão, você deve primeiro criar uma VPC padrão. Você pode chamar a operação CreateDefaultVpc para criar 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:CreateDefaultVSwitch

create

*VSwitch

acs:vpc:{#regionid}:{#accountId}:vswitch/*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ZoneId	string	Sim	O ID da zona do vSwitch padrão a ser criado. Você pode chamar a operação DescribeZones para consultar os IDs das zonas.	cn-hangzhou-b
RegionId	string	Sim	O ID da região do vSwitch padrão a ser criado. Você pode chamar a operação DescribeRegions para consultar os IDs das regiões.	cn-hangzhou
Ipv6CidrBlock	integer	Não	Os últimos 8 bits do bloco CIDR IPv6 do vSwitch. Valores válidos: 0 a 255.	12
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.	0c593ea1-3bea-11e9-b96b-88e9fe63****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O ID do vSwitch padrão criado.
VSwitchId	string	O ID do vSwitch padrão criado.	vsw-bp1a4b5qhmxftjimq****
RequestId	string	O ID da solicitação.	0ED8D006-F706-4D23-88ED-E11ED28DCAC0

Exemplos

Resposta de sucesso

JSON formato

{
  "VSwitchId": "vsw-bp1a4b5qhmxftjimq****",
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidDescription.Malformed	Invalid description.
400	InvalidVSwitchName.Malformed	Specified virtual switch name is not valid.	O formato do nome do vSwitch é inválido. Verifique o formato do nome.
400	InvalidVSwitchDiscription.Malformed	Specified virtual switch description is not valid.
400	Abs.Vpc.InvalidDescription.Malformed	Specified virtual switch name is not valid.
400	ResourceNotAvailable	Resource you requested is not available in this region or zone.
400	InvalidParameter	Specified CIDR block is not valid in VPC.
400	InvalidCidrBlock.Overlapped	Specified CIDR block overlapped with other subnets.
400	QuotaExceeded.VSwitch	Virtual switch quota exceeded.	O número de vSwitches atingiu o limite de cota. Reduza o número de vSwitches e tente novamente.
400	IncorrectRouteEntryStatus	Some route entry status blocked this operation.
400	IncorrectVSwitchStatus	Some virtual switch is modifying within the same VPC.	Falha ao criar o vSwitch porque outro vSwitch na VPC está no estado Creating.
400	InvalidCirdrBlock.MaskLength	Specified CIDR block is not valid .	O formato do bloco CIDR é inválido.
400	IncorrectVpcStatus	Current VPC status does not support this operation.
400	CreateVSwitch.IncorrectStatus.cbnStatus	Current CBN status does not support this operation.	O status atual do CBN não oferece suporte à criação de um vSwitch.
400	InvalidCidrBlock.Malformed	Specified CIDR block is not valid.
400	MissingParameter	Miss mandatory parameter.
400	TaskConflict	The operation is too frequent, TaskConflict.	As operações no EIP são muito frequentes.
400	VPC.SWITCH.RULE.QUOTA.NOT.EXISTS	vSwitch quota rule not exists.
400	Forbidden.VpcNotFound	Specified VPC can not found.	A VPC especificada não existe. Verifique se a VPC está correta.
400	RouteConflict.AlreadyExist	Route conflict exists in routing table.	Existe um conflito de rota na tabela de rotas.
400	OperationFailed.CidrAcross	Classic link instance cidr must not across.
400	Duplicated.ClientToken	%s
400	OperationFailed.Ipv6CidrBlockExisted	%s
400	IllegalParam.Ipv6CidrBlock	%s
400	OperationFailed.VpcIpv6Disabled	%s
400	IncorrectStatus.cbnStatus	Current CBN status does not support this operation.	O status atual do CBN é inválido.
400	OperationFailed.DefaultVpcNotExist	%s
400	UnsupportedFeature.CloudBoxIpv6	The IPv6 feature is not supported by cloud box.	O CloudBox não oferece suporte à criação de endereços IPv6.
400	OperationDenied.VpcPeerExist	The operation is not allowed because the VPC peer exists.	A operação especificada não é permitida porque a VPC possui uma conexão de peering.
400	OperationDenied.CenAttached	The operation is not allowed because the VPC is attached to CEN.	A operação especificada não é permitida porque a VPC está associada a uma instância CEN.
400	OperationDenied.NatgwExist	The operation is not allowed because the NAT gateway exists in VPC.	A operação especificada não é permitida porque existe um gateway NAT na VPC.
400	OperationDenied.OtherSubnetCreating	other subnet is creating
400	OperationFailed.DefaultVSwitchExist	A default vSwitch already exists in the zone.	Já existe um vSwitch padrão na zona atual.
400	InvalidStatus.RouteEntry	RouteEntry status error.
400	InvalidZoneId.NotFound	Specified zone does not exist.
400	OperationDenied.ZoneIsDisabled	The specified zone is disabled. You cannot create a vSwitch in a disabled zone.	A zona atual está desativada. Você não pode criar um vSwitch nesta zona.
404	Invalid.NotExist	witch mask rule not exists.
404	InvalidVpcId.NotFound	Specified VPC does not exist.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.