cdnCacheInvalidation

将提供的URL列表转发到Dynamic Media CDN(内容分发网络)提供程序,以使其现有的HTTP响应缓存失效。

cdnCacheInvalidation:关于

通过CDN网络处理CDN缓存失效请求后,强制针对Dynamic Media网络上当前已发布的数据,对这些URL的所有HTTP请求重新验证。 如果任何URL未连接到Dynamic Media服务URL结构,并且与创建公司时分配的Dynamic Media公司根ID直接匹配,则会导致整个请求出现API错误。 如果CDN不支持且认为无效的任何无效URL,则也会导致整个请求出现API错误。

使用频率:规则

控制此功能使用频率的规则由Dynamic Media的CDN合作伙伴控制。 CDN可自行决定如何降低这些无效的响应速度,以保持其服务对用户的最佳性能。 如果Dynamic Media收到过度使用此功能的通知,我们需要针对每个公司或在整个服务中完全禁用此功能。

确认电子邮件

来自Dynamic Media CDN合作伙伴的确认电子邮件可发送给列表的创建者,或最多5个其他电子邮件地址。 当通知整个CDN网络已清除电子邮件中引用的URL时,API会发送确认消息。 如果提供的URL数量超过Dynamic Media在单次通知中向CDN合作伙伴交付的URL数量,则对cdnCacheInvalidation的单次调用可以发送多封电子邮件。 目前,如果请求超过100个URL,但可能会根据CDN合作伙伴的请求进行更改,则为上述情况。

支持时间

6.0

授权用户类型

  • IpsAdmin
  • IpsCompanyAdmin

参数

输入 ( cdnCacheInvalidationParam)

名称 类型 必需 说明

companyHandle

xsd:string

与URL连接的公司要失效的句柄。

urlArray

类型:UrlArray

要从CDN缓存失效的最多1000个URL的列表。 所有URL都必须包含要失效的Dynamic Media公司根ID。

输出( cdnCacheInvalidationReturn)

名称 类型 必需 说明

invalidationHandle

xsd:string

引用清除请求的句柄。

cdnCacheInvalidation API现在几乎立即使缓存失效(约5秒)。 因此,通常不再需要轮询失效状态。

estimatedSeconds

xsd:int

完成清除请求的预计秒数。 客户端应等待此时间才能轮询状态。

示例

此示例请求在CDN缓存中使四个URL失效。 响应包含操作成功的概要计数以及直接从CDN提供的用于帮助客户端使用此功能的错误详细信息列表。

getCdnCacheInvalidationStatus 操作.

请求

<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>

响应

<cdnCacheInvalidationReturn xmlns="http://www.scene7.com/IpsApi/xsd/2012-02-14">
   <successCount>4</successCount>
   <warningCount>0</warningCount>
   <errorCount>0</errorCount>
</cdnCacheInvalidationReturn>

在此页面上