CreateElasticPlan - 创建弹性计划 - 云原生数据仓库AnalyticDB

创建集群的弹性计划。

接口说明

当前服务的接入地址请参见服务接入点。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

adb:CreateElasticPlan

create

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
ElasticPlanName	string	是	弹性计划名称。说明弹性计划名称的长度为 2～30 个字符，以字母开头，且只能由字母、数字和下划线组成。	test
ResourceGroupName	string	否	资源组名称。说明如果需要创建弹性资源类型为 Interactive 资源组的弹性计划（即计算资源类型的弹性计划），必须指定资源组名称。如果需要创建弹性资源类型为查询存储加速服务（EIU）的弹性计划，无需指定资源组名称。调用 DescribeDBResourceGroup 接口可以查看指定集群的资源组名称。	test
StartTime	string	否	开始时间。说明格式为 yyyy-MM-ddTHH:mm:ssZ。	2022-01-01T12:01:00Z
EndTime	string	否	结束时间。说明格式为 yyyy-MM-ddTHH:mm:ssZ。	2025-01-01T12:01:00Z
Enabled	boolean	是	创建后是否立即启用弹性计划。取值说明： true：立即启用。 false：不启用。	true
CronExpression	string	否	Cron 表达式，表示弹性计划的变配周期和变配时间。说明 Type 参数取值为 EXECUTOR 时，该参数必填。	0 20 14 * * ?
TargetSize	string	否	目标规格。说明只有弹性资源类型为存储加速服务弹性计划并且启用了存储加速服务(EIU)按比例默认弹性，可以不填写该参数。其它情况下，该参数为必填项。调用 DescribeElasticPlanSpecifications 接口可以查看弹性计划支持的弹性变配规格。	32ACU
Type	string	是	弹性计划类型。取值说明： EXECUTOR：Interactive 资源组，即计算资源类型。 WORKER：存储加速服务（EIU）。	EXECUTOR
AutoScale	boolean	否	是否启用存储加速服务(EIU)按比例默认弹性。取值说明： true：启用。启用后，存储资源会跟随计算资源的弹性伸缩而伸缩，且不支持填写目标规格和 Cron 表达式。 false：不启用。说明 Type 为 WORKER 时，本参数必填。Type 为 EXECUTOR 时，本参数不填。整个集群只支持启用一个存储加速服务(EIU)按比例默认弹性的存储弹性计划，启用了此类型的弹性计划以后，无法再启用其他的存储弹性计划。	false
DBClusterId	string	是	集群 ID。说明调用 DescribeDBClusters 接口查看集群 ID。	amv-wz9509beptiz****

返回参数

名称	类型	描述	示例值
	object	BaseResponse
RequestId	string	请求 ID。	A5C433C2-001F-58E3-99F5-3274C14DF8BD

示例

正常返回示例

JSON格式

{
  "RequestId": "A5C433C2-001F-58E3-99F5-3274C14DF8BD"
}

错误码

HTTP status code	错误码	错误信息	描述
400	ACS.ElasticPlan.InvalidEndTime	The end time should be later than current time.	分时弹性的结束时间应该晚于当前时间。
400	ACS.ElasticPlan.NameAlreadyExists	The name already exists.	存在同名的弹性计划。
400	ACS.ElasticPlan.WorkerNotFound	Worker not found.	此实例没有预留存储资源，无法设置存储弹性计划。
400	ACS.ElasticPlan.AutoWorkerPlanExists	Failed to enable the elastic plan. The instance already has an active elastic plan.	启用此存储弹性计划失败，当前实例存在启用的存储自动弹性计划。
400	ACS.ElasticPlan.WorkerPlanExists	Failed to enable the elastic plan. At least one active elastic plan already exists.	启用存储自动弹性计划失败，当前存在另外一个启用的存储弹性计划。
400	ACS.ElasticPlan.InvalidStartTimeInterval	The start time of this elastic plan is too closed to another one.	此弹性计划的启用时间和另外一个弹性计划过于接近。
400	ACS.ElasticPlan.InvalidTodayPlan	Failed to enable this elastic plan. Today's schedule time is missed and you should prepare at least %s minutes for us to prepare resource.	启用弹性计划失败。今天的弹性变配功能已经无法于弹性计划配置的变配时间进行触发，请检查配置的时间是否晚于可变配时间（当前时间加上资源准备时间%s分钟）。
400	ACS.ElasticPlan.InvalidTargetSize	Invalid target size.	无效的目标规格
400	ACS.ElasticPlan.InvalidStartTime	Invalid start time.	弹性计划开始时间填写不正确
404	InvalidDBCluster.NotFound	The DBClusterId provided does not exist in our records.	您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。

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

变更历史

更多信息，参考变更详情。