Resolução de problemas de erro de implementação da política de cache

Está a ver a documentação do Apigee e do Apigee Hybrid.
Ver documentação do Apigee Edge.

InvalidCacheResourceReference

Mensagem de erro

A implementação do proxy de API através da IU ou da API Apigee 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 ecrã de erro de exemplo

Erro ao implementar a revisão 2 para teste.

Causa

Este erro ocorre se o elemento <CacheResource> na política PopulateCache estiver definido para um nome que não existe no ambiente onde o proxy de API está a ser implementado.

Diagnóstico

  1. Identifique o nome da política PopulateCache, a cache inválida usada no elemento <CacheResource> da política e o ambiente onde ocorreu o erro. Pode encontrar todos estes itens na mensagem de erro. Por exemplo, no seguinte erro, o nome da política PopulateCache é PopulateCache-Token, o nome da cache inválida é 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 da política PopulateCache com falhas e verifique se o nome da cache especificado para o elemento <CacheResource> corresponde à mensagem de erro.

    Neste exemplo, o nome da 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 a cache (determinada no passo n.º 1) foi definida no ambiente específico (identificado no passo n.º 1).

    Na IU do Apigee, navegue para ADMIN > Environment > test e verifique se a cache existe no separador Caches de Environment Configuration. Se a cache não existir, essa é a causa do erro.

    Por exemplo, repare na captura de ecrã abaixo que a cache denominada tokencache não existe.

    Separador Caches de configuração do ambiente.

    Uma vez que a cache denominada tokencache não está definida no ambiente test, é apresentado o seguinte erro:

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

Resolução

Certifique-se de que a cache especificada no elemento <CacheResource> da política PopulateCache foi criada no ambiente onde quer implementar o proxy de API.

CacheNotFound

Mensagem de erro

A implementação do proxy de API através da IU ou da API Apigee resulta numa mensagem de erro como esta, e o estado de implementação do proxy de API é marcado como parcialmente implementado:

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

Este erro ocorre se a cache específica mencionada na mensagem de erro não tiver sido criada num componente Message Processor específico. Um processador de mensagens é um componente interno do Apigee que processa o fluxo de tráfego da API através do Apigee.

Resolução

Contacte o apoio técnico do Apigee para receber assistência.