cdnCacheInvalidation cdncacheinvalidation

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

cdnCacheInvalidation : à propos section-4f70d2bc79d64288b961836ab17e9690

L’invalidation du cache du réseau de diffusion de contenu force toutes les requêtes HTTP pour ces URL à être revalidées par rapport aux données publiées actuelles sur le réseau Dynamic Media une fois que cette requête d’invalidation a été traitée via le réseau CDN. Toutes les URL qui ne sont pas connectées à la structure d’URL du service Dynamic Media et qui correspondent directement à l’ID racine de société Dynamic Media affecté lorsque la société est créée entraînent une erreur d’API pour l’ensemble de la requête. Toute URL non valide que le réseau CDN ne prend pas en charge et qu’il considère comme non valide entraîne é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 de réseau CDN de Dynamic Media. Le réseau CDN conserve la discrétion de dégrader la réactivité de ces invalidations afin de maintenir des performances optimales de son service pour ses utilisateurs. Si Dynamic Media est averti d’une utilisation excessive de cette fonctionnalité, Adobe doit désactiver cette fonctionnalité par société ou entièrement sur l’ensemble du service.

E-mails de confirmation

Les e-mails de confirmation du partenaire de réseau CDN Dynamic Media peuvent être envoyés au créateur de la liste ou à jusqu’à 5 autres adresses e-mail. L’API envoie la confirmation lorsque l’ensemble du réseau CDN a été averti que les URL référencées dans l’e-mail ont été effacées. Un seul appel à cdnCacheInvalidation peut envoyer plusieurs e-mails si le nombre d’URL fournies dépasse le nombre que Dynamic Media peut diffuser au partenaire de réseau CDN sur une seule notification. Actuellement, cela se produit si la requête dépasse 100 URL, mais peut être modifiée à la demande du partenaire de réseau CDN.

Pris en charge depuis

6.0

Types d’utilisateurs autorisés section-0d7895e733d54fb68beb8d231a04e4c9

  • IpsAdmin
  • IpsCompanyAdmin

Paramètres section-bd1ed2b7419945d19a2ebd5668499f72

Input ( cdnCacheInvalidationParam)

Name
Type de
obligatoire
Description
companyHandle
xsd:string
Oui
Identifiant de la société connectée aux URL à invalider.
urlArray
types :UrlArray
Oui
Liste de 1 000 URL maximum à invalider à partir du cache du réseau CDN. Toutes les URL doivent contenir l’identifiant racine de la société Dynamic Media pour être invalidées.

Output( cdnCacheInvalidationReturn)

Name
Type de
obligatoire
Description
invalidationHandle
xsd:string
Oui

Un handle 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 pour le statut d’invalidation n’est généralement plus nécessaire.

estimatedSeconds
xsd:int
Oui
Estimation du nombre de secondes avant la fin de la demande de purge. Les clients doivent attendre cette durée avant d’interroger le statut.

Exemple section-f414361a58e84dfcbbac30a358d02125

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

Opération getCdnCacheInvalidationStatus.

Requête

<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>
recommendation-more-help
dynamic-media-developer-resources-help-aem-ips-api