Inoltra l’elenco di URL fornito al provider Dynamic Medie CDN (Content Distribution Network) per annullare la validità della cache esistente delle risposte HTTP.
L’annullamento della validità della cache CDN forza la riconvalida di tutte le richieste HTTP per questi URL in base ai dati pubblicati correnti sulla rete Dynamic Medie dopo l’elaborazione di questa richiesta di annullamento della validità tramite la rete CDN. Eventuali URL non connessi alla struttura dell’URL del servizio Dynamic Medie e che corrispondono direttamente all’ID principale dell’azienda Dynamic Medie assegnato al momento della creazione dell’azienda generano un errore API per l’intera richiesta. Eventuali URL non validi che la rete CDN non supporta e che considera non validi causano inoltre un errore API per l’intera richiesta.
Frequenza di utilizzo: regole
Le regole che disciplinano la frequenza di utilizzo di questa funzione sono controllate dai partner CDN di Dynamic Medie. La CDN mantiene la discrezione di degradare la reattività di questi invalidamenti per mantenere prestazioni ottimali del servizio per i suoi utenti. Se Dynamic Medie viene avvisata di un uso eccessivo di questa funzione, Adobe deve ricorrere alla disattivazione della funzione per singola azienda o per l’intero servizio.
E-mail di conferma
Le e-mail di conferma dal partner CDN di Dynamic Medie possono essere inviate al creatore dell’elenco o a un massimo di 5 altri indirizzi e-mail. L’API invia la conferma quando l’intera rete CDN viene avvisata che gli URL a cui si fa riferimento nell’e-mail sono stati cancellati. Una singola chiamata a cdnCacheInvalidation
può inviare più e-mail se il numero di URL forniti supera il numero che Dynamic Medie può consegnare al partner CDN con una singola notifica. Attualmente, ciò si verifica se la richiesta supera i 100 URL, ma è soggetta a modifiche in base alla richiesta del partner CDN.
Supportato da
6.0
IpsAdmin
IpsCompanyAdmin
Input ( cdnCacheInvalidationParam
)
Nome | Tipo | Obbligatorio | Descrizione |
---|---|---|---|
companyHandle |
xsd:stringa |
Sì |
L’handle dell’azienda connessa agli URL da invalidare. |
urlArray |
tipi:UrlArray |
Sì |
Elenco di un massimo di 1000 URL da invalidare dalla cache CDN. Per poter essere invalidati, tutti gli URL devono contenere l’ID principale della società Dynamic Medie. |
Output( cdnCacheInvalidationReturn
)
Nome | Tipo | Obbligatorio | Descrizione |
---|---|---|---|
invalidationHandle |
xsd:stringa |
Sì |
Handle che fa riferimento alla richiesta di eliminazione. Il cdnCacheInvalidation L’API ora invalida la cache quasi immediatamente (~5 secondi). Di conseguenza, in genere non è più necessario eseguire il polling per lo stato di invalidazione. |
estimatedSeconds |
xsd:int |
Sì |
Secondi stimati al completamento della richiesta di eliminazione. I client devono attendere questo periodo di tempo prima di eseguire il polling dello stato. |
In questo esempio viene richiesto l’annullamento della validità di quattro URL nella cache CDN. La risposta contiene conteggi riepilogativi del successo delle operazioni e un elenco di dettagli sull’errore forniti direttamente dalla rete CDN per assistere il client nell’utilizzo di questa funzione.
getCdnCacheInvalidationStatus
operazione.
Request Contents (Richiesta contenuto)
<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>
Risposta
<cdnCacheInvalidationReturn xmlns="http://www.scene7.com/IpsApi/xsd/2012-02-14">
<successCount>4</successCount>
<warningCount>0</warningCount>
<errorCount>0</errorCount>
</cdnCacheInvalidationReturn>