文档首页/文档数据库服务 DDS/API参考（联盟区域）/API v3（推荐）/获取日志信息/获取慢日志下载链接
更新时间：2026-01-07 GMT+08:00
查看PDF
分享

获取慢日志下载链接

接口说明

获取慢日志下载链接。

约束说明

慢日志下载链接在更新时间后15分钟内有效。

URI

  • URI格式

    POSThttps://{Endpoint}/v3/{project_id}/instances/{instance_id}/slowlog-download

表1 路径参数

名称

类型

IN

是否必选

描述

project_id

string

path

是

租户在某一region下的project ID。请参考获取项目ID章节获取项目编号。

instance_id

string

path

是

实例ID，可以调用“查询实例列表和详情”接口获取。如果未申请实例，可以调用“创建实例”接口创建。

请求参数

表2 请求Header参数

名称

类型

IN

是否必选

描述

X-Auth-Token

string

header

是

用户Token。

表3 参数说明

名称

参数类型

是否必选

描述

file_name_list

Array of strings

否

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

node_id_list

Array of strings

否

节点ID列表，取空值，表示查询实例下所有允许查询的节点。

使用请参考《DDS API参考》的“查询实例列表”响应消息表“nodes 数据结构说明”的“id”。

允许查询的节点如下：

  • 集群下面的shard节点。
  • 副本集下面的所有节点。
  • 请求示例 
    {
"file_name_list":["0541c9f81e80d2201fccc00b92ad6ec0_052f8a12dfed43fbb27c2020e3c3c507no02_slowlog_20201117104809"],
"node_id_list":["052f8a12dfed43fbb27c2020e3c3c507no02"]
}

响应参数

表4 参数说明

名称

参数类型

说明

list

List

慢日志下载链接列表。

详情请参见表5。

status

String

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

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

count

Integer

慢日志链接数量。

表5 list字段数据结构说明

名称

参数类型

说明

node_name

String

节点名称。

file_name

String

生成的下载文件名。

status

String

当前链接的生成状态。

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

file_size

String

文件大小，单位为 KB。

file_link

String

下载链接。

说明：

下载链接在更新时间的15分钟内有效，超出时间会重新获取。

update_at

Long

更新时间。

  • 响应示例 
    {
  "list": [
    {
      "node_name": "dds-2a78_replica_node_3",
      "file_name": "054bc9f81e80d2201fccc00b92ad6ec0_ca327a60b3084fa79ce072d7299b905ano02_slowlog_20201117060412",
      "status": "SUCCESS",
      "file_size": "0",
      "file_link": "https://ddsbucket.xxxr.obs.{Endpoint}:443/054bc9c1f680d55c1f36c006e5a9f67b_slowlog_download_20200515080614589?AWSAccessKeyId=1BQ38TBCQHAVQXBUMUTC&Expires=1589530200&response-cache-control=no-cache%2Cno-store&Signature=Fgi4%2BLOJ9frAXyOkz5hRoW5O%2BUM%3D",
      "update_at": 1605593100566
    }
  ],
  "status": "FINISH",
  "count": 1
}

状态码

详情请参见状态码。

错误码

详情请参见错误码。

父主题：获取日志信息