调用UpdateAutoResourceOptimizeRulesAsync接口，采用异步方式，批量设置指定数据库实例空间碎片自动回收功能的配置参数。

说明 异步调用后不会立即返回完整结果，当返回数据中isFinish取值为false时，请等待1s后重新发起调用，直到isFinish取值为true时，返回完整结果。

使用该接口需满足以下前提条件：

  • 在使用SDK调用DAS服务时，需要将地域指定为cn-shanghai。
  • 数据库实例类型为RDS MySQL高可用版。
  • 数据库实例已开启DAS专业版，您可以调用DescribeInstanceDasPro查询。
  • 数据库实例的CPU规格不小于4核，且innodb_file_per_table参数值为ON。

请求参数

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

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

ConsoleContext String 否 None

备用参数。
InstanceIds String 是 ['rm-2ze8g2am97624****','rm-2ze9xrhze0709****']

数据库实例ID。

说明 数据格式为JSONArray，例如['实例ID1','实例ID2']，实例ID间用英文逗号（,）分隔。
TableSpaceSize double 否 10

触发空间碎片自动回收单个物理表的最小空间，取值范围：5~100，单位为GB。

TableFragmentationRatio double 否 0.2

触发空间碎片自动回收单个物理表的碎片率，取值范围：0.10~0.99。

ResultId String 否 async__507044db6c4eadfa2dab9b084e80****

异步请求的ID。

说明 对于相同调用请求，首次调用时不输入，后续调用时使用首次调用返回数据中的该字段。

返回数据

名称 类型 示例值 描述
Code Long 200

返回的状态码。
Message String Successful

请求返回消息。

说明 请求成功时该参数返回Successful，请求失败时会返回请求异常信息（如错误码等）。
Data Object

返回的数据。
Fail Boolean false

请求是否失败：

  • true：是。
  • false：否。
ConfigResponse Object

批量设置的返回数据。

说明 异步请求完成时（即isFinish取值为true时）才会返回该数据。
TotalInstanceCount Long 2

总数据库实例数量。
ConfigSuccessInstanceCount Long 1

设置成功的数据库实例数量。
ConfigFailInstanceCount Long 1

设置失败的数据库实例数量。
ConfigSuccessInstanceList Array of configSuccessInstanceList

设置成功的数据库实例列表。
ConfigSuccess Boolean true

设置是否成功：

  • true：是。
  • false：否。
InstanceId String rm-2ze8g2am97624****

数据库实例ID。
ConfigFailInstanceList Array of configFailInstanceList

设置失败的数据库实例列表。
ConfigSuccess Boolean false

设置是否成功：

  • true：是。
  • false：否。
InstanceId String rm-2ze9xrhze0709****

数据库实例ID。
ErrorMessage String Only Support DAS Pro High-availability Edition RDS MySQL 5.6, 5.7, 8.0 instance, and CPU cores >= 4, innodb_file_per_table=ON

错误信息。
ResultId String async__20ee808e72257f16a4fe024057ca****

异步请求的ID。
IsFinish Boolean true

异步请求是否执行完成：

  • true：是。
  • false：否。
State String SUCCESS

异步请求的执行状态：

  • RUNNING：正在运行。
  • SUCCESS：成功。
  • FAIL：失败。
Complete Boolean true

异步请求是否执行完成：

  • true：是。
  • false：否。
Timestamp Long 1645668213000

执行时间，格式为Unix时间戳，单位为毫秒。
RequestId String 9CB97BC4-6479-55D0-B9D0-EA925AFE****

请求ID。
Success Boolean true

请求是否执行成功：

  • true：执行成功。
  • false：执行失败。

示例

请求示例

http(s)://das.cn-shanghai.aliyuncs.com/?Action=UpdateAutoResourceOptimizeRulesAsync
&InstanceIds=['rm-2ze8g2am97624****','rm-2ze9xrhze0709****']
&TableSpaceSize=10.0
&TableFragmentationRatio=0.2
&ResultId=async__507044db6c4eadfa2dab9b084e80****
&公共请求参数

正常返回示例

XML格式 

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

<UpdateAutoResourceOptimizeRulesAsyncResponse>
    <Code>200</Code>
    <Message>Successful</Message>
    <Data>
        <Fail>false</Fail>
        <ConfigResponse>
            <TotalInstanceCount>2</TotalInstanceCount>
            <ConfigSuccessInstanceCount>1</ConfigSuccessInstanceCount>
            <ConfigFailInstanceCount>1</ConfigFailInstanceCount>
            <ConfigSuccessInstanceList>
                <ConfigSuccess>true</ConfigSuccess>
                <InstanceId>rm-2ze8g2am97624****</InstanceId>
            </ConfigSuccessInstanceList>
            <ConfigFailInstanceList>
                <ConfigSuccess>false</ConfigSuccess>
                <InstanceId>rm-2ze9xrhze0709****</InstanceId>
                <ErrorMessage>Only Support DAS Pro High-availability Edition RDS MySQL 5.6, 5.7, 8.0 instance, and CPU cores &gt;= 4, innodb_file_per_table=ON</ErrorMessage>
            </ConfigFailInstanceList>
        </ConfigResponse>
        <ResultId>async__20ee808e72257f16a4fe024057ca****</ResultId>
        <IsFinish>true</IsFinish>
        <State>SUCCESS</State>
        <Complete>true</Complete>
        <Timestamp>1645668213000</Timestamp>
    </Data>
    <RequestId>9CB97BC4-6479-55D0-B9D0-EA925AFE****</RequestId>
    <Success>true</Success>
</UpdateAutoResourceOptimizeRulesAsyncResponse>

JSON格式 

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

{
  "Code" : 200,
  "Message" : "Successful",
  "Data" : {
    "Fail" : false,
    "ConfigResponse" : {
      "TotalInstanceCount" : 2,
      "ConfigSuccessInstanceCount" : 1,
      "ConfigFailInstanceCount" : 1,
      "ConfigSuccessInstanceList" : [ {
        "ConfigSuccess" : true,
        "InstanceId" : "rm-2ze8g2am97624****"
      } ],
      "ConfigFailInstanceList" : [ {
        "ConfigSuccess" : false,
        "InstanceId" : "rm-2ze9xrhze0709****",
        "ErrorMessage" : "Only Support DAS Pro High-availability Edition RDS MySQL 5.6, 5.7, 8.0 instance, and CPU cores >= 4, innodb_file_per_table=ON"
      } ]
    },
    "ResultId" : "async__20ee808e72257f16a4fe024057ca****",
    "IsFinish" : true,
    "State" : "SUCCESS",
    "Complete" : true,
    "Timestamp" : 1645668213000
  },
  "RequestId" : "9CB97BC4-6479-55D0-B9D0-EA925AFE****",
  "Success" : true
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidParams The request parameters are invalid. 请求参数错误

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