Netskope Help

Manage Bucket Lists for a Constraint Profile

This endpoint can be used to update the buckets of an existing storage constraint profile or view the buckets in storage constraint profiles. The constraint profiles are applied in an Real-time Protection policy to allowlist or blocklist specific buckets.

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

Valid parameters are:

Key

Value

Description

name

<profile_name> Example: "Allowlist_Bucket"

Required. The name of an existing storage constraint profile.

Will return an error if the provided name either does not exist or if there is some pending change already in the storage constraint profile.

op

appendToBucketList | deleteFromBucketList | modifyBucketList | replaceBucketList | viewBucketList

Required. The operation to perform with the bucket list in the storage constraint profile. 

list

Comma-separated list of bucket names.

Use only for appendToBucketList , deleteFromBucketList and replaceBucketList. Max size of a bucket list is 8MB. 

addlist

Comma-separated list of bucket names.

Use only for modifyBucketListdeleteList is processed first, addList second. Max size of a bucket list is 8MB.

delectlist

Comma-separated list of bucket names.

Use only for modifyBucketListdeleteList is processed first, addList second. Max size of a bucket list is 8MB.

Examples

Append to a bucket list

$ curl -X POST \   
'https://<tenant-name>.goskope.com/api/v1/storage_constraint_profile?token=151b9d5e1f1546b589cb8b6jk6jk&op=appendToBucketList&name=customBucketList201' \   
-H 'Content-Type: application/json' \   
-H 'cache-control: no-cache' \   
-d '{"list": "my-abc,my-abc-0" }'

Delete from a bucket list

$ curl -X POST \   
'https://<tenant-name>.goskope.com/api/v1/storage_constraint_profile?token=151b9d5e1f1546b589cb8b6jk6jk&op=deleteFromBucketList&name=customBucketList201' \   
-H 'Content-Type: application/json' \   
-H 'cache-control: no-cache' \   
-d '{"list": "my-abc,my-abc-0,mn-abc-0,my-abc-0","my-abc,my-abc-0" }'

Modify a bucket list: only addlist

$ curl -X POST \   
'https://<tenant-name>.goskope.com/api/v1/storage_constraint_profile?token=151b9d5e1f1546b589cb8b6jk6jk54jtj&op=modifyBucketList&name=customBucketList201' \   
-H 'Content-Type: application/json' \   
-H 'cache-control: no-cache' \   
-d '{"addList": "bucket-west,content-team,largefiles,netskope-files,toy.videos,vent-12345" }'

Modify a bucket list: only deletelist

$ curl -X POST \   
'https://<tenant-name>.goskope.com/api/v1/storage_constraint_profile?token=151b9d5e1f1546b589cb8b6jk6jk&op=modifyBucketList&name=customBucketList201' \   
-H 'Content-Type: application/json' \   
-H 'cache-control: no-cache' \   
-d '{"deleteList": "bucket-west,content-team,largefiles,netskope-files,toy.videos,kent-12345" }'

Modify a bucket list: both addlist and deletelist

$ curl -X POST \   
'https://<tenant-name>.goskope.com/api/v1/storage_constraint_profile?token=151b9d5e1f1546b589cb8b6jk6jk&op=modifyBucketList&name=customBucketList201' \   
-H 'Content-Type: application/json' \   
-H 'cache-control: no-cache' \   
-d '{"addList": "bucket-east,context-team,smallfiles,toy.videos,vent-12345"    
"deleteList": "bucket-west,content-team,largefiles,netskope-files,bot.videos,kent-12345" }'

Replace a bucket list

$ curl -X POST \   
'https://<tenant-name>.goskope.com/api/v1/storage_constraint_profile?token=151b9d5e1f1546b589cb8b6jk6jk&op=replaceBucketList&name=customBucketList201'  \ 
-H 'Content-Type: application/json'   
-H 'cache-control: no-cache'   
-d '{"list": "toy.videos,vent-12345,my-abc"}'

View a bucket list

$ curl -X POST \   
'https://<tenant-name>.goskope.com/api/v1/storage_constraint_profile?token=151b9d5e1f1546b589cb8b6jk6jk&op=viewBucketList&name=customBucketList201' \   
-H 'Content-Type: application/json' \   
-H 'cache-control: no-cache' \   
-d '{"list": "my-abc,my-abc-0" }'