All Products
Search
Document Center

RefreshDcdnObjectCaches

Last Updated: May 17, 2019

Description

You can call this operation to allow a cache node to pull the latest file from the origin site based on the provided file URL. You can refresh multiple URLs.

You can refresh and push a maximum of 2,000 URLs and 100 directories using the same ID every day.

Request parameters

Name Type Required Description
Action String Yes The operation that you want to perform. Set the value to RefreshDcdnObjectCaches.
ObjectPath String Yes Example: abc.com/image/1.png. Multiple URLs are separated with line breaks, such as \n or \r\n.
ObjectType String No The type of the object that you want to refresh. Valid values:
  • File
  • Directory
Default value: File.

Response parameters

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

Examples

Sample requests

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

Sample responses

JSON format

  1. {
  2. "RefreshTaskId":"704222904","RequestId":"D61E4801-EAFF-4A63-AAE1-FBF6CE1CFD1C"
  3. }

XML format

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <RefreshDcdnObjectCachesResponse>
  3. <RefreshTaskId>704225667</RefreshTaskId>
  4. <RequestId>AB14769A-A5F2-4CCD-B85B-3368DFF63C0A</RequestId>
  5. </RefreshDcdnObjectCachesResponse>

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.
IllegalOperation Illegal domain operate is not permitted. 403 The error message returned when the domain name is invalid.
OperationDenied Your account does not open CDN service yet. 403 The error message returned when the CDN service is not activated.
OperationDenied Your CDN service is suspended. 403 The error message returned when your CDN service is suspended.
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 refresh count exceeds the upper limit.
ServiceBusy The specified Domain is configuring, please retry later. 403 The error message returned when the domain name is being configured. 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.
InvalidObjectType.ValueNotSupported The specified value of “ObjectType” is not supported. 400 The error message returned when the value of the ObjectType parameter is invalid.
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.
QuotaPerMinuteExceeded.Refresh You’ve exceeded the prescribed refresh limits per minute. 400 The error message returned when your refresh count per minute exceeds the upper limit.