调用DescribeAppliedAdvices接口查询已应用的优化建议。

调试

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

请求参数

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

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

DBClusterId String 是 am-uf6g8w25jacm7****

集群ID。

说明 您可以调用DescribeDBClusters接口查看数仓版（3.0）集群的集群ID。
RegionId String 否 cn-hangzhou

地域ID。

说明 您可通过接口DescribeRegions查看可用的地域ID。
StartTime Long 否 20220811

查询建议的开始日期，格式为yyyyMMdd（UTC时间）。
EndTime Long 否 20220824

查询建议的结束日期，格式为yyyyMMdd（UTC时间）。
Lang String 否 zh

设置建议的显示语言，取值说明：

  • zh：简体中文（默认语言）。
  • en：英文。
  • ja：日文。
  • zh-tw：繁体中文。
PageSize Long 否 30

每页记录数，取值：

  • 30（默认值）
  • 50
  • 100
PageNumber Long 否 1

页码，取值为：大于0且不超过Integer数据类型的最大值，默认值为1。

返回数据

名称 类型 示例值 描述
Items Array of Items

详情。
AdviceId String 7417db9c-914d-43f3-a123-4d0e448f****

建议ID。
SubmitTime String 2208131600

建议下发的时间，格式：yyMMddHHmm（UTC时间）。
SubmitStatus String SUCCEED

建议的下发状态。

取值说明：

  • SUCCEED：成功。
  • FAILED：失败。
SQL String alter table `schema1`.`table1` drop key col1_1_idx

应用建议的SQL语句。
RollbackSQL String alter table `schema1`.`table1` add key col1_1_idx(col1)

回滚建议的SQL语句。
JobStatus String SUCCEED

执行建议的任务的状态。

取值说明：

  • SUCCEED：成功。
  • FAILED：失败。
Benefit String 节省0.4GB空间

建议的收益。
BuildSQL String build table `schema1`.`table1`

执行Build任务的SQL语句。
TotalCount Long 1

返回的建议总数，取值为：大于等于0且不超过Integer数据类型的最大值，默认值为0。
PageSize Long 30

每页记录数，取值：

  • 30（默认值）
  • 50
  • 100
PageNumber Long 1

页码，取值为：大于0且不超过Integer数据类型的最大值，默认值为1。
PageNumber Long 1

页码，取值为：大于0且不超过Integer数据类型的最大值，默认值为1。
PageSize Long 30

每页记录数，取值：

  • 30（默认值）
  • 50
  • 100
RequestId String 84489769-3065-5A28-A4CB-977CD426F1C3

请求ID。
TotalCount Long 1

返回的结果总数，取值为：大于等于0且不超过Integer数据类型的最大值，默认值为0。

示例

请求示例

http(s)://adb.aliyuncs.com/?Action=DescribeAppliedAdvices
&DBClusterId=am-uf6g8w25jacm7****
&RegionId=cn-hangzhou
&StartTime=20220811
&EndTime=20220824
&Lang=zh
&PageSize=30
&PageNumber=1
&公共请求参数

正常返回示例

XML格式 

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

<DescribeAppliedAdvicesResponse>
    <Items>
        <AdviceId>7417db9c-914d-43f3-a123-4d0e448f****</AdviceId>
        <SubmitTime>2022-08-20T16:00:00Z</SubmitTime>
        <SubmitStatus>SUCCEED</SubmitStatus>
        <SQL>alter table `schema1`.`table1` drop key col1_1_idx</SQL>
        <RollbackSQL>alter table `schema1`.`table1` add key col1_1_idx(col1)</RollbackSQL>
        <JobStatus>SUCCEED</JobStatus>
        <Benefit>节省0.4GB空间</Benefit>
        <BuildSQL>build table `schema1`.`table1`</BuildSQL>
        <TotalCount>1</TotalCount>
        <PageSize>30</PageSize>
        <PageNumber>1</PageNumber>
    </Items>
    <PageNumber>1</PageNumber>
    <PageSize>30</PageSize>
    <RequestId>84489769-3065-5A28-A4CB-977CD426F1C3</RequestId>
    <TotalCount>1</TotalCount>
</DescribeAppliedAdvicesResponse>

JSON格式 

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

{
  "Items" : [ {
    "AdviceId" : "7417db9c-914d-43f3-a123-4d0e448f****",
    "SubmitTime" : "2022-08-20T16:00:00Z",
    "SubmitStatus" : "SUCCEED",
    "SQL" : "alter table `schema1`.`table1` drop key col1_1_idx",
    "RollbackSQL" : "alter table `schema1`.`table1` add key col1_1_idx(col1)",
    "JobStatus" : "SUCCEED",
    "Benefit" : "节省0.4GB空间",
    "BuildSQL" : "build table `schema1`.`table1`",
    "TotalCount" : 1,
    "PageSize" : 30,
    "PageNumber" : 1
  } ],
  "PageNumber" : 1,
  "PageSize" : 30,
  "RequestId" : "84489769-3065-5A28-A4CB-977CD426F1C3",
  "TotalCount" : 1
}

错误码

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