You need to enable JavaScript to run this app.
导航

DescribeDownloadUrl

最近更新时间2023.11.13 16:31:31

首次发布时间2022.09.15 18:43:16

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

使用说明

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

说明

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

URI

请求方法
GET

URI

https://tls-{region}.ivolces.com/DescribeDownloadUrl?TaskId=${TaskId}

传输协议

HTTPS

URI请求参数

参数
参数类型
是否必选
示例值
说明

TaskId

String

3***********

下载任务的任务 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.******"
}

错误码

错误码(Code)
HTTP 状态码
错误信息(Message)
说明

ErrDownloadTaskNotExists

404

Task does not exist

下载任务不存在

InternalServerError

500

We encountered an unexpected server error, please try again later.

服务器内部错误。

更多信息,请参考通用错误码