CreateVSwitch - Virtual Private Cloud - Centro de documentación de Alibaba Cloud

Crea un vSwitch.

Descripción de la operación

Al llamar a esta operación para crear un vSwitch, tenga en cuenta los siguientes puntos:

El número de vSwitches en cada VPC no puede exceder 150.
La primera y las últimas tres direcciones IP de cada bloque CIDR de vSwitch están reservadas por el sistema. Por ejemplo, las direcciones IP reservadas por el sistema para 192.168.1.0/24 son 192.168.1.0, 192.168.1.253, 192.168.1.254 y 192.168.1.255.
El número de instancias de servicio en la nube en un vSwitch no puede exceder el número de instancias de servicio en la nube disponibles restantes en la VPC (15,000 menos el número actual de instancias de servicio en la nube).
Una instancia de servicio en la nube solo puede pertenecer a un vSwitch.
Los vSwitches no admiten multidifusión ni difusión.
Después de crear un vSwitch, no puede modificar su bloque CIDR.
La operación CreateVSwitch es asíncrona. Después de enviar una solicitud, el sistema devuelve un ID de instancia, pero el vSwitch aún no se ha creado. La tarea en segundo plano sigue en curso. Puede llamar a DescribeVSwitchAttributes para consultar el estado de creación del vSwitch:
- Cuando el vSwitch se encuentra en el estado Pending, se está configurando.
- Cuando el vSwitch se encuentra en el estado Available, el vSwitch está disponible.
La operación CreateVSwitch no admite la creación simultánea de vSwitches en la misma VPC.
Al llamar a la operación CreateVSwitch, el bloque CIDR del vSwitch no puede estar dentro de los siguientes rangos de direcciones reservados: 100.64.0.0/10, 127.0.0.0/8, 169.254.0.0/16 o 224.0.0.0/4.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

vpc:CreateVSwitch

create

*VPC.

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

*VSwitch.

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

vpc:tag

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
Tag	array<object>	No	Las etiquetas del recurso.
	object	No	La etiqueta.
Key	string	No	La clave de etiqueta del recurso. Puede especificar hasta 20 claves de etiqueta. La clave de etiqueta no puede ser una cadena vacía. Una clave de etiqueta puede tener hasta 128 caracteres de longitud. No puede empezar con `aliyun` ni con `acs:`, y no puede contener `http://` ni `https://`.	FinanceJoshua
Value	string	No	El valor de etiqueta del recurso. Puede especificar hasta 20 valores de etiqueta. El valor de etiqueta puede ser una cadena vacía. Un valor de etiqueta puede tener hasta 128 caracteres de longitud. No puede empezar con `aliyun` ni con `acs:`, y no puede contener `http://` ni `https://`.	FinanceDept
ZoneId	string	Sí	El ID de la zona en la que se creará el vSwitch. Puede llamar a la operación DescribeZones para consultar el ID de zona.	cn-hangzhou-b
RegionId	string	No	El ID de región del vSwitch que se va a crear. Puede llamar a la operación DescribeRegions para consultar el ID de región.	cn-hangzhou
CidrBlock	string	No	El bloque CIDR del vSwitch. El bloque CIDR del vSwitch debe cumplir los siguientes requisitos: La longitud de máscara del bloque CIDR del vSwitch debe ser de 16 a 29 bits. El bloque CIDR del vSwitch debe ser un subconjunto del bloque CIDR de la VPC a la que pertenece el vSwitch. El bloque CIDR del vSwitch no puede ser igual al bloque CIDR de destino de una entrada de ruta en la VPC, pero puede ser un subconjunto del bloque CIDR de destino. El bloque CIDR del vSwitch no puede estar dentro de los siguientes rangos de direcciones reservados: 100.64.0.0/10, 127.0.0.0/8, 169.254.0.0/16 o 224.0.0.0/4. Nota Después de crear un vSwitch, no puede modificar su bloque CIDR.	172.16.0.0/24
CidrMask	integer	No	La longitud de máscara del bloque CIDR IPv4 del vSwitch. Nota La longitud de máscara del bloque CIDR IPv4 del vSwitch debe ser de 16 a 29 bits. Debe especificar al menos uno de los parámetros CidrBlock y CidrMask.	24
Ipv6CidrBlock	integer	No	Los últimos 8 bits del bloque CIDR IPv6 del vSwitch. Valores válidos: 0 a 255. Solo puede especificar este parámetro para asignar un bloque CIDR IPv6 al vSwitch cuando la VPC a la que pertenece el vSwitch tiene habilitado IPv6. Una vez asignado el bloque CIDR IPv6, no se puede cambiar a otro bloque CIDR. Asegúrese de que el bloque CIDR no se superponga con los de otros vSwitches en la VPC.	12
Ipv6CidrMask	integer	No	La máscara de subred del bloque CIDR IPv6 del vSwitch. Solo puede especificar este parámetro para asignar un bloque CIDR IPv6 al vSwitch cuando la VPC a la que pertenece el vSwitch tiene habilitado IPv6. Nota Solo se admite 64.	64
VpcId	string	Sí	El ID de la VPC a la que pertenece el vSwitch.	vpc-257gqcdfvx6n****
VSwitchName	string	No	El nombre del vSwitch. El nombre debe tener de 1 a 128 caracteres de longitud y no puede empezar con `http://` ni con `https://`.	vSwitch-1
Description	string	No	La descripción del vSwitch. La descripción debe tener de 1 a 256 caracteres de longitud y no puede empezar con `http://` ni con `https://`.	vSwitch
ClientToken	string	No	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede utilizar el cliente para generar el token, pero debe asegurarse de que el token sea único entre las diferentes solicitudes. El valor de ClientToken solo puede contener caracteres ASCII. Nota Si no especifica este parámetro, el sistema utiliza el RequestId de la solicitud de API como ClientToken. El RequestId puede variar para cada solicitud de API.	0c593ea1-3bea-11e9-b96b-88e9fe63****
VpcIpv6CidrBlock	string	No	El bloque CIDR IPv6 de la VPC. Si la VPC a la que pertenece el vSwitch tiene varios bloques CIDR IPv6, puede especificar este parámetro para determinar el rango de bloques CIDR IPv6 para el vSwitch. Si no especifica este parámetro, se utiliza el bloque CIDR IPv6 asignado cuando se habilitó IPv6 para la VPC.	2408:XXXX:0:6a::/56

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Los parámetros de respuesta.
VSwitchId	string	El ID del vSwitch creado.	vsw-25navfgbue4g****
RequestId	string	El ID de solicitud.	0ED8D006-F706-4D23-88ED-E11ED28DCAC0

Ejemplos

Respuesta exitosa

JSON Formato

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

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
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.	El formato del nombre del vSwitch no es válido. Verifique el formato del nombre del 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.	Falta el parámetro requerido VpcId.
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.	El número de vSwitches ha alcanzado el límite de cuota. Reduzca el número de vSwitches e inténtelo de nuevo.
400	IncorrectRouteEntryStatus	Some route entry status blocked this operation.
400	IncorrectVSwitchStatus	Some virtual switch is modifying within the same VPC.	No se pudo crear el vSwitch porque un vSwitch en la VPC se encuentra en estado Creating.
400	InvalidCirdrBlock.MaskLength	Specified CIDR block is not valid .	El formato del bloque CIDR no es válido.
400	IncorrectVpcStatus	Current VPC status does not support this operation.
400	CreateVSwitch.IncorrectStatus.cbnStatus	Current CBN status does not support this operation.	El estado actual de la instancia de Cloud Enterprise Network (CEN) no admite la operación para crear un conmutador virtual (vSwitch).
400	InvalidCidrBlock.Malformed	Specified CIDR block is not valid.
400	MissingParameter	Miss mandatory parameter.
400	TaskConflict	The operation is too frequent, TaskConflict.	Las operaciones de EIP son demasiado frecuentes.
400	VPC.SWITCH.RULE.QUOTA.NOT.EXISTS	vSwitch quota rule not exists.
400	Forbidden.VpcNotFound	Specified VPC can not found.	La VPC especificada no existe. Verifique si la VPC es correcta.
400	RouteConflict.AlreadyExist	Route conflict exists in routing table.	Existe un conflicto de rutas en la tabla de rutas.
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.	El estado actual de la CBN es incorrecto.
400	OperationFailed.NotifyCenCreate	Failed to notify cen when create vswitch.
400	OperationFailed.DistibuteLock	Distibute lock fail.	El recurso está bloqueado. No se permiten operaciones.
400	UnsupportedFeature.CloudBoxIpv6	The IPv6 feature is not supported by cloud box.	CloudBox no admite la creación de IPv6.
400	OperationDenied.VpcPeerExist	The operation is not allowed because the VPC peer exists.	La operación no está permitida porque la VPC tiene una conexión de emparejamiento.
400	OperationDenied.CenAttached	The operation is not allowed because the VPC is attached to CEN.	La operación no está permitida porque la VPC está asociada con una instancia de Cloud Enterprise Network (CEN).
400	OperationDenied.NatgwExist	The operation is not allowed because the NAT gateway exists in VPC.	La operación no está permitida porque existe una puerta de enlace NAT en la 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.	La operación no está permitida porque existe una conexión de emparejamiento de VPC en la VPC.
400	IllegalParam.CidrBlock	The param of CidrBlock [%s] is illegal.	El bloque CIDR no es vá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.	La zona actual se ha deshabilitado. No se permite crear un vSwitch en esta zona.
400	OperationDenied.VpcIpv6CidrBlockNotExist	The specified VpcIpv6CidrBlock does not exist in the VPC.	El VpcIpv6CidrBlock especificado no existe en la 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.	La operación se denegó porque los recursos de bloques CIDR disponibles son insuficientes.
400	OperationDenied.Ipv6CidrMaskInvalid	The specified Ipv6CidrMask is invalid, only %s is allowed.	La máscara IPv6 especificada no es válida. Solo se admite %s.
400	ParamExclusive.CidrBlockAndCidrMask	CidrBlock and CidrMask are mutually exclusive.	Los parámetros CidrBlock y CidrMask son mutuamente excluyentes.
400	MissingParam.Ipv6CidrBlockOrIpv6CidrMask	Ipv6CidrBlock or Ipv6CidrMask must be specified.	Se debe especificar al menos uno de Ipv6CidrBlock o Ipv6CidrMask.
400	MissingParam.CidrBlockOrCidrMask	CidrBlock or CidrMask is not specified.	Error al agregar un bloque CIDR al pool de direcciones porque falta el parámetro de bloque CIDR o de máscara.
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 error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.