AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

配置实例元数据服务

您可以使用以下其中一种方法，从正在运行的实例中访问实例元数据：

默认情况下，您可以使用 IMDSv1 和/或 IMDSv2。实例元数据服务根据以下条件区分 IMDSv1 和 IMDSv2 请求：对于任何给定请求，PUT 或 GET 标头（对于 IMDSv2 是唯一的）在该请求中是否存在。

您可以在每个实例上配置实例元数据服务，以便本地代码或用户必须使用 IMDSv2。在指定必须使用 IMDSv2 时，IMDSv1 不再起作用。有关更多信息，请参阅配置实例元数据选项。

要检索实例元数据，请参阅检索实例元数据。

实例元数据服务版本 2 的工作原理

IMDSv2 使用面向会话的请求。对于面向会话的请求，您创建一个会话令牌以定义会话持续时间，该时间最少为 1 秒，最多为 6 小时。在指定的持续时间内，您可以将相同的会话令牌用于后续请求。在指定的持续时间到期后，您必须创建新的会话令牌以用于将来的请求。

以下示例使用 Linux Shell 脚本和 IMDSv2 检索顶级实例元数据项。示例命令：

[ec2-user ~]$ TOKEN=`curl -X PUT "http://169.254.169.254/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 21600"` \
&& curl -H "X-aws-ec2-metadata-token: $TOKEN" -v http://169.254.169.254/latest/meta-data/

在创建令牌后，您可以重复使用令牌，直到令牌过期。在以下示例命令（获取用于启动实例的 AMI 的 ID）中，将重复使用上一示例中的令牌（存储在 $TOKEN 中）。

[ec2-user ~]$ curl -H "X-aws-ec2-metadata-token: $TOKEN" -v http://169.254.169.254/latest/meta-data/ami-id

在使用 IMDSv2 请求实例元数据时，请求必须包含以下内容：

允许在 IMDSv2 实例元数据请求中使用 HTTP GET 和 HEAD 方法。如果 PUT 请求包含 X-Forwarded-For 标头，则会被拒绝。

默认情况下，PUT 请求的响应在 IP 协议级别的响应跃点数限制（生存时间）为 1。如果需要增大跃点数限制，您可以使用 modify-instance-metadata-options 命令进行调整。例如，您可能需要使用更大的跃点数限制，以便与实例上运行的容器服务保持向后兼容。有关更多信息，请参阅 AWS CLI Command Reference 中的 modify-instance-metadata-options。

转换为使用 实例元数据服务版本 2

使用 实例元数据服务版本 2 (IMDSv2) 是可选的。将继续无期限支持 实例元数据服务版本 1 (IMDSv1)。如果您选择迁移以使用 IMDSv2，我们建议您使用以下工具和转换途径。

帮助转换为 IMDSv2 的工具

如果您的软件使用 IMDSv1，请使用以下工具帮助重新配置软件，以使用 IMDSv2。

要求 IMDSv2 访问的建议途径

在使用上述工具时，我们建议您按照以下途径转换为 IMDSv2：

步骤 1：在开始时

将在 EC2 实例上使用角色凭证的开发工具包、CLI 和软件更新为与 IMDSv2 兼容的版本。有关更新 CLI 的信息，请参阅 AWS Command Line Interface 用户指南 中的升级到最新版本的 AWS CLI。

然后，使用 IMDSv2 请求更改直接访问实例元数据的软件（换句话说，不使用开发工具包）。

步骤 2：在转换期间

使用 CloudWatch 指标 MetadataNoToken 跟踪您的转换进度。此指标显示对在实例上使用 IMDSv1 的实例元数据服务的调用次数。有关更多信息，请参阅实例指标。

步骤 3：在所有实例上一切准备就绪时

在 CloudWatch 指标 MetadataNoToken 记录 IMDSv1 使用次数为零时，说明在所有实例上一切准备就绪。在此阶段，您可以执行以下操作：

更新现有实例的实例元数据选项的操作只能通过 API 或 AWS CLI 执行。Amazon EC2 控制台当前不支持此操作。有关更多信息，请参阅配置实例元数据选项。

步骤 4：将所有实例转换为 IMDSv2 时

可以使用 ec2:MetadataHttpTokens、ec2:MetadataHttpPutResponseHopLimit 和 ec2:MetadataHttpEndpoint IAM 条件键，以控制 RunInstances 和 ModifyInstanceMetadataOptions API 以及相应 CLI 的使用。如果创建了策略，并且 API 调用中的参数与使用条件键的策略中指定的状态不匹配，API 或 CLI 调用将失败并显示 UnauthorizedOperation 响应。有关示例 IAM 策略，请参阅 使用实例元数据。

配置实例元数据选项

通过实例元数据选项，您可以通过配置新实例或现有实例来执行以下操作：

您还可以在 IAM 策略或 SCP 中使用 IAM 条件键执行以下操作：

您可以在通过 Amazon EC2 控制台启动新实例时配置实例元数据选项。有关更多信息，请参阅步骤 3：配置实例详细信息。

要在新实例或现有实例上配置实例元数据选项，您可以使用 AWS 开发工具包或 AWS CLI。有关更多信息，请参阅 AWS CLI Command Reference中的 run-instances 和 modify-instance-metadata-options。

为新实例配置实例元数据选项

您可以在启动实例时要求使用 IMDSv2。您还可以创建 IAM 策略，使得除非用户在新实例上要求使用 IMDSv2，否则阻止用户启动新实例。

Console

要求在新实例上使用 IMDSv2

• 在 Amazon EC2 控制台中启动新实例时，请在配置实例详细信息页面上选择以下选项：

  • 在高级详细信息下，对于可访问的元数据，选择已启用。

  • 对于元数据版本，选择 V2 (令牌必填)。

有关更多信息，请参阅 步骤 3：配置实例详细信息。

AWS CLI

要求在新实例上使用 IMDSv2

以下 run-instances 示例会启动 --metadata-options 设置为 HttpTokens=required 的 c3.large 实例。在为 HttpTokens 指定值时，还必须将 HttpEndpoint 设置为 enabled。由于元数据检索请求的安全令牌标头设置为 required，因此会在请求实例元数据时使实例选择要求 IMDSv2。

aws ec2 run-instances 
    --image-id ami-0abcdef1234567890 
    --instance-type c3.large 
	...
    --metadata-options "HttpEndpoint=enabled,HttpTokens=required"

在所有新实例上强制使用 IMDSv2

要确保 IAM 用户只能启动要求在请求实例元数据时使用 IMDSv2 的实例，您可以指定在启动实例之前要求 IMDSv2 必须满足的条件。有关示例 IAM 策略，请参阅使用实例元数据。

Console

关闭对实例元数据的访问

• 为了确保关闭对实例元数据的访问（无论您使用的是哪个版本的实例元数据服务），请在 Amazon EC2 控制台中启动实例，并在配置实例详细信息页面上选择以下选项：

  • 在高级详细信息下，对于可访问的元数据，选择已禁用。

有关更多信息，请参阅 步骤 3：配置实例详细信息。

AWS CLI

关闭对实例元数据的访问

要确保关闭对实例元数据的访问权限，无论您使用的是哪个版本的实例元数据服务，请将 --metadata-options 设置为 HttpEndpoint=disabled 来启动实例。您可以稍后使用 modify-instance-metadata-options 命令打开访问权限。

aws ec2 run-instances 
    --image-id ami-0abcdef1234567890 
    --instance-type c3.large 
    ... 
    --metadata-options "HttpEndpoint=disabled"

为现有实例配置实例元数据选项

在现有实例上要求使用 IMDSv2。您也可以更改 PUT 响应跃点限制，并关闭对现有实例上实例元数据的访问。您还可以创建 IAM 策略，防止用户修改现有实例上的实例元数据选项。

要求使用 IMDSv2

您可以选择要求在请求实例元数据时使用 IMDSv2。请使用 modify-instance-metadata-options CLI 命令，并将 http-tokens 参数设置为 required。在为 http-tokens 指定值时，还必须将 http-endpoint 设置为 enabled。

aws ec2 modify-instance-metadata-options \
    --instance-id i-1234567898abcdef0 \
    --http-tokens required \
    --http-endpoint enabled

更改 PUT 响应跃点限制

对于现有的实例，您可以更改 PUT 响应跃点数限制设置。请使用 modify-instance-metadata-options CLI 命令，并将 http-put-response-hop-limit 参数设置为所需的跃点数。在以下示例中，跃点数限制设置为 3。请注意，在为 http-put-response-hop-limit 指定值时，还必须将 http-endpoint 设置为 enabled。

aws ec2 modify-instance-metadata-options \
    --instance-id i-1234567898abcdef0 \
    --http-put-response-hop-limit 3 \
    --http-endpoint enabled

使用 IMDSv2 恢复在实例上使用 IMDSv1

您可以使用 modify-instance-metadata-options CLI 命令并将 http-tokens 设置为 optional，以在请求实例元数据时恢复使用 IMDSv1。

aws ec2 modify-instance-metadata-options \
    --instance-id i-1234567898abcdef0 \
    --http-tokens optional \
    --http-endpoint enabled

关闭对实例元数据的访问

您可以通过禁用实例元数据服务的 HTTP 终端节点以禁用实例元数据访问，而无论使用的是哪种实例元数据服务版本。您可以随时启用 HTTP 终端节点以撤消该更改。请使用 modify-instance-metadata-options CLI 命令，并将 http-endpoint 参数设置为 disabled。

aws ec2 modify-instance-metadata-options \
    --instance-id i-1234567898abcdef0 \
    --http-endpoint disabled

控制 modify-instance-metadata-options 的使用

要控制哪些 IAM 用户可以修改实例元数据选项，请指定一个策略，阻止具有除指定角色的用户以外的所有用户使用 ModifyInstanceMetadataOptions API。有关示例 IAM 策略，请参阅使用实例元数据。