cdnCacheInvalidation cdncacheinvalidation

Vidarebefordrar den angivna listan med URL:er till Dynamic Media CDN-leverantören (Content Distribution Network) för att ogiltigförklara deras befintliga cache för HTTP-svar.

cdnCacheInvalidation: Om section-4f70d2bc79d64288b961836ab17e9690

Cacheogiltigförklaring av CDN tvingar alla HTTP-begäranden för dessa URL:er att valideras mot aktuella publicerade data i Dynamic Media-nätverket efter att denna invalideringsbegäran har bearbetats via CDN-nätverket. Alla URL:er som inte är anslutna till Dynamic Media tjänst-URL-struktur och som direkt matchar Dynamic Media företags rot-ID som tilldelats när företaget skapas resulterar i ett API-fel för hela begäran. Om det finns ogiltiga URL:er som CDN inte stöder och som den anser vara ogiltiga resulterar det också i ett API-fel för hela begäran.

Användningsfrekvens: Regler

Reglerna för hur ofta denna funktion ska användas regleras av Dynamic Media CDN-partners. CDN behåller sin frihet att försämra svarstiden för dessa ogiltigförklaringar för att behålla optimala prestanda för tjänsten för användarna. Om Dynamic Media får ett meddelande om överanvändning av funktionen måste Adobe gå till att inaktivera funktionen antingen per företag eller helt i tjänsten.

Bekräftelsemejl

Bekräftelsemeddelanden från Dynamic Media CDN-partnern kan skickas till den som skapat listan eller upp till fem andra e-postadresser. API:t skickar en bekräftelse när hela CDN-nätverket har underrättats om att URL:erna som refereras i e-postmeddelandet har rensats. Ett samtal till cdnCacheInvalidation kan skicka flera e-postmeddelanden om antalet URL:er som anges överstiger det antal som Dynamic Media kan leverera till CDN-partnern i ett enda meddelande. Detta skulle för närvarande vara om begäran överskrider 100 URL:er, men kan ändras på begäran av CDN-partnern.

Stöds sedan

6.0

Auktoriserade användartyper section-0d7895e733d54fb68beb8d231a04e4c9

  • IpsAdmin
  • IpsCompanyAdmin

Parametrar section-bd1ed2b7419945d19a2ebd5668499f72

Indata ( cdnCacheInvalidationParam)

Namn
Typ
Obligatoriskt
Beskrivning
companyHandle
xsd:sträng
Ja
Handtaget till företaget som är kopplat till URL:erna som ska ogiltigförklaras.
urlArray
typer:UrlArray
Ja
Lista med upp till 1 000 URL:er som ska göras ogiltiga från CDN-cachen. Alla URL:er måste innehålla Dynamic Media-företagets rot-ID för att kunna ogiltigförklaras.

Utdata( cdnCacheInvalidationReturn)

Namn
Typ
Obligatoriskt
Beskrivning
invalidationHandle
xsd:sträng
Ja

En referens som refererar till rensningsbegäran.

The cdnCacheInvalidation API gör nu cachen nästan omedelbart ogiltig (~5 sekunder). Därför behövs vanligtvis inte längre avsökning för ogiltigförklaringsstatus.

measuredSeconds
xsd:int
Ja
Beräknade sekunder för slutförande av rensningsbegäran. Klienter bör vänta den här tiden innan avsökningsstatus.

Exempel section-f414361a58e84dfcbbac30a358d02125

I det här exemplet begärs fyra URL:er som ska ogiltigförklaras i CDN-cachen. Svaret innehåller en sammanfattning av om åtgärderna lyckades och en lista med felinformation som tillhandahålls direkt från CDN för att hjälpa klienten att använda den här funktionen.

getCdnCacheInvalidationStatus operation.

Begäran

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

Svar

<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