Resolução de problemas de erros de implementação da política de invalidação da 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 [invalidate_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 InvalidateCache-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 InvalidateCache 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 InvalidateCache, a cache inválida usada no elemento <CacheResource> da política InvalidateCache 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 InvalidateCache é InvalidateCache-Token, o nome da cache inválida é tokencache e o nome do ambiente é test.

    Invalid cache resource reference tokencache in Step definition InvalidateCache-Token. Context Revision:2;APIProxy:TestCache;Organization:kkalckstein-eval;Environment:test
    
  2. Examine o XML da política InvalidateCache 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"?>
    <InvalidateCache async="false" continueOnError="false" enabled="true" name="InvalidateCache-Token">
        <DisplayName>InvalidateCache-Token</DisplayName>
        <Properties/>
        <CacheKey>
            <Prefix/>
            <KeyFragment ref=""/>
        </CacheKey>
        <CacheResource>tokencache</CacheResource>
        <Scope>Exclusive</Scope>
        <CacheContext>
            <APIProxyName/>
            <ProxyName>default</ProxyName>
            <TargetName>default</TargetName>
        </CacheContext>
        <PurgeChildEntries>false</PurgeChildEntries>
    </InvalidateCache>
    
  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.

    Caixa de diálogo 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 InvalidateCache-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 InvalidateCache 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 do processador de mensagens específico. Um processador de mensagens é um componente interno 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.