实例元数据类别 - Amazon Elastic Compute Cloud
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

实例元数据类别

下表列举了实例元数据的类别。

注意

当 Amazon EC2 发布新的实例元数据类别时,新类别的实例元数据可能不适用于现有实例。要确保实例元数据可用于现有实例,您需要停止并重新启动该实例。

重要

下表中的一些类别名称是实例独有的数据的占位符。例如,mac 表示网络接口的 MAC 地址。您必须使用实际值替换占位符。

数据 说明 发行日期
ami-id 用于启动实例的 AMI ID。 版本 1.0
ami-launch-index 如果您同时启动了多个实例,此值表示实例启动的顺序。第一个启动的实例的值是 0。 版本 1.0
ami-manifest-path 指向 Amazon S3 中的 AMI 清单文件的路径。如果您使用 Amazon EBS 支持的 AMI 来启动实例,则返回的结果为 unknown 版本 1.0
ancestor-ami-ids 为创建此 AMI 而重新绑定的任何实例的 AMI ID。仅当 AMI 清单文件包含一个 ancestor-amis 密钥时,此值才存在。 2007-10-10
block-device-mapping/ami 包含根/启动文件系统的虚拟设备。 2007-12-15
block-device-mapping/ebs 与任何 Amazon EBS 卷关联的虚拟设备。仅当 Amazon EBS 卷在启动时存在或者在上一次启动该实例时存在时,这些卷才在元数据中可用。N 表示 Amazon EBS 卷的索引(例如 ebs1ebs2)。 2007-12-15
block-device-mapping/ephemeral 任何非 NVMe 实例存储卷的虚拟设备。N 表示每个卷的索引。块储存设备映射中的实例存储卷数可能与实例的实际实例存储卷数不匹配。实例类型将决定对实例可用的实例存储卷的数量。如果块储存设备映射中的实例存储卷数超过了对实例可用的实例存储卷数,则其他实例存储卷将被忽略。 2007-12-15
block-device-mapping/root 与根设备关联的虚拟设备或分区或虚拟设备上的分区,其中根(/ 或 C:)文件系统与给定实例相关联。 2007-12-15
block-device-mapping/swap swap 关联的虚拟设备。并不总是存在。 2007-12-15
elastic-gpus/associations/elastic-gpu-id 如果有 Elastic GPU 附加到实例,在有关 Elastic GPU 的信息中包含 JSON 字符串,包括其 ID 和连接信息。 2016-11-30
elastic-inference/associations/eia-id 如果有 Elastic Inference 加速器附加到实例,则在有关Elastic Inference 加速器的信息中包含一个 JSON 字符串,包括其 ID 和类型。 2018-11-29
events/maintenance/history 如果实例存在已完成或已取消的维护事件,则包含一个 JSON 字符串,其中包含有关事件的信息。有关更多信息,请参阅查看有关已完成或已取消的事件的事件历史记录 2018-08-17
events/maintenance/scheduled 如果实例存在活动的维护事件,则包含一个 JSON 字符串,其中包含有关事件的信息。有关更多信息,请参阅查看计划的事件 2018-08-17
hostname 实例的私有 IPv4 DNS 主机名。在存在多个网络接口的情况下,其指的是 eth0 设备 (设备号为 0 的设备)。 版本 1.0
iam/info 如果存在与实例关联的 IAM 角色,则包含有关实例配置文件上次更新时间的信息 (包括实例的 LastUpdated 日期、InstanceProfileArn 和 InstanceProfileId)。如果没有,则不显示。 2012-01-12
iam/security-credentials/role-name 如果存在与实例关联的 IAM 角色,则 role-name 为角色的名称,并且 role-name 包含与角色关联的临时安全凭证 (有关更多信息,请参阅 从实例元数据中检索安全凭证)。如果没有,则不显示。 2012-01-12
identity-credentials/ec2/info [仅限内部使用] 有关 identity-credentials/ec2/security-credentials/ec2-instance 中的凭证的信息。这些凭证由 AWS 功能(如 EC2 Instance Connect)使用,除了确认实例身份外,没有任何其他 AWS API 权限或特权。 2018-05-23
identity-credentials/ec2/security-credentials/ec2-instance [仅限内部使用] 允许实例软件向 AWS 确认自身身份以支持 EC2 Instance Connect 等功能的凭证。这些凭证不具有任何额外的 AWS API 权限或特权。 2018-05-23
instance-action 通知实例在准备打包时重新启动。有效值:none | shutdown | bundle-pending 2008-09-01
instance-id 此实例的 ID。 版本 1.0
instance-life-cycle 此实例的采购选项。有关更多信息,请参阅 实例购买选项 2019-10-01
instance-type 实例的类型。有关更多信息,请参阅 实例类型 2007-08-29
kernel-id 此实例启动的内核的 ID,如果适用的话。 2008-02-01
local-hostname 实例的私有 IPv4 DNS 主机名。在存在多个网络接口的情况下,其指的是 eth0 设备 (设备号为 0 的设备)。 2007-01-19
local-ipv4 实例的私有 IPv4 地址。在存在多个网络接口的情况下,其指的是 eth0 设备 (设备号为 0 的设备)。 版本 1.0
mac 实例的媒体访问控制 (MAC) 地址。在存在多个网络接口的情况下,其指的是 eth0 设备 (设备号为 0 的设备)。 2011 年 1 月 1 日
metrics/vhostmd 不再可用。 2011-05-01
network/interfaces/macs/mac/device-number 与该接口关联的唯一设备号。设备号与设备名称对应;例如,device-number 为 2 对应于 eth2 设备。此类别对应的是 AWS CLI 的 Amazon EC2 API 和 EC2 命令使用的 DeviceIndexdevice-index 字段。 2011 年 1 月 1 日
network/interfaces/macs/mac/interface-id 网络接口的 ID。 2011 年 1 月 1 日
network/interfaces/macs/mac/ipv4-associations/public-ip 与每个公用 IP 地址相关联并被分配到该接口的私有 IPv4 地址。 2011 年 1 月 1 日
network/interfaces/macs/mac/ipv6s 与接口关联的 IPv6 地址。仅对启动至 VPC 的实例返回。 2016-06-30
network/interfaces/macs/mac/local-hostname 实例的本地主机名称。 2011 年 1 月 1 日
network/interfaces/macs/mac/local-ipv4s 与接口关联的私有 IPv4 地址。 2011 年 1 月 1 日
network/interfaces/macs/mac/mac 该实例的 MAC 地址。 2011 年 1 月 1 日
network/interfaces/macs/mac/owner-id 网络接口拥有者的 ID。在多个接口的环境中,接口可由第三方连接,如 Elastic Load Balancing。接口拥有者需为接口上的流量付费。 2011 年 1 月 1 日
network/interfaces/macs/mac/public-hostname 接口的公有 DNS (IPv4)。仅当 enableDnsHostnames 属性设置为 true 时,才返回此类别。有关更多信息,请参阅在您的 VPC 中使用 DNS 2011 年 1 月 1 日
network/interfaces/macs/mac/public-ipv4s 与接口关联的公有 IP 地址或弹性 IP 地址。一个实例上可能有多个 IPv4 地址。 2011 年 1 月 1 日
network/interfaces/macs/mac/security-groups 网络接口所属的安全组。 2011 年 1 月 1 日
network/interfaces/macs/mac/security-group-ids 网络接口所属的安全组的 ID。 2011 年 1 月 1 日
network/interfaces/macs/mac/subnet-id 接口所驻留的子网的 ID。 2011 年 1 月 1 日
network/interfaces/macs/mac/subnet-ipv4-cidr-block 接口所在子网的 IPv4 CIDR 块。 2011 年 1 月 1 日
network/interfaces/macs/mac/subnet-ipv6-cidr-blocks 接口所在子网的 IPv6 CIDR 块。 2016-06-30
network/interfaces/macs/mac/vpc-id 接口所驻留的 VPC 的 ID。 2011 年 1 月 1 日
network/interfaces/macs/mac/vpc-ipv4-cidr-block VPC 的主 IPv4 CIDR 块。 2011 年 1 月 1 日
network/interfaces/macs/mac/vpc-ipv4-cidr-blocks VPC 的 IPv4 CIDR 块。 2016-06-30
network/interfaces/macs/mac/vpc-ipv6-cidr-blocks 接口所在 VPC 的 IPv6 CIDR 块。 2016-06-30
placement/availability-zone 实例启动的可用区。 2008-02-01
placement/availability-zone-id 在其中启动实例的静态可用区 ID。可用区 ID 在账户之间保持一致。但是,它可能与可用区不同,后者可能因账户而异。 2020-08-24
placement/group-name 在其中启动实例的置放群组的名称。 2020-08-24
placement/host-id 启动实例的主机的 ID。仅适用于专用主机。 2020-08-24
placement/partition-number 在其中启动实例的分区编号。 2020-08-24
placement/region 在其中启动实例的 AWS 区域。 2020-08-24
product-codes 与实例关联的 AWS Marketplace 产品代码(如果有)。 2007-03-01
public-hostname 实例的公有 DNS。仅当 enableDnsHostnames 属性设置为 true 时,才返回此类别。有关更多信息,请参阅 Amazon VPC 用户指南中的在您的 VPC 中使用 DNS 2007-01-19
public-ipv4 公有 IPv4 地址。如果弹性 IP 地址与实例相关联,返回的值是弹性 IP 地址。 2007-01-19
public-keys/0/openssh-key 公有密钥。仅在实例启动时提供了公有密钥的情况下可用。 版本 1.0
ramdisk-id 启动时指定的 RAM 磁盘 的 ID,如果适用的话。 2007-10-10
reservation-id 预留的 ID。 版本 1.0
security-groups

应用到实例的安全组的名称。

在启动后,您可以更改实例的安全组。这些更改将体现在此处和 network/interfaces/macs/mac/security-groups 中。

版本 1.0
services/domain

区域的 AWS 资源所在的域。

2014-02-25
services/partition

资源所处的分区。对于标准 AWS 区域,分区是 aws。如果资源位于其他分区,则分区是 aws-partitionname。例如,中国(北京)区域中的资源的分区为 aws-cn

2015-10-20
spot/instance-action

操作(休眠、停止或终止)和操作发生的大致时间(用 UTC 表示)。仅在已将 Spot 实例 实例标记为休眠、停止或终止时才提供此项目。有关更多信息,请参阅instance-action

2016-11-15
spot/termination-time

Spot 实例 操作系统将收到关闭信号的大致时间 (UTC)。仅当 Spot 实例 已由 Amazon EC2 标记为终止时,此项目才会出现并包含时间值(例如,2015-01-05T18:02:00Z)。如果您自己终止了 Spot 实例,那么终止时间项目不会设置为时间。有关更多信息,请参阅termination-time

2014-11-05

动态数据类别

下表列举了动态数据的类别。

数据 说明 发行日期
fws/instance-monitoring 显示客户是否在 CloudWatch 中启用了详细的一分钟监控的值。有效值:enabled | disabled 2009-04-04
instance-identity/document 包含实例属性 (如实例 ID、私有 IP 地址等) 的 JSON。请参阅 实例身份文档 2009-04-04
instance-identity/pkcs7 用于验证签名的文档的真实性和内容。请参阅 实例身份文档 2009-04-04
instance-identity/signature 可被其他各方用于验证来源和真实性的数据。请参阅 实例身份文档 2009-04-04