cdnCacheInvalidation

Reenvía la lista suministrada de direcciones URL al proveedor de CDN de Dynamic Media (Red de distribución de contenido) para invalidar la caché existente de respuestas HTTP.

cdnCacheInvalidation: Acerca de

La invalidación de caché de CDN obliga a todas las solicitudes HTTP para que estas URL se revaliden con los datos publicados actualmente en la red de Dynamic Media después de que esta solicitud de invalidación se procese a través de la red de CDN. Cualquier URL que no esté conectada a la estructura de la URL del servicio de Dynamic Media y que coincida directamente con el ID raíz de la empresa de Dynamic Media asignado cuando se crea la empresa dará como resultado un error de API para toda la solicitud. Cualquier URL no válida que la CDN no admita y que considere no válida también generará un error de API para toda la solicitud.

Frecuencia de uso: Reglas

Las reglas que rigen la frecuencia de uso de esta función están controladas por los socios de CDN de Dynamic Media. La CDN conserva la discreción de degradar la capacidad de respuesta de estas invalidaciones para mantener un rendimiento óptimo de su servicio a sus usuarios. Si se notifica a Dynamic Media del uso excesivo de esta función, tendremos que recurrir a la desactivación de la función, ya sea por empresa o por completo a través del servicio.

Correos electrónicos de confirmación

Los correos electrónicos de confirmación del socio de CDN de Dynamic Media se pueden enviar al creador de la lista o hasta 5 direcciones de correo electrónico más. La API envía la confirmación cuando se ha notificado a toda la red de CDN que se han borrado las direcciones URL a las que se hace referencia en el correo electrónico. Una sola llamada a cdnCacheInvalidation puede enviar varios correos electrónicos si el número de URL suministradas supera el número que Dynamic Media puede enviar al socio de CDN en una sola notificación. Actualmente, eso sería si la solicitud supera las 100 direcciones URL, pero está sujeta a cambios según la solicitud del socio de CDN.

Admitido desde

6,0

Tipos de usuarios autorizados

  • IpsAdmin
  • IpsCompanyAdmin

Parámetros

Input ( cdnCacheInvalidationParam)

Nombre Tipo Obligatorio Descripción

companyHandle

xsd:string

Sí

El identificador de la empresa conectada con las URL para invalidar.

urlArray

tipos:UrlArray

Sí

Lista de hasta 1000 direcciones URL que se van a invalidar desde la caché de CDN. Todas las direcciones URL deben contener el ID raíz de la empresa de Dynamic Media para invalidarse.

Output( cdnCacheInvalidationReturn)

Nombre Tipo Obligatorio Descripción

invalidationHandle

xsd:string

Sí

Un controlador que hace referencia a la solicitud de depuración.

La API cdnCacheInvalidation ahora invalida la caché casi inmediatamente (~5 segundos). Por lo tanto, ya no suele ser necesario sondear el estado de invalidación.

estimatedSeconds

xsd:int

Sí

Segundos estimados hasta la finalización de la solicitud de depuración. Los clientes deben esperar este tiempo antes del estado de sondeo.

Ejemplo

Este ejemplo solicita que se invaliden cuatro direcciones URL en la caché de CDN. La respuesta contiene recuentos resumidos del éxito de las operaciones y una lista de detalles de error suministrados directamente desde la CDN para ayudar al cliente en el uso de esta función.

getCdnCacheInvalidationStatus operación.

Solicitar

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

Respuesta

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

En esta página