All Products
Search
Document Center

Edge Security Acceleration:UpdateUserDeliveryTask

Last Updated:Aug 03, 2026

Modifies the delivery task configuration of a user, allowing you to set the task name, select fields, specify the real-time log type, and adjust the discard rate.

Operation description

Before calling this operation, you must have successfully created a task with the target TaskName by using CreateUserDeliveryTask. Only then can you use this operation to update the delivery task configuration.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

TaskName

string

Yes

The task name.

test_project

FieldName

string

Yes

The selected fields, separated by commas (,).

ClientRequestID,ClientRequestHost

BusinessType

string

No

The real-time log type. Valid values:

  • dcdn_log_access_l1 (default): access logs.

  • dcdn_log_er: Edge Routine function logs.

  • dcdn_log_waf: security protection logs.

  • dcdn_log_ipa: Layer 4 acceleration logs.

dcdn_log_er

DiscardRate

number

No

The discard rate. If not specified, the default value is 0.

0

Details

string

No

The list of ER PODs to configure.

xxx,xxx

FilterVer

string

No

The version of the filter rule.

Note

Compatible with legacy filter rules. The default value is v1. Newly created tasks use v2.

v2

Response elements

Element

Type

Description

Example

object

The response parameters.

RequestId

string

The request ID.

34DCBC8A-****-****-****-6DAA11D7DDBD

Examples

Success response

JSON format

{
  "RequestId": "34DCBC8A-****-****-****-6DAA11D7DDBD"
}

Error codes

HTTP status code

Error code

Error message

Description

400 InvalidParameter The specified parameter is invalid. The specified parameter is invalid.
400 InternalError An internal exception occurred, please try again later. An inner exception was triggered. Please try again later.
403 EsaService.NotOpen ESA service has not opend. Edge Security Accelerator (ESA) is not turned on

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.