cdnCacheInvalidation 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 section-4f70d2bc79d64288b961836ab17e9690

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 bei der gesamten Anfrage ein API-Fehler 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 Verwendung: Regeln

Die Regeln für die Häufigkeit der Verwendung dieser Funktion werden von den CDN-Partnern von Dynamic Media kontrolliert. 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, muss Adobe entweder die Funktion pro Unternehmen oder vollständig über den gesamten Dienst deaktivieren.

Bestätigungs-E-Mail

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 einzelner Aufruf an 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 section-0d7895e733d54fb68beb8d231a04e4c9

  • IpsAdmin
  • IpsCompanyAdmin

Parameter section-bd1ed2b7419945d19a2ebd5668499f72

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.

Ausgabe( cdnCacheInvalidationReturn)

Name
Typ
Erforderlich
Beschreibung
invalidationHandle
xsd:string
Ja

Ein Handle, das auf die Bereinigungsanforderung verweist.

Die cdnCacheInvalidation API 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 section-f414361a58e84dfcbbac30a358d02125

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>
recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681