Netskope Help

List App Instances

This endpoint lists all your app instances.

Request Endpoint
GET https://<tenant-name>.goskope.com/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 10000

REST API responses can return up to 10000 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-name>.goskope.com/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"
			]
		}
	]
}