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

Crea un bloque CIDR reservado para un vSwitch mediante la operación CreateVSwitchCidrReservation.

Descripción de la operación

Al invocar esta operación para crear un bloque CIDR reservado para un vSwitch, tenga en cuenta los siguientes puntos:

El número máximo de bloques CIDR IPv4 reservados y bloques CIDR IPv6 reservados en una VPC es de 100 para cada uno.
Un bloque CIDR reservado no puede contener las direcciones IP reservadas por el sistema del vSwitch al que pertenece.
- Bloque CIDR IPv4: la primera dirección IP y las últimas tres direcciones IP del vSwitch son direcciones IP reservadas por el sistema.
- Bloque CIDR IPv6: la primera dirección IP y las últimas nueve direcciones IP del vSwitch son direcciones IP reservadas por el sistema.
La operación CreateVSwitchCidrReservation es asíncrona. Después de enviar una solicitud, el sistema devuelve un ID de instancia, pero el bloque CIDR reservado para un vSwitch aún no se ha creado. El sistema continúa ejecutando la tarea en segundo plano. Puede invocar ListVSwitchCidrReservations para consultar el estado de creación del bloque CIDR reservado para un vSwitch:
- Si el bloque CIDR reservado para un vSwitch está en el estado Assigning, el bloque CIDR reservado para un vSwitch se está asignando.
- Si el bloque CIDR reservado para un vSwitch está en el estado Assigned, el bloque CIDR reservado para un vSwitch ya se ha asignado.

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

create

*VSwitchCidrReservation.

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
Tag	array<object>	No	Las etiquetas del recurso.
	object	No	La información de la etiqueta.
Key	string	No	La clave de etiqueta del recurso. Puede especificar hasta 20 claves de etiqueta. Si especifica este parámetro, el valor no puede ser una cadena vacía. Una clave de etiqueta puede tener hasta 128 caracteres de longitud. No puede empezar con aliyun ni acs: y no puede contener `http://` ni `https://`.	FinanceDept
Value	string	No	El valor de etiqueta del recurso. Puede especificar hasta 20 valores de etiqueta. El valor puede ser una cadena vacía. Un valor de etiqueta puede tener hasta 128 caracteres de longitud. No puede empezar con aliyun ni acs: y no puede contener `http://` ni `https://`.	FinanceJoshua
VSwitchId	string	Sí	El ID del vSwitch al que pertenece el bloque CIDR reservado para un vSwitch.	vsw-25navfgbue4g****
VSwitchCidrReservationName	string	No	El nombre del bloque CIDR reservado para un vSwitch. El nombre debe tener de 1 a 128 caracteres de longitud y debe comenzar con una letra o un carácter chino. Puede contener dígitos, guiones bajos (_) y guiones (-). No puede empezar con `http://` ni `https://`.	ReservationName
VSwitchCidrReservationDescription	string	No	La descripción del bloque CIDR reservado para un vSwitch. Si deja este parámetro vacío, el valor predeterminado está vacío. La descripción debe tener de 1 a 256 caracteres de longitud y debe comenzar con una letra o un carácter chino. No puede empezar con `http://` ni `https://`.	ReservationDescription
IpVersion	string	No	La versión de IP del bloque CIDR reservado para un vSwitch. Valores válidos: IPv4 (predeterminado) IPv6 Nota No es necesario especificar este parámetro al crear un bloque CIDR reservado IPv4 para un vSwitch. Este parámetro es obligatorio al crear un bloque CIDR reservado IPv6 para un vSwitch.	IPv4
VSwitchCidrReservationMask	string	No	La máscara del bloque CIDR reservado para un vSwitch. Si IpVersion se establece en IPv4, la longitud de la máscara del bloque CIDR reservado para un vSwitch debe ser al menos 2 bits mayor que la máscara del bloque CIDR IPv4 del vSwitch y no puede superar los 28. Si IpVersion se establece en IPv6, la longitud de la máscara del bloque CIDR reservado para un vSwitch debe ser mayor que la máscara del bloque CIDR IPv6 del vSwitch y no puede superar los 80. Nota Debe especificar el parámetro VSwitchCidrReservationMask o el parámetro VSwitchCidrReservationCidr. El bloque CIDR reservado no puede contener las direcciones IP reservadas por el sistema del vSwitch al que pertenece.	28
VSwitchCidrReservationCidr	string	No	El bloque CIDR reservado para un vSwitch. Si IpVersion se establece en IPv4, el bloque CIDR reservado para un vSwitch debe ser un subconjunto propio del bloque CIDR IPv4 del vSwitch, y la longitud de la máscara no puede superar los 28. Si IpVersion se establece en IPv6, el bloque CIDR reservado para un vSwitch debe ser un subconjunto propio del bloque CIDR IPv6 del vSwitch, y la longitud de la máscara no puede superar los 80. Nota Debe especificar el parámetro VSwitchCidrReservationMask o el parámetro VSwitchCidrReservationCidr. El bloque CIDR reservado no puede contener las direcciones IP reservadas por el sistema del vSwitch al que pertenece.	192.168.1.64/28
VSwitchCidrReservationType	string	No	El tipo del bloque CIDR reservado para un vSwitch. Valores válidos: prefix, que indica que las direcciones IP se asignan por bloque CIDR. Nota Cuando los usuarios o los servicios en la nube asignan automáticamente bloques CIDR a las interfaces de red elásticas (NIC), los bloques CIDR deben asignarse desde el bloque CIDR reservado. Si las direcciones IP del bloque CIDR reservado se agotan, el sistema devuelve un error.	prefix
IpPrefixNumber	integer	No	El número esperado de prefijos de IP para reservar. Valores válidos: de 1 a 32.	1
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 token solo puede contener caracteres ASCII. Nota Si no especifica este parámetro, el sistema utiliza automáticamente el RequestId de la solicitud de API como ClientToken. El RequestId puede ser diferente para cada solicitud de API.	123e4567-e89b-12d3-a456-426655440000
DryRun	boolean	No	Especifica si se debe realizar una ejecución de prueba. Valores válidos: true: realiza una ejecución de prueba. El sistema comprueba los parámetros obligatorios, el formato de la solicitud y las restricciones comerciales. Si la comprobación falla, se devuelve el error correspondiente. Si la comprobación se realiza correctamente, se devuelve el código de error `DryRunOperation`. false (predeterminado): envía una solicitud normal. Si la comprobación se realiza correctamente, se devuelve un código de estado HTTP 2xx y se crea el bloque CIDR reservado para un vSwitch.	false
RegionId	string	Sí	El ID de la región del vSwitch. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.	cn-hangzhou

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	El ID de la instancia del bloque CIDR reservado para un vSwitch.
RequestId	string	El ID de la solicitud.	54B48E3D-DF70-471B-AA93-08E683A1B45
VSwitchCidrReservationId	string	El ID de la instancia del bloque CIDR reservado para un vSwitch.	vcr-bp1m12saqteraw3rp****

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "54B48E3D-DF70-471B-AA93-08E683A1B45",
  "VSwitchCidrReservationId": "vcr-bp1m12saqteraw3rp****"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	IllegalParamFormat	IllegalParamFormat	El formato del parámetro es incorrecto.
400	IllegalParamFormat.VSwitchCidrReservationCidr	The param format of VSwitchCidrReservationCidr is illegal.	El formato del parámetro VSwitchCidrReservationCidr no es válido.
400	ResourceNotFound.VSwitch	The specified resource of VSwitch is not found.	La instancia de vSwitch especificada no existe.
400	UnsupportedFeature.ReservedType	The specified ReservedType is not supported.	El ReservedType especificado no es compatible.
400	UnsupportedFeature.VSwitchIpv6	The ipv6 feature of switch is not supported.	El vSwitch especificado no tiene IPv6 habilitado.
400	OperationFailed.VSwitchCidrReservationCidr	The specified VSwitchCidrReservationCidr conflicts with existed cidr reservation or vswitch cidr.	El VSwitchCidrReservationCidr especificado entra en conflicto con un bloque CIDR de VSwitchCidrReservation existente.
400	MissingParam.CidrReservationMaskOrCidrReservationCidr	Either VSwitchCidrReservationMask or VSwitchCidrReservationCidr should be specified.	Los parámetros VSwitchCidrReservationMask y VSwitchCidrReservationCidr no pueden estar vacíos simultáneamente. Especifique uno de ellos e inténtelo de nuevo.
400	UnsupportedRegion	UnsupportedRegion	La región actual no admite operaciones en rutas de lista de prefijos.
400	UnsupportedFeature.VpcAdvancedFeature	UnsupportedFeature.VpcAdvancedFeature	La VPC a la que pertenece el VSwitch especificado no admite funciones avanzadas. Utilice un VSwitch diferente e inténtelo de nuevo.
400	QuotaExceeded.CidrReservationCount	The quota of VSwitchCidrReservation is exceeded.	El número de instancias de VSwitchCidrReservation excede la cuota.
400	Conflict.CidrReservationMaskAndCidrReservationCidr	The specified VSwitchCidrReservationMask and VSwitchCidrReservationCidr is conflict.	El valor especificado de VSwitchCidrReservationMask entra en conflicto con VSwitchCidrReservationCidr. Modifique los parámetros según la descripción de la métrica en la documentación de la API e inténtelo de nuevo.
400	OperationFailed.CidrNotEnoughInVSwitch	No enough cidr to allocate in this vswitch.	El vSwitch especificado no tiene suficientes bloques CIDR para asignar una CidrReservation.
400	OperationFailed.SystemReservedIpContained	The specified VSwitchCidrReservationCidr cannot contain system reserved IP addresses.	El VSwitchCidrReservationCidr especificado no puede contener direcciones IP reservadas por el sistema.
400	OperationFailed.AlreadyUsedIpContained	The specified VSwitchCidrReservationCidr cannot contain already used IP addresses.	El bloque CIDR reservado especificado no puede contener direcciones IP que ya estén en uso.
400	IncorrectStatus.VSWITCH	The status of the specified VSwitch is invalid.
400	IllegalParam.VSwitchCidrReservationMask	The specified VSwitchCidrReservationMask must be at least 2 bits greater than the vSwitch mask.	El parámetro VSwitchCidrReservationMask no es válido. Consulte la descripción del parámetro en la referencia de la API e inténtelo de nuevo.
400	QuotaExceeded.VSwitchCidrReservationMask	The operation is failed because of %s. The mask of the reserved subnet cidr exceeds the current default mask of IP Prefix, %s/%s.	El valor de VSwitchCidrReservationMask excede la cuota. Consulte la descripción del parámetro en la referencia de la API e inténtelo de nuevo.
400	IllegalParam.ReservedType	IpPrefixNumber is only supported with Prefix reserved type.	IpPrefixNumber solo se admite para el tipo de reserva Prefix.
400	MissingParam.VSwitchCidrReservationParam	One of IpPrefixNumber, VSwitchCidrReservationMask, or VSwitchCidrReservationCidr must be specified.	Se debe especificar uno de IpPrefixNumber, VSwitchCidrReservationMask o VSwitchCidrReservationCidr.
400	Conflict.VSwitchCidrReservationParam	IpPrefixNumber cannot be used together with VSwitchCidrReservationCidr or VSwitchCidrReservationMask.	IpPrefixNumber no se puede utilizar junto con VSwitchCidrReservationCidr o VSwitchCidrReservationMask.

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.