Create SSL VPN Connection

Creates an SSL VPN Connection.

URI

/v2.0/vpn/ssl-vpn-connections

HTTP method

POST

Request parameter

Key Description Type Required/optional
name name of the SSL VPN connection

(default: "")

string Optional
admin_state_up Administrative state of the SSL VPN connection. If false (down), port does not forward packets

(default: true)

bool Optional
client_address_pool_cidr Client address pool subnet which will be used by sslvpn client cidr Required
credential_id UUID for VPNCredential Container on keymanagement

When you use client certificate offered by K5 to connect SSL-VPN, please omit this parameter.

uuid-str Optional
vpnservice_id UUID for VPNService uuid-str Required
availability_zone The Availability Zone name.

If you don't specify, the resource will be created in default Availability Zone.

(default: default Availability Zone selected)

string Optional
protocol Communication protocol used by VPN connection: tcp

(only tcp can be specified but this parameter cannot be committed)

string Required

Example request


{
  "ssl_vpn_connection":{
    "name":"conn1",
    "client_address_pool_cidr":"10.8.0.0/24",
    "admin_state_up": true,
    "credential_id": "434a9843-ecc0-4653-8f3a-e604d9d7aadc",
    "vpnservice_id":"cc91b7af-8304-4aff-ad07-86bdbaae2e93",
    "availability_zone": "AZ1"
    "protocol": "tcp"
  }
}
     

Response codes

Status code Description
201 Normal response codes
Bad Request (400) Error response codes
Unauthorized (401) Error response codes

Response body (normal status)


{
  "ssl_vpn_connection":{
    "id":"76ee7216-5eef-470c-a7d2-ce4a7461b046",
    "name":"conn1",
    "status":"DOWN",
    "client_address_pool_cidr":"10.8.0.0/24",
    "credential_id": "434a9843-ecc0-4653-8f3a-e604d9d7aadc",
    "admin_state_up": true,
    "tenant_id":"1219ecaa01e0254dac4f08c9123aefcd",
    "vpnservice_id":"cc91b7af-8304-4aff-ad07-86bdbaae2e93",
    "availability_zone": "AZ1"
  }
}
     

Description of response body (normal status)

Item Number of occurrences of element Description
tenant_id   Unique identifier for owner of the SSL VPN connection.
name   name of the SSL VPN connection.
admin_state_up   Administrative state of the SSL VPN connection. If false (down), port does not forward packets.
client_address_pool_cidr   Client address pool subnet which will be used by sslvpn client
credential_id   UUID for VPNCredential Container on keymanagement.

When you didn't specify this parameter at creating the resource, this value returns 'null'.

vpnservice_id   UUID for VPNService
id   UUID for SSL VPN connection Object.
status   Indicates whether the SSL VPN connection is currently operational. Possible values include:

ACTIVE DOWN PENDING_CREATE ERROR

availability_zone   The Availability Zone name