3 homepage: https://github.com/wallix/awless
5 awless is a powerful, innovative and small surface command line interface (CLI) to manage Amazon Web Services.
8 To update or switch versions, run `webi awless@stable` (or `@v2`, `@beta`, etc).
12 awless is modeled after popular command-line tools such as Git. Most commands
16 awless verb [entity] [parameter=value ...]
19 If you already have awscli installed and configured, awless will use your
20 existing `~/.aws/credentials` file. If not, you can review and configure awless
23 Unlike the standard awscli tools, `awless` aims to be more human readable.
27 For instance, let's list some resources:
33 Which outputs a friendly human readable table!
36 | ID ▲ | NAME | DEFAULT | STATE | CIDR |
37 |-----------------------|------|---------|-----------|---------------|
38 | vpc-00fd208a070000000 | | false | available | 172.16.0.0/16 |
39 | vpc-22222222 | | true | available | 172.31.0.0/16 |
42 There's also filter capabilities, in case the list is long. For example, let's
43 list all EC2 instances with "api" in the name:
46 awless list instances --filter name=api
49 In addition to the default table output, there's also csv, tsv, json.
52 awless list loadbalancers --format csv
57 awless allows specifying things by name rather than ID by using the `@` prefix.
60 awless create subnet cidr=10.0.0.0/24 vpc=@wordpress-vpc name=wordpress-public-subnet
65 If you leave out a parameter, awless will prompt you for the missing
69 awless delete i-123456789000abcd
72 It will correctly detect what you were probably trying to do:
75 Did you mean `awless delete instance ids=i-051fcef0537a53eb0` ? [Y/n]
80 For a more advanced tutorial about awless' features, see the official
81 [Getting Started](https://github.com/wallix/awless/wiki/Getting-Started) guide.