实例元数据是指您的ECS实例在阿里云系统中的一些基本信息,包括实例ID、IP地址、操作系统等。您可以使用这些元数据管理或配置ECS实例。

说明 如果您手动更改了部分实例信息,这种更改不会体现到实例元数据中。

使用限制

仅支持获取专有网络VPC类型实例的元数据。

获取方法

Linux 实例
  1. 使用用户名密码验证连接Linux实例
  2. 执行命令curl http://100.100.100.200/latest/meta-data/可以访问元数据的根目录。

  3. 在URL中添加具体的元数据名称即可获取具体的元数据,例如:
    • 执行命令curl http://100.100.100.200/latest/meta-data/instance-id获取实例ID。

    • 执行命令curl http://100.100.100.200/latest/meta-data/image-id获取创建实例时所使用的镜像ID。

Windows实例
  1. 使用软件连接Windows实例
  2. 使用PowerShell执行命令Invoke-RestMethod http://100.100.100.200/latest/meta-data/可以获取元数据信息。

  3. 在URL中添加具体的元数据名称即可获取具体的元数据,例如:

    • 执行命令Invoke-RestMethod http://100.100.100.200/latest/meta-data/instance-id获取实例ID。

    • 执行命令Invoke-RestMethod http://100.100.100.200/latest/meta-data/image-id获取创建实例时所使用的镜像ID。

实例元数据列表

元数据项 元数据说明 引入版本
dns-conf/nameservers 实例的DNS配置。 2016-01-01
eipv4 弹性公网IP。 2016-01-01
hostname 实例的主机名。 2016-01-01
image-id 创建实例时所使用的镜像ID。 2016-01-01
image/market-place/product-code 镜像市场镜像的商品码。 2016-01-01
image/market-place/charge-type 镜像市场镜像的计费方式。 2016-01-01
instance-id 实例ID。 2016-01-01
mac 实例的MAC地址,如果实例存在多个网卡,只显示eth0上的MAC地址。 2016-01-01
network-type 网络类型,只支持VPC类型实例。 2016-01-01
ntp-conf/ntp-servers NTP服务器地址。 2016-01-01
owner-account-id 实例拥有者的阿里云账号ID。 2016-01-01
private-ipv4 私网IP地址。 2016-01-01
public-ipv4 公网IP。 2016-01-01
public-keys 当前实例所有公钥的列表。 2016-01-01
region-id 实例所属地域。 2016-01-01
zone-id 实例所属可用区。 2016-01-01
serial-number 实例所对应的序列号。 2016-01-01
source-address Yum或者apt源,只支持Linux实例。 2016-01-01
kms-server 激活服务器,只支持Windows实例。 2016-01-01
wsus-server/wu-server 更新服务器,只支持Windows实例。 2016-01-01
wsus-server/wu-status-server 实例更新状态监控服务器,只支持Windows实例。 2016-01-01
vpc-id 实例所属VPC ID。 2016-01-01
vpc-cidr-block 实例所属VPC的网段。 2016-01-01
vswitch-cidr-block 实例所属虚拟交换机的网段。 2016-01-01
vswitch-id 实例所属虚拟交换机ID。 2016-01-01
ram/security-credentials/[role-name] 由实例RAM角色的策略所生成的STS临时凭证。只有在实例指定了RAM角色后,您才能获取STS临时凭证。其中[role-name]参数需要替换为实例RAM角色的名称。
说明 STS临时凭证更新时间早于凭证失效前半小时,在这半小时内,新旧STS临时凭证均可以使用。
2016-01-01
instance/spot/termination-time 抢占式实例的操作系统设置的停机释放时间,时区标准为UTC,格式为 YYYY-MM-DDThh:mm:ssZ 例如,2018-04-07T17:03:00Z。 2016-01-01
network/interfaces/macs 多网卡的MAC地址列表。 2016-01-01
network/interfaces/macs/[mac]/network-interface-id 网卡的标识ID,其中[mac]参数需要替换为实例MAC地址。 2016-01-01
instance/virtualization-solution ECS虚拟化方案,支持Virt 1.0和Virt 2.0。 2016-01-01
instance/virtualization-solution-version 内部Build号。 2016-01-01
instance/last-host-landing-time 实例所在宿主机的最新变更时间。 2016-01-01
instance-identity/pkcs7 实例标识签名。 2016-01-01

其他透传给元数据的配置

  • 运维类:活跃中的系统事件,在实例内部运行:
    curl http://100.100.100.200/latest/maintenance/active-system-events
  • 标识类实例标识,在实例内部运行:
    curl http://100.100.100.200/latest/dynamic/instance-identity/document
  • 实例配置类:实例自定义数据,在实例内部运行:
    curl http://100.100.100.200/latest/user-data