全部产品
Search
文档中心

云服务器 ECS:ModifyReservedInstanceAttribute

更新时间:Oct 27, 2023

调用ModifyReservedInstanceAttribute修改预留实例券的属性,包括名称和描述信息。

调试

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

请求参数

名称

类型

是否必选

示例值

描述

Action String ModifyReservedInstanceAttribute

系统规定参数。取值:ModifyReservedInstanceAttribute

RegionId String cn-hangzhou

资源所在的地域ID。

ReservedInstanceId String ecsri-uf61hdhue4kcorqsk****

预留实例券ID。

ReservedInstanceName String testReservedInstanceName

预留实例券的名称。长度为2~128个英文或中文字符。必须以大小写字母或中文开头,不能以http://https://开头。可以包含数字、半角冒号(:)、下划线(_)或者短划线(-)。

Description String ri-example

预留实例券的描述。长度为2~256个英文或中文字符,不能以http://https://开头。

默认值:空。

返回数据

名称

类型

示例值

描述

HttpStatusCode Integer 200

HTTP状态码。

Code String 200

返回错误码。

Message String Success

实例操作返回错误信息。返回值Success为成功,更多请参见下文错误码列表。

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

请求ID。

示例

请求示例

http(s)://ecs.aliyuncs.com/?Action=ModifyReservedInstanceAttribute
&RegionId=cn-hangzhou
&ReservedInstanceId=ecsri-uf61hdhue4kcorqsk****
&ReservedInstanceName=testReservedInstanceName
&Description=ri-example
&公共请求参数

正常返回示例

XML格式

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

<ModifyReservedInstanceAttributeResponse>
    <HttpStatusCode>200</HttpStatusCode>
    <Code>200</Code>
    <Message>Success</Message>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</ModifyReservedInstanceAttributeResponse>

JSON格式

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

{
  "HttpStatusCode" : 200,
  "Code" : "200",
  "Message" : "Success",
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

错误码

HttpCode

错误码

错误信息

描述

403 InvalidParameter.ReservedInstanceName The reservedInstanceName is invalid. reservedInstanceName字段值不合法
500 InternalError The request processing has failed due to some unknown error. 内部错误,请重试。

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