cdnCacheInvalidation

Inoltra l’elenco di URL fornito al provider Dynamic Media CDN (Content Distribution Network) per annullare la validità della cache esistente delle risposte HTTP.

cdnCacheInvalidation: Informazioni

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 Media 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 Media e che corrispondono direttamente all’ID principale dell’azienda Dynamic Media assegnato al momento della creazione dell’azienda genereranno un errore API per l’intera richiesta. Eventuali URL non validi che la rete CDN non supporta e che considera non validi causeranno 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 Media. La CDN mantiene la discrezione di degradare la reattività di questi invalidamenti per mantenere prestazioni ottimali del servizio per i suoi utenti. Qualora Dynamic Media venisse avvisata di un uso eccessivo di questa funzione, sarà necessario disabilitare la funzione per singola azienda o per l'intero servizio.

E-mail di conferma

Le e-mail di conferma dal partner CDN di Dynamic Media 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 Media 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

Tipi di utenti autorizzati

  • IpsAdmin
  • IpsCompanyAdmin

Parametri

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

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.

Esempio

In questo esempio viene richiesto che quattro URL vengano invalidati 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>

In questa pagina