全部产品
Search

搜索本产品

    云服务器 ECS：ModifyInstanceMetadataOptions - 修改实例内的元数据访问设置

    文档中心

    云服务器 ECS：ModifyInstanceMetadataOptions - 修改实例内的元数据访问设置

    更新时间：Aug 28, 2026

    本接口用于修改指定地域下实例内的元数据访问设置，包括是否启用元数据访问通道和访问元数据时是否启用强制加固模式等设置。

    调试

    您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

    调试

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。

    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

      • 对于必选的资源类型，用前面加 * 表示。

      • 对于不支持资源级授权的操作，用全部资源表示。

    • 条件关键字：是指云产品自身定义的条件关键字。

    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    ecs:ModifyInstanceMetadataOptions

    update

    *Instance

    acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

    		 无 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    RegionId

    string

    是

    实例所在地域的 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

    cn-hangzhou
    InstanceId

    string

    否

    指定的实例 ID。

    i-bp67acfmxaz****
    HttpEndpoint

    string

    是

    是否启用实例元数据的访问通道。取值范围：

    • enabled：启用。

    • disabled：禁用。

    默认值：enabled。

    说明

    有关实例元数据的更多信息，请参见实例元数据概述。

    enabled
    HttpTokens

    string

    否

    访问实例元数据时是否强制使用加固模式。取值范围：

    • optional：不强制使用。

    • required：强制使用。设置该取值后，普通模式无法访问实例元数据。

    默认值：optional。

    说明

    有关实例元数据访问模式的更多信息，请参见实例元数据访问模式。

    optional
    HttpPutResponseHopLimit

    integer

    否

    说明

    该参数暂未开放使用。

    0
    InstanceMetadataTags

    string

    否

    是否启用实例元数据的访问标签能力。取值范围：

    • enabled：启用。

    • disabled：禁用。

    默认值：disabled。

    重要 标签键需为字母、数字、@、半角冒号（:）、下划线（_）、短划线（-）、句点（.）、等号（=）、半角逗号（,）的组合，且不能为"."或者".."，否则无法在元数据中访问。

    disabled

    返回参数

    名称

    类型

    描述

    示例值

    object

    RequestId

    string

    请求 ID。

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

    示例

    正常返回示例

    JSON格式

    {
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

    错误码

    HTTP status code

    错误码

    错误信息

    描述
    400 InvalidHttpEndpoint.NotSupported The specified HttpEndpoint not supported, you can use enabled(default) or disabled. 指定的参数 HttpEndpoint 值非法，请使用enabled（默认）或者disabled。
    400 InvalidHttpTokens.NotSupported The specified HttpTokens not supported, you can use optional(default) or required. 指定的参数 HttpTokens 值非法，请使用optional（默认）或者required。
    400 InvalidHttpPutResponseHopLimit.NotSupported The specified HttpPutResponseHopLimit not supported, more than 1 and less than 64 is reasonable. 指定的参数 HttpPutResponseHopLimit 值非法，取值范围必须大于等于1且小于等于64。
    400 InvalidInstanceMetadataTags.NotSupported The specified InstanceMetadataTags not supported.
    400 InvalidImdsAccessPolicyId.NotFound The specified parameter ImdsAccessPolicyId is not found. 指定的参数ImdsAccessPolicyId没有找到。
    404 InvalidInstanceId.NotFound The specified InstanceId is not found. 指定的实例ID不存在

    访问错误中心查看更多错误码。

    变更历史

    更多信息，参考变更详情。