详情页标题前

阿里云ECS云服务器ModifyCapacityReservation-云淘科技

详情页1

调用ModifyCapacityReservation修改一个容量预定服务的部分信息,包括容量预定服务的名称、描述信息、失效方式以及预留的实例总数量。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String ModifyCapacityReservation

系统规定参数。取值:ModifyCapacityReservation

RegionId String cn-hangzhou

容量预定服务所属地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。

PrivatePoolOptions.Id String crp-bp67acfmxazb4****

容量预定服务ID。

PrivatePoolOptions.Name String eapTestName

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

Description String This is description.

容量预定服务的描述信息。长度为2~256个英文或中文字符,不能以http://https://开头。

StartTime String 2021-10-29T06:32:00Z

容量预定服务的生效时间

说明 只有状态为Preparing(准备中)的容量预定允许修改生效时间,生效时间的格式以ISO 8601为标准,并需要使用UTC+0时间,格式为yyyy-MM-ddTHH:mm:ssZ,分钟和秒如果不为0,将被忽略。

EndTimeString2021-10-30T06:32:00Z

容量预定服务的失效时间,仅EndTimeType=Limited时该参数生效。时间格式以ISO 8601为标准,并需要使用UTC +0时间,格式为yyyy-MM-ddTHH:mm:ssZ,秒如果不为0,将被忽略。结束时间至少在当前时间1分钟之后。更多信息,请参见ISO 8601。

EndTimeType String Unlimited

容量预定服务的失效方式。取值范围:

  • Limited:指定时间释放。必须同时指定EndTime参数。
  • Unlimited:手动释放。不限制时间。
Platform String Linux

实例使用的镜像的操作系统类型。取值范围:

  • Windows:Windows Server类型的操作系统。
  • Linux:Linux及类Unix类型的操作系统。

说明 该参数暂未开放使用。

InstanceAmountInteger100

容量预定服务需要预留的实例总数量。取值范围:已使用的实例数量~1000。

说明 扩充实例总数量时,可能因库存不足导致扩充失败。

返回数据

名称类型示例值描述
RequestIdString8455DD10-84F8-43C9-8365-5F448EB169B6

请求ID。

示例

请求示例

https://ecs.aliyuncs.com/?Action=ModifyCapacityReservation
&PrivatePoolOptions.Id=crp-bp67acfmxazb4****
&RegionId=cn-hangzhou
&PrivatePoolOptions.Name=eapTestName
&Description=This is description.
&

正常返回示例

XML格式

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


    8455DD10-84F8-43C9-8365-5F448EB169B6

JSON格式

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

{
  "RequestId" : "8455DD10-84F8-43C9-8365-5F448EB169B6"
}

错误码

HttpCode 错误码 错误信息 描述
401 InvalidUser.Unauthorized The user is not authorized 您当前使用的账号无权限。
403 IncorrectPrivatePoolStatus The current status of the private pool does not support this operation. 参数中指定的私有池状态不支持当前操作
403 OperationDenied.NoStock The requested resource is sold out in the specified zone; try other types of resources or other regions and zones. 请求的资源在指定的可用区已售完,请您更换实例规格或者可用区重试,调用 DescribeZones 接口可以获得库存结果。

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

腾讯云1折,限时活动,即将结束: 马上收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折,更有现金返利。同意关联立享优惠

转转请注明出处:https://www.yunxiaoer.com/153336.html

(0)
上一篇 2023年12月9日
下一篇 2023年12月9日
详情页2

相关推荐

联系我们

400-800-8888

在线咨询: QQ交谈

邮件:admin@example.com

工作时间:周一至周五,9:30-18:30,节假日休息

关注微信
本站为广大会员提供阿里云、腾讯云、华为云、百度云等一线大厂的购买,续费优惠,保证底价,买贵退差。