cdnCacheInvalidation

Leitet die bereitgestellte Liste von URLs an den Dynamic Media CDN (Content Distribution Network)-Provider weiter, um den vorhandenen Cache mit HTTP-Antworten ungültig zu machen.

cdnCacheInvalidation: Info

Die CDN-Cache-Invalidierung erzwingt, dass alle HTTP-Anforderungen für diese URLs anhand der aktuellen veröffentlichten Daten im Dynamic Media-Netzwerk erneut validiert werden, nachdem diese Invalidierungsanforderung über das CDN-Netzwerk verarbeitet wurde. Für alle URLs, die nicht mit der URL-Struktur des Dynamic Media-Dienstes verbunden sind und direkt mit der Stammordner-ID des Dynamic Media-Unternehmens übereinstimmen, die beim Erstellen des Unternehmens zugewiesen wird, tritt ein API-Fehler für die gesamte Anfrage auf. Alle ungültigen URLs, die das CDN nicht unterstützt und für ungültig hält, führen auch zu einem API-Fehler für die gesamte Anfrage.

Häufigkeit der Anwendung: Regeln

Die Regeln für die Häufigkeit der Verwendung dieser Funktion werden von den CDN-Partnern von Dynamic Media gesteuert. Das CDN behält sich das Ermessen vor, die Reaktionsfähigkeit dieser Invalidierungen herabzusetzen, um eine optimale Leistung seines Dienstes für seine Benutzer zu gewährleisten. Sollte Dynamic Media über eine Übernutzung dieser Funktion informiert werden, müssen wir die Funktion entweder pro Unternehmen oder vollständig im gesamten Service deaktivieren.

Bestätigungs-E-Mails

Bestätigungs-E-Mails vom Dynamic Media CDN-Partner können an den Ersteller der Liste oder bis zu fünf weitere E-Mail-Adressen gesendet werden. Die API sendet eine Bestätigung, wenn das gesamte CDN-Netzwerk darüber informiert wurde, dass die in der E-Mail referenzierten URLs gelöscht wurden. Ein Einzelaufruf von cdnCacheInvalidation kann mehrere E-Mails senden, wenn die Anzahl der angegebenen URLs die Anzahl übersteigt, die Dynamic Media mit einer einzigen Benachrichtigung an den CDN-Partner senden kann. Derzeit wäre dies dann der Fall, wenn die Anfrage 100 URLs überschreitet, aber auf Anfrage des CDN-Partners geändert werden kann.

Unterstützt seit

6,0

Autorisierte Benutzertypen

  • IpsAdmin
  • IpsCompanyAdmin

Parameter

Eingabe ( cdnCacheInvalidationParam)

Name Typ Erforderlich Beschreibung

companyHandle

xsd:string

Ja

Der Handle für das Unternehmen, das mit den URLs verbunden ist, die ungültig gemacht werden sollen.

urlArray

Typen:UrlArray

Ja

Liste von bis zu 1000 URLs, die aus dem CDN-Cache ungültig gemacht werden sollen. Alle URLS müssen die Dynamic Media-Unternehmens-Stamm-ID enthalten, die ungültig gemacht werden soll.

Output( cdnCacheInvalidationReturn)

Name Typ Erforderlich Beschreibung

invalidationHandle

xsd:string

Ja

Ein Handle, das auf die Bereinigungsanforderung verweist.

Die API cdnCacheInvalidation macht den Cache jetzt fast sofort ungültig (~5 Sekunden). Daher ist eine Abfrage zum Invalidierungsstatus im Allgemeinen nicht mehr erforderlich.

estimatedSeconds

xsd:int

Ja

Geschätzte Sekunden bis zum Abschluss der Bereinigungsanforderung. Clients sollten auf diese Zeit warten, bevor sie den Abrufstatus abrufen.

Beispiel

In diesem Beispiel werden vier URLs angefordert, die im CDN-Cache ungültig gemacht werden sollen. Die Antwort enthält zusammenfassende Zählungen zum Erfolg der Vorgänge und eine Liste mit Fehlerdetails, die direkt vom CDN bereitgestellt werden, um den Client bei der Verwendung dieser Funktion zu unterstützen.

getCdnCacheInvalidationStatus Betrieb.

Anforderung

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

Antwort

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

Auf dieser Seite