Forwards the supplied list of URLs to the Dynamic Media CDN (Content Distribution Network) provider to invalidate their existing cache of HTTP responses.
CDN cache invalidation forces all HTTP requests for these URLs to be revalidated against the current published data on the Dynamic Media network after this invalidation request is processed through the CDN network. Any URLs that are not connected to the Dynamic Media service URL structure and directly matching the Dynamic Media company root ID assigned when the company is created will result in an API fault for the entire request. Any invalid URLs that the CDN does not support that it considers invalid will also result in an API fault for the entire request.
Frequency of Use: Rules
The rules governing the frequency of the use of this feature are controlled by Dynamic Media’s CDN partners. The CDN retains the discretion to degrade the responsiveness of these invalidations to maintain optimum performance of its service to its users. Should Dynamic Media be notified of overuse of this feature we will need to resort to disabling the feature on either a per company basis or entirely across the service.
Confirmation Emails
Confirmation emails from the Dynamic Media CDN partner can be sent to the list’s creator or up to 5 other email addresses. The API sends the confirmation when the entire CDN network has been notified that the URLs referenced in the email have been cleared. A single call to cdnCacheInvalidation
can send multiple emails if the number of URLs supplied exceed the number that Dynamic Media can deliver to the CDN partner on a single notification. Currently, that would be if the request exceeds 100 URLs, but is subject to change based at the request of the CDN partner.
Supported Since
6.0
IpsAdmin
IpsCompanyAdmin
Input ( cdnCacheInvalidationParam
)
Name | Type | Required | Description |
---|---|---|---|
companyHandle |
xsd:string |
Yes |
The handle to the company connected with the URLs to invalidate. |
urlArray |
types:UrlArray |
Yes |
List of up to 1000 URLs to invalidate from the CDN cache. All URLS must contain the Dynamic Media company root ID to be invalidated. |
Output( cdnCacheInvalidationReturn
)
Name | Type | Required | Description |
---|---|---|---|
invalidationHandle |
xsd:string |
Yes |
A handle referencing the purge request. The cdnCacheInvalidation API now invalidates the cache almost immediately (~5 seconds). As such, polling for invalidation status is generally no longer required. |
estimatedSeconds |
xsd:int |
Yes |
Estimated seconds to completion of the purge request. Clients should wait for this time before polling status. |
This example requests four URLs to be invalidated in the CDN cache. The response contains summary counts of the success of the operations and a list of error details supplied directly from the CDN to assist the client in use of this feature.
getCdnCacheInvalidationStatus
operation.
Request
<cdnCacheInvalidationParam xmlns="http://www.scene7.com/IpsApi/xsd/2012-02-14">
<companyHandle>c|6</companyHandle>
<urlArray>
<items>http://s7d7.scene7.com/is/image/JJEsquire/11008047?$thumbnail$</items>
<items>http://s7d7.scene7.com/is/image/JJEsquire/11008047?$product$</items>
<items>http://s7d7.scene7.com/is/image/JJEsquire/11008047?$large$</items>
<items>http://s7d7.scene7.com/is/image/JJEsquire/ImageSetConfigDefaults?req=userdata</items>
</urlArray>
</cdnCacheInvalidationParam>
Response
<cdnCacheInvalidationReturn xmlns="http://www.scene7.com/IpsApi/xsd/2012-02-14">
<successCount>4</successCount>
<warningCount>0</warningCount>
<errorCount>0</errorCount>
</cdnCacheInvalidationReturn>