Update an object's ACL configuration

put

https://api.linode.com/{apiVersion}/object-storage/buckets/{regionId}/{bucket}/object-acl

Update a specific object's access control list (ACL) settings. ACLs define who can access your buckets and objects, and specify the level of access granted to those users. See Define access and permissions using ACLs (Access Control Lists).

📘
The request header sent in an Object Storage operation can't exceed eight KB in total size.

Permissions and scopes

To call this operation, you need the following:

OAuth scopes. Your user needs these scopes assigned. Learn more.
- Scopes: object_storage:read_write

Path Params

apiVersion

string

enum

required

Enum Call either the v4 URL, or v4beta for operations still in Beta.

Allowed:

regionId

string

required

Identifies a region where this bucket lives.

📘
You can use a clusterId in place of regionId in requests for buckets that you created using the legacy version of the API. Run List clusters to see each cluster id.

bucket

string

required

The bucket name.

Body Params

acl

string

enum

required

The S3 predefined collection of grantees and permissions set for the bucket, also referred to as a Canned ACL.

Allowed:

name

string

required

The name of the object where access control list (ACL) settings will be updated. Run the List Object Storage bucket contents operation to access all object names in a bucket.

Responses

200The ACL configuration was updated.

defaultSee Errors for the range of possible error response codes.