API
  1. Object Storage
  2. Buckets

Get an Object Storage object ACL configuration

get
https://api.linode.com//object-storage/buckets///object-acl

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

📘

You can use an outside API, such as the Ceph Object Gateway S3 API for more options.

​

OAuth scopes

object_storage:read_only

Learn more...

Path Params
string
enum
required

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

Allowed:
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.

string
required

The bucket name.

Query Params
string
required

The name of a specific object to get its access control list (ACL) details. Run the List Object Storage bucket contents operation to access all object names in a bucket.

Responses

Response body
object
string
enum

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

private public-read authenticated-read public-read-write custom

string

The full XML of the object's ACL policy.

Updated about 2 months ago

Did this page help you?
Language
Credentials

Updated about 2 months ago

Did this page help you?
Original text
Rate this translation
Your feedback will be used to help improve Google Translate