All Products
Search

This Product

    Edge Security Acceleration:RefreshErObjectCachesByCacheTag

    Document Center

    Edge Security Acceleration:RefreshErObjectCachesByCacheTag

    Last Updated:Apr 14, 2026

    Refreshes content using a cache tag in Edge Routine (ER) scenarios.

    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
    Domain

    string

    Yes

    The domain name that the ER component uses for fetch requests.

    example.com
    CacheTag

    string

    Yes

    The cache tag. Separate multiple tags with commas.

    tag1,tag2
    MergeDomainName

    string

    No

    The domain names for merged refresh operations. During the refresh, the points of presence (POPs) of the specified domain names are merged.

    Note

    Separate multiple domain names with commas (,).

    a.test.com,b.test.com
    Force

    boolean

    No

    Specifies whether to refresh resources within the specified scope when the back-to-origin content is consistent with the resource on the origin server. The default value is false.

    • true: Refreshes all resources within the specified scope. If a user request matches a resource in the scope, DCDN POPs directly fetch the latest resource from the origin server, return it to the user, and then cache the resource.

    • false: Refreshes only updated resources within the specified scope. If a user request matches a resource in the scope, DCDN POPs fetch the Last-Modified information from the origin server. If the Last-Modified value is the same as that of the cached resource, the cached resource is returned. Otherwise, DCDN POPs fetch the latest resource from the origin server, return it to the user, and then cache the resource.

    Note

    This parameter applies to all refresh types except for file refreshes.

    true

    Response elements

    Element

    Type

    Description

    Example

    object

    Schema of Response

    RequestId

    string

    The request ID.

    EEEBE525-F576-1196-8DAF-2D70CA3F4D2F

    RefreshTaskId

    string

    The ID of the refresh task.

    17410889914

    Examples

    Success response

    JSON format

    {
  "RequestId": "EEEBE525-F576-1196-8DAF-2D70CA3F4D2F\n",
  "RefreshTaskId": "17410889914"
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    400 SingleRequest.OverLimit A maximum of 1000 URLs are supported for each request.
    400 InvalidObjectType.Malformed The specified ObjectType is invalid. The ObjectType parameter is set to an invalid value. Specify a valid value and try again.
    400 InvalidObjectPath.Malformed The specified ObjectPath is invalid. The ObjectPath parameter is set to an invalid value. Specify a valid value and try again.
    400 InvalidObjectPath.Size.Malformed The size of ObjectPath is bigger than 1000.
    400 QuotaExceeded.Refresh You've exceeded the prescribed refresh limits.
    400 InvalidExtensiveDomain.ValueNotSupported The specified ExtensiveDomain is not supported. Wildcard domain names are not supported.
    400 QuotaPerMinuteExceeded.Refresh You tried to refresh too frequently; please try again later. Refresh requests are submitted too frequently. Try again later.
    400 TooMany.Refresh The refresh queue is full; please try again later. The maximum number of refresh requests for a domain name has been reached. Try again later.
    400 PreloadQueueFull Preload queue is full, please try again later!
    400 InvalidStations.Malformed The specified Stations is invalid.
    400 InvalidParameters The parameters you provided are invalid.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.