CreateCapacityReservation
指定需要预留的实例规格、总数量，生效方式和可用区等，创建容量预定服务
服务地址：
华东1 金融云
输入参数
只看必填
RegionId容量预定服务所属地域ID
ResourceGroupId容量预定服务所在的企业资源组ID
Tag容量预定服务绑定的标签对列表
0标签对
Key容量预定服务的标签键
Value容量预定服务的标签值
添加
PrivatePoolOptions.Name容量预定服务的名称
Description容量预定服务的描述信息
PrivatePoolOptions.MatchCriteria容量预定服务生效后生成的私有资源池的类型
InstanceAmount在一个实例规格内
InstanceType实例规格
StartTime容量预定服务的生效方式
EndTime容量预定服务的失效时间
EndTimeType容量预定服务的失效方式
Platform实例使用的镜像的操作系统类型
ZoneId容量预定服务所属地域下的可用区ID
0容量预定服务所属地域下的可用区ID
添加
幂等性参数
ClientToken保证请求幂等性
插件下载了解更多
VS Code 插件
安装插件之前，确保已安装 VS Code安装插件之前，确保已安装 VS Code
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安 装
JetBrains 插件
安装插件之前，确保已安装 JetBrains IDE安装插件之前，确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
安 装

接口说明

您可以通过容量预定服务，指定可用区、实例规格等属性，系统会以私有池的方式预留属性相匹配的资源。更多信息，请参见立即生效容量预定概述。

  • 目前服务仅支持立即生效模式。购买立即生效容量预定服务后，实例规格即开始遵循按量付费标准计费，不论是否实际创建了按量付费实例，直至您自行手动释放或到期系统自动释放立即生效容量预订。
    • 您可以通过 CreateInstance 或 RunInstances 创建实例时设置私有池容量选项，或者通过 ModifyInstanceAttachmentAttributes 修改实例的私有池容量选项。实例成功匹配私有池容量后，将根据您的实例配置收取实例规格、云盘、公网带宽等相关资源费用。
    • 未实际创建按量付费实例时，仅收取实例规格的费用。
  • 立即生效容量预定的匹配的实例和未使用的容量账单支持通过节省计划、地域级预留实例券抵扣小时账单，不支持通过可用区级预留实例券抵扣小时账单。推荐您先购买预留实例券或节省计划，在预留实例券或节省计划的覆盖下使用立即生效容量预定服务，可以免费获取资源的确定性保障。
说明 调用 API 方式仅支持创建立即生效容量预定。通过 ECS 控制台可以创建立即生效容量预定或指定时间生效容量预定，更多信息，请参见资源预定服务。

请求参数

字段名称字段详情
RegionIdstring

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

示例值:cn-hangzhou
ResourceGroupIdstring

容量预定服务所在的企业资源组 ID。

示例值:rg-bp67acfmxazb4p****
Tagarray<object>

容量预定服务绑定的标签对列表。

子级条数 <= 20
ClientTokenstring

保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持 ASCII 字符，且不能超过 64 个字符。更多信息，请参见如何保证幂等性。

示例值:0c593ea1-3bea-11e9-b96b-88e9fe637760
PrivatePoolOptions.Namestring

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

示例值:crpTestName
Descriptionstring

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

示例值:This is description.
PrivatePoolOptions.MatchCriteriastring

容量预定服务生效后生成的私有资源池的类型。取值范围：展开详情

示例值:Open
InstanceAmountinteger<int32>

在一个实例规格内，需要预留的实例的总数量。

示例值:2取值 >= 1
InstanceTypestring

实例规格。目前仅支持为一个实例规格设置容量预定服务。您可以调用 DescribeInstanceTypes 查询云服务器 ECS 提供的实例规格信息。

示例值:ecs.g6.xlarge
StartTimestring

容量预定服务的生效方式。目前调用 API 的方式仅支持设置为立即生效。展开详情

示例值:2021-10-30T05:32:00Z
EndTimestring

容量预定服务的失效时间。时间格式以 ISO 8601 为标准，并需要使用 UTC +0 时间，格式为yyyy-MM-ddTHH:mm:ssZ。更多信息，请参见ISO 8601。

示例值:2021-10-30T06:32:00Z
EndTimeTypestring

容量预定服务的失效方式。取值范围：展开详情

示例值:Unlimited
Platformstring

实例使用的镜像的操作系统类型。该参数与地域级预留实例券的Platform参数对应。如果容量预定服务和地域级预留实例券的操作系统类型相匹配，则可以使用地域级预留实例券来抵扣容量预定服务中的未使用容量的账单。取值范围：展开详情

示例值:Linux
ZoneIdarray<string>

容量预定服务所属地域下的可用区 ID。目前仅支持在一个可用区下创建容量预定服务。

示例值:cn-hangzhou-h子级条数 <= 100

返回参数

字段名称字段详情
PrivatePoolOptionsIdstring

容量预定服务 ID。

示例值:crp-bp67acfmxazb4****
RequestIdstring

请求 ID。

示例值:473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
变更历史
变更时间变更内容概要操作
2025-02-27
变更错误码400
2025-02-19
变更错误码400
2022-11-14
变更错误码400
2021-07-29
变更错误码400