DescribeDownloadUrl--日志服务-火山引擎

文档中心

导航

DescribeDownloadUrl

最近更新时间：2024.04.19 13:54:14首次发布时间：2022.09.15 18:43:16

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

使用说明

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

说明

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

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

参数	类型	是否必选	示例值	描述
TaskId	String	是	`4a9bd4bd-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 状态码	错误码	错误信息	说明
404	ErrDownloadTaskNotExists	Task does not exist	下载任务不存在
500	InternalServerError	We encountered an unexpected server error, please try again later.	服务器内部错误。