文档中心

云服务器

请输入

实例元数据

查看实例元数据

实例元数据包含了实例在云平台的基本信息，可以用来配置或管理实例，本文介绍如何查看实例元数据。

使用须知

实例元数据只能从实例内部访问，数据并未被加密保护，可访问实例的人员均可查看其元数据。如果元数据中包含了敏感信息，您应当采取适当的措施来保护敏感数据，比如限制访问范围、加密等。

实例元数据项

展开下方表格，查看元数据服务支持获取的实例元数据信息。

实例元数据项汇总表

元数据项	说明	示例
mac	实例的MAC地址。	00:16:3e:53:xx:xx
hostname	实例的主机名。	iv-ybo19qc2zqijuuub****
uuid	实例的唯一标识符。	8508262e-df5a-11ec-9ec1-0c42a14c****
instance_id	实例ID。	i-ybo19qc2zqijuuub****
instance_type_id	实例规格。	ecs.g1.large
image_id	启动实例时所用的镜像ID。	image-4ay4awvwifaqrvqd****
region_id	实例所在地域ID。	cn-beijing
availability_zone	实例所在可用区。	cn-beijing_a
private_ipv4	实例主网卡的主私网IPv4地址。	192.XX.XX.2
eip_address	实例主网卡的公网IP地址。	10.XX.XX.88
network/interfaces/macs/[mac]/primary_ip_address	网卡主私有IP地址。	172.XX.XX.127
network/interfaces/macs/[mac]/eip_address	实例绑定的公网IP地址列表。	10.XX.XX.1
network/interfaces/macs/[mac]/vpc_id	实例所属私有网络ID。	vpc-mini07ggfxmo5smt1b5f****
network/interfaces/macs/[mac]/subnet_id	实例所属子网ID。	subnet-13g3mh3hjglj43n6nu5if****
network/interfaces/macs/[mac]/private_ip_addresses	网卡分配的私网IPv4地址列表。	172.XX.XX.127
network/interfaces/macs/[mac]/subnet_cidr_block	网卡对应的子网掩码。	172.XX.XX.0/24
network/interfaces/macs/[mac]/gateway	网卡对应的IPv4网关地址。	172.XX.XX.1
network/interfaces/macs/[mac]/interface_type	网卡属性。	primary：主网卡
payment/charge_type	实例计费类型。	PostPaid：按量付费
payment/created_at	实例创建时间。	2022-4-30 13:39:12
payment/expired_at	包年包月实例到期时间。	2022-5-30 13:39:12
network/interfaces/macs/[mac]/security_group_ids	实例绑定的安全组ID。	sg-mini0ddjs3k05smt1b6n****
network/interfaces/macs/[mac]/security_group_names	实例绑定的安全组名称。	default
block_devices	磁盘ID列表。	vol-3tf33o3o254bwbhd****
block_devices/[volume_id]/device_type	根据磁盘ID查询磁盘类型，包含云盘和本地盘。	云盘类型，取值：
serial_number	查看云盘ID与云盘序列号的映射关系。	[{"serial_number":"3vqvpywv352tq1di**","volume_id":"vol-3vqvpywv352tq1di**"}]
iam/security_credentials	实例IAM角色列表。	ServiceRoleForECS
spot_instance_termination_time	抢占式实例中断时间。	2023-02-23T17:35:00Z
instance_network_bandwith_baseline	网络基准带宽能力（出+入），单位：Mbps。	2560
instance_network_bandwith_maximum	网络峰值带宽能力（出+入），单位：Mbps。	12288
instance_network_throughput_maximum	网络收发包能力（出+入），单位：Kpps。	150

访问方式

概述

查看元数据有两种方式，普通方式和加固方式。

普通方式：直接利用curl工具，通过访问预先设定好的固定IP地址，来获取实例元数据。这种方式相对较为直接和简便，不涉及复杂的鉴权流程。

加固方式：实例依靠token访问凭证进行身份验证来查看实例元数据。与普通方式相比，该方式对服务器端请求伪造（SSRF）攻击能起到更好的防范作用。

对比项	普通方式	加固方式
交互方式	请求/响应	会话
安全校验	同VPC内源IP地址校验	同VPC内源IP地址校验 + 实例元数据访问凭证鉴权说明访问凭证具有以下特点：短时效性：访问凭证有效期最长为6小时，超过有效期后将失效，需要重新获取。绑定实例：仅作用于一台实例，如果将凭证复制到其他实例使用，会被拒绝访问。不接受代理访问：请求中若包含标头X-Forwarded-For，实例元数据会拒绝签发访问凭证，以提高安全性。
查看方法	通过命令直接访问endpoint	需要先获取元数据访问凭证进行鉴权，再通过命令访问endpoint，请求中必须包含token标头
安全性	较低说明请求通过IP地址鉴权，意味着攻击者可以伪造请求的源IP地址，绕过IP地址鉴权，进行SSRF攻击，造成实例元数据信息泄露风险。	较高说明访问元数据之前，必须先获取访问凭证，该凭证只能在ECS实例内部生成，具有时效性且只作用于特定的实例，攻击者很难猜测或伪造，可以防范大多数SSRF攻击。

操作步骤

加固方式

普通方式

注意

在下述命令中，需要设置的参数说明如下：

<元数据访问凭证有效期>：取值范围为1～21600，单位为秒。

<metadata>：需替换为具体要查询的元数据项，详情请参见实例元数据项。

<token>：需替换为获取到的token访问凭证。如果token无效会返回Unauthorized request。token的校验规则如下：

必须在有效期内。

必须是本实例申请的token。

Linux实例

Windows实例

登录Linux实例。

执行如下命令，获取元数据访问凭证，需设置有效期。

curl --location --request PUT '100.96.0.96/latest/api/token' \
--header 'X-volc-ecs-metadata-token-ttl-seconds: <元数据访问凭证有效期>'

执行如下命令获取实例元数据。

curl --location '100.96.0.96/latest/<metadata>' \
--header 'X-volc-ecs-metadata-token: <token>'

回显如下（以metadata为payment/charge_type为例）。

配置元数据访问模式

概述

创建实例时支持设置元数据的访问模式为兼容模式或仅加固模式。

注意

仅加固模式正在邀测中，如需试用，请联系客户经理申请。

仅加固模式必须同时满足以下条件，方可正常使用：

实例类型为非GPU型实例。

实例所使用的镜像为支持仅加固模式的自定义镜像，了解更多。

仅加固模式：仅支持基于token鉴权的加固方式访问实例元数据，可以进一步增强安全性。

兼容模式：指既可以通过普通方式直接访问实例元数据，也可以通过基于token鉴权的加固方式进行访问。

操作步骤

参考通过向导购买实例，依次完成基础配置和网络配置，然后在自定义配置阶段，展开“高级选项”，选择元数据的访问模式。按照界面信息逐步操作，完成实例创建。

最近更新时间：2025.08.07 10:29:19

这个页面对您有帮助吗？

有用

无用