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" }'