Solucionar problemas de errores de implementación de la política de caché de respuestas

Estás consultando la documentación de Apigee y Apigee Hybrid.
Consulta la documentación de Apigee Edge.

InvalidTimeout

Mensaje de error

La implementación del proxy de API a través de la interfaz de usuario o la API de Apigee falla y se muestra este mensaje de error:

Error Saving Revision revision_number
CacheLookupTimeoutInSeconds value value should be greater than zero.

Ejemplo de mensaje de error

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

Captura de pantalla de ejemplo de error

No se ha podido guardar la revisión 2.

Causa

Si el elemento <CacheLookupTimeoutInSeconds> de una política ResponseCache tiene asignado un número negativo, la implementación del proxy de API fallará.

Por ejemplo, si <CacheLookupTimeoutInSeconds> es -1, no se podrá implementar el proxy de API.

Diagnóstico

  1. Identifica el valor no válido que se ha usado en el elemento <CacheLookupTimeoutInSeconds> de la política ResponseCache. Puede encontrar esta información en el mensaje de error. Por ejemplo, en el siguiente error, el valor no válido que se ha usado para el elemento <CacheLookupTimeoutInSeconds> es -1:

    CacheLookupTimeoutInSeconds -1 value should be greater than zero.

  2. Examina todas las políticas ResponseCache del proxy de API específico en el que se ha producido el error. Puede haber una o varias políticas ResponseCache en las que se especifique el elemento <CacheLookupTimeoutInSeconds>.

    Por ejemplo, la siguiente configuración de la política asigna el valor <CacheLookupTimeoutInSeconds> a -1, que coincide con lo que aparece en el mensaje de error:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ResponseCache async="false" continueOnError="false" enabled="true" name="Response-Cache-1">
    <DisplayName>Response Cache-1</DisplayName>
    <Properties/>
    <CacheKey>
        <Prefix/>
        <KeyFragment ref="request.uri" type="string"/>
    </CacheKey>
    <Scope>Exclusive</Scope>
    <ExpirySettings>
        <ExpiryDate/>
        <TimeOfDay/>
        <TimeoutInSec ref="">3600</TimeoutInSec>
    </ExpirySettings>
    <CacheLookupTimeoutInSeconds>-1</CacheLookupTimeoutInSeconds>
</ResponseCache>

  3. Si <CacheLookupTimeoutInSeconds> se especifica como un número entero negativo, ese es el motivo del error.

Resolución

Asegúrate de que el valor del elemento <CacheLookupTimeoutInSeconds> de la política ResponseCache siempre se especifique como un número entero no negativo.

Para corregir la política ResponseCache de ejemplo que se muestra arriba, puede modificar <CacheLookupTimeoutInSeconds> element por 30.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ResponseCache async="false" continueOnError="false" enabled="true" name="Response-Cache-1">
    <DisplayName>Response Cache-1</DisplayName>
    <Properties/>
    <CacheKey>
        <Prefix/>
        <KeyFragment ref="request.uri" type="string"/>
    </CacheKey>
    <Scope>Exclusive</Scope>
    <ExpirySettings>
        <ExpiryDate/>
        <TimeOfDay/>
        <TimeoutInSec ref="">3600</TimeoutInSec>
    </ExpirySettings>
    <CacheLookupTimeoutInSeconds>30</CacheLookupTimeoutInSeconds>
</ResponseCache>

InvalidCacheResourceReference

Mensaje de error

La implementación del proxy de API a través de la interfaz de usuario o la API de Apigee falla y se muestra este mensaje de error:

Error Deploying Revision revision_number to environment
Invalid cache resource reference cache_resource in Step definition response_cache_policy_name. Context Revision:revision_number;APIProxy:ResponseCache;Organization:organization;Environment:environment

Ejemplo de mensaje de error

Error Deploying Revision 2 to prod
Invalid cache resource reference itemscache in Step definition ItemsResponseCache. Context Revision:2;APIProxy:StoresInventory;Organization:kkalckstein-eval;Environment:prod

Captura de pantalla de ejemplo de error

Error al implementar la revisión 2 en producción.

Causa

Este error se produce si el elemento <CacheResource> de una política ResponseCache se asigna a un nombre que no existe en el entorno en el que se está implementando el proxy de API.

Diagnóstico

  1. Identifica la caché no válida que se ha usado en el elemento <CacheResource> de la política de caché de respuesta y el entorno en el que se ha producido el error. Puedes encontrar ambos elementos en el mensaje de error. Por ejemplo, en el siguiente error, el nombre de la caché no válida es itemscache y el nombre del entorno es prod.

    Invalid cache resource reference itemscache in Step definition ItemsResponseCache. Context Revision:2;APIProxy:StoresInventory;Organization:kkalckstein-eval;Environment:prod

  2. Examina todas las políticas ResponseCache del proxy de API específico en el que se ha producido el error. Identifica la política ResponseCache específica en la que se especifica la caché no válida (identificada en el paso 1) en el elemento <CacheResource>.

    Por ejemplo, la siguiente política especifica el valor de <CacheResource> como itemscache, que coincide con lo que aparece en el mensaje de error:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ResponseCache async="false" continueOnError="false" enabled="true" name="ItemsResponseCache">
  <DisplayName>ItemsResponseCache</DisplayName>
  <Properties/>
  <CacheKey>
      <Prefix/>
      <KeyFragment ref="request.uri" type="string"/>
  </CacheKey>
  <CacheResource>itemscache</CacheResource>
  <Scope>Exclusive</Scope>
  <ExpirySettings>
      <ExpiryDate/>
      <TimeOfDay/>
      <TimeoutInSec ref="">3600</TimeoutInSec>
  </ExpirySettings>
  <SkipCacheLookup/>
  <SkipCachePopulation/>
</ResponseCache>

  3. Verifica si la caché (determinada en el paso 2) se ha definido en el entorno específico (identificado en el paso 1).

    En la interfaz de usuario de Apigee, vaya a APIs > Environment Configuration (APIs > Configuración del entorno) y compruebe si la caché existe en la pestaña Caches (Cachés) del entorno específico. Si la caché no existe, esa es la causa del error.

    Por ejemplo, en la captura de pantalla que se muestra a continuación, la caché llamada itemscache no existe.

    Pestaña Cachés de configuración del entorno.

    Como la caché llamada itemscache no está definida en el entorno prod, se muestra el siguiente error:

    Invalid cache resource reference does_not_exist in Step definition Response-Cache-1. Context Revision:2;APIProxy:ResponseCache;Organization:kkalckstein-eval;Environment:prod

Resolución

Asegúrate de que el nombre de la caché especificado en el elemento <CacheResource> se haya creado en el entorno en el que quieras implementar el proxy de API.

ResponseCacheStepAttachmentNotAllowedReq

Mensaje de error

La implementación del proxy de API a través de la interfaz de usuario o la API de Apigee falla y se muestra este mensaje de error:

Error Deploying Revision revision_number to environment
Response cache step definition response_cache_policy_name can not be attached more than once in the request path.

Ejemplo de mensaje de error

Error Deploying Revision 2 to test
Response cache step definition Response-Cache-1 can not be attached more than once in the request path.

Captura de pantalla de ejemplo de error

Error al implementar la revisión 2 en la prueba.

Causa

Este error se produce si la misma política ResponseCache se adjunta a varias rutas de solicitud en cualquier flujo de un proxy de API.

Por ejemplo, si tiene la misma política ResponseCache adjunta en el Preflow de solicitud de los endpoints Proxy y Target, se producirá este error.

Diagnóstico

  1. Identifica el nombre de la política ResponseCache que se ha adjuntado más de una vez. Puede encontrar esta información en el mensaje de error. Por ejemplo, en el siguiente error, el nombre de la política ResponseCache es Response‑Cache‑1.

    Error Deploying Revision 2 to test
Response cache step definition Response-Cache-1 can not be attached more than once in the request path.

  2. Examina todos los flujos de solicitudes de los endpoints de proxy y de destino del proxy de API en los que se ha producido el error. Si se adjunta la misma política ResponseCache a dos o más flujos de solicitudes, ese es el motivo del error.

    En el siguiente ejemplo, la misma política ResponseCache Response-Cache-1 se configura en la ruta de solicitud del flujo previo del punto de conexión de proxy predeterminado y en el flujo previo del punto de conexión de destino predeterminado:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ProxyEndpoint name="default">
    <Description/>
    <FaultRules/>
    <PreFlow name="PreFlow">
        <Request>
            <Step>
                <Name>Response-Cache-1</Name>
            </Step>
        </Request>
    ...
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<TargetEndpoint name="default">
    <Description/>
    <FaultRules/>
    <PreFlow name="PreFlow">
        <Request/>
        <Response/>
    </PreFlow>
    <PostFlow name="PostFlow">
        <Request>
            <Step>
                <Name>Response-Cache-1</Name>
            </Step>
        </Request>
    ...

Resolución

Asegúrate de que una política ResponseCache solo esté asociada a una ruta de solicitud en todos los flujos del proxy de API.

Para corregir el ejemplo que se muestra arriba, elimina la política ResponseCache Response-Cache-1 de uno de los dos flujos de solicitudes.

ResponseCacheStepAttachmentNotAllowedResp

Mensaje de error

La implementación del proxy de API a través de la interfaz de usuario o la API de Apigee falla y se muestra este mensaje de error:

Error Deploying Revision revision_number to environment
Response cache step definition response_cache_policy_name can not be attached more than once in the response path.

Ejemplo de mensaje de error

Error Deploying Revision 2 to test
Response cache step definition Response-Cache-1 can not be attached more than once in the response path.

Captura de pantalla de ejemplo de error

Error al implementar la revisión 2 en la prueba.

Causa

Este error se produce si la misma política ResponseCache se adjunta a varias rutas de respuesta en cualquier flujo de un proxy de API.

Por ejemplo, si tiene la misma política ResponseCache adjunta en el preflujo de respuesta de los endpoints Proxy y Target, se producirá este error.

Diagnóstico

  1. Identifica el nombre de la política ResponseCache que se ha adjuntado más de una vez. Puede encontrar esta información en el mensaje de error. Por ejemplo, en el siguiente error, el nombre de la política ResponseCache es Response-Cache-1.

    Error Deploying Revision 2 to test
Response cache step definition Response-Cache-1 can not be attached more than once in the response path.

  2. Examina todos los flujos de solicitudes de los endpoints de proxy y de destino del proxy de API en los que se ha producido el error. Si se adjunta la misma política ResponseCache a dos o más flujos de respuesta, esa es la causa del error.

    En el siguiente ejemplo, la misma política ResponseCache Response-Cache-1 se configura en la ruta de respuesta de PreFlow del endpoint de proxy predeterminado y en PreFlow del endpoint de destino predeterminado:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ProxyEndpoint name="default">
    <Description/>
    <FaultRules/>
    <PreFlow name="PreFlow">
        <Request>
            <Step>
                <Name>Response-Cache</Name>
            </Step>
        </Request>
        <Response>
            <Step>
                <Name>Response-Cache-1</Name>
            </Step>
        </Response>
    </PreFlow>
    ...
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<TargetEndpoint name="default">
    <Description/>
    <FaultRules/>
    <PreFlow name="PreFlow">
        <Request/>
        <Response/>
    </PreFlow>
    <PostFlow name="PostFlow">
        <Request/>
        <Response>
            <Step>
                <Name>Response-Cache-1</Name>
            </Step>
        </Response>
    </PostFlow>
    ...

Resolución

Asegúrate de que una política ResponseCache solo esté asociada a una ruta de respuesta en todos los flujos del proxy de API.

Para corregir el ejemplo anterior, elimina la política ResponseCache Response-Cache-1 de una de las dos rutas de respuesta.

InvalidMessagePatternForErrorCode

Mensaje de error

La implementación del proxy de API a través de la interfaz de usuario o la API de Apigee falla y se muestra uno de estos mensajes de error:

Error Deploying Revision revision_number to environment
Invalid message pattern found for error code steps.cache.InvalidSkipCacheLookUpCondition.

O

Error Deploying Revision revision_number to environment
Invalid message pattern found for error code steps.cache.InvalidSkipCachePopulationCondition.

Ejemplo de mensaje de error

Error Deploying Revision 2 to prod
Invalid message pattern found for error code steps.cache.InvalidSkipCacheLookUpCondition.

O

Error Deploying Revision 2 to prod
Invalid message pattern found for error code steps.cache.InvalidSkipCachePopulationCondition.

Captura de pantalla de ejemplo de error

Error al implementar la revisión 2 en producción: LookUp.

O

Error al implementar la revisión 2 en producción: población.

Causa

Este error se produce si el elemento <SkipCacheLookup> o <SkipCachePopulation> de una política ResponseCache contiene una condición no válida.

Diagnóstico

  1. Examina todas las políticas ResponseCache del proxy de API en el que se ha producido el error y comprueba si hay alguna política que tenga condiciones especificadas para los elementos <SkipCacheLookup> o <SkipCachePopulation>.

  2. Comprueba si la condición especificada para el elemento <SkipCacheLookup> o <SkipCachePopulation> no es válida. Si es así, esa es la causa del error.

    En el siguiente ejemplo, el elemento <SkipCachePopulation> usa el operador de JavaScript === para comprobar si el valor y el tipo son iguales, lo cual no es válido.

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ResponseCache async="false" continueOnError="false" enabled="true" name="Response-Cache-1">
    <DisplayName>Response Cache-1</DisplayName>
    <Properties/>
    <CacheKey>
        <Prefix/>
        <KeyFragment ref="request.uri" type="string"/>
    </CacheKey>
    <Scope>Exclusive</Scope>
    <ExpirySettings>
        <ExpiryDate/>
        <TimeOfDay/>
        <TimeoutInSec ref="">3600</TimeoutInSec>
    </ExpirySettings>
    <CacheLookupTimeoutInSeconds>2</CacheLookupTimeoutInSeconds>
    <SkipCacheLookup>request.header.bypass-cache === "true"</SkipCacheLookup>
</ResponseCache>

    Como el operador === no es válido, se muestra el siguiente error:

    Invalid message pattern found for error code steps.cache.InvalidSkipCacheLookUpCondition.

Resolución

Asegúrate de que la condición especificada para los elementos <SkipCacheLookup> o <SkipCachePopulation> sea siempre válida.

Para corregir el ejemplo de política ResponseCache que se muestra arriba, puedes modificar el <SkipCacheLookup> para usar el operador =:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ResponseCache async="false" continueOnError="false" enabled="true" name="Response-Cache-1">
    <DisplayName>Response Cache-1</DisplayName>
    <Properties/>
    <CacheKey>
        <Prefix/>
        <KeyFragment ref="request.uri" type="string"/>
    </CacheKey>
    <Scope>Exclusive</Scope>
    <ExpirySettings>
        <ExpiryDate/>
        <TimeOfDay/>
        <TimeoutInSec ref="">3600</TimeoutInSec>
    </ExpirySettings>
    <CacheLookupTimeoutInSeconds>2</CacheLookupTimeoutInSeconds>
    <SkipCacheLookup>request.header.bypass-cache = "true"</SkipCacheLookup>
</ResponseCache>

CacheNotFound

Mensaje de error

Si se despliega un proxy de API a través de la interfaz de usuario o de la API de Apigee, se mostrará un mensaje de error como este y el estado del despliegue del proxy de API se marcará como parcialmente desplegado:

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

Ejemplo de mensaje de error

Error Cache : Response-Cache-1, not found in organization : kkalckstein-eval__prod

Causa

Este error se produce si la caché específica mencionada en el mensaje de error no se ha creado en un componente Message Processor específico.

Resolución

Ponte en contacto con el equipo de Asistencia de Apigee para obtener ayuda.