List IPSec tunnels

GET 
/sse/config/v1/ipsec-tunnels

Retrieve IPSec tunnels.

Request

Query Parameters

limit number

The maximum number of result objects to return per page.

offset number

The offset of the result entry.

name string

The name of the entry.

folder stringrequired

Possible values: Value must match regular expression ^[0-9a-zA-Z._-\s]{1,}$, [Shared, Mobile Users, Remote Networks, Service Connections, Mobile Users Container, Mobile Users Explicit Proxy]

The folder on which you want to perform this operation.

Responses

200

List of ipsec tunnels

application/json

Schema

Schema

data object[]
Array [
anti_replay boolean
Enable Anti-Replay check on this tunnel
auto_key objectrequired
ike_gateway object[]required
Array [
name string
]
ipsec_crypto_profile stringrequired
proxy_id object[]
IPv4 type of proxy_id values
Array [
local string
name stringrequired
protocol object
oneOf
number
number integer
Possible values: >= 1 and <= 254
IP protocol number
tcp
tcp object
local_port integer
Possible values: <= 65535
remote_port integer
Possible values: <= 65535
udp
udp object
local_port integer
Possible values: <= 65535
remote_port integer
Possible values: <= 65535
remote string
]
proxy_id_v6 object[]
IPv6 type of proxy_id values
Array [
local string
name stringrequired
protocol object
oneOf
number
number integer
Possible values: >= 1 and <= 254
IP protocol number
tcp
tcp object
local_port integer
Possible values: <= 65535
remote_port integer
Possible values: <= 65535
udp
udp object
local_port integer
Possible values: <= 65535
remote_port integer
Possible values: <= 65535
remote string
]
copy_tos boolean
Default value: false
Copy IP TOS bits from inner packet to IPSec packet (not recommended)
enable_gre_encapsulation boolean
Default value: false
allow GRE over IPSec
id string
uuid of the resource
name stringrequired
Possible values: <= 63 characters
Alphanumeric string begin with letter: [0-9a-zA-Z._-]
tunnel_monitor object
destination_ip stringrequired
Destination IP to send ICMP probe
enable boolean
Default value: true
Enable tunnel monitoring on this tunnel
proxy_id string
Which proxy-id (or proxy-id-v6) the monitoring traffic will use
]
limit number

Default value: 200

offset number
total number

Example (from schema)

{
  "data": [
    {
      "anti_replay": true,
      "auto_key": {
        "ike_gateway": [
          {
            "name": "string"
          }
        ],
        "ipsec_crypto_profile": "string",
        "proxy_id": [
          {
            "local": "string",
            "name": "string",
            "protocol": {
              "number": 0
            },
            "remote": "string"
          }
        ],
        "proxy_id_v6": [
          {
            "local": "string",
            "name": "string",
            "protocol": {
              "number": 0
            },
            "remote": "string"
          }
        ]
      },
      "copy_tos": false,
      "enable_gre_encapsulation": false,
      "id": "abcd-1234",
      "name": "string",
      "tunnel_monitor": {
        "destination_ip": "string",
        "enable": true,
        "proxy_id": "string"
      }
    }
  ],
  "limit": 200,
  "offset": 0,
  "total": 0
}

400

Bad Request

application/json

Schema

Schema

_errors object[]
Array [
code string
details object
help string
message string
]
_request_id string

Example (from schema)

{
  "_errors": [
    {
      "code": "string",
      "details": {},
      "help": "string",
      "message": "string"
    }
  ],
  "_request_id": "string"
}

input_format_mismatch

Input Format Mismatch

{
  "_errors": [
    {
      "code": "E003",
      "details": {},
      "message": "Input Format Mismatch: input-format=json"
    }
  ],
  "_request_id": "abcd-1234"
}

invalid_query_parameter

Invalid Query Parameter

{
  "_errors": [
    {
      "code": "E003",
      "details": {},
      "message": "Invalid Query Parameter: location=invalid"
    }
  ],
  "_request_id": "abcd-1234"
}

missing_query_parameter

Missing Query Parameter

{
  "_errors": [
    {
      "code": "E003",
      "details": {},
      "message": "Missing Query Parameter: name"
    }
  ],
  "_request_id": "abcd-1234"
}

output_format_mismatch

Output Format Mismatch

{
  "_errors": [
    {
      "code": "E003",
      "details": {},
      "message": "Output Format Mismatch: output-format=json Accept=xml"
    }
  ],
  "_request_id": "abcd-1234"
}

401

Unauthorized

application/json

Schema

Schema

_errors object[]
Array [
code string
details object
help string
message string
]
_request_id string

Example (from schema)

{
  "_errors": [
    {
      "code": "string",
      "details": {},
      "help": "string",
      "message": "string"
    }
  ],
  "_request_id": "string"
}

auth_not_authenticated

Not Authenticated

{
  "_errors": [
    {
      "code": "E016",
      "details": {},
      "message": "Not Authenticated"
    }
  ],
  "_request_id": "abcd-1234"
}

invalid_credential

Invalid Credential

{
  "_errors": [
    {
      "code": "E016",
      "details": {},
      "message": "Invalid Credential"
    }
  ],
  "_request_id": "abcd-1234"
}

key_expired

Key Expired

{
  "_errors": [
    {
      "code": "E016",
      "details": {},
      "message": "Key Expired"
    }
  ],
  "_request_id": "abcd-1234"
}

key_too_long

Key Too Long

{
  "_errors": [
    {
      "code": "E016",
      "details": {},
      "message": "Key Too Long"
    }
  ],
  "_request_id": "abcd-1234"
}

need_password_change

Need Password Change

{
  "_errors": [
    {
      "code": "E016",
      "details": {},
      "message": "The password needs to be changed."
    }
  ],
  "_request_id": "abcd-1234"
}

403

Forbidden

application/json

Schema

Schema

_errors object[]
Array [
code string
details object
help string
message string
]
_request_id string

Example (from schema)

{
  "_errors": [
    {
      "code": "string",
      "details": {},
      "help": "string",
      "message": "string"
    }
  ],
  "_request_id": "string"
}

auth_unauthorized

Unauthorized

{
  "_errors": [
    {
      "code": "E007",
      "details": {},
      "message": "Unauthorized"
    }
  ],
  "_request_id": "abcd-1234"
}

404

Not Found

application/json

Schema

Schema

_errors object[]
Array [
code string
details object
help string
message string
]
_request_id string

Example (from schema)

{
  "_errors": [
    {
      "code": "string",
      "details": {},
      "help": "string",
      "message": "string"
    }
  ],
  "_request_id": "string"
}

object_not_present

Object Not Present

{
  "_errors": [
    {
      "code": "E005",
      "details": {},
      "message": "Object Not Present"
    }
  ],
  "_request_id": "abcd-1234"
}

default

General Errors

application/json

Schema

Schema

_errors object[]
Array [
code string
details object
help string
message string
]
_request_id string

Example (from schema)

{
  "_errors": [
    {
      "code": "string",
      "details": {},
      "help": "string",
      "message": "string"
    }
  ],
  "_request_id": "string"
}

action_not_supported

Action Not Supported

{
  "_errors": [
    {
      "code": "E012",
      "details": {},
      "message": "Action Not Supported: move"
    }
  ],
  "_request_id": "abcd-1234"
}

bad_xpath

Bad XPath

{
  "_errors": [
    {
      "code": "E013",
      "details": {},
      "message": "Bad XPath"
    }
  ],
  "_request_id": "abcd-1234"
}

invalid_command

Invalid Command

{
  "_errors": [
    {
      "code": "E003",
      "details": {},
      "message": "Invalid Command"
    }
  ],
  "_request_id": "abcd-1234"
}

malformed_command

Malformed Command

{
  "_errors": [
    {
      "code": "E003",
      "details": {},
      "message": "Malformed Command"
    }
  ],
  "_request_id": "abcd-1234"
}

method_not_allowed

Method Not Supported

{
  "_errors": [
    {
      "code": "E012",
      "details": {},
      "message": "Method Not Supported"
    }
  ],
  "_request_id": "abcd-1234"
}

session_timeout

Session Timeout

{
  "_errors": [
    {
      "code": 4,
      "details": {},
      "message": "Session Timeout"
    }
  ],
  "_request_id": "abcd-1234"
}

version_not_supported

Version Not Supported

{
  "_errors": [
    {
      "code": "E012",
      "details": {},
      "message": "Version Not Supported"
    }
  ],
  "_request_id": "abcd-1234"
}

Loading...