Solução de problemas de erro de implantação da política de preenchimento de cache

InvalidCacheResourceReference

Mensagem de erro

A implantação do proxy de API por meio da IU da Apigee ou da API falha com esta mensagem de erro:

Error Deploying Revision revision_number to environment
Invalid cache resource reference [cache_resource] in Step definition [populate_cache_policy_name]. Context Revision:[revision_number];APIProxy:[apiproxy_name];Organization:[organization];Environment:[environment]

Exemplo de mensagem de erro

Error Deploying Revision 2 to test
Invalid cache resource reference tokencache in Step definition PopulateCache-Token. Context Revision:2;APIProxy:TestCache;Organization:kkalckstein-eval;Environment:test

Captura de tela com erro de exemplo

Erro ao implantar a revisão 2 para teste.

Causa

Esse erro ocorrerá se o elemento <CacheResource> na política PopulateCache estiver definido como um nome que não exista no ambiente em que o proxy de API está sendo implantado.

Diagnóstico

  1. Identifique o nome da política PopulateCache, o cache inválido usado no elemento <CacheResource> da política e o ambiente em que o erro ocorreu. Você pode encontrar todos esses itens na mensagem de erro. Por exemplo, no erro a seguir, o nome da política PopulateCache é PopulateCache-Token, o nome do cache inválido é tokencache e o nome do ambiente é test.

    Invalid cache resource reference tokencache in Step definition PopulateCache-Token. Context Revision:2;APIProxy:TestCache;Organization:kkalckstein-eval;Environment:test
    
  2. Examine o XML com a política PopulateCache com falha e verifique se o nome do cache especificado do elemento <CacheResource> corresponde à mensagem de erro.

    Neste exemplo, o nome do cache especificado no elemento <CacheResource> é tokencache:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <PopulateCache async="false" continueOnError="false" enabled="true" name="PopulateCache-Token">
        <DisplayName>PopulateCache-Token</DisplayName>
        <Properties/>
        <CacheKey>
            <Prefix/>
            <KeyFragment ref="request.queryparam.client_id"/>
        </CacheKey>
        <CacheResource>tokencache</CacheResource>
        <Scope>Exclusive</Scope>
        <ExpirySettings>
            <TimeoutInSec>3600</TimeoutInSec>
        </ExpirySettings>
        <Source>token</Source>
    </PopulateCache>
    
  3. Verifique se o cache (determinado na etapa 1) foi definido no ambiente específico (identificado na etapa 1).

    Na IU da Apigee, navegue até ADMIN > Ambiente > teste e verifique se o cache existe na guia Caches em Configuração do Ambiente. Se o cache não existir, essa é a causa do erro.

    Por exemplo, observe na captura de tela abaixo que o cache tokencache não existe.

    Caches de configuração do ambiente

    Como o cache denominado tokencache não está definido no ambiente test, você recebe o erro:

    Invalid cache resource reference tokencache in Step definition PopulateCache-Token. Context Revision:2;APIProxy:TestCache;Organization:kkalckstein-eval;Environment:test
    

Resolução

Verifique se o cache especificado no elemento <CacheResource> da política PopulateCache foi criado no ambiente em que você quer implantar o proxy de API.

CacheNotFound

Mensagem de erro

A implantação do proxy da API por meio da IU da Apigee ou da API resulta em uma mensagem de erro como esta, e o status da implantação do Proxy da API é marcado como parcialmente implantado:

Error: Cache : cache_resource, not found in organization : organization__environment.

Exemplo de mensagem de erro

Error Cache : configCache, not found in organization : kkalckstein-eval__test

Causa

Esse erro ocorre quando o cache específico mencionado na mensagem de erro não tiver sido criado em um componente de processador de mensagens específico. Um processador de mensagens é um componente interno da Apigee que processa o fluxo de tráfego de API usando a Apigee.

Resolução

Entre em contato com o suporte da Apigee (em inglês) para receber ajuda.