解決 HTTPModifier 政策部署錯誤問題

您目前查看的是 Apigee X 說明文件。
查看 Apigee Edge 說明文件。

InvalidIndex

錯誤訊息

透過 Apigee 使用者介面或 API 部署 API Proxy 時失敗，並顯示以下錯誤訊息：

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]

錯誤訊息範例

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

原因

如果 HTTPModifier 政策的 <Copy> 和/或 <Remove> 元素中指定的索引為 0 或負數，API Proxy 的部署作業就會失敗。

舉例來說，如果您傳遞多個同名的查詢參數，可以將這些參數做為編列索引的流程變數存取。假設您想以查詢參數的形式傳遞 3 位學生的 ID，可以按照下列方式操作：

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

假設您嘗試在 HTTPModifier 政策中，使用索引編號 0、1 和 2 存取這些查詢參數，如下所示：

id.0
id.1 and
id.2

在本例中，由於索引必須從 1 開始，因此 Proxy 部署作業會失敗。也就是說，您可以將第一個查詢參數「id=1」存取為「id.1」。如要存取第二個查詢參數「id=2」，您需要使用索引 2，也就是「id.2」。同樣地，如要存取第三個查詢參數「id=3」，可以使用「id.3」。

詳情請參閱「AssignMessage 政策的 Copy 元素說明文件」。

診斷

  1. 找出發生錯誤的 HTTPModifier 政策、屬性名稱和無效索引。您可以在錯誤訊息中找到所有這些項目。舉例來說，在下列錯誤中，政策名稱為 GeneratingGeocodingRequest，屬性名稱為 id，索引為 0：

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

  2. 確認失敗的 HTTPModifier 政策 XML 中使用的屬性名稱和索引，與錯誤訊息中識別的屬性名稱和索引 (上述步驟 1) 相符。舉例來說，下列政策會將屬性 id 和索引指定為 0，與錯誤訊息中的內容相符：

    <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. 如果指定的索引為 0 或負數，就會導致錯誤。

    在上述「指派訊息」政策範例中，您嘗試使用索引 0 存取查詢參數「id」的第一個值。因此，API Proxy 部署作業會失敗，並顯示下列錯誤：

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

解析度

在 HTTPModifier 中，當您存取多個共用相同名稱的標頭、查詢參數或其他參數時，請確保索引一律大於零。例如：

<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>