调用CreateElasticPlan接口为AnalyticDB MySQL数仓版（3.0）集群创建资源弹性计划。

使用说明

该接口仅适用于AnalyticDB MySQL数仓版（3.0）弹性模式集群版（新版）32核及以上规格的集群。

调试

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

请求参数

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

系统规定参数。取值：CreateElasticPlan。

DBClusterId String 是 am-bp1d8lbdj22rx****

AnalyticDB MySQL数仓版（3.0）集群ID。

说明 您可以调用DescribeDBClusters接口查看目标地域下所有AnalyticDB MySQL数仓版（3.0）集群的集群ID。
ElasticPlanName String 是 test

弹性计划名称。取值说明：

  • 长度为2~30字符。
  • 由大写字母、小写字母、数字或下划线（_）组成。
ResourcePoolName String 是 realtime

资源组名称。

说明 您可以调用DescribeDBResourceGroup接口查看资源组名称。
ElasticPlanNodeNum Integer 否 0

弹性计划节点数。

  • 当ElasticPlanType为worker时，该参数可以不填写或者填写0。
  • 当ElasticPlanType为executorcombineworker或executor时，该参数必须填写大于0的数字。
ElasticPlanTimeStart String 是 08:00:00

弹性计划扩容时间，只支持设置整点时间。格式：HH:mm:ss。
ElasticPlanTimeEnd String 是 10:00:00

弹性计划还原时间，只支持设置整点时间，与弹性计划扩容时间的间隔不能超过24小时。格式：HH:mm:ss。
ElasticPlanWeeklyRepeat String 是 1,2,3,4,5

执行弹性计划的周期。0~6表示周日到周六，多个日期用半角逗号（,）分隔。
ElasticPlanStartDay String 是 2022-12-02

弹性计划起始日期，格式：yyyy-MM-dd。
ElasticPlanEndDay String 是 2022-12-09

弹性计划结束日期，格式：yyyy-MM-dd。
ElasticPlanEnable Boolean 是 true

弹性计划是否生效，取值说明：

  • true（默认值）：生效。
  • false：不生效。
ElasticPlanType String 否 worker

弹性计划资源类型，取值说明：

  • worker：弹性IO资源单独弹性。
  • executor：计算资源单独弹性。
  • executorcombineworker（默认值）：计算，弹性IO资源按默认比例弹性。
说明
  • 如果要使用executorcombineworker，集群内核版本需为3.1.3.2及以上版本。
  • 如果要使用worker或executor，集群内核版本需为3.1.6.1及以上版本，且需要通过提交工单申请。申请通过后，才能使用worker或executor。
ElasticPlanWorkerSpec String 否 32 Core 64 GB

弹性计划支持扩容的资源规格。取值说明：

  • 8 Core 64 GB（默认规格）
  • 16 Core 64 GB
  • 32 Core 64 GB
  • 64 Core 128 GB
  • 12 Core 96 GB
  • 24 Core 96 GB
  • 52 Core 86 GB

返回数据

名称 类型 示例值 描述
RequestId String 1AD222E9-E606-4A42-BF6D-8A4442913CEF

请求ID。

示例

请求示例

http(s)://adb.aliyuncs.com/?Action=CreateElasticPlan
&DBClusterId=am-bp1d8lbdj22rx****
&ElasticPlanName=test
&ResourcePoolName=realtime
&ElasticPlanNodeNum=0
&ElasticPlanTimeStart=08:00:00
&ElasticPlanTimeEnd=10:00:00
&ElasticPlanWeeklyRepeat=1,2,3,4,5
&ElasticPlanStartDay=2022-12-02
&ElasticPlanEndDay=2022-12-09
&ElasticPlanEnable=true
&ElasticPlanType=worker
&ElasticPlanWorkerSpec=32 Core 64 GB
&公共请求参数

正常返回示例

XML格式 

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

<CreateElasticPlanResponse>
    <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>
</CreateElasticPlanResponse>

JSON格式 

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

{
  "RequestId" : "1AD222E9-E606-4A42-BF6D-8A4442913CEF"
}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidDBCluster.NotFound The DBClusterId provided does not exist in our records. 您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。

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