cdnCacheInvalidation cdncacheinvalidation

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

cdnCacheInvalidation: Sobre section-4f70d2bc79d64288b961836ab17e9690

A invalidação do cache do CDN força todas as solicitações HTTP para esses URLs a serem revalidados em relação aos dados publicados atuais na rede do Dynamic Media depois que essa solicitação de invalidação for processada pela rede CDN. Qualquer URL que não esteja conectado à estrutura de URL de serviço do Dynamic Media e que corresponda diretamente à ID raiz da empresa do Dynamic Media atribuída quando a empresa foi criada resultará em uma falha de API para toda a solicitação. Quaisquer URLs inválidos não suportados pelo CDN e considerados inválidos também resultam em uma falha de API para toda a solicitação.

Frequência de Uso: Regras

As regras que regem a frequência de uso desse recurso são controladas pelos parceiros CDN da Dynamic Media. A CDN mantém a discrição de degradar a capacidade de resposta dessas invalidações para manter o desempenho ideal de seu serviço para seus usuários. Se a Dynamic Media for notificada de uso excessivo desse recurso, o Adobe deverá recorrer à desativação do recurso por empresa ou inteiramente por todo o serviço.

Emails de Confirmação

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

Com Suporte Desde

6,0

Tipos de usuário autorizados section-0d7895e733d54fb68beb8d231a04e4c9

  • IpsAdmin
  • IpsCompanyAdmin

Parâmetros section-bd1ed2b7419945d19a2ebd5668499f72

Entrada ( cdnCacheInvalidationParam)

Nome
Tipo
Necessário
Descrição
companyHandle
xsd:string
Sim
O identificador da empresa conectada com os URLs a serem invalidados.
urlArray
tipos:UrlArray
Sim
Lista de até 1000 URLs a serem invalidados do cache da CDN. Todos os URLS devem conter a ID raiz da empresa do Dynamic Media para serem invalidados.

Saída( cdnCacheInvalidationReturn)

Nome
Tipo
Necessário
Descrição
invalidationHandle
xsd:string
Sim

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

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

estimatedSeconds
xsd:int
Sim
Segundos estimados para a conclusão da solicitação de limpeza. Os clientes devem aguardar esse tempo antes de pesquisar o status.

Exemplo section-f414361a58e84dfcbbac30a358d02125

Esse exemplo solicita quatro URLs a serem invalidados no cache da 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.

Operação getCdnCacheInvalidationStatus.

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