获取慢日志下载链接

功能介绍

获取慢日志下载链接。

• 调用接口前，您需要了解API 认证鉴权。

URI

• URI格式

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

• URI样例

  https://{Endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/cee5265e1e5845649e354841234567dfin01/slowlog-download

• 参数说明

  表1 参数说明

  名称	是否必选	说明
  project_id	是	租户在某一region下的project ID。 获取方法请参见获取项目ID。
  instance_id	是	要查询的实例ID。

请求消息

• 参数说明

  表2 参数说明

  名称	是否必选	参数类型	说明
  request_id	是	String	请求ID。先任意指定一个uuid，格式为 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx，使用该请求ID调用接口，获取实例正在生成慢日志下载链接的workflow_id，详见表4。 将获取的workflow_id作为request_id的值，再次调用该接口，获取实例的慢日志下载链接。
  file_name	否	String	需要下载的文件的文件名。

• 请求样例
  获取正在生成慢日志下载链接的workflow_id：

  {
  	"request_id":"6e0e7ee2-a3b5-4bc1-a5a8-cb2987ac4771"
  }

  获取慢日志下载链接：

  {
  	"request_id":"0202bf1a-4181-48b9-bdd8-27ea4cef05b2"
  }

响应消息

• 正常响应要素说明

  表3 要素说明

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

  表4 linkInfo字段数据结构说明

  名称	参数类型	说明
  workflow_id	String	任务ID。
  file_name	String	生成的下载文件名。
  status	String	当前链接的生成状态。
  file_size	String	文件大小。
  file_link	String	下载链接。
  create_at	Long	生成时间。

• 正常响应样例
  正在生成慢日志下载链接：

  {
      "list": [
          {
              "workflow_id": "0202bf1a-4181-48b9-bdd8-27ea4cef05b2",
              "file_name": "054bc98b0a80d39b1faec01373f2f339_slowlog_download_20211117091141667",
              "status": "EXPORTING",
              "create_at": 1637140301659
          }
      ],
      "status": "CREATING",
      "count": 1
  }

  慢日志下载链接获取成功：

  {
      "list": [
          {
              "workflow_id": "0202bf1a-4181-48b9-bdd8-27ea4cef05b2",
              "file_name": "054bc98b0a80d39b1faec01373f2f339_slowlog_download_20211117091141667",
              "status": "SUCCESS",
              "file_size": "922",
              "file_link": "https://rdsbucket.opxxx.svc.rds.xxxxx",
              "create_at": 1637140315066
          }
      ],
      "status": "FINISH",
      "count": 1
  }

• 异常响应

  请参见异常请求结果。

状态码

• 正常

  200

• 异常

  请参见状态码。

错误码

请参见错误码。