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"
			]
		}
	]
}

In this section:

Netskope Help

List App Instances

Search results