全部文档
当前文档
最近更新时间：2026-10-08 10:01:30
本文介绍如何在金山云云服务器Linux实例上查询实例元数据，涵盖访问地址、查询步骤、常用命令示例及各元数据项说明。实例元数据是指云服务器KEC相关的配置信息，如网卡、实例名称、IP地址等，可以用来配置和管理正在运行的实例。
本文操作仅适用于Linux系统云服务器。
若未使用金山云DNS服务，可参考示例使用 11.255.255.100 进行访问。
连接实例。
访问元数据的根目录。
curl http://11.255.255.100:8775/latest/meta-data/在URL中添加元数据项名称，获取对应元数据的详细信息。常用元数据项包括，详细内容可参考元数据说明相关内容：
获取实例ID。
curl http://11.255.255.100:8775/latest/meta-data/instance-id获取实例的操作系统名称。
curl http://11.255.255.100:8775/latest/meta-data/hostname获取实例类型，如KEC（云服务器）。
curl http://11.255.255.100:8775/latest/meta-data/host-type获取实例所使用的镜像ID。
curl http://11.255.255.100:8775/latest/meta-data/image-id获取实例所使用的网卡ID。
curl http://11.255.255.100:8775/latest/meta-data/mac获取实例绑定的IAM角色。
curl http://11.255.255.100:8775/latest/iam（可选）查看用户自定义数据。
curl http://11.255.255.100:8775/latest/user-data元数据项名称 | 元数据项说明 |
|---|---|
hostname | 主机名称（操作系统名称） |
iam | 实例绑定的IAM角色 |
host-type | 实例类型 |
instance-id | 实例ID |
image-id | 镜像ID |
vpc-id | 主网卡所属VPC ID |
subnet-id | 主网卡所属子网ID |
securitygroup-ids | 主网卡所在安全组ID |
mac | 主网卡MAC地址 |
placement/region | 实例所在地域信息 |
placement/zone | 实例所在可用区信息 |
local-ipv4 | 主网卡IPv4地址 |
local-ipv6 | 主网卡IPv6地址 |
public-ipv4 | 主网卡弹性IP地址 |
network/interfaces/macs | 实例网卡MAC地址列表 |
network/interfaces/macs/mac/vpc-id | 网卡所属VPC ID |
network/interfaces/macs/mac/subnet-id | 网卡所属子网ID |
network/interfaces/macs/mac/gateway | 网卡网关地址 |
network/interfaces/macs/mac/local-ipv4 | 网卡IPv4地址 |
network/interfaces/macs/mac/local-ipv6 | 网卡IPv6地址 |
network/interfaces/macs/mac/public-ipv4 | 网卡弹性IP地址 |
network/interfaces/macs/mac/securitygroup-ids | 网卡所在安全组ID |
纯净模式