cdnCacheInvalidation

Encaminha a lista de URLs fornecida para o provedor Scene7 CDN (Content Distribution Network) para invalidar o cache existente de respostas HTTP.

cdnCacheInvalidation: Sobre

A invalidação do cache de CDN força todas as solicitações HTTP para esses URLs a serem revalidados em relação aos dados publicados atuais na rede do Scene7 depois que essa solicitação de invalidação é processada pela rede de CDN. Quaisquer URLs que não estejam conectados à estrutura do URL do serviço Scene7 e que correspondam diretamente à ID raiz da empresa Scene7 atribuída quando a empresa é criada resultarão em uma falha da API para toda a solicitação. Quaisquer URLs inválidos que o CDN não suporta e que considere inválidos também resultarão em uma falha de API para toda a solicitação.

Frequência de utilização: Regras

As regras que regem a frequência de uso deste recurso são controladas pelos parceiros CDN da Scene7. O CDN mantém a discrição de diminuir a capacidade de resposta dessas invalidações para manter o desempenho ótimo de seu serviço para seus usuários. Se a Scene7 for notificada de uso excessivo deste recurso, será necessário desativar o recurso por empresa ou totalmente pelo serviço.

E-mails de confirmação

Os emails de confirmação do parceiro Scene7 CDN podem ser enviados para o criador da lista ou até cinco outros endereços de email. A API envia a confirmação quando toda a rede CDN foi notificada de que os URLs referenciados no email foram apagados. Uma única chamada para cdnCacheInvalidation pode enviar vários emails se o número de URLs fornecidos exceder o número que a Scene7 pode fornecer ao parceiro CDN em uma única notificação. Atualmente, isso ocorre se a solicitação exceder 100 URLs, mas está sujeita a alterações com base na solicitação do parceiro CDN.

Suportado desde

6,0

Tipos de usuário autorizados

  • IpsAdmin
  • IpsCompanyAdmin

Parâmetros

Input ( cdnCacheInvalidationParam)

Nome Tipo Obrigatório Descrição

companyHandle

xsd:string

Sim

O identificador da empresa conectada aos URLs a serem invalidados.

urlArray

tipos:UrlArray

Sim

Lista de até 1000 URLs para invalidar do cache CDN. Todos os URLS devem conter a ID raiz da empresa Scene7 a ser invalidada.

Output( cdnCacheInvalidationReturn)

Nome Tipo Obrigatório Descrição

invalidationHandle

xsd:string

Sim

Um identificador que faz referência à solicitação de expurgação.

A API cdnCacheInvalidation agora invalida o cache quase imediatamente (~5 segundos). Dessa forma, a pesquisa para o status de invalidação geralmente não é mais necessária.

estimatedSeconds

xsd:int

Sim

Estimados segundos para a conclusão da solicitação de expurgação. Os clientes devem aguardar esse tempo antes do status da pesquisa.

Exemplo

Este exemplo solicita que quatro URLs sejam invalidados no cache de CDN. A resposta contém contagens resumidas do sucesso das operações e uma lista de detalhes de erros fornecidos diretamente da CDN para ajudar o cliente a usar esse recurso.

getCdnCacheInvalidationStatus operação.

Solicitação

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

Resposta

<cdnCacheInvalidationReturn xmlns="http://www.scene7.com/IpsApi/xsd/2012-02-14">
   <successCount>4</successCount>
   <warningCount>0</warningCount>
   <errorCount>0</errorCount>
</cdnCacheInvalidationReturn>

Nesta página