CreateVSwitch - - Centro de documentación de Alibaba Cloud

Cree un vSwitch.

Notas de uso

Al invocar esta operación, tenga en cuenta los siguientes límites:

Se pueden crear hasta 150 vSwitches en una virtual private cloud (VPC).
La primera dirección IP y las últimas tres direcciones IP de cada bloque CIDR de vSwitch están reservadas. Por ejemplo, si el bloque CIDR de un vSwitch es 192.168.1.0/24, las direcciones IP 192.168.1.0, 192.168.1.253, 192.168.1.254 y 192.168.1.255 se encuentran reservadas.
El número de instancias en un vSwitch no puede exceder la capacidad restante de la VPC. Esta capacidad corresponde a la diferencia entre 15,000 y la cantidad actual de instancias.
Cada instancia solo puede pertenecer a un vSwitch.
Los vSwitches no admiten multicast ni broadcast.
Una vez creado un vSwitch, no es posible modificar su bloque CIDR.
CreateVSwitch es una operación asíncrona. Tras enviar la solicitud, el sistema devuelve un ID de solicitud y ejecuta la tarea en segundo plano. Para consultar el estado de la tarea, invoque la operación DescribeVSwitchAttributes.
- Si el vSwitch se encuentra en estado Pending, está en proceso de configuración.
- Si el vSwitch se encuentra en estado Available, está disponible para su uso.
No invoque repetidamente la operación CreateVSwitch para crear un vSwitch en una VPC dentro del periodo de tiempo especificado.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para mayor comodidad, se recomienda invocar esta operación desde OpenAPI Explorer. Esta herramienta genera dinámicamente el código de ejemplo de la operación para diferentes SDKs.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	CreateVSwitch	Operación que desea ejecutar. Establezca el valor en CreateVSwitch.
Tag.N.Key	String	No	FinanceJoshua	Clave de la etiqueta N que se agregará al recurso. Puede especificar hasta 20 claves de etiqueta. La clave no puede ser una cadena vacía. La longitud máxima permitida es de 128 caracteres. No debe comenzar con `aliyun` ni `acs:`, y tampoco puede contener `http://` o `https://`.
Tag.N.Value	String	No	FinanceDept	Valor de la etiqueta N que se agregará al recurso. Puede especificar hasta 20 valores de etiqueta. Este campo acepta cadenas vacías. El valor puede tener hasta 128 caracteres de longitud y no debe incluir `http://` ni `https://`. Tampoco puede comenzar con `aliyun` o `acs:`.
ZoneId	String	Sí	cn-hangzhou-b	ID de zona del vSwitch. Para obtener la lista más reciente de zonas, invoque la operación DescribeZones.
RegionId	String	No	cn-hangzhou	ID de región del vSwitch. Para consultar la lista actualizada de regiones, invoque la operación DescribeRegions.
CidrBlock	String	Sí	172.16.0.0/24	Bloque CIDR del vSwitch. Considere las siguientes restricciones: La máscara de subred del bloque CIDR debe tener una longitud de entre 16 y 29 bits. El bloque CIDR del vSwitch debe estar contenido dentro del bloque CIDR de la VPC a la que pertenece. Este bloque no puede coincidir con el bloque CIDR de destino en ninguna entrada de ruta de la VPC, aunque sí puede ser un subconjunto del mismo.
Ipv6CidrBlock	Integer	No	12	Últimos ocho bits del bloque CIDR IPv6 del vSwitch. Valores válidos: de 0 a 255.
VpcId	String	Sí	vpc-257gqcdfvx6n****	ID de la VPC donde se creará el vSwitch.
VSwitchName	String	No	vSwitch-1	Nombre del vSwitch. Debe tener entre 1 y 128 caracteres de longitud. No puede comenzar con `http://` ni `https://`.
Description	String	No	vSwitch	Descripción del vSwitch. La longitud debe ser de 1 a 256 caracteres y el texto no puede comenzar con `http://` o `https://`.
ClientToken	String	No	0c593ea1-3bea-11e9-b96b-88e9fe63****	Token de cliente utilizado para garantizar la idempotencia de la solicitud. Puede generar este token mediante el cliente, pero debe asegurarse de que sea único para cada solicitud distinta. Solo se permiten caracteres ASCII. Nota Si no especifica este parámetro, el sistema utilizará automáticamente el ID de solicitud como token de cliente. Tenga en cuenta que el ID de solicitud podría variar en cada llamada.
VpcIpv6CidrBlock	String	No	2408:XXXX:0:6a::/56	Bloque CIDR IPv6 de la VPC.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
VSwitchId	String	vsw-25navfgbue4g****	ID del vSwitch.
RequestId	String	0ED8D006-F706-4D23-88ED-E11ED28DCAC0	ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

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 error

HttpCode	Código de error	Mensaje de error	Descripción
400	InvalidVSwitchName.Malformed	Specified virtual switch name is not valid.	El formato del nombre de vSwitch especificado no es válido. Utilice un formato correcto.
400	InvalidVSwitchDiscription.Malformed	Specified virtual switch description is not valid.	La descripción del vSwitch no es válida.
400	MissingParam.vpcId	The parameter vpcId is mandatory.	El parámetro vpcId es obligatorio.
400	ResourceNotAvailable	Resource you requested is not available in this region or zone.	No es posible crear un vSwitch en la región o zona actual.
400	InvalidParameter	Specified CIDR block is not valid in VPC.	El bloque CIDR indicado no se encuentra dentro del rango CIDR de la VPC.
400	InvalidCidrBlock.Overlapped	Specified CIDR block overlapped with other subnets.	El bloque CIDR del vSwitch se superpone con otro bloque CIDR de vSwitch o con el destino de una entrada de ruta personalizada. Pruebe con un bloque CIDR diferente que no esté en uso.
400	InvalidCidrBlock.Overlapped	Specified CIDR block overlapped with other entry.	El bloque CIDR del vSwitch se superpone con otro bloque CIDR de vSwitch o con el destino de una entrada de ruta personalizada. Seleccione un bloque CIDR distinto que no se esté utilizando.
400	QuotaExceeded.VSwitch	Virtual switch quota exceeded.	Se alcanzó el límite máximo de vSwitches. Reduzca la cantidad de vSwitches e inténtelo nuevamente más tarde.
400	IncorrectRouteEntryStatus	Some route entry status blocked this operation.	Una o varias entradas de ruta en la tabla de rutas actual se encuentran en estado Pending o Modifying.
400	IncorrectVSwitchStatus	Some virtual switch is modifying within the same VPC.	Hay varios vSwitches en estado Modifying dentro de la misma VPC. Inténtelo de nuevo posteriormente.
400	InvalidCirdrBlock.MaskLength	Specified CIDR block is not valid .	El formato del bloque CIDR es incorrecto.
400	IncorrectVpcStatus	Current VPC status does not support this operation.	No se puede ejecutar esta operación mientras la VPC se encuentra en su estado actual.
400	CreateVSwitch.IncorrectStatus.cbnStatus	Current CBN status does not support this operation.	No es posible crear un vSwitch cuando la instancia CEN está en el estado actual.
400	InvalidCidrBlock.Malformed	Specified CIDR block is not valid.	El formato del bloque CIDR proporcionado no es válido.
400	MissingParameter	Miss mandatory parameter.	Faltan uno o más parámetros obligatorios. Verifique que todos los parámetros requeridos estén configurados antes de invocar esta operación.
400	IncorrectVSwitchStatus	VSwitch Creation simultaneously is not supported.	El sistema no pudo crear el vSwitch porque uno o varios vSwitches pertenecientes a la VPC están en estado Creating.
400	TaskConflict	The operation is too frequent, TaskConflict.	El sistema se encuentra ocupado. Inténtelo nuevamente más tarde.
400	Forbidden.VpcNotFound	Specified VPC can not found.	La VPC especificada no existe.
400	RouteConflict.AlreadyExist	Route conflict exists in routing table.	Existen conflictos de rutas en la tabla de enrutamiento.
400	IncorrectStatus.cbnStatus	Current CBN status does not support this operation.	El estado de la instancia CEN no es válido.
400	UnsupportedFeature.CloudBoxIpv6	The IPv6 feature is not supported by cloud box.	No es posible crear una dirección IPv6 para un cloud box.
400	OperationDenied.VpcPeerExist	The operation is not allowed because the VPC peer exists.	La VPC tiene una conexión de emparejamiento VPC activa.
400	OperationDenied.CenAttached	The operation is not allowed because the VPC is attached to CEN.	No se permite la operación porque la VPC está vinculada a una instancia CEN.
400	OperationDenied.NatgwExist	The operation is not allowed because the NAT gateway exists in VPC.	La operación está restringida debido a la existencia de puertas de enlace NAT en la VPC.
400	MissingParam.Ipv6CidrBlock	The parameter Ipv6CidrBlock is mandatory.	El parámetro Ipv6CidrBlock es obligatorio.
400	OperationDenied.VpcPeerExists	The operation is not allowed because the VpcPeer exists.	Existe una conexión de emparejamiento VPC asociada a esta VPC.
404	InvalidZoneId.NotFound	Specified zone does not exist.	El ID de zona no es válido.
404	InvalidVpcId.NotFound	Specified VPC does not exist.	No se encontró la VPC indicada.

Para obtener una lista completa de códigos de error, consulte los Códigos de error del servicio.