文档首页/ 云数据库 RDS/ API参考/ API v3（推荐）/ 获取日志信息/ 获取慢日志下载链接
更新时间：2024-08-09 GMT+08:00
查看PDF
分享

获取慢日志下载链接

功能介绍

获取慢日志下载链接。下载的日志仅包含主节点的日志。

调试

您可以在API Explorer中调试该接口。

URI

  • URI格式

    POST /v3/{project_id}/instances/{instance_id}/slowlog-download

  • 参数说明
    表1 参数说明

    名称

    是否必选

    说明

    project_id

    是

    参数解释：

    租户在某一Region下的项目ID。

    获取方法请参见获取项目ID。

    约束限制：

    不涉及。

    取值范围：

    不涉及。

    默认取值：

    不涉及。

    instance_id

    是

    参数解释：

    要查询的实例ID。

    约束限制：

    不涉及。

    取值范围：

    不涉及。

    默认取值：

    不涉及。

请求消息

表2 参数说明

名称

是否必选

参数类型

说明

file_name

否

String

参数解释：

需要下载的文件的文件名。

文件名称可以在控制台单击实例名称，在“日志管理 > 慢日志”页面的文件列表中获取。

约束限制：

当引擎为SQL Server时为必选。

取值范围：

不涉及。

默认取值：

不涉及。

请求示例

获取慢日志文件“Database_slowlog_name”的下载链接。

POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/cee5265e1e5845649e354841234567dfin01/slowlog-download
{
	"file_name":"Database_slowlog_name"
}

响应消息

  • 正常响应要素说明
    表3 要素说明

    名称

    参数类型

    说明

    list

    List

    参数解释：

    慢日志下载链接列表，详见表4。

    status

    String

    参数解释：

    慢日志下载链接生成状态。

    取值范围：

    • FINISH，表示下载链接已经生成完成。
    • CREATING，表示正在生成文件，准备下载链接。
    • FAILED，表示存在日志文件准备失败。

    count

    Integer

    参数解释：

    慢日志链接数量。

    取值范围：

    不涉及。
    表4 linkInfo字段数据结构说明

    名称

    参数类型

    说明

    workflow_id

    String

    参数解释：

    任务ID。

    取值范围：

    MySQL引擎该字段值固定为""。

    file_name

    String

    参数解释：

    生成的下载文件名。

    取值范围：

    不涉及。

    status

    String

    参数解释：

    当前链接的生成状态。

    取值范围：

    • EXPORTING，下载链接正在生成中。
    • SUCCESS，下载链接生成成功。
    • FAILED，下载链接生成失败。

    file_size

    String

    参数解释：

    文件大小。单位：KB。

    取值范围：

    不涉及。

    file_link

    String

    参数解释：

    下载链接。链接有效时间为5分钟。

    取值范围：

    不涉及。

    create_at

    Long

    参数解释：

    生成时间。

    取值范围：

    不涉及。

    update_at

    Long

    参数解释：

    更新时间。

    取值范围：

    不涉及。
  • 正常响应样例 
    {
  "list": [
           {
              "workflow_id": "44fb1d85-2fcc-4d63-ad3b-c3d1ecd7000e",
              "file_name": "054bc9c1f680d55c1f36c006e5a9f67b_slowlog_download_20200515080614589",
              "status": "SUCCESS",
              "file_size": "0",
              "file_link": "https://rdsbucket.xxxr.obs.cn-xianhz-1.myhuaweicloud.com:443/054bc9c1f680d55c1f36c006e5a9f67b_slowlog_download_20200515080614589?AWSAccessKeyId=1BQ38TBCQHAVQXBUMUTC&Expires=1589530200&response-cache-control=no-cache%2Cno-store&Signature=Fgi4%2BLOJ9frAXyOkz5hRoW5O%2BUM%3D",
 
              "create_at": 1589529991385,
              "update_at": 1589529991385
           }
    ],
  "status": "finish",
  "count": 1
}
  • 异常响应

    请参见异常请求结果。

状态码

错误码

请参见错误码。

父主题： 获取日志信息

相关文档