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

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

InvalidTimeout

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 Saving Revision revision_number
CacheLookupTimeoutInSeconds value value should be greater than zero.

Exemplo de mensagem de erro

Error Saving Revision 2
CacheLookupTimeoutInSeconds -1 value should be greater than zero.

Captura de ecrã de erro de exemplo

Causa

Se o elemento <CacheLookupTimeoutInSeconds> de uma política LookupCache estiver definido como um número negativo, a implementação do proxy de API falha.

Por exemplo, se o elemento <CacheLookupTimeoutInSeconds> for -1, a implementação do proxy da API falha.

Diagnóstico

1. Identifique o valor inválido especificado para o elemento <CacheLookupTimeoutInSeconds> na política LookupCache. Pode encontrar estas informações na mensagem de erro. Por exemplo, no erro seguinte, o valor inválido usado para o elemento <CacheLookupTimeoutInSeconds> é -1:

   CacheLookupTimeoutInSeconds -1 value should be greater than zero.
   

2. Examine todas as políticas de LookupCache no proxy de API específico onde ocorreu a falha. Pode haver uma ou mais políticas LookupCache nas quais o elemento <CacheLookupTimeoutInSeconds> é especificado. Identifique a política LookUpCache onde o valor inválido (identificado no passo n.º 1 acima) é especificado para o elemento <CacheLookupTimeoutInSeconds>.

   Por exemplo, a seguinte configuração da política especifica o valor de <CacheLookupTimeoutInSeconds> de -1, que corresponde à mensagem de erro:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <LookupCache async="false" continueOnError="false" enabled="true" name="LookupCache-Token">
       <DisplayName>LookupCache-Token</DisplayName>
       <Properties/>
       <CacheKey>
           <Prefix/>
           <KeyFragment ref="request.queryparam.client_id"/>
       </CacheKey>
       <CacheLookupTimeoutInSeconds>-1</CacheLookupTimeoutInSeconds>
       <Scope>Exclusive</Scope>
       <ExpirySettings>
           <TimeoutInSec>3600</TimeoutInSec>
       </ExpirySettings>
       <AssignTo>usertoken</AssignTo>
   </LookupCache>
   

3. Se o <CacheLookupTimeoutInSeconds> for especificado como um número inteiro negativo, essa é a causa do erro.

Resolução

Certifique-se de que o valor do elemento <CacheLookupTimeoutInSeconds> da política LookupCache é sempre especificado como um número inteiro não negativo.

Para corrigir a política LookupCache de exemplo apresentada acima, pode modificar o elemento <CacheLookupTimeoutInSeconds> para 30.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<LookupCache async="false" continueOnError="false" enabled="true" name="LookupCache-Token">
    <DisplayName>LookupCache-Token</DisplayName>
    <Properties/>
    <CacheKey>
        <Prefix/>
        <KeyFragment ref="request.queryparam.client_id"/>
    </CacheKey>
    <CacheResource>tokencache</CacheResource>
    <CacheLookupTimeoutInSeconds>30</CacheLookupTimeoutInSeconds>
    <Scope>Exclusive</Scope>
    <ExpirySettings>
        <TimeoutInSec>3600</TimeoutInSec>
    </ExpirySettings>
    <AssignTo>usertoken</AssignTo>
</LookupCache>

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:ResponseCache;Organization:[organization];Environment:[environment]

Exemplo de mensagem de erro

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

Captura de ecrã de erro de exemplo

Causa

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

Diagnóstico

1. Identifique a cache inválida usada no elemento <CacheResource> da política LookupCache e o ambiente onde ocorreu o erro. Pode encontrar ambos os itens na mensagem de erro. Por exemplo, no erro seguinte, o nome da cache inválida é tokencache e o nome do ambiente é test.

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

2. Examine todas as políticas de LookupCache no proxy de API específico onde ocorreu a falha. Identifique a política LookupCache específica onde a cache inválida (identificada no passo n.º 1) é especificada no elemento <CacheResource>.

   Por exemplo, a seguinte política especifica o valor de <CacheResource> como tokencache, que corresponde à mensagem de erro:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <LookupCache async="false" continueOnError="false" enabled="true" name="LookupCache-Token">
       <DisplayName>LookupCache-Token</DisplayName>
       <Properties/>
       <CacheKey>
           <Prefix/>
           <KeyFragment ref="request.queryparam.client_id"/>
       </CacheKey>
       <CacheResource>tokencache</CacheResource>
       <CacheLookupTimeoutInSeconds/>
       <Scope>Exclusive</Scope>
       <ExpirySettings>
           <TimeoutInSec>3600</TimeoutInSec>
       </ExpirySettings>
       <AssignTo>usertoken</AssignTo>
   </LookupCache>
   

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.

   

   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 LookupCache-Token. Context Revision:2;APIProxy:TestCache;Organization:kkalckstein-eval;Environment:test
   
   

Resolução

Certifique-se de que o nome da cache especificado no elemento <CacheResource> foi criado 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.

Resolução

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