setacl

exo storage setacl

Description

This command sets bucket/objects ACL. It can be used in 2 (mutually exclusive) forms:

* With a "canned" ACL:

    exo storage setacl sos://my-bucket public-read

* With explicit Access Control Policy (ACP) grantees:

    exo storage setacl sos://my-bucket \
        --full-control alice@example.net \
        --read bob@example.net

Supported canned ACLs:

* For buckets: private, public-read, public-read-write, authenticated-read
* For objects: private, public-read, public-read-write, authenticated-read, aws-exec-read, bucket-owner-read, bucket-owner-full-control

In ACP mode, it is possible to use the following special values to reference pre-defined groups:

* ALL_USERS (as in "public-read" canned ACL)
* AUTHENTICATED_USERS (as in "authenticated-read" canned ACL)

For more information on ACL, please refer to the Exoscale Storage documentation: https://community.exoscale.com/documentation/storage/acl/

If you want to target objects under a “directory” prefix, suffix the path argument with “/”:

exo storage setacl sos://my-bucket/ --full-control alice@example.net
exo storage setacl -r sos://my-bucket/public/ public-read

Supported output template annotations:

* When showing a bucket: .Name, .Zone, .ACL, .CORS, .ObjectOwnership
* When showing an object: .Path, .Bucket, .LastModified, .Size, .ACL, .Metadata, .Headers, .URL

exo storage setacl sos://BUCKET/[OBJECT|PREFIX/] [CANNED-ACL] [flags]

Options

Option	Description
`--full-control`	ACP Full Control grantee
`--help, -h`	help for setacl
`--read`	ACL Read grantee
`--read-acp`	ACP Read ACP grantee
`--recursive, -r`	set ACL recursively (with object prefix only)
`--write`	ACP Write grantee
`--write-acp`	ACP Write ACP grantee

Options inherited from parent commands

Option	Description
`--config, -C`	Specify an alternate config file [env EXOSCALE_CONFIG]
`--output-format, -O`	Output format (table\|json\|text), see "exo output –help" for more information
`--output-template`	Template to use if output format is "text"
`--quiet, -Q`	Quiet mode (disable non-essential command output)
`--use-account, -A`	Account to use in config file [env EXOSCALE_ACCOUNT]

Related Commands

storage - Object Storage management

rb show