Docy

Manage Bucket Lists for a Constraint Profile

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:

KeyValueDescription
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.

opappendToBucketList | deleteFromBucketList | modifyBucketList | replaceBucketList | viewBucketListRequired. The operation to perform with the bucket list in the storage constraint profile. 
listComma-separated list of bucket names.Use only for appendToBucketList , deleteFromBucketList and replaceBucketList. Max size of a bucket list is 8MB. 
addlistComma-separated list of bucket names.Use only for modifyBucketListdeleteList is processed first, addList second. Max size of a bucket list is 8MB.
delectlistComma-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-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" }'
Share this Doc
In this topic ...