更新时间:2024-03-28 GMT+08:00

获取慢日志下载链接

功能介绍

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

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
    }
  • 异常响应

    请参见异常请求结果

状态码

错误码

请参见错误码