You need to enable JavaScript to run this app.
导航
DescribeDownloadUrl
最近更新时间:2024.04.19 13:54:14首次发布时间:2022.09.15 18:43:16

调用接口 DescribeDownloadUrl 获取指定任务对应的日志下载链接。

使用说明

此接口用于获取指定日志下载任务对应的下载链接。通过该下载链接可以无需鉴权,直接下载对应的日志数据。

说明

  • 调用此接口前,建议先通过 DescribeDownloadTasks 查看下载任务的状态,仅 success(文件已生成)和部分 created_cut(文件生成中断)状态的任务可以下载对应的文件。
  • 链接有效期为 5 分钟,获取下载链接后请及时下载。若链接失效,需要重新调用此接口获取新的下载链接。
  • 此接口的调用频率限制为 20 次/s,超出频率限制会报错 ExceedQPSLimit。

请求说明

  • 请求方式:GET
  • 请求地址:https://tls-{Region}.ivolces.com/DescribeDownloadUrl

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数

Query

参数类型是否必选示例值描述
TaskIdString4a9bd4bd-53f1-43ff-b88a-64ee1be5****下载任务的任务 ID。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构

参数类型示例值描述

DownloadUrl

String

https://www.******

指定下载任务对应的下载链接。
链接有效期为 5 分钟,获取下载链接后请及时下载。若链接失效,需要重新调用此接口获取新的下载链接。

请求示例

GET /DescribeDownloadUrl?TaskId=9f* HTTP/1.1
Content-Type: application/json
...
{

}

返回示例

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 0 
{
    "DownloadUrl": "https://www.******"
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

HTTP 状态码错误码错误信息说明
404ErrDownloadTaskNotExistsTask does not exist下载任务不存在
500InternalServerErrorWe encountered an unexpected server error, please try again later.服务器内部错误。