Skip to main content

Netskope Help

List Storage Scan Policies

Use this endpoint to list storage scan policies.

Request Endpoint
https://<tenant-name>.goskope.com/api/v1/storage_scan_policies/?token=<token>&op=list

Valid parameters include:

Key

Type

Value

Description

op

string

list

Required. Operation performed.

filters

JSON array of object

{
"cloud_provider": "<aws|googlecloud>", "policy_name": "<policy_name>",
"instance": "<instance_name>",
"dlp_profile": "<dlp_profile_name>",
"threat_protection_profile": "<threat_protection-profile_name>",
"pending": "<true | false>",

}

Optional. Filters used to scan policies.

cloud_provider

string

aws | googlecloud

Optional. The storage platform provider.

policy_name

string

URL-encoded string

Optional. Name of the storage policy.

instance

string

Array of strings

Optional. Searches for Instance names among the allowList.

dlp_profile

string

Array of strings

Optional. Name of the DLP profile.

If used DLP Profile filter AND Threat Protection Profile filter together, likely you'll see no results.

threat_protection_profile

string

Array of strings

Optional. Name of the Threat Protection profile.

If used DLP Profile filter AND Threat Protection Profile filter together, likely you'll see no results.

pending

boolean

true | false

Optional. Use true to return only the policies with pending changes. User false to return only the policies without pending changes

sort_by

string

cloud_provider | policy name | last-edited

Optional. Determines the order of policy scan results

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 Policies Request
POST 'https://<tenant>/api/v1/storage_scan_policies?token=xxx&op=list' \
--header 'Content-Type: application/json' \
--data-raw '{
    "filters": {
        "cloud_provider": ["aws", "azure", "googlecloud"],
        "policy_name": "foo",
        "instance": ["instance_name1"],
        "dlp_profile": ["dlp_profile_nameA"],
        "threat_protection_profile": ["tss_profile_nameX"],
        "pending": false
    },
    "sortby": "cloud_provider",
    "limit": 10,
    "skip": 0
}'