Object Storage
Object Storage Object ACL Config View
https://api.linode.com/v4/object-storage/buckets/{clusterId}/{bucket}/object-acl
View an Object's configured Access Control List (ACL) in this Object Storage bucket. ACLs define who can access your buckets and objects and specify the level of access granted to those users.
This endpoint is available for convenience. It is recommended that instead you use the more fully-featured S3 API directly.
Path Parameters
The ID of the cluster this bucket exists in.
The bucket name.
Query Parameters
The name
of the object for which to retrieve its Access Control List (ACL). Use the Object Storage Bucket Contents List endpoint to access all object names in a bucket.
Request Samples
- Shell
curl -H "Authorization: Bearer $TOKEN" \
https://api.linode.com/v4/object-storage/buckets/us-east-1/example-bucket/object-acl?name=example.txt
Response Samples
- 200
- default
{
"acl": "public-read",
"acl_xml": "<AccessControlPolicy>...</AccessControlPolicy>"
}
Responses
200: The Object's canned ACL and policy.
The Access Control Level of the bucket, as a canned ACL string. For more fine-grained control of ACLs, use the S3 API directly.
The full XML of the object's ACL policy.
default: Error
What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to open a Support Ticket or perform some other action before you can complete the request successfully.
The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as "null" if the error is not specific to any single element of the request.
Object Storage Object ACL Config Update
https://api.linode.com/v4/object-storage/buckets/{clusterId}/{bucket}/object-acl
Update an Object's configured Access Control List (ACL) in this Object Storage bucket. ACLs define who can access your buckets and objects and specify the level of access granted to those users.
This endpoint is available for convenience. It is recommended that instead you use the more fully-featured S3 API directly.
Path Parameters
The ID of the cluster this bucket exists in.
The bucket name.
Request Body Schema
The Access Control Level of the bucket, as a canned ACL string. For more fine-grained control of ACLs, use the S3 API directly.
The name
of the object for which to update its Access Control List (ACL). Use the Object Storage Bucket Contents List endpoint to access all object names in a bucket.
Request Samples
- Shell
curl -H "Content-Type: application/json" \
-H "Authorization: Bearer $TOKEN" \
-X PUT -d '{
"acl": "public-read",
"name": "example.txt"
}' \
https://api.linode.com/v4/object-storage/buckets/us-east-1/example-bucket/object-acl
Response Samples
- 200
- default
{
"acl": "public-read",
"acl_xml": "<AccessControlPolicy>...</AccessControlPolicy>"
}
Responses
200: The Object's canned ACL and policy.
The name
of the object for which to update its Access Control List (ACL). Use the Object Storage Bucket Contents List endpoint to access all object names in a bucket.
The Access Control Level of the bucket, as a canned ACL string. For more fine-grained control of ACLs, use the S3 API directly.
default: Error
What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to open a Support Ticket or perform some other action before you can complete the request successfully.
The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as "null" if the error is not specific to any single element of the request.