ModifyInstanceMetadataOptions - 云服务器 ECS

调试

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

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	ModifyInstanceMetadataOptions	系统规定参数。取值：ModifyInstanceMetadataOptions。
RegionId	String	是	cn-hangzhou	实例所在地域的ID。您可以调用DescribeRegions查看最新的阿里云地域列表。
InstanceId	String	否	i-bp67acfmxaz****	指定的实例ID。
HttpEndpoint	String	是	enabled	是否启用实例元数据的访问通道。取值范围： enabled：启用。 disabled：禁用。默认值：enabled。说明有关实例元数据的更多信息，请参见实例元数据概述。
HttpTokens	String	否	optional	访问实例元数据时是否强制使用加固模式（IMDSv2）。取值范围： optional：不强制使用。 required：强制使用。设置该取值后，普通模式无法访问实例元数据。默认值：optional。说明有关实例元数据访问模式的更多信息，请参见实例元数据访问模式。
HttpPutResponseHopLimit	Integer	否	null	说明该参数正在邀测中，暂未开放使用。
InstanceMetadataTags	String	否	null	说明该参数正在邀测中，暂未开放使用。

返回数据

名称	类型	示例值	描述
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	请求ID。

示例

请求示例

http(s)://ecs.aliyuncs.com/?Action=ModifyInstanceMetadataOptions
&RegionId=cn-hangzhou
&InstanceId=i-bp67acfmxaz****
&HttpEndpoint=enabled
&HttpTokens=required
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyInstanceMetadataOptionsResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</ModifyInstanceMetadataOptionsResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

HttpCode	错误码	错误信息	描述
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。
404	InvalidInstanceId.NotFound	The specified InstanceId is not found.	指定的实例ID不存在

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