cdnCacheInvalidation
创建对象:
- 开发人员
- 管理员
将提供的URL列表转发给Dynamic Media CDN(内容分发网络)提供程序,以使其现有的HTTP响应缓存失效。
cdnCacheInvalidation:关于
在通过CDN网络处理此失效请求后,CDN缓存失效会强制根据Dynamic Media网络上的当前已发布数据重新验证这些URL的所有HTTP请求。 任何未连接到Dynamic Media服务URL结构且与创建公司时分配的Dynamic Media公司根ID直接匹配的URL都会导致整个请求的API出错。 CDN不支持的任何被视为无效的无效URL也会导致整个请求的API出错。
使用频率:规则
控制此功能使用频率的规则由Dynamic Media的CDN合作伙伴控制。 CDN保留降低这些失效的响应性的酌处权,以保持其向其用户提供的服务的最佳性能。 如果Dynamic Media收到过度使用此功能的通知,Adobe必须基于每个公司或整个服务禁用该功能。
确认电子邮件
Dynamic Media CDN合作伙伴的确认电子邮件最多可以发送给列表创建者或其他5个电子邮件地址。 当通知整个CDN网络电子邮件中引用的URL已被清除时,API会发送确认。 如果提供的URL数量超过Dynamic Media在单个通知中可向CDN合作伙伴提供的数量,则对cdnCacheInvalidation
的单次调用可以发送多个电子邮件。 目前,这表示请求将超过100个URL,但可能会根据CDN合作伙伴的请求而发生更改。
自 起便受支持
6.0
授权用户类型
IpsAdmin
IpsCompanyAdmin
参数
输入 ( cdnCacheInvalidationParam
)
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
companyHandle | xsd:string | 是 | 与要失效的URL关联的公司的句柄。 |
urlArray | 类型:UrlArray | 是 | 从CDN缓存中失效的URL列表,最多1000个。 所有URL都必须包含要失效的Dynamic Media公司根ID。 |
输出(cdnCacheInvalidationReturn
)
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
invalidationHandle | xsd:string | 是 |
引用清除请求的句柄。 cdnCacheInvalidation API现在几乎立即使缓存失效(~5秒)。 因此,通常不再需要轮询失效状态。 |
estimatedSeconds | xsd:int | 是 | 预计完成清除请求的秒数。 客户端应等待此时间,然后再轮询状态。 |
示例
此示例请求在CDN缓存中使4个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>