Solucionar problemas de errores de implementación de la política HTTPModifier

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

InvalidIndex

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 in deployment for environment [environment]
The revision is deployed, but traffic cannot flow.
AssignMessage[policy_name]: index must be greater than zero in [attribute].[index]

Ejemplo de mensaje de error

Error in deployment for environment test.
The revision is deployed, but traffic cannot flow.
HTTPModifier[GenerateStudentsRequest]: index must be greater than zero in id.0

Causa

Si el índice especificado en los elementos <Copy> o <Remove> de la política HTTPModifier es 0 o un número negativo, no se podrá implementar el proxy de API.

Por ejemplo, si envía varios parámetros de consulta con el mismo nombre, puede acceder a ellos como variables de flujo indexadas. Supongamos que quiere transferir los IDs de tres alumnos como parámetros de consulta. Puede hacerlo de la siguiente manera:

https://$EXTERNAL_IP/$PROXY_BASEPATH?school_name=NPS&id=1&id=2&id=3

Supongamos que intentas acceder a estos parámetros de consulta con los números de índice 0, 1 y 2 en la política HTTPModifier de la siguiente manera:

id.0
id.1 and
id.2

En este caso, la implementación del proxy falla porque el índice debe empezar por 1. Esto significa que puede acceder al primer parámetro de consulta "id=1" como "id.1". Para acceder al segundo parámetro de consulta "id=2", debes usar el índice 2, es decir, "id.2". Del mismo modo, para acceder al tercer parámetro de consulta "id=3", puede usar "id.3".

Para obtener más información, consulta la documentación del elemento Copy de la política AssignMessage.

Diagnóstico

  1. Identifica la política HTTPModifier en la que se ha producido el error, el nombre del atributo y el índice no válido. Puedes encontrar todos estos elementos en el mensaje de error. Por ejemplo, en el siguiente error, el nombre de la política es GeneratingGeocodingRequest, el nombre del atributo es id y el índice es 0:

    HTTPModifier[GenerateStudentsRequest]: index must be greater than zero in id.0
    
  2. Verifica que el nombre del atributo y el índice utilizados en el XML de la política HTTPModifier fallida coincidan con el nombre del atributo y el índice identificados en el mensaje de error (paso 1 anterior). Por ejemplo, la siguiente política especifica el atributo id y el índice como 0, que coincide con lo que aparece en el mensaje de error:

    <AssignMessage name="GenerateStudentsRequest">
      <AssignTo createNew="true" type="request">StudentsInfoRequest</AssignTo>
      <Copy source="request">
          <QueryParams>
              <QueryParam name="school_name"/>
              <QueryParam name="id.0"/>
              <QueryParam name="id.1"/>
              <QueryParam name="id.2"/>
          </QueryParams>
      </Copy>
    </AssignMessage>
  3. Si el índice especificado es 0 o un número negativo, esa es la causa del error.

    En el ejemplo de política Asignar mensaje que se muestra arriba, se intenta acceder al primer valor del parámetro de consulta "id" mediante el índice 0. Por lo tanto, el despliegue del proxy de API falla y se produce el siguiente error:

    AssignMessage[GenerateStudentsRequest]: index must be greater than zero in id.0
    

Resolución

En HTTPModifier, cuando acceda a varios encabezados, parámetros de consulta u otros parámetros que compartan el mismo nombre, asegúrese de que el índice sea siempre mayor que cero. Por ejemplo:

<AssignMessage name="GenerateStudentsRequest">
    <AssignTo createNew="true" type="request">StudentsInfoRequest</AssignTo>
    <Copy source="request">
        <QueryParams>
            <QueryParam name="school_name"/>
            <QueryParam name="id.1"/>
            <QueryParam name="id.2"/>
            <QueryParam name="id.3"/>
        </QueryParams>
    </Copy>
</AssignMessage>