实例元数据介绍
实例元数据包含了ECS实例在阿里云系统中的基本信息，例如实例ID、IP地址、网卡MAC地址和操作系统类型等。实例还支持动态实例元数据项，动态实例元数据是在实例初次启动以后产生或自定义的数据，目前包括系统事件、实例标识和实例自定义数据。
获取实例元数据
1、远程连接实例
2、执行以下命令访问元数据的根目录，
curl http://100.100.100.200/latest/meta-data/3、在URL中添加具体的元数据名称即可获取具体的元数据，具体请参见 实例元数据列表。
例如：
- 执行以下命令获取实例ID。
curl http://100.100.100.200/latest/meta-data/instance-id - 执行以下命令获取创建实例时所使用的镜像ID。
curl http://100.100.100.200/latest/meta-data/image-id - 执行以下命令获取活跃中的系统事件。
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
实例元数据列表
下表包含了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 |