Updates a tracking task by task ID.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameter

Parameter Type Required Example Description
Action String Yes UpdateDcdnDeliverTask

The operation that you want to perform. Set the value to UpdateDcdnDeliverTask.

DeliverId Long Yes 92

The ID of the tracking task that you want to update.

Name String No Domain name report

The name of the operations report.

Status String No enable

The status of the tracking task. Valid values:

  • enable: enabled
  • disable: disabled
Note The Status parameter is reserved. You do not need to set it.
Reports String No [{\"reportId\":2,\"conditions\":[{\"field\":\"prov\",\"op\":\"in\",\"value\":[\"Heilongjiang\",\"Beijing\"]}]}]

The operations reports that the task tracks. The data must be escaped in JSON.

DomainName String No www.example.com

The domain names from which the tracking task collects data. Separate domain names with commas (,). If you do not specify a domain name, the task collects data from all domain names that belong to your Alibaba Cloud account.

Deliver Json No {"email":{"subject":"the email subject","to":["username@example.com","username@example1.com"]}}

The method by which operations reports are sent. Operations reports are sent to you only through emails. The report content must be escaped in JSON.

Schedule Json No {"schedName":"the name of the tracking task","description":"the description","crontab":"000**?","frequency":"d","status":"enable","effectiveFrom":"2020-09-17T00:00:00Z","effectiveEnd":"2020-11-17T00:00:00Z"}

The parameters that specify the time interval at which the tracking task sends operations reports. The settings must be escaped in JSON.

Fields of the Reports parameter

Field

Type

Required

Description

reportId

String

Yes

The ID of the operations report.

conditions

ConDatas[]

No

The filter conditions for the report.

Fields of the conditions parameter

Field

Type

Required

Description

field

String

No

The filter fields.

op

String

No

The filter action. Only in is supported.

value

String[]

No

An array of field values.

Fields of the Deliver parameter

Field

Type

Required

Description

subject

String

Yes

The email subject.

to

String[]

Yes

The email addresses to which operations reports are sent.

Fields of the Schedule parameter

Field

Type

Required

Description

schedName

String

Yes

The name of the tracking task.

description

String

Yes

The description of the tracking task.

crontab

String

Yes

The time interval at which the tracking task runs.

frequency

String

Yes

The time interval at which the tracking task sends reports. Valid values:

h: every hour

d: every day

w: every week

status

String

Yes

The status of the tracking task. Valid values:

enable: enabled

disable: disabled

effectiveFrom

String

Yes

The start time of the tracking task.

effectiveEnd

String

Yes

The end time of the tracking task.

Response parameters

Parameter Type Example Description
RequestId String 04F0F334-1335-436C-A1D7-6C044FE73368

The ID of the request.

Examples

Sample requests

http(s)://dcdn.aliyuncs.com/?Action=UpdateDcdnDeliverTask
&DeliverId=92
&Name=Domain name report
&Reports=[{\"reportId\":2,\"conditions\":[{\"field\":\"prov\",\"op\":\"in\",\"value\":[\"Heilongjiang\",\"Beijing\"]}]}]
&DomainName=www.example.com
&Deliver={"email":{"subject":"the email subject","to":["username@example.com","username@example1.com"]}}
&Schedule={"schedName":"The name of the tracking task","description":"the description","crontab":"000**?","frequency":"d","status":"enable","effectiveFrom":"2020-09-17T00:00:00Z","effectiveEnd":"2020-11-17T00:00:00Z"}
&<Common request parameters>

Sample success responses

XML format

<UpdateDcdnDeliverTaskResponse>
  <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
</UpdateDcdnDeliverTaskResponse>

JSON format

{
    "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
}

Error codes

HttpCode Error code Error message Description
400 NameAlreadyExist The subscription name already exists. The error message returned because the tracking task already exists.

For a list of error codes, visit the API Error Center.