文档

CreateElasticPlan - 创建弹性计划

更新时间:

创建集群的弹性计划。

接口说明

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

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
adb:CreateElasticPlancreate
  • 全部资源
    *

请求参数

名称类型必填描述示例值
ElasticPlanNamestring

弹性计划名称。

说明 弹性计划名称的长度为 2~30 个字符,以字母开头,且只能由字母、数字和下划线组成。
test
ResourceGroupNamestring

资源组名称。

说明
  • 如果需要创建弹性资源类型为 Interactive 资源组的弹性计划(即计算资源类型的弹性计划),必须指定资源组名称。如果需要创建弹性资源类型为查询存储加速服务(EIU)的弹性计划,无需指定资源组名称。
  • test
    StartTimestring

    开始时间。

    说明 格式为 yyyy-MM-ddTHH:mm:ssZ。
    2022-01-01T12:01:00Z
    EndTimestring

    结束时间。

    说明 格式为 yyyy-MM-ddTHH:mm:ssZ。
    2025-01-01T12:01:00Z
    Enabledboolean

    创建后是否立即启用弹性计划。 取值说明:

    • true:立即启用。
    • false:不启用。
    true
    CronExpressionstring

    Cron 表达式,表示弹性计划的变配周期和变配时间。

    0 20 14 * * ?
    TargetSizestring

    目标规格。

    说明
  • 只有弹性资源类型为存储加速服务弹性计划并且启用了存储加速服务(EIU)按比例默认弹性,可以不填写该参数。其它情况下,该参数为必填项。
  • 32ACU
    Typestring

    弹性计划类型。 取值说明:

    • EXECUTOR:Interactive 资源组,即计算资源类型。
    • WORKER:存储加速服务(EIU)。
    EXECUTOR
    AutoScaleboolean

    是否启用存储加速服务(EIU)按比例默认弹性。 取值说明:

    • true:启用。启用后,存储资源会跟随计算资源的弹性伸缩而伸缩,且不支持填写目标规格和 Cron 表达式。
    • false:不启用。
    说明
  • Type 为 WORKER 时,本参数必填。Type 为 EXECUTOR 时,本参数不填。
    • 整个集群只支持启用一个存储加速服务(EIU)按比例默认弹性的存储弹性计划,启用了此类型的弹性计划以后,无法再启用其他的存储弹性计划。
    false
    DBClusterIdstring

    集群 ID。

    说明 调用 DescribeDBClusters 接口查看集群 ID。
    amv-wz9509beptiz****

    返回参数

    名称类型描述示例值
    object

    BaseResponse

    RequestIdstring

    请求 ID。

    A5C433C2-001F-58E3-99F5-3274C14DF8BD

    示例

    正常返回示例

    JSON格式

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

    错误码

    HTTP status code错误码错误信息描述
    400ACS.ElasticPlan.InvalidEndTimeThe end time should be later than current time.分时弹性的结束时间应该晚于当前时间。
    400ACS.ElasticPlan.NameAlreadyExistsThe name already exists.存在同名的弹性计划。
    400ACS.ElasticPlan.WorkerNotFoundWorker not found.此实例没有预留存储资源,无法设置存储弹性计划。
    400ACS.ElasticPlan.AutoWorkerPlanExistsFailed to enable the elastic plan. The instance already has an active elastic plan.启用此存储弹性计划失败,当前实例存在启用的存储自动弹性计划。
    400ACS.ElasticPlan.WorkerPlanExistsFailed to enable the elastic plan. At least one active elastic plan already exists.启用存储自动弹性计划失败,当前存在另外一个启用的存储弹性计划。
    400ACS.ElasticPlan.InvalidStartTimeIntervalThe start time of this elastic plan is too closed to another one.此弹性计划的启用时间和另外一个弹性计划过于接近。
    400ACS.ElasticPlan.InvalidTodayPlanFailed 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分钟)。
    400ACS.ElasticPlan.InvalidTargetSizeInvalid target size.无效的目标规格
    400ACS.ElasticPlan.InvalidStartTimeInvalid start time.弹性计划开始时间填写不正确
    404InvalidDBCluster.NotFoundThe DBClusterId provided does not exist in our records.您指定的 DBClusterId 不存在,请确认 DBClusterId 值是否正确。

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

    变更历史

    变更时间变更内容概要操作
    2023-12-12OpenAPI 错误码发生变更查看变更详情
    2023-06-30OpenAPI 错误码发生变更查看变更详情
    2023-04-14OpenAPI 错误码发生变更查看变更详情
    2023-04-13OpenAPI 错误码发生变更查看变更详情