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

更新云服务器元数据配置

功能介绍

更新云服务器元数据配置。

接口约束

云服务器状态（云服务器的OS-EXT-STS:vm_state属性）必须是active，stopped，paused或者suspended。

URI

PUT /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版本

响应消息

无

请求示例

更新云服务器的元数据配置，启用IMDS服务，并要求必须携带token，仅使用v2版本。

PUT https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/metadata-options
{
    "http_endpoint": "enabled",
    "http_tokens": "required"
}

响应示例

无

返回值

请参考通用请求返回值。

父主题： 元数据配置管理