Get Instance Info - Netskope Technical Documentation

This endpoint gets information about your IaaS instance.

Request

GET https://<tenant-URL>/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"`