summaryrefslogtreecommitdiff
path: root/plugins/aws/README.md
diff options
context:
space:
mode:
authorMark Keisler <mark@mitsein.net>2023-04-18 03:36:07 -0500
committerGitHub <noreply@github.com>2023-04-18 10:36:07 +0200
commit673b9fc3317d48a169fe612575186b3eb1a42a13 (patch)
treec933f364a209e6f5556faaed2fb02cd7b3d2ebd9 /plugins/aws/README.md
parentd889eca72633b7a66d6c832736a5460c5f1a1833 (diff)
downloadzsh-673b9fc3317d48a169fe612575186b3eb1a42a13.tar.gz
zsh-673b9fc3317d48a169fe612575186b3eb1a42a13.tar.bz2
zsh-673b9fc3317d48a169fe612575186b3eb1a42a13.zip
feat(aws)!: improve `aws_change_access_key` (#11378)
BREAKING CHANGE: This commit removes compatibility for `aws` cli v1. Now only v2 is supported.
Diffstat (limited to 'plugins/aws/README.md')
-rw-r--r--plugins/aws/README.md11
1 files changed, 6 insertions, 5 deletions
diff --git a/plugins/aws/README.md b/plugins/aws/README.md
index 846bf1414..54bc7a44d 100644
--- a/plugins/aws/README.md
+++ b/plugins/aws/README.md
@@ -1,7 +1,8 @@
# aws
-This plugin provides completion support for [awscli](https://docs.aws.amazon.com/cli/latest/reference/index.html)
+This plugin provides completion support for [awscli v2](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/index.html)
and a few utilities to manage AWS profiles/regions and display them in the prompt.
+[awscli v1](https://docs.aws.amazon.com/cli/latest/userguide/cliv2-migration.html) is no longer supported.
To use it, add `aws` to the plugins array in your zshrc file.
@@ -12,9 +13,9 @@ plugins=(... aws)
## Plugin commands
* `asp [<profile>]`: sets `$AWS_PROFILE` and `$AWS_DEFAULT_PROFILE` (legacy) to `<profile>`.
- It also sets `$AWS_EB_PROFILE` to `<profile>` for the Elastic Beanstalk CLI. It sets `$AWS_PROFILE_REGION` for display in `aws_prompt_info`.
+ It also sets `$AWS_EB_PROFILE` to `<profile>` for the Elastic Beanstalk CLI. It sets `$AWS_PROFILE_REGION` for display in `aws_prompt_info`.
Run `asp` without arguments to clear the profile.
-* `asp [<profile>] login`: If AWS SSO has been configured in your aws profile, it will run the `aws sso login` command following profile selection.
+* `asp [<profile>] login`: If AWS SSO has been configured in your aws profile, it will run the `aws sso login` command following profile selection.
* `asr [<region>]`: sets `$AWS_REGION` and `$AWS_DEFAULT_REGION` (legacy) to `<region>`.
Run `asr` without arguments to clear the profile.
@@ -65,7 +66,7 @@ the current `$AWS_PROFILE` and `$AWS_REGION`. It uses four variables to control
Source profile credentials in `~/.aws/credentials`:
-```
+```ini
[source-profile-name]
aws_access_key_id = ...
aws_secret_access_key = ...
@@ -73,7 +74,7 @@ aws_secret_access_key = ...
Role configuration in `~/.aws/config`:
-```
+```ini
[profile source-profile-name]
mfa_serial = arn:aws:iam::111111111111:mfa/myuser
region = us-east-1