Skip to main content

Netskope Help

Get Instance Info

This endpoint gets information about your IaaS instance.

Request
GET https://<tenant-name>.goskope.com/api/v1/introspection_instance?token=<token>&<parameters>

Valid parameters are:

Key

Value

Description

app

aws | azure | googlecloud

Specifies the IaaS to be accessed. 

instance_name

<instance_name> Example: "MYAWS_GOSKOPE"

Required. The IaaS instance name in the Netskope UI.

Response

Key

Type

Value

app

string

Ex: Amazon Web Services | Amazon S3 | Amazon EC2 | Amazon DynamoDB | Google Cloud Platform | Microsoft Azure | Microsoft Office 365 Sharepoint Sites | Microsoft Office 365 OneDrive for Business | Box | Slack

instance

Below keys/values are for AWS

instance_name

string

"<instance_name>"

active

boolean

true | false

deleted

boolean

true | false

account_id

string

Netskope account ID

external_id

string

Netskope external ID

role_arn

string

"<arn_aws_iam_role_name>"

trail_name

string

"<cloudtrail_name>"

trail_region

string

"<aws_region_id>"

admin_email

string

"<admin_email>"

use_for

array

Any of these: "introspection", "malware", "securityscan"

securityscan_interval

integer

Available when use_for contains "securityscan"

instance

Below keys/values are for Azure

instance_name

string

"<instance_name>"

active

boolean

true | false

deleted

boolean

true | false

directory_id

string

Azure Directory ID

application_id

string

Azure Application ID

client_key

string

Azure Client Key

admin_email

string

"<admin_email>"

use_for

array

Any of these: "introspection", "malware", "securityscan"

securityscan_interval

integer

Available when use_for contains "securityscan"

instance

Below keys/values are for GCP

instance_name

string

"<instance_name>"

active

boolean

true | false

deleted

boolean

true | false

sink_name

string

<sink_name>

admin_email

string

"<admin_email>"

use_for

array

"securityscan"

securityscan_interval

integer

Available when use_for contains "securityscan"