功能介绍

获取慢日志下载链接。

接口约束

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

调试

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

URI

• URI格式

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

• URI样例

  https://dds.cn-north-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/6ade8143870047b8999aba8f1891b48ein02/slowlog-download

• 参数说明

  表1 参数说明

  名称	是否必选	说明
  project_id	是	租户在某一Region下的Project ID。
  instance_id	是	实例ID，可以调用“查询实例列表”接口获取。如果未申请实例，可以调用“创建实例”接口创建。

请求消息

• 参数说明

  名称	是否必选	参数类型	描述
  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"]
  }

响应消息

• 要素说明

  表2 要素说明

  名称	参数类型	说明
  list	List	慢日志下载链接列表。 详情请参见表3。
  status	String	慢日志下载链接生成状态。 FINISH，表示下载链接已经生成完成。 CREATING，表示正在生成文件，准备下载链接。 FAILED，表示存在日志文件准备失败。
  count	Integer	慢日志链接数量。

  表3 list字段数据结构说明

  名称	参数类型	说明
  node_name	String	节点名称。
  file_name	String	生成的下载文件名。
  status	String	当前链接的生成状态。 SUCCESS，表示下载链接已经生成完成。 EXPORTING，表示正在生成文件，准备下载链接。 FAILED，表示存在日志文件准备失败。
  file_size	String	文件大小，单位为 KB。
  file_link	String	下载链接。 说明： 下载链接在更新时间的15分钟内有效，超出时间会重新获取。
  update_at	Long	更新时间。

• 响应样例

  {
    "list": [
      {
        "file_name": "node_1",
        "file_name": "054bc9c1f680d55c1f36c006e5a9f67b_slowlog_download_20200515080614589",
        "status": "SUCCESS",
        "file_size": "0",
        "file_link": "https://rdsbucket.opxxx.svc.rds.xxxxx.cnxianhz1.ur.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",
        " updated_at ": 1589529991385
      }
    ],
    "status": "FINISH",
    "count": 1
  }