Get Instance Info
Get Instance Info
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" |