Policy > Networking > Network Services > VPN > IPSEC > Sessions

Create or fully replace IPSec VPN session (Deprecated)

Create or fully replace IPSec VPN session for a given locale
service under Tier-1.
Revision is optional for creation and required for update.
Deprecated: This API is deprecated. Please use PUT /infra/tier-1s/<tier-1-id>/ipsec-vpn-services/<service-id>/sessions/<session-id> instead. Note: Please note that request is validated and any error messages returned from validation may include the new VPN path instead of the deprecated path. Both new path and old path refer to same resource. Also VPN path returned in the Alarm, GPRR payload may include the new VPN path.

Request:

Method:
PUT
URI Path(s):
/policy/api/v1/infra/tier-1s/{tier-1-id}/locale-services/{locale-service-id}/ipsec-vpn-services/{service-id}/sessions/{session-id}
Request Headers:
n/a
Query Parameters:
n/a
Request Body:
PolicyBasedIPSecVpnSession+
RouteBasedIPSecVpnSession+

Example Request:

PUT https://<policy-mgr>/policy/api/v1/infra/tier-1s/int_net/locale-services/default/ipsec-vpn-services/default/sessions/rbs-1 { "resource_type": "RouteBasedIPSecVpnSession", "display_name" : "rbs-1", "description" : "Route based vpn session 1", "enabled" : true, "connection_initiation_mode" : "INITIATOR", "authentication_mode" : "PSK", "tunnel_profile_path" : "/infra/ipsec-vpn-tunnel-profiles/custom-tunnel-profile", "dpd_profile_path" : "/infra/ipsec-vpn-dpd-profiles/custom-dpd-profile", "ike_profile_path" : "/infra/ipsec-vpn-ike-profiles/custom-ike-profile", "local_endpoint_path" : "/infra/tier-1s/int_net/locale-services/default/ipsec-vpn-services/default/local-endpoints/default-le", "psk" : "test", "peer_address" : "2.1.4.1", "peer_id" : "2.1.4.1", "tunnel_interfaces" : [ { "ip_subnets" : [ { "ip_addresses" : [ "169.90.50.1" ], "prefix_length" : 30 } ], "_revision" : 2, } ], "_revision" : 0 }

Successful Response:

Response Code:
200 OK
Response Headers:
Content-type: application/json
Response Body:
PolicyBasedIPSecVpnSession+
RouteBasedIPSecVpnSession+

Example Response:

{ "resource_type": "RouteBasedIPSecVpnSession", "display_name" : "rbs-1", "description" : "Route based vpn session 1", "path": "/infra/tier-1s/int_net/locale-services/default/ipsec-vpn-services/default/sessions/rbs-1", "parent_path": "/infra/tier-1s/int_net/locale-services/default/ipsec-vpn-services/default", "relative_path": "rbs-1", "enabled" : true, "connection_initiation_mode" : "INITIATOR", "authentication_mode" : "PSK", "tunnel_profile_path" : "/infra/ipsec-vpn-tunnel-profiles/custom-tunnel-profile", "dpd_profile_path" : "/infra/ipsec-vpn-dpd-profiles/custom-dpd-profile", "ike_profile_path" : "/infra/ipsec-vpn-ike-profiles/custom-ike-profile", "local_endpoint_path" : "/infra/tier-1s/int_net/locale-services/default/ipsec-vpn-services/default/local-endpoints/default-le", "psk" : "test", "peer_address" : "2.1.4.1", "peer_id" : "2.1.4.1", "tunnel_interfaces" : [ { "resource_type" : "IPSecVpnTunnelInterface", "path": "/infra/tier-1s/int_net/locale-services/default/ipsec-vpn-services/default/sessions/rbs-1/interfaces/default-tunnel-interface", "parent_path": "/infra/tier-1s/int_net/locale-services/default/ipsec-vpn-services/default/sessions/rbs-1", "relative_path": "default-tunnel-interface", "ip_subnets" : [ { "ip_addresses" : [ "169.90.50.1" ], "prefix_length" : 30 } ], "_create_user": "admin", "_create_time": 1516385949942, "_last_modified_user": "admin", "_last_modified_time": 1516385949942, "_system_owned": false, "_protection": "NOT_PROTECTED", "_revision" : 2, } ], "_create_user": "admin", "_create_time": 1516385949942, "_last_modified_user": "admin", "_last_modified_time": 1516385949942, "_system_owned": false, "_protection": "NOT_PROTECTED", "_revision" : 0 }

Required Permissions:

crud

Feature:

policy_vpn

Additional Errors: