本文介绍实例元数据的概念,并列出了支持的实例元数据项,您可以使用实例元数据灵活管理或配置ECS实例。

实例元数据介绍

实例元数据包含了ECS实例在阿里云系统中的基本信息,例如实例ID、IP地址、网卡MAC地址和操作系统类型等。实例还支持动态实例元数据项,动态实例元数据是在实例初次启动以后产生或自定义的数据,目前包括系统事件、实例标识和实例自定义数据。

更多操作,请参见获取实例元数据

实例元数据列表

下表包含了ECS实例目前能获取的基本实例元数据项:

实例元数据项 说明 引入版本
/dns-conf/nameservers 实例的DNS配置。 2016-01-01
/eipv4 实例主网卡挂载的弹性公网IP(IPv4类型)。 2016-01-01
/hostname 实例的主机名。 2016-01-01
/instance/instance-type 实例规格。 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
/network/interfaces/macs 网卡的MAC地址列表。 2016-01-01
/network/interfaces/macs/[mac]/network-interface-id 网卡的标识ID,其中[mac]参数需要替换为实例MAC地址。 2016-01-01
/network/interfaces/macs/[mac]/netmask 网卡对应的子网掩码。 2016-01-01
/network/interfaces/macs/[mac]/vswitch-cidr-block 网卡所属的虚拟交换机IPv4 CIDR段。 2016-01-01
/network/interfaces/macs/[mac]/vpc-cidr-block 网卡所属的VPC IPv4 CIDR段。 2016-01-01
/network/interfaces/macs/[mac]/private-ipv4s 网卡分配的私网IPv4地址列表。 2016-01-01
/network/interfaces/macs/[mac]/vpc-ipv6-cidr-blocks 网卡所属的VPC IPv6 CIDR段,仅支持已配置了IPv6的VPC类型实例。 2016-01-01
/network/interfaces/macs/[mac]/vswitch-id 网卡所属安全组的虚拟交换机 ID。 2016-01-01
/network/interfaces/macs/[mac]/vpc-id 网卡所属安全组的VPC ID。 2016-01-01
/network/interfaces/macs/[mac]/primary-ip-address 网卡主私有IP地址。 2016-01-01
/network/interfaces/macs/[mac]/gateway 网卡对应的IPv4网关地址。 2016-01-01
/instance/max-netbw-egress 实例规格的出方向内网最大带宽。单位:Kbit/s。 2016-01-01
/instance/max-netbw-ingerss 实例规格的入方向内网最大带宽。单位:Kbit/s。 2016-01-01
/network/interfaces/macs/[mac]/ipv6s 网卡分配的IPv6地址列表,仅支持已配置了IPv6的VPC类型实例。 2016-01-01
/network/interfaces/macs/[mac]/ipv6-gateway 网卡所属的VPC的IPv6网关地址。 2016-01-01
/network/interfaces/macs/[mac]/vswitch-ipv6-cidr-block 网卡所属的虚拟交换机IPv6 CIDR段,仅支持已配置了IPv6的VPC类型实例。 2016-01-01
/private-ipv4 实例主网卡的私网IPv4地址。 2016-01-01
/public-ipv4 实例主网卡的公网IPv4地址。 2016-01-01
/ntp-conf/ntp-servers NTP服务器地址。 2016-01-01
/owner-account-id 实例拥有者的阿里云账号ID。 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 Linux实例的包管理软件(主要为Yum源或者apt源)获取更新的镜像库。 2016-01-01
/kms-server Windows实例的KMS激活服务器。 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 CIDR段。 2016-01-01
/vswitch-cidr-block 实例所属虚拟交换机CIDR段。 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+0,格式为yyyy-MM-ddThh:mm:ssZ。例如,2018-04-07T17:03:00Z。 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-identity/pkcs7 实例标识签名。 2016-01-01

运维类动态实例元数据项

更多信息,请参见系统事件

标识类动态实例元数据项

实例标识用于快速辨识并区分 ECS 实例,可以为应用程序权限控制和软件激活等提供重要的信任基础。实例标识由动态生成的 实例标识文档document)和 实例标识签名signature)组成。更多信息,请参见使用实例标识

配置类动态实例元数据项

实例自定义数据主要通过不同类型的自定义脚本实现,然后在创建实例时指定,提供了自定义启动行为及传入数据的功能,例如,自动获取软件资源包、开启服务、打印日志、安装依赖包、初始化Web服务环境等其他配置实例环境的操作。实例自定义数据也可以作为普通数据,将某些信息传入实例中,您可以在实例中引用这些数据。

在实例开始运行时(Running),系统首先以管理员或者root权限运行实例自定义数据,其次运行初始化或 /etc/init信息。

更多信息,请参见生成实例自定义数据