Modifies the metadata of an Elastic Compute Service (ECS) instance.
Debugging
Authorization information
There is currently no authorization information disclosed in the API.
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
RegionId | string | Yes | The region ID of the instance. You can call the DescribeRegions operation to query the most recent region list. | cn-hangzhou |
InstanceId | string | No | The ID of the instance. | i-bp67acfmxaz**** |
HttpEndpoint | string | Yes | Specifies whether to enable the access channel for instance metadata. Valid values:
Default value: enabled. Note
For more information about instance metadata, see Overview of ECS instance metadata.
| enabled |
HttpTokens | string | No | Specifies whether to forcefully use the security-enhanced mode (IMDSv2) to access instance metadata. Valid values:
Default value: optional. Note
For more information about the modes of accessing instance metadata, see Access mode of instance metadata.
| optional |
HttpPutResponseHopLimit | integer | No | Note
This parameter is in invitational preview and is not publicly available.
| 1 |
InstanceMetadataTags | string | No | Note
This parameter is in invitational preview and is not publicly available.
| null |
Response parameters
Examples
Sample success responses
JSON
format
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | InvalidHttpEndpoint.NotSupported | The specified HttpEndpoint not supported, you can use enabled(default) or disabled. | The specified HttpEndpoint parameter is invalid. The valid values of this parameter are enabled and disabled. The default value is enabled. |
400 | InvalidHttpTokens.NotSupported | The specified HttpTokens not supported, you can use optional(default) or required. | The specified HttpTokens parameter is invalid. The valid values of this parameter are optional and required. The default value is optional. |
400 | InvalidHttpPutResponseHopLimit.NotSupported | The specified HttpPutResponseHopLimit not supported, more than 1 and less than 64 is reasonable. | The specified HttpPutResponseHopLimit parameter is invalid. The valid values of this parameter are 1 to 64. |
400 | InvalidInstanceMetadataTags.NotSupported | The specified InstanceMetadataTags not supported. | - |
404 | InvalidInstanceId.NotFound | The specified InstanceId is not found. | The specified instance ID does not exist. |
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation | ||||||
---|---|---|---|---|---|---|---|---|
2023-07-17 | The Error code has changed | see changesets | ||||||
|