Skip to main content

REST APIs for 24.2.20 and 24.2.10

Virtual Servers

A virtual server is similar to a workload. It can be assigned labels and has IP addresses, but does not report traffic to the Illumio Core. Each virtual server has only one VIP. The local IP addresses are used as source IP addresses for connection to the pool members (backend servers) when the virtual server operates in SNAT or Auto mode. These IP addresses are likely to be shared by multiple virtual servers on the server load balancer.

A discovered virtual server is a server load balancer (SLB) virtual server (IP address and port(s)) that the NEN has discovered when interrogating SLBs managed by the PCE.

Virtual Server Methods

There are two groups of methods used to manage virtual servers:

  • Methods for virtual servers

  • Methods for discovered virtual servers

Functionality

HTTP

URI

Get a list of Virtual Servers.

GET

[api_version][org_href]/sec_policy/:version/virtual_servers

Get a specified Virtual Server.

GET

[api_version][org_href]/sec_policy/:version/virtual_servers/:uuid

Create a Virtual Server object.

POST

[api_version][org_href]/sec_policy/:version/virtual_servers

Modify the enforcement mode, labels, and backend/provider labels of a specified Virtual Server.

PUT

[api_version][org_href]/sec_policy/:version/virtual_servers/:uuid

Discovered Virtual Servers Methods

You can use only three GET methods for discovered virtual servers.

Functionality

HTTP

URI

Get a list of Discovered Virtual Servers.

GET

[api_version][org_href]/discovered _virtual_servers

Get a specified Discovered Virtual Server.

GET

[api_version][org_href]/discovered_ virtual_servers/:uuid

Discovery

GET

[api_version][org_href]/network_enforcement_nodes/ virtual_server_discovery_jobs/:uuid