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 |
|---|---|---|
|
| 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. |
|
| Required. The operation to perform with the bucket list in the storage constraint profile. |
| Comma-separated list of bucket names. | Use only for |
| Comma-separated list of bucket names. | Use only for |
| Comma-separated list of bucket names. | Use only for |
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" }'