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

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

IMDS 客户端

SDK 使用面向会话的请求来实施实例元数据服务版本 2 (IMDSv2) 客户端。有关 IMDSv2 的更多信息,请参阅适用于 Linux 实例的 Amazon EC2 用户指南中的使用 IMDS v2适用于 Windows 实例的 Amazon EC2 用户指南中的使用 IMDSv2。IMDS 客户端可通过 SDK 代码库中提供的客户端配置对象进行配置。

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

retries - 客户端配置对象成员

任何失败的请求的额外重试次数。

默认值:3

有效值:大于 0 的数字。

port - 客户端配置对象成员

端点的端口。

默认值:80

有效值:数字。

token_ttl - 客户端配置对象成员

令牌的 TTL。

默认值:21,600 秒(6 小时,分配的最长时间)。

有效值:数字。

endpoint - 客户端配置对象成员

IMDS 的端点。

默认值:如果 endpoint_mode 等于 IPv4,则默认端点为 http://169.254.169.254。如果 endpoint_mode 等于 IPv6,则默认端点为 http://[fd00:ec2::254]

有效值:有效的 URI。

多数 SDK 都支持以下选项。有关详细信息,请参阅您的特定 SDK 代码库。

endpoint_mode - 客户端配置对象成员

IMDS 的端点模式。

默认值IPv4

有效值IPv4IPv6

http_open_timeout - 客户端配置对象成员(名称可能有所不同)

等待连接打开的秒数。

默认值:1 秒。

有效值:大于 0 的数字。

http_read_timeout - 客户端配置对象成员(名称可能有所不同)

读取一个数据块的秒数。

默认值:1 秒。

有效值:大于 0 的数字。

http_debug_output - 客户端配置对象成员(名称可能有所不同)

设置用于调试的输出流。

默认值:无。

有效值:有效的 I/O 流,如 STDOUT。

backoff - 客户端配置对象成员(名称可能有所不同)

在两次重试之间休眠的秒数,或者客户提供的回退功能可供调用。这会覆盖默认的指数回退策略。

默认值:因 SDK 而异。

有效值:因 SDK 而异。可以是数值,也可以是对自定义函数的调用。

与 Amazon SDK 的兼容性

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