exo(1)

📦
version 1.102.1 · 2 versions
, in nixpkgs unstable

exo(1) — exo-storage-setacl 💖✨

🌸 NAME 🌸

Okay bestie, this is exo-storage-setacl — set a bucket/objects ACL. That's the whole name, no cap. 💅

✨ SYNOPSIS ✨

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

🦋 DESCRIPTION 🦋

So 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
Heads up: those two forms are mutually exclusive — pick one, bestie. 😭

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, .ReplicationStatus

💅 OPTIONS 💅

  • --full-control="" — ACP Full Control grantee.
  • -h, --help[=false] — help for setacl.
  • --read="" — ACL Read grantee.
  • --read-acp="" — ACP Read ACP grantee.
  • -r, --recursive[=false] — set ACL recursively (with object prefix only).
  • --write="" — ACP Write grantee.
  • --write-acp="" — ACP Write ACP grantee.

🫶 OPTIONS INHERITED FROM PARENT COMMANDS 🫶

  • -C, --config="" — Specify an alternate config file [env EXOSCALE_CONFIG].
  • -O, --output-format="" — Output format (table|json|text), see exo output --help for more information.
  • --output-template="" — Template to use if output format is "text".
  • -Q, --quiet[=false] — Quiet mode (disable non-essential command output).
  • --timeout=15s — Per-zone timeout for list operations; -1s disables timeout [env EXOSCALE_TIMEOUT].
  • -A, --use-account="" — Account to use in config file [env EXOSCALE_ACCOUNT].

👑 SEE ALSO 👑

exo-storage(1) — go read that one too, bestie. 💖

🎀 HISTORY 🎀

  • 1-Jan-1980 — Auto generated by spf13/cobra.

💖 Auto generated by spf13/cobra · Jan 1980 · exo(1) — mwah, bestie 💋✨

📦 where this page comes from