调用ModifyDBCluster接口对AnalyticDB MySQL集群进行升降配。

调试

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

请求参数

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

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

DBClusterId String 是 am-bpxxxxxxxx47

集群ID。
DBNodeGroupCount String 否 2

节点组数量，取值范围为：1~200。

说明 Mode取值为Reserver（即预留模式）时，本参数必填。
DBNodeStorage String 否 200

节点存储空间，取值说明：

  • 规格为C8时，取值范围为：100~1000GB。

  • 规格为C32时，取值范围为：100~8000GB。
说明
  • Mode取值为Reserver（即预留模式）时，本参数必填。
  • 1000GB以下步长为100GB，1000GB以上步长为1000GB。
DBNodeClass String 否 C32

节点规格，取值：

  • C8
  • C32
    说明 Mode取值为Reserver（即预留模式）时，本参数必填。
ModifyType String 否 Upgrade

变更类型，取值说明：

  • Upgrade：升级。
  • Downgrade：降级。
ExecutorCount String 否 无

不涉及。
RegionId String 否 cn-hangzhou

地域ID，通过DescribeRegions查看可用的地域。

StorageResource String 否 无

不涉及。
ComputeResource String 否 32Core128GB

计算资源，您可以调用DescribeAvailableResource接口查询指定地域中可用的计算资源。

说明 Mode取值为Flexible（即弹性模式）时，本参数必填。
ElasticIOResource Integer 否 0

弹性IO资源（Elastic IO Unit，简称EIU），更多详情，请参见EIU详解。

DBClusterCategory String 否 Cluster

系列。取值说明：

  • Cluster：预留模式集群版。
说明 仅中国内地地域和新加坡地域支持购买预留模式集群版。其中，新加坡地域仅支持在按量付费模式下购买预留模式集群版。
  • MixedStorage：弹性模式集群版（新版）。
    说明 当DBClusterCategory为Cluster时，Mode参数必须填写Reserver；当DBClusterCategory为MixedStorage时，Mode参数必须填写Flexible，否则会导致创建集群失败。
Mode String 否 Reserver

模式。取值说明：

  • Reserver：预留模式。
  • Flexible：弹性模式。

返回数据

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

请求ID。
DBClusterId String am-xxxxxxxxxxxxx

集群ID。
OrderId String 2035629xxxxxx

订单ID。

示例

请求示例

http(s)://[Endpoint]/?Action=ModifyDBCluster
&DBClusterId=am-bpxxxxxxxx47
&DBNodeGroupCount=2
&DBNodeStorage=200
&DBNodeClass=C32
&ModifyType=Upgrade
&ExecutorCount=无
&RegionId=cn-hangzhou
&StorageResource=无
&ComputeResource=32Core128GB
&ElasticIOResource=0
&DBClusterCategory=Cluster
&Mode=Reserver
&公共请求参数

正常返回示例

XML格式 

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

<ModifyDBClusterResponse>
    <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>
    <DBClusterId>am-xxxxxxxxxxxxx</DBClusterId>
    <OrderId>2035629xxxxxx</OrderId>
</ModifyDBClusterResponse>

JSON格式 

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

{
  "RequestId" : "1AD222E9-E606-4A42-BF6D-8A4442913CEF",
  "DBClusterId" : "am-xxxxxxxxxxxxx",
  "OrderId" : "2035629xxxxxx"
}

错误码

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