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

Esta é a documentação da Apigee e da Apigee híbrida.
Confira a documentação da Apigee Edge.

InvalidTimeout

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 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 tela com erro de exemplo

Erro ao salvar a revisão 2.

Causa

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

Por exemplo, se o elemento <CacheLookupTimeoutInSeconds> for -1, a implantação do proxy de API falhará.

Diagnóstico

Identifique o valor inválido especificado para o elemento <CacheLookupTimeoutInSeconds> na política LookupCache. Você encontra essas informações na mensagem de erro. Por exemplo, no erro a seguir, o valor inválido usado para o elemento <CacheLookupTimeoutInSeconds> é -1:
```
CacheLookupTimeoutInSeconds -1 value should be greater than zero.
```

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

Por exemplo, a configuração de política a seguir especifica o valor <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>

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

Resolução

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

Para corrigir a política de LookupCache de exemplo mostrada acima, modifique 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 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: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 tela com erro de exemplo

Erro ao implantar a revisão 2 para teste.

Causa

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

Diagnóstico

Identifique o cache inválido usado no elemento <CacheResource> da política LookupCache e o ambiente em que o erro ocorreu. É possível encontrar os dois itens na mensagem de erro. Por exemplo, no erro a seguir, o nome do cache inválido é 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
```

Examine todas as políticas LookupCache no proxy de API específico onde a falha ocorreu. Identifique a política LookupCache específica em que o cache inválido (identificado na etapa 1) é especificado no elemento <CacheResource>.

Por exemplo, a política a seguir 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>

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.

Como o cache denominado tokencache não está definido no ambiente test, você recebe o erro:
```
Invalid cache resource reference tokencache in Step definition LookupCache-Token. Context Revision:2;APIProxy:TestCache;Organization:kkalckstein-eval;Environment:test
```

Resolução

Verifique se o nome do cache especificado no elemento <CacheResource> foi criado no ambiente em que você quer implantar o proxy da 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.

Resolução

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