All Products
Search
Document Center

PreloadDcdnObjectCaches

Last Updated: May 17, 2019

Description

You can call this operation to push the specified content to the L2 cache node. When users access the content for the first time, a cache hit occurs, reducing pressure on the origin site.

Note:

  • You can push a maximum of 500 URLs using the same ID each day.
  • Currently, you cannot push directories to the cache node.

Request parameters

Name Type Required Description
Action String Yes The operation that you want to perform. Set the value to PreloadDcdnObjectCaches.
ObjectPath String Yes Example: http://abc.com/image/1.png
. Multiple URLs are separated with line breaks, such as \n or \r\n.
Area String No The region for pushing DCDN objects. Valid values:
  • domestic
  • overseas

Response parameters

Name Type Description
PushTaskId String The ID of the specified push task. Multiple identifiers are separated with commas (,).

Examples

Sample requests

  1. https://dcdn.aliyuncs.com?&Action=PreloadDcdnObjectCaches&ObjectPath=test.test.com/test.txt&<Common request parameters>

Sample responses

JSON format:

  1. {
  2. "PushTaskId": "95248880",
  3. "RequestId": "E5BD4B50-7A02-493A-AE0B-97B9024B4135"
  4. }

Error codes

Error code Error message HTTP status code Description
Throttling Request was denied due to request throttling. 503 The error message returned when the request was denied due to throttling.
InvalidDomain.NotFound The domain provided does not belong to you. 404 The error message returned when the domain name does not exist or does not belong to you.
InvalidDomain.Offline The domain provided is offline. 404 The error message returned when the domain is offline.
QuotaExceeded.Refresh You’ve exceeded the prescribed refresh limits. 400 The error message returned when your daily push count exceeds the upper limit.
PreloadQueueFull Preload queue is full, please try again later! 403 The error message returned when the push queue is full. Try again later.
InvalidDomain.Configure_failed Failed to configure the provided domain. 500 The error message returned when you failed to configure the domain.
MissingParameter The input parameter “ObjectPath” that is mandatory for processing this request is not supplied. 400 The error message returned when the ObjectPath parameter is not specified.
InvalidObjectPath.Malformed The specific value of parameter ObjectPath is malformed. 400 The error message returned when the format of the ObjectPath value is invalid.
InvalidExtensiveDomain.ValueNotSupported Extensive domain not supported. 400 The error message returned when wildcard domains are not supported.