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

Cria um vSwitch.

Descrição da operação

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

O número de vSwitches em cada VPC não pode exceder 150.
O primeiro e os três últimos endereços IP de cada bloco CIDR do vSwitch são 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 não pode exceder o número restante de instâncias de serviço em nuvem disponíveis na VPC (15.000 menos o número atual de instâncias de serviço em nuvem).
Uma instância de serviço em nuvem pode pertencer a apenas um vSwitch.
Os vSwitches não suportam multicast ou broadcast.
Após a criação de um vSwitch, você não pode modificar seu bloco CIDR.
A operação CreateVSwitch é assíncrona. Após o envio de uma solicitação, o sistema retorna um ID de instância, mas o vSwitch ainda não foi criado. A tarefa em segundo plano ainda está em andamento. Você pode chamar DescribeVSwitchAttributes para consultar o status de criação do vSwitch:\n - Quando o vSwitch está no estado Pending, o vSwitch está sendo configurado.\n - Quando o vSwitch está no estado Available, o vSwitch está disponível.\n- A operação CreateVSwitch não suporta a criação simultânea de vSwitches na mesma VPC.\n- Ao chamar a operação CreateVSwitch, o bloco CIDR do vSwitch não pode estar dentro dos seguintes intervalos de endereços reservados: 100.64.0.0/10, 127.0.0.0/8, 169.254.0.0/16 ou 224.0.0.0/4.

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:CreateVSwitch

create

*VPC.

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

*VSwitch.

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

vpc:tag

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Tag	array<object>	Não	As tags do recurso.
	object	Não	A tag.
Key	string	Não	A chave da tag do recurso. Você pode especificar até 20 chaves de tag. A chave da tag não pode ser uma string vazia.\n\nUma chave de tag pode ter até 128 caracteres de comprimento. Não pode começar com `aliyun` ou `acs:` e não pode conter `http://` ou `https://`.	FinanceJoshua
Value	string	Não	O valor da tag do recurso. Você pode especificar até 20 valores de tag. O valor da tag pode ser uma string vazia.\n\nO valor da tag pode ter até 128 caracteres de comprimento. Não pode começar com `aliyun` ou `acs:` e não pode conter `http://` ou `https://`.	FinanceDept
ZoneId	string	Sim	O ID da zona na qual o vSwitch será criado.\n\nVocê pode chamar a operação DescribeZones para consultar o ID da zona.	cn-hangzhou-b
RegionId	string	Não	O ID da região do vSwitch a ser criado.\n\nVocê pode chamar a operação DescribeRegions para consultar o ID da região.	cn-hangzhou
CidrBlock	string	Não	O bloco CIDR do vSwitch. O bloco CIDR do vSwitch deve atender aos seguintes requisitos: \n\n- O comprimento da máscara do bloco CIDR do vSwitch deve ser de 16 a 29 bits. \n\n- O bloco CIDR do vSwitch deve ser um subconjunto do bloco CIDR da VPC à qual o vSwitch pertence. \n\n- O bloco CIDR do vSwitch não pode ser igual ao bloco CIDR de destino de uma entrada de rota na VPC, mas pode ser um subconjunto do bloco CIDR de destino. \n\n- O bloco CIDR do vSwitch não pode estar dentro dos seguintes intervalos de endereços reservados: 100.64.0.0/10, 127.0.0.0/8, 169.254.0.0/16 ou 224.0.0.0/4.\n\n> Após a criação de um vSwitch, você não pode modificar seu bloco CIDR.	172.16.0.0/24
CidrMask	integer	Não	O comprimento da máscara do bloco CIDR IPv4 do vSwitch.\n> O comprimento da máscara do bloco CIDR IPv4 do vSwitch deve ser de 16 a 29 bits. Você deve especificar pelo menos um entre CidrBlock e CidrMask.	24
Ipv6CidrBlock	integer	Não	Os últimos 8 bits do bloco CIDR IPv6 do vSwitch. Valores válidos: 0 a 255.\nVocê pode especificar este parâmetro para atribuir um bloco CIDR IPv6 ao vSwitch somente quando a VPC à qual o vSwitch pertence tiver o IPv6 ativado. Após a atribuição do bloco CIDR IPv6, ele não pode ser alterado para outro bloco CIDR. Certifique-se de que o bloco CIDR não se sobreponha aos de outros vSwitches na VPC.	12
Ipv6CidrMask	integer	Não	A máscara de sub-rede do bloco CIDR IPv6 do vSwitch. Você pode especificar este parâmetro para atribuir um bloco CIDR IPv6 ao vSwitch somente quando a VPC à qual o vSwitch pertence tiver o IPv6 ativado.\n\n> Apenas 64 é suportado.	64
VpcId	string	Sim	O ID da VPC à qual o vSwitch pertence.	vpc-257gqcdfvx6n****
VSwitchName	string	Não	O nome do vSwitch. \n\nO nome deve ter de 1 a 128 caracteres de comprimento e não pode começar com `http://` ou `https://`.	vSwitch-1
Description	string	Não	A descrição do vSwitch. \n\nA descrição deve ter de 1 a 256 caracteres de comprimento e não pode começar com `http://` ou `https://`.	vSwitch
ClientToken	string	Não	O token do cliente que é usado para garantir a idempotência da solicitação.\n\nVocê 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.\n\n> Se você não especificar este parâmetro, o sistema usará o RequestId da solicitação de API como o ClientToken. O RequestId pode variar para cada solicitação de API.	0c593ea1-3bea-11e9-b96b-88e9fe63****
VpcIpv6CidrBlock	string	Não	O bloco CIDR IPv6 da VPC. Se a VPC à qual o vSwitch pertence tiver vários blocos CIDR IPv6, você poderá especificar este parâmetro para determinar o intervalo do bloco CIDR IPv6 para o vSwitch. Se você não especificar este parâmetro, o bloco CIDR IPv6 atribuído quando o IPv6 foi ativado para a VPC será usado.	2408:XXXX:0:6a::/56

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
VSwitchId	string	O ID do vSwitch criado.	vsw-25navfgbue4g****
RequestId	string	O ID da solicitação.	0ED8D006-F706-4D23-88ED-E11ED28DCAC0

Exemplos

Resposta de sucesso

JSON formato

{
  "VSwitchId": "vsw-25navfgbue4g****",
  "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	OperationFailed.ResourceConflict	vpc only support one cloud box.
400	OperationFailed.IdempotentTokenProcessing	Action is processing.
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 do vSwitch.
400	InvalidVSwitchDiscription.Malformed	Specified virtual switch description is not valid.
400	Abs.Vpc.InvalidDescription.Malformed	Specified virtual switch name is not valid.
400	MissingParam.vpcId	The parameter vpcId is mandatory.
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 da 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 um 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 da instância Cloud Enterprise Network (CEN) não suporta a operação de criação de um switch virtual (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 de 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 rotas 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 estado atual do CBN está incorreto.
400	OperationFailed.NotifyCenCreate	Failed to notify cen when create vswitch.
400	OperationFailed.DistibuteLock	Distibute lock fail.	O recurso está bloqueado. As operações não são permitidas.
400	UnsupportedFeature.CloudBoxIpv6	The IPv6 feature is not supported by cloud box.	O CloudBox não suporta a criação de IPv6.
400	OperationDenied.VpcPeerExist	The operation is not allowed because the VPC peer exists.	A operação é proibida 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 é proibida porque a VPC está associada a uma instância da Cloud Enterprise Network (CEN).
400	OperationDenied.NatgwExist	The operation is not allowed because the NAT gateway exists in VPC.	A operação é proibida porque existe um gateway NAT na VPC.
400	IllegalParam.VpcIpv6CidrBlock	%s
400	OperationDenied.OtherSubnetCreating	The operation is not allowed because the other VSwitch is creating.
400	OperationDenied.VpcPeerExists	The operation is not allowed because the VpcPeer exists.	A operação é proibida porque existe uma conexão de peering de VPC na VPC.
400	IllegalParam.CidrBlock	The param of CidrBlock [%s] is illegal.	O bloco CIDR é inválido.
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 foi desativada. A criação de um vSwitch nesta zona não é permitida.
400	OperationDenied.VpcIpv6CidrBlockNotExist	The specified VpcIpv6CidrBlock does not exist in the VPC.	O VpcIpv6CidrBlock especificado não existe na VPC.
400	OperationDenied.AvailableCidrInsufficient	Insufficient available CIDR blocks for allocation. This is either because the VPC has no remaining address space, or because the candidate CIDR contains destination networks of active non-system routes in the VPC.	A operação foi rejeitada porque os recursos de bloco CIDR disponíveis são insuficientes.
400	OperationDenied.Ipv6CidrMaskInvalid	The specified Ipv6CidrMask is invalid, only %s is allowed.	A máscara IPv6 especificada é inválida. Apenas %s é suportado.
400	ParamExclusive.CidrBlockAndCidrMask	CidrBlock and CidrMask are mutually exclusive.	Os parâmetros CidrBlock e CidrMask são mutuamente exclusivos.
400	MissingParam.Ipv6CidrBlockOrIpv6CidrMask	Ipv6CidrBlock or Ipv6CidrMask must be specified.	Pelo menos um dos parâmetros Ipv6CidrBlock ou Ipv6CidrMask deve ser especificado.
400	MissingParam.CidrBlockOrCidrMask	CidrBlock or CidrMask is not specified.	Falha ao adicionar um bloco CIDR ao pool de endereços porque o parâmetro de bloco CIDR ou máscara está ausente.
400	UnsupportedFeature.Ipv6OnlyVsw	IPv6-only VSwitches are not supported in this region.
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.