实例元数据介绍
实例元数据包含了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 |