Overview of Async GET Requests
An asynchronous job collects and downloads all matching records as a single job. You can configure a script to continuously poll the job until it is done and then download the job results using the job location HREF listed in the response.
Collection vs. Instance
GET collection methods return HREF path properties for each 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.
For example, the response body for the API to get a collection of labels returns a list of labels, where each one is identified as 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 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 |
| Stable |
workloads/ | ||
workloads/ |
| Both |
interfaces |
| Both |