cdnCacheInvalidation

Transfère la liste fournie des URL au fournisseur Dynamic Media CDN (Content Distribution Network) pour invalider le cache existant de réponses HTTP.

cdnCacheInvalidation : A propos

L’invalidation du cache CDN force toutes les requêtes HTTP pour que ces URL soient revalidées par rapport aux données publiées actuelles sur le réseau Dynamic Media après le traitement de cette demande d’invalidation par le biais du réseau CDN. Toute URL qui n’est pas connectée à la structure d’URL du service Dynamic Media et qui correspond directement à l’ID racine de l’entreprise Dynamic Media affecté lors de la création de l’entreprise entraînera une erreur d’API pour l’ensemble de la requête. Toute URL non valide que le réseau de diffusion de contenu ne prend pas en charge et qu’il considère non valide entraînera également une erreur d’API pour l’ensemble de la requête.

Fréquence d’utilisation : Règles

Les règles régissant la fréquence d’utilisation de cette fonctionnalité sont contrôlées par les partenaires CDN de Dynamic Media. Le réseau de diffusion de contenu conserve la discrétion de dégrader la réactivité de ces invalidations afin de maintenir des performances optimales de son service à ses utilisateurs. Si Dynamic Media est averti de l’utilisation abusive de cette fonctionnalité, il devra recourir à la désactivation de cette dernière, soit pour chaque entreprise, soit pour l’ensemble du service.

Courriers électroniques de confirmation

Les emails de confirmation du partenaire Dynamic Media CDN peuvent être envoyés à l’auteur de la liste ou à 5 autres adresses électroniques au maximum. L’API envoie la confirmation lorsque l’ensemble du réseau CDN a été informé que les URL référencées dans l’email ont été effacées. Un seul appel à cdnCacheInvalidation peut envoyer plusieurs emails si le nombre d’URL fournies dépasse le nombre que Dynamic Media peut fournir au partenaire CDN sur une seule notification. Actuellement, cela se produit si la requête dépasse 100 URL, mais qu’elle peut être modifiée sur la base de la requête du partenaire CDN.

Pris en charge depuis

6.0

Types d’utilisateurs autorisés

  • IpsAdmin
  • IpsCompanyAdmin

Paramètres

Input ( cdnCacheInvalidationParam)

Nom Type Obligatoire Description

companyHandle

xsd:string

Oui

Gestionnaire de la société connectée à l’URL à invalider.

urlArray

types:UrlArray

Oui

Liste de 1 000 URL au maximum à invalider à partir du cache CDN. Toutes les URL doivent contenir l’ID racine de la société Dynamic Media à invalider.

Sortie( cdnCacheInvalidationReturn)

Nom Type Obligatoire Description

invalidationHandle

xsd:string

Oui

Gestionnaire référençant la requête de purge.

L’API cdnCacheInvalidation invalide désormais le cache presque immédiatement (~5 secondes). Par conséquent, l’interrogation de l’état d’invalidation n’est généralement plus nécessaire.

estimatedSeconds

xsd:int

Oui

Durée estimée en secondes jusqu’à la fin de la requête de purge. Les clients doivent attendre cette période avant d’interroger le statut.

Exemple

Cet exemple demande l’invalidation de quatre URL dans le cache CDN. La réponse contient un résumé des résultats des opérations et une liste des détails d’erreur fournis directement par le réseau de diffusion de contenu pour aider le client à utiliser cette fonctionnalité.

getCdnCacheInvalidationStatus opération.

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>

Réponse

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

Sur cette page