文档首页/ 弹性云服务器 ECS/ API参考/ API/ 元数据配置管理/ 查询云服务器元数据配置
更新时间：2025-09-23 GMT+08:00
查看PDF
分享

查询云服务器元数据配置

功能介绍

查询云服务器元数据配置。

接口约束

  • 该功能当前仅上线“拉美-圣保罗一”区域。
  • 云服务器状态（云服务器的OS-EXT-STS:vm_state属性）必须是active，stopped，paused或者suspended。

URI

GET /v1/{project_id}/cloudservers/{server_id}/metadata-options

表1 参数说明

参数

是否必选

描述

project_id

是

项目ID。

获取方法请参见获取项目ID。

server_id

是

云服务器ID。

请求消息

无

响应消息

表2 响应参数说明

参数

是否必选

参数类型

说明

http_endpoint

否

String

是否启用IMDS服务，默认enabled。

  • enabled：启用IMDS服务
  • disabled：禁用IMDS服务

http_tokens

否

String

是否要求携带token，默认optional。

  • optional：不要求携带token
  • required：要求必须携带token，即IMDS服务禁用v1版本，启用v2版本

请求示例

查询云服务器的元数据配置

GET https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/metadata-options

响应示例

{
    "http_endpoint": "enabled",
    "http_tokens": "required"
}

返回值

请参考通用请求返回值。

父主题： 元数据配置管理