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

Observações de uso

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

É possível criar no máximo 150 vSwitches em uma Virtual Private Cloud (VPC).
O primeiro endereço IP e os três últimos endereços IP de cada bloco CIDR do vSwitch são reservados. Por exemplo, se o bloco CIDR de um vSwitch for 192.168.1.0/24, os endereços IP 192.168.1.0, 192.168.1.253, 192.168.1.254 e 192.168.1.255 estarão reservados.
A quantidade de instâncias em um vSwitch não pode exceder a capacidade restante da VPC. A capacidade restante corresponde à diferença entre 15.000 e o número atual de instâncias.
Cada instância pode pertencer a apenas um vSwitch.
Os vSwitches não oferecem suporte a multicast ou broadcast.
Após criar um vSwitch, não é possível modificar seu bloco CIDR.
A operação CreateVSwitch é assíncrona. Após o envio da solicitação, o sistema retorna um ID de solicitação e executa a tarefa em segundo plano. Para consultar o status da tarefa, chame a operação DescribeVSwitchAttributes.
- Se o vSwitch estiver no estado Pending, ele está sendo configurado.
- Se o vSwitch estiver no estado Available, ele está disponível para uso.
Não chame repetidamente a operação CreateVSwitch para criar um vSwitch em uma VPC dentro do período especificado.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar o OpenAPI Explorer para chamar esta operação. O OpenAPI Explorer gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	CreateVSwitch	A operação a ser executada. Defina o valor como CreateVSwitch.
Tag.N.Key	String	Não	FinanceJoshua	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	FinanceDept	Valor da tag N a ser adicionado 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:`.
ZoneId	String	Sim	cn-hangzhou-b	ID da zona do vSwitch. Para obter a lista mais recente de zonas, chame a operação DescribeZones.
RegionId	String	Não	cn-hangzhou	ID da região do vSwitch. Para obter a lista mais recente de regiões, chame a operação DescribeRegions.
CidrBlock	String	Sim	172.16.0.0/24	Bloco CIDR do vSwitch. Observe os seguintes limites: A máscara de sub-rede do bloco CIDR deve ter entre 16 e 29 bits. O bloco CIDR do vSwitch deve estar contido no bloco CIDR da VPC à qual o vSwitch pertence. O bloco CIDR de um vSwitch não pode ser igual ao bloco CIDR de destino em uma entrada de rota da VPC, mas pode ser um subconjunto desse bloco.
Ipv6CidrBlock	Integer	Não	12	Últimos oito bits do bloco CIDR IPv6 do vSwitch. Valores válidos: 0 a 255.
VpcId	String	Sim	vpc-257gqcdfvx6n****	ID da VPC onde você deseja criar o vSwitch.
VSwitchName	String	Não	vSwitch-1	Nome do vSwitch. O nome deve ter de 1 a 128 caracteres e não pode começar com `http://` ou `https://`.
Description	String	Não	vSwitch	Descrição do vSwitch. A descrição deve ter de 1 a 256 caracteres e não pode começar com `http://` ou `https://`.
ClientToken	String	Não	0c593ea1-3bea-11e9-b96b-88e9fe63****	Token de cliente usado para garantir a idempotência da solicitação. Use o cliente para gerar o token, garantindo que ele seja exclusivo entre diferentes solicitações. O token pode conter apenas caracteres ASCII. Nota Se este parâmetro não for especificado, o sistema usará automaticamente o ID da solicitação como token de cliente. O ID da solicitação pode variar a cada solicitação.
VpcIpv6CidrBlock	String	Não	2408:XXXX:0:6a::/56	Bloco CIDR IPv6 da VPC.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
VSwitchId	String	vsw-25navfgbue4g****	ID do vSwitch.
RequestId	String	0ED8D006-F706-4D23-88ED-E11ED28DCAC0	ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=CreateVSwitch
&Tag=[{"Key":"FinanceJoshua","Value":"FinanceDept"}]
&ZoneId=cn-hangzhou-b
&RegionId=cn-hangzhou
&CidrBlock=172.16.0.0/24
&Ipv6CidrBlock=12
&VpcId=vpc-257gqcdfvx6n****
&VSwitchName=vSwitch-1
&Description=vSwitch
&ClientToken=0c593ea1-3bea-11e9-b96b-88e9fe63****
&VpcIpv6CidrBlock=2408:XXXX:0:6a::/56
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

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

<CreateVSwitchResponse>
    <VSwitchId>vsw-25navfgbue4g****</VSwitchId>
    <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
</CreateVSwitchResponse>

Formato JSON

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

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

Códigos de erro

HttpCode	Código de erro	Mensagem de erro	Descrição
400	InvalidVSwitchName.Malformed	Specified virtual switch name is not valid.	O formato do nome do vSwitch especificado é inválido. Especifique o nome no formato válido.
400	InvalidVSwitchDiscription.Malformed	Specified virtual switch description is not valid.	A descrição do vSwitch é inválida.
400	MissingParam.vpcId	The parameter vpcId is mandatory.	O parâmetro vpcId é obrigatório.
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	InvalidParameter	Specified CIDR block is not valid in VPC.	O bloco CIDR não está contido no bloco CIDR da VPC.
400	InvalidCidrBlock.Overlapped	Specified CIDR block overlapped with other subnets.	O bloco CIDR do vSwitch sobrepõe-se a outro bloco CIDR de vSwitch ou ao bloco CIDR de destino de uma entrada de rota personalizada. Tente usar um bloco CIDR diferente que não esteja em uso.
400	InvalidCidrBlock.Overlapped	Specified CIDR block overlapped with other entry.	O bloco CIDR do vSwitch sobrepõe-se a outro bloco CIDR de vSwitch ou ao bloco CIDR de destino de uma entrada de rota personalizada. Tente usar um bloco CIDR diferente que não esteja em uso.
400	QuotaExceeded.VSwitch	Virtual switch quota exceeded.	A quantidade de vSwitches atingiu o limite superior. Reduza o número de vSwitches e tente novamente mais tarde.
400	IncorrectRouteEntryStatus	Some route entry status blocked this operation.	Uma ou mais entradas de rota na tabela de rotas atual estão no estado Pending ou Modifying.
400	IncorrectVSwitchStatus	Some virtual switch is modifying within the same VPC.	Vários vSwitches estão no estado Modifying na mesma VPC. Tente novamente mais tarde.
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.	Esta operação não pode ser executada quando a VPC está no estado atual.
400	CreateVSwitch.IncorrectStatus.cbnStatus	Current CBN status does not support this operation.	Não é possível criar um vSwitch quando a instância CEN está no estado atual.
400	InvalidCidrBlock.Malformed	Specified CIDR block is not valid.	O formato do bloco CIDR especificado é inválido.
400	MissingParameter	Miss mandatory parameter.	Um ou mais parâmetros obrigatórios não foram definidos. Verifique se todos os parâmetros necessários foram configurados antes de chamar esta operação.
400	IncorrectVSwitchStatus	VSwitch Creation simultaneously is not supported.	O sistema falhou ao criar o vSwitch e um ou mais vSwitches pertencentes à VPC estão no estado Creating.
400	TaskConflict	The operation is too frequent, TaskConflict.	O sistema está ocupado. Tente novamente mais tarde.
400	Forbidden.VpcNotFound	Specified VPC can not found.	A VPC especificada não existe.
400	RouteConflict.AlreadyExist	Route conflict exists in routing table.	Existem conflitos de rota na tabela de rotas.
400	IncorrectStatus.cbnStatus	Current CBN status does not support this operation.	O status da instância CEN é inválido.
400	UnsupportedFeature.CloudBoxIpv6	The IPv6 feature is not supported by cloud box.	Não é possível criar um endereço IPv6 para uma cloud box.
400	OperationDenied.VpcPeerExist	The operation is not allowed because the VPC peer exists.	A VPC possui uma conexão de peering VPC.
400	OperationDenied.CenAttached	The operation is not allowed because the VPC is attached to CEN.	A operação não é permitida porque a VPC está anexada a uma instância CEN.
400	OperationDenied.NatgwExist	The operation is not allowed because the NAT gateway exists in VPC.	A operação não é permitida porque existem gateways NAT na VPC.
400	MissingParam.Ipv6CidrBlock	The parameter Ipv6CidrBlock is mandatory.	O parâmetro Ipv6CidrBlock é obrigatório.
400	OperationDenied.VpcPeerExists	The operation is not allowed because the VpcPeer exists.	A VPC possui uma conexão de peering VPC.
404	InvalidZoneId.NotFound	Specified zone does not exist.	O ID da zona é inválido.
404	InvalidVpcId.NotFound	Specified VPC does not exist.	A VPC não foi encontrada.

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