This endpoint lists all your app instances.
Request Endpoint
GET https://<tenant-URL>/api/v1/app_instances?token=<token>&op=list
Valid parameters are:
| Key | Type | Value | Description |
|---|---|---|---|
op | string | list | Required. Operation performed. |
app | string | Ex:Amazon Web Services | Amazon S3 | Amazon EC2 | Amazon DynamoDB | Microsoft Azure | Microsoft Office 365 Sharepoint Sites | Microsoft Office 365 OneDrive for Business | Box | Slack | Required. Filters by app. Matches if value contains the search term. |
instance_id | string | Ex: 123451234512 | Optional. Filters by instance_id. Matches if value contains the search term. |
instance_name | string | Ex: "MYAWS_GOSKOPE" | Optional. Filters by instance_name. Matches if value contains the search term. |
tags | string | Sanctioned | Unsanctioned | Optional. Filters by tag. |
type | string | All | Custom | Sync | Optional. Filters by type. Default is All. |
sort_by | string | instance_id | instance_name | app | type | last-modified | Optional. Determines the order of policy scan results. Default is app. |
limit | integer | Positive integer less than 5000 | REST API responses can return up to 5000 items in a single response. You can use pagination to retrieve more results. Limit defines the page size. If limit is not provided or set to 0, all records will be shown. |
skip | integer | Positive integer | Skip over some of the items (useful for pagination in combination with limit). Skip decides the page amount. If limit is provided and skip is not, it will default to 0. |
Example List App Instances Request
GET 'https://<tenant-URL>/api/v1/app_instances?token=xxx&op=list&sortby=app'
--header 'Content-Type: application/json'
--data-raw '{
"instances":[
{
"app":"Azure",
"instance_id": "123451234512",
"instance_name":"New Instance-1",
"tags":[
"Sanctioned"
]
},
{
"app":"AWS",
"instance_id": "123451234513",
"instance_name":"New Instance-2",
"tags":[
"Unsanctioned"
]
}
]
}