更新时间：2026-03-19 GMT+08:00
更新云服务器元数据配置 - UpdateMetadataOptions
功能介绍
更新云服务器元数据配置。
接口约束
- 该功能当前仅上线“拉美-圣保罗一”区域。
- 云服务器状态（云服务器的OS-EXT-STS:vm_state属性）必须是active，stopped，paused或者suspended。
调试
您可以在API Explorer中调试该接口。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，需具备如下身份策略权限。
授权项 | 访问级别 | 资源类型（*为必须） | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
ecs:cloudServers:updateMetadataOptions | write | - |
| - | - |
URI
PUT /v1/{project_id}/cloudservers/{server_id}/metadata-options
参数 | 是否必选 | 描述 |
|---|---|---|
project_id | 是 | 参数解释： 项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
server_id | 是 | 参数解释： 云服务器ID。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
请求消息
参数 | 是否必选 | 参数类型 | 说明 |
|---|---|---|---|
http_endpoint | 否 | String | 参数解释： 是否启用IMDS服务，默认enabled。 约束限制： 不涉及 取值范围：
默认取值： 不涉及 |
http_tokens | 否 | String | 参数解释： 是否要求携带token，默认optional。 约束限制： 不涉及 取值范围：
默认取值： 不涉及 |
响应消息
无
请求示例
更新云服务器的元数据配置，启用IMDS服务，并要求必须携带token，仅使用v2版本。
PUT https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/metadata-options
{
"http_endpoint": "enabled",
"http_tokens": "required"
} 响应示例
无
返回值
请参考通用请求返回值。
父主题：元数据配置管理
