本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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
有效值:
IPv4
、IPv6
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 系统属性设置。
SDK | 支持 | 备注或更多信息 |
---|---|---|
Amazon CLI v2 | 支持 | |
适用于 C++ 的 SDK | 不支持 | IMDSv2 仅在内部使用。请参阅 IMDS 凭证提供者。 |
适用于 Go V2 (1.x) 的 SDK |
支持 | |
适用于 Go 1.x(V1)的 SDK | 支持 | |
适用于 Java 2.x 的 SDK | 支持 | |
适用于 Java 1.x 的 SDK | 支持 | |
适用于 JavaScript 3.x 的软件开发工具包 | 支持 | |
适用于 JavaScript 2.x 的 SDK | 支持 | |
适用于 Kotlin 的 SDK | 支持 | |
适用于 .NET 3.x 的 SDK | 支持 | |
适用于 PHP 3.x 的 SDK | 支持 | |
适用于 Python (Boto3) 的 SDK |
支持 | |
适用于 Ruby 3.x 的 SDK | 支持 | |
适用于 Rust 的 SDK | 支持 | |
用于 PowerShell | 支持 |