Amazon EC2 实例元数据
注意
如需获得相关帮助,以了解设置页面的布局或解释后面的 AWS SDK 和工具支持表,请参阅了解本指南的设置页面。
Amazon EC2 在实例上提供了一项名为实例元数据服务(IMDS)的服务。要了解有关此服务的更多信息,请参阅《Amazon EC2 用户指南》中的使用实例元数据。尝试在已配置 IAM 角色的 Amazon EC2 实例上检索凭证时,默认情况下,与实例元数据服务的连接是可调节的。
使用以下方法配置此功能:
metadata_service_num_attempts- 共享 AWSconfig文件设置AWS_METADATA_SERVICE_NUM_ATTEMPTS- 环境变量-
本设置指定了尝试从实例元数据服务检索数据时,在放弃前尝试的总次数。
默认值: 1
有效值:大于或等于 1 的数字。
metadata_service_timeout- 共享 AWSconfig文件设置AWS_METADATA_SERVICE_TIMEOUT- 环境变量-
指定的从实例元数据服务检索数据时,发生超时前的秒数。
默认值: 1
有效值:大于或等于 1 的数字。
在 config 文件中设置这些值的示例:
[default] metadata_service_num_attempts=10metadata_service_timeout=10
Linux/macOS 通过命令行设置环境变量的示例:
export AWS_METADATA_SERVICE_NUM_ATTEMPTS=10export AWS_METADATA_SERVICE_TIMEOUT=10
Windows 通过命令行设置环境变量的示例:
setx AWS_METADATA_SERVICE_NUM_ATTEMPTS10setx AWS_METADATA_SERVICE_TIMEOUT10
AWS SDK 和工具支持
以下 SDK 支持本主题中所述的功能和设置。所有部分例外情况均已注明。任何 JVM 系统属性设置都仅支持 适用于 Java 的 AWS SDK 和 适用于 Kotlin 的 AWS SDK。
| SDK | 支持 | 备注或更多信息 |
|---|---|---|
| AWS CLI v2 | 是 | |
| 适用于 C++ 的 SDK | 否 | |
| 适用于 Go V2 (1.x) 的 SDK |
否 | |
| 适用于 Go 1.x(V1)的 SDK | 否 | |
| 适用于 Java 2.x 的 SDK | 部分 | 仅支持 AWS_METADATA_SERVICE_TIMEOUT。 |
| 适用于 Java 1.x 的 SDK | 部分 | 仅支持 AWS_METADATA_SERVICE_TIMEOUT。 |
| 适用于 JavaScript 3.x 的 SDK | 否 | |
| 适用于 JavaScript 2.x 的 SDK | 否 | |
| 适用于 Kotlin 的 SDK | 否 | |
| 适用于 .NET 4.x 的 SDK | 否 | |
| 适用于 .NET 3.x 的 SDK | 否 | |
| 适用于 PHP 3.x 的 SDK | 是 | |
| 适用于 Python (Boto3) 的 SDK |
是 | |
| 适用于 Ruby 3.x 的 SDK | 否 | |
| 适用于 Rust 的 SDK | 否 | |
| 适用于 Swift 的 SDK | 否 | |
| Tools for PowerShell V5 | 否 | |
| Tools for PowerShell V4 | 否 |