Overview of Async GET Requests
An asynchronous job collects all matching records and downloads them as a single job. You can configure a script to continuously poll the job until it is done, then download the job results using the job Location HREF listed in the response.
REST Patterns for Collection vs. Instance
GET collection methods return HREF path properties for each individual resource. Perform other REST operations on individual instances of these resources (such as POST, PUT, and DELETE) using the HREF to identify the resources to operate on.
For example, the API response body for retrieving a collection of labels returns a list of labels, each identified by an HREF path. In this instance, the general syntax for the API call looks like this:
GET https://scp.illum.io:8443[api_version][org_href]labels
[org_href] identifies the organization from which you want to get a collection of labels.
A single label instance in the response is identified by its HREF path:
{
href: "/orgs/2/labels/8"
key: "env"
value: "Prod"
created_at: "2014-01-22T18:24:33Z"
updated_at: "2014-01-22T18:24:40Z"
created_by: {
href: "/users/9"
}
updated_by: {
href: "/users/9"
}
} To perform other operations on this label (href: "/orgs/2/labels/8"), you can provide this HREF in the API call to operate on this label instance.
For example:
PUT https://scp.illum.io:8443/api/v2/orgs/2/labels/8
Async GET Supported APIs
These APIs support async GET collections:
Description | Resource Type | Exposure |
|---|---|---|
agents/update |
| Experimental Experimental |
audit_log_events |
| Experimental |
auth_security_principals |
| Experimental |
authentication_settings/ password_policy |
| Experimental |
datafiles |
| Experimental |
events |
| Experimental |
jobs |
| Experimental |
labels |
| Both |
network_devices/ network_endpoints |
| Experimental |
network_enforcement_nodes |
| Experimental |
node_available |
| Both |
pairing profiles |
| Experimental |
permissions |
| Experimental |
security_principals |
| Experimental |
system_events |
| |
vulnerability_reports |
| Experimental |
sec_policy/draft/ | ||
allow |
| Experimental |
dependencies |
| Experimental |
ip_lists |
| Both |
label_groups |
| Experimental |
label_groups/member-of |
| Experimental |
modified_objects |
| Experimental |
pending |
| Experimental |
rule_sets |
| Both |
rule_sets/sec_rule |
| Both |
services |
| Both |
virtual_service |
| Both |
settings/ | ||
settings |
| |
syslog/destinations |
| Experimental |
workloads |
| Experimental |
users/ | ||
users |
| Stable |
api_keys |
| Both |
orgs |
| Experimental |
login | G | Stable |
workloads/ | ||
workloads/ |
| Both |
interfaces |
| Both |