本文档 Amazon CLI 仅适用于版本 1。有关版本 2 的文档 Amazon CLI,请参阅版本 2 用户指南。
本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
对错误进行故障排除 Amazon CLI
本节介绍常见错误和解决您的问题的故障排除步骤。我们建议首先进行一般故障排除。
目录
首先尝试的一般故障排除
如果您收到错误或遇到问题 Amazon CLI,我们建议您使用以下一般提示来帮助您进行故障排除。
检查您的 Amazon CLI 命令格式
如果您收到一个错误,表明某个命令不存在,或者它无法识别文档指明可用的参数 (Parameter validation failed
),则您的命令可能格式不正确。我们建议您检查以下内容:
-
检查命令是否存在拼写和格式错误。
-
确认您的命令中适用于您的终端的所有引号和转义都是正确的。
-
生成 Amazon CLI 骨架以确认命令结构。
-
有关JSON值JSON,请参阅其他疑难解答部分。如果您在终端处理JSON格式方面遇到问题,我们建议您使用 Blobs 将JSON数据直接传递到,从而跳过终端的报价规则。 Amazon CLI
有关如何构造特定命令的更多信息,请参阅Amazon CLI 参考指南。
检查 Amazon Web Services 区域 你的 Amazon CLI 命令正在使用什么
注意
使用 Amazon Web Services 区域 时,必须明确指定或通过设置默认区域来指定。 Amazon CLI有关您可以指定的所有内容的列表 Amazon Web Services 区域 ,请参阅中的Amazon 区域和终端节点Amazon Web Services 一般参考。使用的 Amazon Web Services 区域 标号与您在 Amazon Web Services Management Console URLs和服务端点中看到的名称相同。 Amazon CLI
如果您指定的资源 Amazon Web Services 服务 不可用,或者您的资源位于其他位置,则可能会出现错误 Amazon Web Services 区域 或意外结果 Amazon Web Services 区域。按优先顺序排列,按以下方式设置: Amazon Web Services 区域
-
--region
命令行选项。 -
环境变量
AWS_DEFAULT_REGION
-
region配置文件设置。
确认您的资源使用的是正确 Amazon Web Services 区域 的。
确认您运行的是 Amazon CLI的最新版本
如果您收到错误消息,表明某个命令不存在,或者它无法识别参考指南参考指南所说的可用参数,请首先确认您的命令格式是否正确。如果格式正确,我们建议您升级到 Amazon CLI的最新版本。的更新版本几乎每个工作日都会发布。 Amazon CLI 这些新版本中引入了新的 Amazon 服务、功能和参数 Amazon CLI。获取这些新服务、功能或参数的唯一方式是升级到首次引入该元素后发布的版本。
如何更新版本 Amazon CLI 取决于您最初的安装方式,如中所述安装、更新和卸载 Amazon CLI。
如果您使用了某个捆绑安装程序,则可能需要先删除现有安装,然后为您的操作系统下载并安装最新版本。
使用 --debug
选项
当 Amazon CLI 报告一个你无法立即理解的错误,或者产生了你意想不到的结果时,你可以通过使用--debug
选项再次运行该命令来获得有关错误的更多详细信息。使用此选项, Amazon CLI
会输出有关它处理命令所执行的每一步的详细信息。输出中的详细信息可以帮助您确定错误发生的时间,并提供错误从何处开始的线索。
您可以将输出发送到文本文件以供日后查看,或者按要求发送给 Amazon Web Services Support 。
当您包含 --debug
选项时,一些详细信息包括:
-
查找凭证
-
解析提供的参数
-
构造发送到 Amazon 服务器的请求
-
发送到的请求的内容 Amazon
-
原始响应的内容
-
带格式的输出
以下是使用和不使用 --debug
选项运行命令的示例。
$
aws iam list-groups --profile MyTestProfile
{
"Groups": [
{
"Path": "/",
"GroupName": "MyTestGroup",
"GroupId": "AGPA0123456789EXAMPLE",
"Arn": "arn:aws:iam::123456789012:group/MyTestGroup",
"CreateDate": "2019-08-12T19:34:04Z"
}
]
}
$
aws iam list-groups --profile MyTestProfile --debug
2019-08-12 12:36:18,305 - MainThread - awscli.clidriver - DEBUG - CLI version: aws-cli/1.16.215 Python/3.7.3 Linux/4.14.133-113.105.amzn2.x86_64 botocore/1.12.205
2019-08-12 12:36:18,305 - MainThread - awscli.clidriver - DEBUG - Arguments entered to CLI: ['iam', 'list-groups', '--debug']
2019-08-12 12:36:18,305 - MainThread - botocore.hooks - DEBUG - Event session-initialized: calling handler <function add_scalar_parsers at 0x7fdf173161e0>
2019-08-12 12:36:18,305 - MainThread - botocore.hooks - DEBUG - Event session-initialized: calling handler <function register_uri_param_handler at 0x7fdf17dec400>
2019-08-12 12:36:18,305 - MainThread - botocore.hooks - DEBUG - Event session-initialized: calling handler <function inject_assume_role_provider_cache at 0x7fdf17da9378>
2019-08-12 12:36:18,307 - MainThread - botocore.credentials - DEBUG - Skipping environment variable credential check because profile name was explicitly set.
2019-08-12 12:36:18,307 - MainThread - botocore.hooks - DEBUG - Event session-initialized: calling handler <function attach_history_handler at 0x7fdf173ed9d8>
2019-08-12 12:36:18,308 - MainThread - botocore.loaders - DEBUG - Loading JSON file: /home/ec2-user/venv/lib/python3.7/site-packages/botocore/data/iam/2010-05-08/service-2.json
2019-08-12 12:36:18,317 - MainThread - botocore.hooks - DEBUG - Event building-command-table.iam: calling handler <function add_waiters at 0x7fdf1731a840>
2019-08-12 12:36:18,320 - MainThread - botocore.loaders - DEBUG - Loading JSON file: /home/ec2-user/venv/lib/python3.7/site-packages/botocore/data/iam/2010-05-08/waiters-2.json
2019-08-12 12:36:18,321 - MainThread - awscli.clidriver - DEBUG - OrderedDict([('path-prefix', <awscli.arguments.CLIArgument object at 0x7fdf171ac780>), ('marker', <awscli.arguments.CLIArgument object at 0x7fdf171b09e8>), ('max-items', <awscli.arguments.CLIArgument object at 0x7fdf171b09b0>)])
2019-08-12 12:36:18,322 - MainThread - botocore.hooks - DEBUG - Event building-argument-table.iam.list-groups: calling handler <function add_streaming_output_arg at 0x7fdf17316510>
2019-08-12 12:36:18,322 - MainThread - botocore.hooks - DEBUG - Event building-argument-table.iam.list-groups: calling handler <function add_cli_input_json at 0x7fdf17da9d90>
2019-08-12 12:36:18,322 - MainThread - botocore.hooks - DEBUG - Event building-argument-table.iam.list-groups: calling handler <function unify_paging_params at 0x7fdf17328048>
2019-08-12 12:36:18,326 - MainThread - botocore.loaders - DEBUG - Loading JSON file: /home/ec2-user/venv/lib/python3.7/site-packages/botocore/data/iam/2010-05-08/paginators-1.json
2019-08-12 12:36:18,326 - MainThread - awscli.customizations.paginate - DEBUG - Modifying paging parameters for operation: ListGroups
2019-08-12 12:36:18,326 - MainThread - botocore.hooks - DEBUG - Event building-argument-table.iam.list-groups: calling handler <function add_generate_skeleton at 0x7fdf1737eae8>
2019-08-12 12:36:18,326 - MainThread - botocore.hooks - DEBUG - Event before-building-argument-table-parser.iam.list-groups: calling handler <bound method OverrideRequiredArgsArgument.override_required_args of <awscli.customizations.cliinputjson.CliInputJSONArgument object at 0x7fdf171b0a58>>
2019-08-12 12:36:18,327 - MainThread - botocore.hooks - DEBUG - Event before-building-argument-table-parser.iam.list-groups: calling handler <bound method GenerateCliSkeletonArgument.override_required_args of <awscli.customizations.generatecliskeleton.GenerateCliSkeletonArgument object at 0x7fdf171c5978>>
2019-08-12 12:36:18,327 - MainThread - botocore.hooks - DEBUG - Event operation-args-parsed.iam.list-groups: calling handler functools.partial(<function check_should_enable_pagination at 0x7fdf17328158>, ['marker', 'max-items'], {'max-items': <awscli.arguments.CLIArgument object at 0x7fdf171b09b0>}, OrderedDict([('path-prefix', <awscli.arguments.CLIArgument object at 0x7fdf171ac780>), ('marker', <awscli.arguments.CLIArgument object at 0x7fdf171b09e8>), ('max-items', <awscli.customizations.paginate.PageArgument object at 0x7fdf171c58d0>), ('cli-input-json', <awscli.customizations.cliinputjson.CliInputJSONArgument object at 0x7fdf171b0a58>), ('starting-token', <awscli.customizations.paginate.PageArgument object at 0x7fdf171b0a20>), ('page-size', <awscli.customizations.paginate.PageArgument object at 0x7fdf171c5828>), ('generate-cli-skeleton', <awscli.customizations.generatecliskeleton.GenerateCliSkeletonArgument object at 0x7fdf171c5978>)]))
2019-08-12 12:36:18,328 - MainThread - botocore.hooks - DEBUG - Event load-cli-arg.iam.list-groups.path-prefix: calling handler <awscli.paramfile.URIArgumentHandler object at 0x7fdf1725c978>
2019-08-12 12:36:18,328 - MainThread - botocore.hooks - DEBUG - Event load-cli-arg.iam.list-groups.marker: calling handler <awscli.paramfile.URIArgumentHandler object at 0x7fdf1725c978>
2019-08-12 12:36:18,328 - MainThread - botocore.hooks - DEBUG - Event load-cli-arg.iam.list-groups.max-items: calling handler <awscli.paramfile.URIArgumentHandler object at 0x7fdf1725c978>
2019-08-12 12:36:18,328 - MainThread - botocore.hooks - DEBUG - Event load-cli-arg.iam.list-groups.cli-input-json: calling handler <awscli.paramfile.URIArgumentHandler object at 0x7fdf1725c978>
2019-08-12 12:36:18,328 - MainThread - botocore.hooks - DEBUG - Event load-cli-arg.iam.list-groups.starting-token: calling handler <awscli.paramfile.URIArgumentHandler object at 0x7fdf1725c978>
2019-08-12 12:36:18,328 - MainThread - botocore.hooks - DEBUG - Event load-cli-arg.iam.list-groups.page-size: calling handler <awscli.paramfile.URIArgumentHandler object at 0x7fdf1725c978>
2019-08-12 12:36:18,328 - MainThread - botocore.hooks - DEBUG - Event load-cli-arg.iam.list-groups.generate-cli-skeleton: calling handler <awscli.paramfile.URIArgumentHandler object at 0x7fdf1725c978>
2019-08-12 12:36:18,329 - MainThread - botocore.hooks - DEBUG - Event calling-command.iam.list-groups: calling handler <bound method CliInputJSONArgument.add_to_call_parameters of <awscli.customizations.cliinputjson.CliInputJSONArgument object at 0x7fdf171b0a58>>
2019-08-12 12:36:18,329 - MainThread - botocore.hooks - DEBUG - Event calling-command.iam.list-groups: calling handler <bound method GenerateCliSkeletonArgument.generate_json_skeleton of <awscli.customizations.generatecliskeleton.GenerateCliSkeletonArgument object at 0x7fdf171c5978>>
2019-08-12 12:36:18,329 - MainThread - botocore.credentials - DEBUG - Looking for credentials via: assume-role
2019-08-12 12:36:18,329 - MainThread - botocore.credentials - DEBUG - Looking for credentials via: assume-role-with-web-identity
2019-08-12 12:36:18,329 - MainThread - botocore.credentials - DEBUG - Looking for credentials via: shared-credentials-file
2019-08-12 12:36:18,329 - MainThread - botocore.credentials - INFO - Found credentials in shared credentials file: ~/.aws/credentials
2019-08-12 12:36:18,330 - MainThread - botocore.loaders - DEBUG - Loading JSON file: /home/ec2-user/venv/lib/python3.7/site-packages/botocore/data/endpoints.json
2019-08-12 12:36:18,334 - MainThread - botocore.hooks - DEBUG - Event choose-service-name: calling handler <function handle_service_name_alias at 0x7fdf1898eb70>
2019-08-12 12:36:18,337 - MainThread - botocore.hooks - DEBUG - Event creating-client-class.iam: calling handler <function add_generate_presigned_url at 0x7fdf18a028c8>
2019-08-12 12:36:18,337 - MainThread - botocore.regions - DEBUG - Using partition endpoint for iam, us-west-2: aws-global
2019-08-12 12:36:18,337 - MainThread - botocore.args - DEBUG - The s3 config key is not a dictionary type, ignoring its value of: None
2019-08-12 12:36:18,340 - MainThread - botocore.endpoint - DEBUG - Setting iam timeout as (60, 60)
2019-08-12 12:36:18,341 - MainThread - botocore.loaders - DEBUG - Loading JSON file: /home/ec2-user/venv/lib/python3.7/site-packages/botocore/data/_retry.json
2019-08-12 12:36:18,341 - MainThread - botocore.client - DEBUG - Registering retry handlers for service: iam
2019-08-12 12:36:18,342 - MainThread - botocore.hooks - DEBUG - Event before-parameter-build.iam.ListGroups: calling handler <function generate_idempotent_uuid at 0x7fdf189b10d0>
2019-08-12 12:36:18,342 - MainThread - botocore.hooks - DEBUG - Event before-call.iam.ListGroups: calling handler <function inject_api_version_header_if_needed at 0x7fdf189b2a60>
2019-08-12 12:36:18,343 - MainThread - botocore.endpoint - DEBUG - Making request for OperationModel(name=ListGroups) with params: {'url_path': '/', 'query_string': '', 'method': 'POST', 'headers': {'Content-Type': 'application/x-www-form-urlencoded; charset=utf-8', 'User-Agent': 'aws-cli/1.16.215 Python/3.7.3 Linux/4.14.133-113.105.amzn2.x86_64 botocore/1.12.205'}, 'body': {'Action': 'ListGroups', 'Version': '2010-05-08'}, 'url': 'https://iam.amazonaws.com/', 'context': {'client_region': 'aws-global', 'client_config': <botocore.config.Config object at 0x7fdf16e9a4a8>, 'has_streaming_input': False, 'auth_type': None}}
2019-08-12 12:36:18,343 - MainThread - botocore.hooks - DEBUG - Event request-created.iam.ListGroups: calling handler <bound method RequestSigner.handler of <botocore.signers.RequestSigner object at 0x7fdf16e9a470>>
2019-08-12 12:36:18,343 - MainThread - botocore.hooks - DEBUG - Event choose-signer.iam.ListGroups: calling handler <function set_operation_specific_signer at 0x7fdf18996f28>
2019-08-12 12:36:18,343 - MainThread - botocore.auth - DEBUG - Calculating signature using v4 auth.
2019-08-12 12:36:18,343 - MainThread - botocore.auth - DEBUG - CanonicalRequest:
POST
/
content-type:application/x-www-form-urlencoded; charset=utf-8
host:iam.amazonaws.com
x-amz-date:20190812T193618Z
content-type;host;x-amz-date
5f776d91EXAMPLE9b8cb5eb5d6d4a787a33ae41c8cd6eEXAMPLEca69080e1e1f
2019-08-12 12:36:18,344 - MainThread - botocore.auth - DEBUG - StringToSign:
AWS4-HMAC-SHA256
20190812T193618Z
20190812/us-east-1/iam/aws4_request
ab7e367eEXAMPLE2769f178ea509978cf8bfa054874b3EXAMPLE8d043fab6cc9
2019-08-12 12:36:18,344 - MainThread - botocore.auth - DEBUG - Signature:
d85a0EXAMPLEb40164f2f539cdc76d4f294fe822EXAMPLE18ad1ddf58a1a3ce7
2019-08-12 12:36:18,344 - MainThread - botocore.endpoint - DEBUG - Sending http request: <AWSPreparedRequest stream_output=False, method=POST, url=https://iam.amazonaws.com/, headers={'Content-Type': b'application/x-www-form-urlencoded; charset=utf-8', 'User-Agent': b'aws-cli/1.16.215 Python/3.7.3 Linux/4.14.133-113.105.amzn2.x86_64 botocore/1.12.205', 'X-Amz-Date': b'20190812T193618Z', 'Authorization': b'AWS4-HMAC-SHA256 Credential=AKIA01234567890EXAMPLE-east-1/iam/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature=d85a07692aceb401EXAMPLEa1b18ad1ddf58a1a3ce7EXAMPLE', 'Content-Length': '36'}>
2019-08-12 12:36:18,344 - MainThread - urllib3.util.retry - DEBUG - Converted retries value: False -> Retry(total=False, connect=None, read=None, redirect=0, status=None)
2019-08-12 12:36:18,344 - MainThread - urllib3.connectionpool - DEBUG - Starting new HTTPS connection (1): iam.amazonaws.com:443
2019-08-12 12:36:18,664 - MainThread - urllib3.connectionpool - DEBUG - https://iam.amazonaws.com:443 "POST / HTTP/1.1" 200 570
2019-08-12 12:36:18,664 - MainThread - botocore.parsers - DEBUG - Response headers: {'x-amzn-RequestId': '74c11606-bd38-11e9-9c82-559da0adb349', 'Content-Type': 'text/xml', 'Content-Length': '570', 'Date': 'Mon, 12 Aug 2019 19:36:18 GMT'}
2019-08-12 12:36:18,664 - MainThread - botocore.parsers - DEBUG - Response body:
b'<ListGroupsResponse xmlns="https://iam.amazonaws.com/doc/2010-05-08/">\n <ListGroupsResult>\n <IsTruncated>false</IsTruncated>\n <Groups>\n <member>\n <Path>/</Path>\n <GroupName>MyTestGroup</GroupName>\n <Arn>arn:aws:iam::123456789012:group/MyTestGroup</Arn>\n <GroupId>AGPA1234567890EXAMPLE</GroupId>\n <CreateDate>2019-08-12T19:34:04Z</CreateDate>\n </member>\n </Groups>\n </ListGroupsResult>\n <ResponseMetadata>\n <RequestId>74c11606-bd38-11e9-9c82-559da0adb349</RequestId>\n </ResponseMetadata>\n</ListGroupsResponse>\n'
2019-08-12 12:36:18,665 - MainThread - botocore.hooks - DEBUG - Event needs-retry.iam.ListGroups: calling handler <botocore.retryhandler.RetryHandler object at 0x7fdf16e9a780>
2019-08-12 12:36:18,665 - MainThread - botocore.retryhandler - DEBUG - No retry needed.
2019-08-12 12:36:18,665 - MainThread - botocore.hooks - DEBUG - Event after-call.iam.ListGroups: calling handler <function json_decode_policies at 0x7fdf189b1d90>
{
"Groups": [
{
"Path": "/",
"GroupName": "MyTestGroup",
"GroupId": "AGPA123456789012EXAMPLE",
"Arn": "arn:aws:iam::123456789012:group/MyTestGroup",
"CreateDate": "2019-08-12T19:34:04Z"
}
]
}
启用并查看 Amazon CLI 命令历史记录日志
您可以使用cli_history
文件设置启用 Amazon CLI 命令历史记录日志。启用此设置后,会 Amazon CLI 记录aws
命令的历史记录。
您可以使用 aws history list
命令列出您的历史记录,然后使用 aws history show
命令中生成的 command_id 获取详细信息。有关更多信息,请参阅《Amazon CLI 参考指南》中的 aws
history
。
当您包含 --debug
选项时,一些详细信息包括:
-
API拨打 botocore 的电话
-
状态代码
-
HTTP回应
-
标头
-
返回代码
你可以使用这些信息来确认参数数据和API调用的行为是否符合你的预期,然后可以推断出你的命令在流程的哪个步骤失败。
确认您的配置 Amazon CLI 已完成
如果您的config
和credentials
文件或您的IAM用户或角色配置不正确,可能会出现各种错误。有关解决config
和credentials
文件或您的IAM用户或角色错误的更多信息,请参阅访问被拒绝错误和凭证无效和密钥错误。
找不到命令错误
此错误意味着操作系统找不到该 Amazon CLI 命令。安装可能不完整或需要更新。
- 可能的原因:您正在尝试使用比已安装版本更新的 Amazon CLI 功能,或者格式不正确
-
错误示例文本:
$
aws s3 copy
usage: aws [options] <command> <subcommand> [<subcommand> ...] [parameters] To see help text, you can run: aws help aws <command> help aws <command> <subcommand> help
aws: error: argument subcommand: Invalid choice, valid choices are:
ls | website cp | mv ....如果命令格式不正确,或者您使用的是发布此功能之前的早期版本,可能会发生各种错误。有关解决围绕这两个问题的错误的更多信息,请参阅检查您的 Amazon CLI 命令格式和确认您运行的是 Amazon CLI的最新版本。
- 可能的原因:安装后需要重新启动终端
-
错误示例文本:
$
aws --version
command not found: aws
如果在首次安装或更新后找不到该
aws
命令 Amazon CLI,则可能需要重新启动终端才能识别任何PATH
更新。 - 可能的原因: Amazon CLI 未完全安装
-
错误示例文本:
$
aws --version
command not found: aws
如果在首次安装或更新后找不到该
aws
命令 Amazon CLI,则该命令可能尚未完全安装。按照安装、更新和卸载 Amazon CLI中适用于您的平台的步骤尝试重新安装。 - 可能的原因: Amazon CLI 没有权限 (Linux)
-
如果在 Linux Amazon CLI 上首次安装或更新后找不到该
aws
命令,则该命令可能没有execute
权限访问其安装的文件夹。在 Amazon CLI 安装时运行以下命令,为chmod
用户提供权限 Amazon CLI:PATH
$
sudo chmod -R 755
/usr/local/aws-cli/
- 可能的原因:安装期间未更新操作系统
PATH
。 -
错误示例文本:
$
aws --version
command not found: aws
您可能需要将
aws
可执行文件添加到操作系统的PATH
环境变量中。要将 Amazon CLI 添加到您的PATH
,请按照以下适用于您的操作系统的说明进行操作。
“aws --version
”命令返回的版本与您安装的版本不同
您的终端返回的结果可能与您预期PATH
的 Amazon CLI 不同。
- 可能的原因:安装后需要重新启动终端
-
如果
aws
命令显示错误的版本,您可能需要重新启动终端以便它识别任何PATH
更新。需要关闭所有打开的终端,而不仅仅是活动的终端。 - 可能的原因:安装后需要重新启动系统
-
如果
aws
命令显示了错误的版本,并且重新启动终端不起作用,您可能需要重新启动系统,系统才能识别您的PATH
更新。 - 可能的原因:您有多个版本的 Amazon CLI
-
如果您更新了 Amazon CLI 并使用了与先前安装不同的安装方法,则可能会导致安装多个版本。例如,如果您在 Linux 或 macOS 上使用
pip
进行了当前安装,但试图使用.pkg
安装文件进行更新,这可能会导致一些冲突,尤其是当PATH
指向旧版本时。要解决这个问题,请卸载 Amazon CLI的所有版本,然后执行净安装。
卸载所有版本后,请按照适用于您的操作系统的说明安装所需版本:Amazon CLI 版本 1 或 Amazon CLI 版本 2。
注意
如果在安装 Amazon CLI 版本 2 并预先安装了版本 1 之后发生这种情况,则在从 Amazon CLIAmazon CLI 版本 1 迁移时,请按照安装说明中的迁移说明进行操作。
卸载后,aws --version
“” 命令会返回一个版本 Amazon CLI
这种情况通常发生在您的系统上还有 Amazon CLI 安装的软件时。
- 可能的原因:卸载后需要重新启动终端
-
如果
aws --version
命令仍然有效,您可能需要重新启动终端以便它识别任何终端更新。 - 可能的原因:您的系统 Amazon CLI 上有多个版本的,或者使用的卸载方法与最初安装时使用的卸载方法不同 Amazon CLI
-
如果您 Amazon CLI 使用与安装方法不同的方法卸载,或者安装了多个版本,则 Amazon CLI 可能无法正确卸载。例如,如果您使用
pip
执行了当前安装,则必须使用pip
卸载它。要解决此问题,请 Amazon CLI 使用与安装方法相同的方法进行卸载。-
按照适用于您的操作系统的说明和原始安装方法卸载 Amazon CLI 版本 1 和 Amazon CLI 版本 2。
-
关闭所有打开的终端。
-
打开首选终端,输入以下命令并确认没有返回任何版本。
$
aws --version
command not found: aws
如果输出中仍列出了一个版本,则 Amazon CLI 很可能是使用其他方法安装的,或者有多个版本。如果您不知道安装的是哪种方法 Amazon CLI,请按照适用于您的操作系统的Amazon CLI 版本 1 和Amazon CLI 版本 2 的每种卸载方法的说明进行操作,直到没有收到任何版本输出。
注意
如果您是使用软件包管理器(
pip
、apt
、brew
等)安装 Amazon CLI 的,则必须使用同一个软件包管理器来卸载它。请务必按照软件包管理器提供的有关如何卸载软件包的所有版本的说明进行操作。
-
Amazon CLI 处理了一个参数名称不完整的命令
- 可能的原因:您使用了普遍接受的 Amazon CLI 参数缩写
-
由于 Amazon CLI 是使用 Python 构建的,因此 Amazon CLI 使用 Python
argparse
库,包括allow_abbrev
参数。参数的缩写由识别 Amazon CLI 并处理。 以下
create-change-set
命令示例更改了 CloudFormation 堆栈名称。该参数--change-set-n
被识别为的缩写--change-set-name
,然后 Amazon CLI 处理该命令。$
aws cloudformation create-change-set --stack-name my-stack
--change-set-n
my-change-set当您的缩写可能代表多个命令时,参数将不会被识别为缩写。
以下
create-change-set
命令示例更改了 CloudFormation 堆栈名称。参数--change-set-
无法识别为缩写,因为它可以是多个参数(例如--change-set-name
和--change-set-type
)的缩写。因此, Amazon CLI 不处理该命令。$
aws cloudformation create-change-set --stack-name my-stack
--change-set-
my-change-set警告
不要刻意使用参数缩写。缩写不可靠且不向后兼容。如果在命令中添加了任何会使缩写产生混淆的新参数,则会中断您的命令。
此外,如果参数是单值参数,则会导致命令出现意外行为。如果传递了单值参数的多个实例,则只有最后一个实例会运行。在以下示例中,参数
--filters
是单值参数。指定了参数--filters
和--filter
。--filter
参数是--filters
的缩写。这会导致应用--filters
的两个实例,只有最后一个--filter
参数会应用。$
aws ec2 describe-vpc-peering-connections \
--filters
Name=tag:TagName,Values=VpcPeeringConnection \--filter
Name=status-code,Values=active在运行命令之前,请确认您使用的是有效参数,以防止出现意外行为。
访问被拒绝错误
- 可能的原因: Amazon CLI 程序文件没有 “运行” 权限
-
在 Linux 或 macOS 上,确保
aws
程序具有发出调用的用户的运行权限。通常,权限设置为755
。要为您的用户添加运行权限,请运行以下命令,替换为
~/.local/bin/aws
包含计算机上程序的路径。$
chmod +x
~/.local/bin/aws
- 可能的原因:您的IAM身份无权执行操作
-
错误示例文本:
$
aws s3 ls
An error occurred (AcessDenied) when calling the ListBuckets operation: Access denied.
运行 Amazon CLI 命令时,将使用将您与IAM账户或角色关联的凭据代表您执行 Amazon 操作。附加的策略必须授予您调用与您在中运行的命令相对应的API操作的权限 Amazon CLI。
大多数命令会通过一个与命令名称匹配的名称来调用单个操作。但是,自定义命令,例如
aws s3 sync
调用多个APIs。您可以使用--debug
选项查看调用了哪些APIs命令。如果您确定用户或角色具有策略分配的适当权限,请确保您的 Amazon CLI 命令使用的是您期望的证书。请参阅下一节中有关凭据的内容,以验证他们使用的凭证 Amazon CLI 是否符合您的期望。
有关分配IAM权限的信息,请参阅《IAM用户指南》中的 “访问管理概述:权限和策略”。
凭证无效和密钥错误
错误示例文本:
$
aws s3 ls
An error occurred (InvalidAccessKeyId) when calling the ListBuckets operation: The AWS Access Key Id you provided does not exist in our records.
$
aws s3 ls
An error occurred (InvalidClientTokenId) when calling the ListBuckets operation: The security token included in the request is invalid.
- 可能的原因: Amazon CLI 正在读取错误的凭据或来自意外的位置
-
Amazon CLI 可能正在从与您预期不同的位置读取证书,或者您的密钥对(key pair)信息不正确。您可以运行
aws configure list
以确认使用哪些凭证。以下示例说明如何检查用于默认配置文件的凭证。
$
aws configure list
Name Value Type Location ---- ----- ---- -------- profile <not set> None None access_key ****************XYVA shared-credentials-file secret_key ****************ZAGY shared-credentials-file region us-west-2 config-file ~/.aws/config
以下示例说明如何检查命名配置文件的凭证。
$
aws configure list --profile saanvi
Name Value Type Location ---- ----- ---- -------- profile saanvi manual --profile access_key **************** shared-credentials-file secret_key **************** shared-credentials-file region us-west-2 config-file ~/.aws/config
要确认密钥对详细信息,请检查
config
和credentials
文件。有关config
和credentials
文件的更多信息,请参阅中的配置和凭据文件设置 Amazon CLI。有关凭证和身份验证(包括凭证优先顺序)的更多信息,请参阅的身份验证和访问凭证 Amazon CLI。 - 可能的原因:您计算机的时钟不同步
-
如果您使用的凭证是有效的,则可能是您的时钟不同步。在 Linux 或 macOS 上,运行
date
以检查时间。$
date
如果您的系统时钟在几分钟内不正确,则使用
ntpd
进行同步。$
sudo service ntpd stop
$
sudo ntpdate time.nist.gov
$
sudo service ntpd start
$
ntpstat
在 Windows 上,使用控制面板中的日期和时间选项来配置系统时钟。
签名与错误不匹配
错误示例文本:
$
aws s3 ls
An error occurred (SignatureDoesNotMatch) when calling the ListBuckets operation: The request signature we calculated does not match the signature you provided. Check your key and signing method.
Amazon CLI 运行命令时,它会向 Amazon 服务器发送加密请求以执行相应的 Amazon 服务操作。您的证书(访问密钥和私有密钥)参与加密,并 Amazon 允许对提出请求的人进行身份验证。有多种因素可能会干扰此过程的正常执行,如下所示。
- 可能的原因:您的时钟与 Amazon 服务器不同步
-
为了帮助防范重播攻击
,在加密/解密过程中可能会使用当前时间。如果客户端和服务器的时间不一致超出允许的时间量,该过程可能会失败,并且请求会被拒绝。当您在其时钟与主机时钟不同步的虚拟机中运行命令时,也可能发生此错误。一个可能的原因是,当虚拟机休眠时,唤醒后需要一些时间才能将时钟与主机同步。 在 Linux 或 macOS 上,运行
date
以检查时间。$
date
如果您的系统时钟在几分钟内不正确,则使用
ntpd
进行同步。$
sudo service ntpd stop
$
sudo ntpdate time.nist.gov
$
sudo service ntpd start
$
ntpstat
在 Windows 上,使用控制面板中的日期和时间选项来配置系统时钟。
- 可能的原因:您的操作系统对包含某些特殊字符的 Amazon 密钥处理不当
-
如果您的 Amazon 密钥包含某些特殊字符,例如、
-
+
/
%
、或,则某些操作系统变体会不正确地处理字符串,从而导致密钥字符串解释不正确。如果您使用其他工具或脚本处理密钥,例如在新实例上构建证书文件作为其创建过程的一部分的工具,则这些工具和脚本可能对特殊字符有自己的处理方式,从而导致它们被转换为 Amazon 无法识别的东西。
我们建议重新生成私有密钥,以使获得的私有密钥不包含会导致问题的特殊字符。
找不到 Windows 控制台错误
错误示例文本:
$
aws s3 ls
No Windows console found. Are you running cmd.exe?
当你使用 Amazon CLI 命令时,你会收到 “未找到 Windows 控制台”。您是否正在运行 cmd.exe?” 错误消息。如果您安装的 Python 已过时,则在 Amazon CLI 版本 1 中通常prompt_toolkit
会出现错误。要解决此问题,请安装 Python 网站prompt_toolkit
。
SSL证书错误
- 可能的原因: Amazon CLI 不信任你的代理证书
-
错误示例文本:
$
aws s3 ls
[SSL: CERTIFICATE_ VERIFY_FAILED] certificate verify failed
使用 Amazon CLI 命令时,您会收到一条
[SSL: CERTIFICATE_ VERIFY_FAILED] certificate verify failed
错误消息。这是由于代理人的证书是自签名的,您的公司被设置为证书颁发机构 (CA),导致您 Amazon CLI 不信任代理人的证书。这可以防止在本地 CA 注册表中找到您公司的 CA 根证书。 Amazon CLI要解决此问题,请使用
ca_bundle
配置.pem
文件设置、--ca-bundle命令行选项或AWS_CA_BUNDLE
环境变量指示在 Amazon CLI 哪里可以找到您的公司文件。 - 可能的原因:您的配置未指向正确的 CA 根证书位置
-
错误示例文本:
$
aws s3 ls
SSL validation failed for
regionname
[Errno 2] No such file or directory这是由于您的证书颁发机构 (CA)捆绑包文件位置在 Amazon CLI中配置不正确所致。要解决此问题,请确认您的公司
.pem
文件所在的位置,并使用ca_bundle
配置文件设置、--ca-bundle 命令行选项或AWS_CA_BUNDLE
环境变量更新 Amazon CLI 配置。 - 可能的原因:您的配置使用不正确 Amazon Web Services 区域
-
错误示例文本:
$
aws s3 ls
[SSL: CERTIFICATE_ VERIFY_FAILED] certificate verify failed
如果您指定的资源 Amazon Web Services 服务 不可用,或者您的资源位于其他位置,则可能会出现错误 Amazon Web Services 区域 或意外结果 Amazon Web Services 区域。有关问题排查步骤,请参阅检查 Amazon Web Services 区域 你的 Amazon CLI 命令正在使用什么。
- 可能的原因:您的TLS版本需要更新
-
错误示例文本:
$
aws s3 ls
[SSL: UNSAFE_LEGACY_RENEGOTIATION_DISABLED] unsafe legacy renegotiation disabled
使用的 Amazon Web Services 服务 版本与您的设备TLS版本不兼容。TLS要解决此问题,请更新到支持的TLS版本。有关更多信息,请参阅 强制使用最低版本TLS的 Amazon CLI。
JSON错误无效
错误示例文本:
$
aws dynamodb update-table \ --provisioned-throughput
'{"ReadCapacityUnits":15,WriteCapacityUnits":10}'
\ --table-name MyDDBTableError parsing parameter '--provisioned-throughput': Invalid JSON: Expecting property name enclosed in double quotes: line 1 column 25 (char 24) JSON received: {"ReadCapacityUnits":15,WriteCapacityUnits":10}
使用 Amazon CLI 命令时,您会收到 “Invalid JSON
” 错误消息。当您输入具有预期JSON格式的命令并且 Amazon CLI 无法JSON正确读取您的命令时,通常会出现错误。
- 可能的原因:您输入JSON的内容无效, Amazon CLI 无法使用
-
确认您JSON输入的命令是有效的。我们建议您使用JSON验证器,因为JSON您在格式化方面遇到了问题。
要在命令行中JSON使用更高级的用法,可以考虑使用命令行JSON处理器(例如
jq
)来创建JSON字符串。有关的更多信息jq
,请参阅上的 jq 存储库。GitHub - 可能的原因:您的终端的报价规则导致无法将有效JSON报价发送到 Amazon CLI
-
在从命令 Amazon CLI 接收任何内容之前,您的终端会使用自己的引用和转义规则处理该命令。由于终端的格式化规则,在将命令传递给之前,您的某些JSON内容可能会被删除。 Amazon CLI在构建命令时,请务必使用终端的引号规则。
要进行故障排除,请使用
echo
命令来查看 Shell 如何处理您的参数:$
echo {"ReadCapacityUnits":15,"WriteCapacityUnits":10}
ReadCapacityUnits:15 WriteCapacityUnits:10
$
echo '{"ReadCapacityUnits":15,"WriteCapacityUnits":10}'
{"ReadCapacityUnits":15,"WriteCapacityUnits":10}
修改您的命令,直到返回有效JSON为止。
要进行更深入的故障排除,请使用
--debug
参数来查看调试日志,因为它们将确切地显示传递给 Amazon CLI的内容:$
aws dynamodb update-table \ --provisioned-throughput
'{"ReadCapacityUnits":15,WriteCapacityUnits":10}'
\ --table-name MyDDBTable \ --debug2022-07-19 22:25:07,741 - MainThread - awscli.clidriver - DEBUG - CLI version: aws-cli/1.18.147 Python/2.7.18 Linux/5.4.196-119.356.amzn2int.x86_64 botocore/1.18.6 2022-07-19 22:25:07,741 - MainThread - awscli.clidriver - DEBUG - Arguments entered to CLI: ['dynamodb', 'update-table', '--provisioned-throughput', '{"ReadCapacityUnits":15,WriteCapacityUnits":10}', '--table-name', 'MyDDBTable', '--debug']
使用终端的报价规则来修复您的JSON输入发送到时遇到的任何问题。 Amazon CLI有关引号规则的更多信息,请参阅在字符串中使用引号和文字 Amazon CLI。
注意
如果您在获取有效JSON性时遇到问题 Amazon CLI,我们建议您使用 Blobs 将您的JSON数据直接传递给,从而绕过终端JSON的数据输入报价规则。 Amazon CLI有关 Blob 的更多信息,请参阅Blob。
其他资源
要获得 Amazon CLI 有关问题的更多帮助,请访问Amazon CLI 社区GitHub