Amazon EC2 实例元数据 - Amazon 软件开发工具包和工具
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

Amazon EC2 实例元数据

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

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

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

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

默认值: 1

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

metadata_service_timeout-共享 Amazon 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

与 Amazon SDK 的兼容性

以下 SDK 支持本主题中所述的功能和设置。所有部分例外情况均已注明。 Amazon SDK for Java 和 Amazon SDK for Kotlin 唯一支持任何 JVM 系统属性设置。