调用CreateDeliveryHistoryJob接口创建历史事件投递任务。

使用限制:

  • 请确保您已经调用CreateTrail接口创建了投递到日志服务SLS的单账号跟踪。
  • 一个阿里云账号同时只能存在一个正在运行的历史事件投递任务。

本文将提供一个示例,为跟踪trail-name创建历史事件投递任务。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateDeliveryHistoryJob

要执行的操作,取值:CreateDeliveryHistoryJob。

TrailName String trail-name

跟踪名称。

ClientToken String 123e4567-e89b-12d3-a456-42665544****

保证请求的幂等性。该值由客户端生成,并且必须全局唯一。

ClientToken只支持ASCII字符,且不能超过64个字符。

更多信息,请参见如何保证幂等性

关于公共请求参数的详情,请参见公共参数

返回数据

名称 类型 示例值 描述
RequestId String 9D356A34-D5A9-41CD-9915-837B7F9D8722

请求ID。

JobId Integer 16602

任务ID。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateDeliveryHistoryJob
&TrailName=trail-name
&<公共请求参数>

正常返回示例

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "9D356A34-D5A9-41CD-9915-837B7F9D8722",
  "JobId" : 16602
}

错误码

HttpCode 错误码 错误信息 描述
404 TrailNotFoundException The specified Trail does not exist. 指定的跟踪不存在。

访问错误中心查看更多错误码。