文档

DescribeSqlLogConfig - 查询DAS企业版配置信息

更新时间:

调用DescribeSqlLogConfig接口,查询数据库实例的DAS企业版配置信息。

接口说明

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

  • 使用阿里云或 DAS 的 SDK 时,建议使用最新版本。
  • 在使用 SDK 调用 DAS 服务时,需要将地域指定为 cn-shanghai。

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

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

数据库实例 ID。

rm-2ze8g2am97624****

返回参数

名称类型描述示例值
object
Codestring

返回的状态码。

200
Messagestring

请求返回消息。

说明 请求成功时该参数返回 Successful,请求失败时会返回请求异常信息(如错误码等)。
Successful
RequestIdstring

请求 ID。

0A74B755-98B7-59DB-8724-1321B394****
Successstring

请求是否执行成功:

  • true:执行成功
  • false:执行失败
true
Dataobject

返回数据。

SqlLogVisibleTimelong

DAS 企业版开启的时间,格式为 Unix 时间戳,单位为毫秒。

1683712800000
CollectorVersionstring

采集器版本。

  • MYSQL_V0:MySQL V0 版。
  • MYSQL_V1:MySQL V1 版。
  • MYSQL_V2:MySQL V2 版。
  • MYSQL_V3:MySQL V3 版。
  • PG_V1:PostgreSQL V1 版。
  • rdspg_v1:RDS PostgreSQL V1 版。
  • polarpg_v1:PolarDB PostgreSQL 版 V1 版。
MYSQL_V3
SupportVersionstring

当前支持的最新 DAS 企业版版本。

  • SQL_LOG_V0:企业版 V0。
  • SQL_LOG_V1:企业版 V1。
  • SQL_LOG_V2:企业版 V2。
  • SQL_LOG_V3:企业版 V3。
  • SQL_LOG_NOT_ENABLE:未开启企业版。
  • SQL_LOG_NOT_SUPPORT: 不支持企业版。
SQL_LOG_V3
ColdRetentioninteger

数据冷存储时长,单位为天。

23
SqlLogEnableboolean

是否开启了 DAS 企业版。

  • true:是。
  • false:否。
true
Retentioninteger

数据总存储时长,HotRetentionColdRetention 之和,单位为天。

30
HotRetentioninteger

数据热存储时长,单位为天。

7
RequestEnableboolean

是否开启 SQL 洞察。

  • true:是。
  • false:否。
true
Versionstring

当前开启的 DAS 企业版版本。

  • SQL_LOG_V0:企业版 V0。
  • SQL_LOG_V1:企业版 V1。
  • SQL_LOG_V2:企业版 V2。
  • SQL_LOG_V3:企业版 V3。
  • SQL_LOG_NOT_ENABLE:未开启企业版。
  • SQL_LOG_NOT_SUPPORT: 不支持企业版。
SQL_LOG_V3
RequestStartTimelong

SQL 洞察开启时间,格式为 Unix 时间戳,单位为毫秒。

1683712800000
HotEnableboolean

是否开启数据热存储。

  • true:是。
  • false:否。
true
HotStartTimelong

数据热存储开始时间,格式为 Unix 时间戳,单位为毫秒。

1683712800000
ColdEnableboolean

是否开启数据冷存储。

  • true:是。
  • false:否。
true
ColdStartTimelong

数据冷存储开始时间,格式为 Unix 时间戳,单位为毫秒。

1683712800000
SqlLogStatestring

数据迁移状态。

  • FINISH: 历史数据迁移完成。
  • RUNNING: 历史数据迁移中。
  • FAILURE: 历史数据迁移失败。
FINISH
RequestStopTimelong

DAS 企业版 V1 到期时间,格式为 Unix 时间戳,单位为毫秒。

1715335200000
LogFilterstring

预留参数。

None

对于SQL_LOG_V0(企业版 V0)和SQL_LOG_V1(企业版 V1) ,其数据存储在 CStore 中,视为热存储。开通该版本的数据库实例,查询返回结果中SqlLogEnable = HotEnable = true, Retention = HotRetention, ColdEnable = false, ColdRetention = 0

示例

正常返回示例

JSON格式

{
  "Code": "200",
  "Message": "Successful",
  "RequestId": "0A74B755-98B7-59DB-8724-1321B394****",
  "Success": "true",
  "Data": {
    "SqlLogVisibleTime": 1683712800000,
    "CollectorVersion": "MYSQL_V3",
    "SupportVersion": "SQL_LOG_V3",
    "ColdRetention": 23,
    "SqlLogEnable": true,
    "Retention": 30,
    "HotRetention": 7,
    "RequestEnable": true,
    "Version": "SQL_LOG_V3",
    "RequestStartTime": 1683712800000,
    "HotEnable": true,
    "HotStartTime": 1683712800000,
    "ColdEnable": true,
    "ColdStartTime": 1683712800000,
    "SqlLogState": "FINISH",
    "RequestStopTime": 1715335200000,
    "LogFilter": "None"
  }
}

错误码

HTTP status code错误码错误信息描述
400InvalidParamsThe request parameters are invalid.请求参数错误
403NoPermissionYou are not authorized to do this action.没有权限执行该操作

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

  • 本页导读
文档反馈