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-URL>/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 `modifyBucketList`. `deleteList` is processed first, `addList` second. Max size of a bucket list is 8MB.
`delectlist`	Comma-separated list of bucket names.	Use only for `modifyBucketList`. `deleteList` is processed first, `addList` second. Max size of a bucket list is 8MB.

Examples

Append to a bucket list

$ curl -X POST    
'https://<tenant-URL>/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-URL>/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-URL>/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-URL>/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-URL>/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-URL>/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-URL>/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" }'

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 modifyBucketList. deleteList is processed first, addList second. Max size of a bucket list is 8MB.

delectlist

Comma-separated list of bucket names.

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

$ curl -X POST 'https://<tenant-URL>/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" }'

$ curl -X POST 'https://<tenant-URL>/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" }'

$ curl -X POST 'https://<tenant-URL>/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" }'

$ curl -X POST 'https://<tenant-URL>/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" }'

$ curl -X POST 'https://<tenant-URL>/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" }'

$ curl -X POST 'https://<tenant-URL>/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"}'

$ curl -X POST 'https://<tenant-URL>/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" }'