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

查询云服务器元数据配置 - ShowMetadataOptions

功能介绍

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

接口约束

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

调试

您可以在API Explorer中调试该接口。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

ecs:cloudServers:showMetadataOptions

read

-
  • g:ResourceTag/<tag-key>
  • g:EnterpriseProjectId

-

-

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"
}

返回值

请参考通用请求返回值。

父主题： 元数据配置管理

相关文档