Get Prep Info to Create an AWS Role - Netskope Technical Documentation

This endpoint provides the info needed to create a role in your AWS app. If you do not already have an existing AWS role, you need get the prep info to create a role.

Request

POST https://<tenant-URL>/api/v1/introspection_instance?token=<token>&op=get_aws_role_prep_info

Valid payload parameters are:

Key Type Value Validation

Key	Type	Value	Validation
`use_for`	array	Any of the possible use_for supported by AWS. `"introspection" \| "malware" \| "securityscan"`	Must not be empty array. Items in array must be supported by AWS. If `"malware"` is used, `introspection` must be also supplied.

use_for

array

Any of the possible use_for supported by AWS.

"introspection" | "malware" | "securityscan"

Must not be empty array.

Items in array must be supported by AWS.

If "malware" is used, introspection must be also supplied.

Response

Responses for AWS are as follows:

Key	Value
account_id	Netskope account ID
external_ID	Netskope external ID
permissions	“<`json_string>`” or “<`instruction`“. Permission needed. Value is based of the combination in “`use_for`” supplied in the request.