DocumentazioneAPI di Dynamic Medie Image Production System

cdnCacheInvalidation cdncacheinvalidation

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Sviluppatore
  • Amministratore

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

cdnCacheInvalidation: Informazioni section-4f70d2bc79d64288b961836ab17e9690

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ò inviare 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 section-0d7895e733d54fb68beb8d231a04e4c9

  • IpsAdmin
  • IpsCompanyAdmin

Parametri section-bd1ed2b7419945d19a2ebd5668499f72

Input ( cdnCacheInvalidationParam)

Nome
Tipo
Obbligatorio
Descrizione
companyHandle
xsd:string
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:string
Sì

Handle che fa riferimento alla richiesta di eliminazione.

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

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.

Operazione getCdnCacheInvalidationStatus.

Richiesta

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