CreateVpnGateway - - Centro de documentación de Alibaba Cloud

Cree una puerta de enlace VPN.

Notas de uso

Antes de crear una puerta de enlace VPN, se recomienda conocer sus límites. Para obtener más información, consulte Límites de las puertas de enlace VPN.
En algunas regiones, las puertas de enlace VPN solo admiten conexiones IPsec-VPN en modo de túnel doble. Al invocar CreateVpnGateway en estas regiones, debe especificar VSwitchId y DisasterRecoveryVSwitchId además de los parámetros obligatorios. Para más detalles sobre las regiones y zonas compatibles con el modo de túnel doble, consulte Actualizar una puerta de enlace VPN para habilitar el modo de túnel doble.
La operación CreateVpnGateway es asíncrona. Tras enviar la solicitud, el sistema devuelve un ID de solicitud y ejecuta la tarea en segundo plano. Llame a DescribeVpnGateway para consultar el estado de la tarea.
- Si la puerta de enlace VPN se encuentra en estado provisioning, significa que está en proceso de creación.
- Cuando la puerta de enlace VPN pasa al estado active, la creación se ha completado.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, se recomienda realizar esta llamada desde OpenAPI Explorer. Esta herramienta genera dinámicamente código de ejemplo de la operación para distintos SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	CreateVpnGateway	Operación que desea ejecutar. Establezca el valor en CreateVpnGateway.
RegionId	String	Sí	cn-hangzhou	ID de región de la puerta de enlace VPN. Llame a la operación DescribeRegions para obtener la lista actualizada de regiones.
Name	String	No	MYVPN	Nombre de la puerta de enlace VPN. El valor predeterminado es el ID de la propia puerta de enlace. El nombre debe tener entre 2 y 100 caracteres y no puede comenzar con `http://` ni con `https://`. Debe iniciar con una letra y puede contener letras, dígitos, guiones bajos (_), guiones (-) y puntos (.). No se admiten otros caracteres especiales.
VpcId	String	Sí	vpc-bp1ub1yt9cvakoelj****	ID de la virtual private cloud (VPC) donde se creará la puerta de enlace VPN.
InstanceChargeType	String	No	Valor de ejemplo para el sitio de Alibaba Cloud China: PREPAY. Valor de ejemplo para el sitio internacional de Alibaba Cloud: POSTPAY.	Método de facturación de la puerta de enlace VPN. Establezca el valor en POSTPAY, que corresponde al modelo pay-as-you-go.
Period	Integer	No	1	Duración de la suscripción. Unidad: meses. Valores válidos: de 1 a 9, 12, 24 y 36.
AutoPay	Boolean	No	false	Indica si se habilita el pago automático para la puerta de enlace VPN. Valores válidos: true false (predeterminado)
Bandwidth	Integer	Sí	5	Ancho de banda máximo de la puerta de enlace VPN. Unidad: Mbit/s. Si va a crear una puerta de enlace VPN pública, los valores válidos son 10, 100, 200, 500 y 1000. Si va a crear una puerta de enlace VPN privada, los valores válidos son 200 y 1000. Nota En ciertas regiones, el ancho de banda máximo admitido por una puerta de enlace VPN es de 200 Mbit/s. Para más información, consulte Límites de las puertas de enlace VPN.
EnableIpsec	Boolean	No	true	Indica si se habilita la función IPsec-VPN. Valores válidos: true (predeterminado) false
EnableSsl	Boolean	No	false	Indica si se habilita la función SSL-VPN en la puerta de enlace VPN. Valores válidos: true false (predeterminado)
SslConnections	Integer	No	5	Número máximo de clientes que pueden conectarse simultáneamente. Valores válidos: 5 (predeterminado), 10, 20, 50, 100, 200, 500 y 1000.
VSwitchId	String	No	vsw-bp1j5miw2bae9s2vt****	vSwitch al que se asociará la puerta de enlace VPN. Este parámetro es obligatorio si invoca la operación en una región compatible con el modo de túnel doble. Debe especificar un vSwitch y también definir DisasterRecoveryVSwitchId. Si la región solo admite el modo de túnel único y no se especifica ningún vSwitch, el sistema asigna uno automáticamente.
VpnType	String	No	Normal	Tipo de puerta de enlace VPN. Valores válidos: Normal (predeterminado)
ClientToken	String	No	02fb3da4****	Token de cliente utilizado para garantizar la idempotencia de la solicitud. Genere este token desde el cliente, pero asegúrese de que sea único para cada solicitud distinta. El token de cliente solo puede contener caracteres ASCII. Nota Si no especifica este parámetro, el sistema utiliza automáticamente el ID de solicitud como token de cliente. El ID de solicitud puede variar entre solicitudes.
NetworkType	String	No	public	Tipo de red de la puerta de enlace VPN. Valores válidos: public (predeterminado) private
DisasterRecoveryVSwitchId	String	No	vsw-p0wiz7obm0tbimu4r****	Segundo vSwitch al que se asociará la puerta de enlace VPN. Este parámetro es obligatorio si invoca la operación en una región compatible con el modo de túnel doble. Debe especificar dos vSwitch ubicados en zonas distintas dentro de la VPC asociada para implementar recuperación ante desastres entre zonas. En regiones con una sola zona available, no es posible configurar recuperación ante desastres entre zonas. Se recomienda especificar dos vSwitch en la misma zona para lograr alta disponibilidad; puede utilizar el mismo vSwitch en ambos campos. Para más información sobre las regiones y zonas compatibles con el modo de túnel doble, consulte Actualizar una puerta de enlace VPN para habilitar el modo de túnel doble.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
VpnGatewayId	String	vpn-uf68lxhgr7ftbqr3p****	ID de la puerta de enlace VPN.
RequestId	String	EB2C156A-41F8-49CC-A756-D55AFC8BFD69	ID de la solicitud.
Name	String	MYVPN	Nombre de la puerta de enlace VPN.
OrderId	Long	208240895400460	ID del pedido. Si el pago automático está deshabilitado, complete manualmente el pago de la puerta de enlace VPN en la consola de administración de Alibaba Cloud.

Ejemplos

Solicitudes de ejemplo

http(s)://[Endpoint]/?Action=CreateVpnGateway
&RegionId=cn-hangzhou
&Name=MYVPN
&VpcId=vpc-bp1ub1yt9cvakoelj****
&InstanceChargeType=PREPAY
&Period=1
&AutoPay=false
&Bandwidth=5
&EnableIpsec=true
&EnableSsl=true
&SslConnections=5
&VSwitchId=vsw-bp1j5miw2bae9s2vt****
&VpnType=Normal
&ClientToken=02fb3da4****
&NetworkType=public
&Common request parameters

Respuestas exitosas de ejemplo

Formato XML

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

<CreateVpnGatewayResponse>
    <VpnGatewayId>vpn-uf68lxhgr7ftbqr3p****</VpnGatewayId>
    <RequestId>EB2C156A-41F8-49CC-A756-D55AFC8BFD69</RequestId>
    <Name>MYVPN</Name>
    <OrderId>208240895400460</OrderId>
</CreateVpnGatewayResponse>

Formato JSON

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

{
  "VpnGatewayId" : "vpn-uf68lxhgr7ftbqr3p****",
  "RequestId" : "EB2C156A-41F8-49CC-A756-D55AFC8BFD69",
  "Name" : "MYVPN",
  "OrderId" : 208240895400460
}

Códigos de error

HttpCode	Código de error	Mensaje de error	Descripción
400	Resource.QuotaFull	The quota of resource is full	La cuota del recurso se ha agotado.
400	OperationFailed.SslNotSupport	Enable ssl vpn with private networkType is unsupported.	No es posible habilitar la función SSL en una puerta de enlace VPN privada.
400	Forbidden.TagKey.Duplicated	The specified tag key already exists.	Existen etiquetas duplicadas en los recursos.
400	SizeLimitExceeded.TagNum	The maximum number of tags is exceeded.	Se alcanzó el límite máximo de etiquetas.
400	InvalidParameter.TagValue	The specified parameter TagValue is invalid.	El valor de etiqueta especificado no es válido.
400	InvalidParameter.TagKey	The specified parameter TagKey is invalid.	La clave de etiqueta especificada no es válida.
400	Duplicated.TagKey	The specified parameter TagKey is duplicated.	La clave de etiqueta especificada ya existe.
400	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocurrió un error interno.
404	InvalidRegionId.NotFound	The specified region is not found during access authentication.	No se encontró la región especificada durante la autenticación de acceso.

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