Enable the original image protection function of bucket
Updated at:2025-11-03
API description
This API allows you to enable the original image protection function for a bucket and specify the resource field to define the valid resource scope. For files with original image protection enabled, anonymous downloads, access without proper authorization, or access with custom image processing parameters are not allowed. Only access based on styles or valid signatures is permitted.
Note: Users must have FULL_CONTROL permission.
Request URI
PUT /v1/{bucketName}/?copyrightProtection
| Parameter name | Parameter type | Required or not | Description | Example value | Parameter location |
|---|---|---|---|---|---|
| bucketName | String | Yes | Bucket name | "bucketName_example" | Path |
Parameters of request body
Description of the data structure of request body fields
| Parameter name | Parameter type | Required or not | Description | Example value |
|---|---|---|---|---|
| resource | List |
No | Indicate the scope of effective resources |
Response body parameters
Description of the data structure of response body fields
Request example
JSON
1PUT /v1/bucketName_example/?copyrightProtection
2 <Common request headers>
3{
4 "resource" : [ "bucket/prefix/*" ]
5}
Response example
JSON
1HTTP/1.1 200 OK
2 <Common response headers>
3{ }
Error code
Please refer to the general error codes
