Introducing sss (S3-client)

1

brew install sj14/tap/sss

1

docker pull ghcr.io/sj14/sss

1

go install github.com/sj14/sss@latest

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

[profiles.default]
endpoint = "https://earth.example.com"
region = "earth"
access_key = "<CHANGE_ME>"
secret_key = "<CHANGE_ME>"

[profiles.mars]
endpoint = "https://mars.example.com"
region = "mars"
access_key = "<CHANGE_ME>"
secret_key = "<CHANGE_ME>"
path_style = true
insecure   = true
read_only  = true

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135

Usage: sss <command> [flags]

Flags:
  -h, --help                    Show context-sensitive help.
  -c, --config=STRING           Path to the config file (default: ~/.config/sss/config.toml) ($SSS_CONFIG).
  -p, --profile="default"       Profile to use ($SSS_PROFILE).
  -v, --verbosity=1             Output verbosity (0=disable; 1=default; 8=header; 9=body) ($SSS_VERBOSITY).
      --endpoint=STRING         S3 endpoint URL ($SSS_ENDPOINT).
      --region=STRING           S3 region ($SSS_REGION).
      --path-style              Use path style S3 requests ($SSS_PATH_STYLE).
      --access-key=STRING       S3 access key ($SSS_ACCESS_KEY).
      --secret-key=STRING       S3 secret key ($SSS_SECRET_KEY).
      --insecure                Skip TLS verification ($SSS_INSECURE).
      --read-only               Only allow safe HTTP methods (HEAD, GET, OPTIONS) ($SSS_READ_ONLY).
      --bandwidth=STRING        Limit bandwith per second, e.g. '1 MiB' (always 64 KiB burst) ($SSS_BANDWIDTH).
      --header=KEY=VALUE;...    Set HTTP headers (format: 'key1=val1;key2=val2') ($SSS_HEADER).
      --param=KEY=VALUE;...     Set URL parameters (format: 'key1=val1;key2=val2') ($SSS_PARAM).
      --sni=STRING              TLS Server Name Indication ($SSS_SNI).

Commands:
  profiles (p) [flags]
    List availale profiles.

  version [flags]
    Show version information.

Bucket Commands
  buckets (ls) [flags]
    List all buckets.

  bucket (b) <bucket> mb [flags]
    Make/create bucket.

  bucket (b) <bucket> hb
    Head bucket lists bucket information.

  bucket (b) <bucket> rb [flags]
    Remove/delete bucket.

  bucket (b) <bucket> policy get
    Get lifecycle policy.

  bucket (b) <bucket> policy put <path>
    Put lifecycle policy.

  bucket (b) <bucket> policy rm
    Delete lifecycle policy.

  bucket (b) <bucket> cors get
    Get CORS policy.

  bucket (b) <bucket> cors put <path>
    Put CORS policy.

  bucket (b) <bucket> cors rm
    Delete CORS policy.

  bucket (b) <bucket> tag get
    Get bucket tag.

  bucket (b) <bucket> lifecycle (lc) get
    Get lifecycle policy.

  bucket (b) <bucket> lifecycle (lc) put <path>
    Put lifecycle policy.

  bucket (b) <bucket> lifecycle (lc) rm
    Delte lifecycle policy.

  bucket (b) <bucket> versioning get
    Get bucket versioning config.

  bucket (b) <bucket> versioning put <path>
    Put bucket versioning config.

  bucket (b) <bucket> cleanup [flags]
    Remove all objects versions and multiparts from the bucket.

  bucket (b) <bucket> object-lock (ol) get
    Get object-lock config.

  bucket (b) <bucket> object-lock (ol) put <path>
    Put object-lock config.

  bucket (b) <bucket> size [<path>]
    Calculate bucket size (resource heavy!)

Multipart Commands
  bucket (b) <bucket> multipart (mp) rm <object> <upload-id>
    Delete multipart upload.

  bucket (b) <bucket> multipart (mp) ls [<prefix>] [flags]
    List multipart uploads.

  bucket (b) <bucket> multipart (mp) create [<prefix>]
    Create multipart upload.

  bucket (b) <bucket> multipart (mp) parts ls <object> <upload-id> [flags]
    List parts.

Object Commands
  bucket (b) <bucket> ls [<prefix>] [flags]
    List objects.

  bucket (b) <bucket> cp <src-object> <dst-bucket> <dst-object> [flags]
    Server-side copy.

  bucket (b) <bucket> put <path> [<destination>] [flags]
    Upload object(s).

  bucket (b) <bucket> put-rand [flags]
    Upload random object(s).

  bucket (b) <bucket> rm <object> [flags]
    Remove object.

  bucket (b) <bucket> get <object> [<destination>] [flags]
    Download object(s). Requires HeadObject permission.

  bucket (b) <bucket> head <object> [flags]
    Head Object Liss object information.

  bucket (b) <bucket> versions [<path>] [flags]
    List object versions

  bucket (b) <bucket> presign get <object> [flags]
    Create pre-signed URL for GET request.

  bucket (b) <bucket> presign put <object> [flags]
    Create pre-signed URL for PUT request.

  bucket (b) <bucket> acl get <object> [flags]
    Get object ACL.

Run "sss <command> --help" for more information on a command.