Amazon EC2 实例元数据 - AWS SDK 和工具

Amazon EC2 实例元数据

注意

如需获得相关帮助,以了解设置页面的布局或解释后面的 AWS SDK 和工具支持表,请参阅了解本指南的设置页面

Amazon EC2 在实例上提供了一项名为实例元数据服务(IMDS)的服务。要了解有关此服务的更多信息,请参阅《Amazon EC2 用户指南》中的使用实例元数据。尝试在已配置 IAM 角色的 Amazon EC2 实例上检索凭证时,默认情况下,与实例元数据服务的连接是可调节的。

使用以下方法配置此功能:

metadata_service_num_attempts - 共享 AWS config 文件设置
AWS_METADATA_SERVICE_NUM_ATTEMPTS - 环境变量

本设置指定了尝试从实例元数据服务检索数据时,在放弃前尝试的总次数。

默认值: 1

有效值:大于或等于 1 的数字。

metadata_service_timeout - 共享 AWS config 文件设置
AWS_METADATA_SERVICE_TIMEOUT - 环境变量

指定的从实例元数据服务检索数据时,发生超时前的秒数。

默认值: 1

有效值:大于或等于 1 的数字。

config 文件中设置这些值的示例:

[default] metadata_service_num_attempts=10 metadata_service_timeout=10

Linux/macOS 通过命令行设置环境变量的示例:

export AWS_METADATA_SERVICE_NUM_ATTEMPTS=10 export AWS_METADATA_SERVICE_TIMEOUT=10

Windows 通过命令行设置环境变量的示例:

setx AWS_METADATA_SERVICE_NUM_ATTEMPTS 10 setx AWS_METADATA_SERVICE_TIMEOUT 10

AWS SDK 和工具支持

以下 SDK 支持本主题中所述的功能和设置。所有部分例外情况均已注明。任何 JVM 系统属性设置都仅支持 适用于 Java 的 AWS SDK 和 适用于 Kotlin 的 AWS SDK。