มอบหมายการแก้ปัญหาข้อผิดพลาดในการทำให้นโยบายข้อความใช้งานได้

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X
ข้อมูล

InvalidIndex

ข้อความแสดงข้อผิดพลาด

การติดตั้งใช้งานพร็อกซี API ผ่าน Edge UI หรือ Edge Management API ล้มเหลวโดยมีข้อความแสดงข้อผิดพลาดนี้

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.
AssignMessage[GenerateStudentsRequest]: index must be greater than zero in id.0

ภาพหน้าจอตัวอย่าง

สาเหตุ

หากดัชนีที่ระบุในองค์ประกอบ <Copy> และ/หรือ <Remove> ของนโยบาย Assign Message เป็น 0 หรือหมายเลขลบ จะทำให้ใช้งานพร็อกซี API ไม่สำเร็จ

เช่น หากคุณส่งพารามิเตอร์การค้นหาหลายรายการที่มีชื่อเดียวกัน คุณก็สามารถเข้าถึงพารามิเตอร์เหล่านั้นใน Edge ได้ในฐานะตัวแปรขั้นตอนที่จัดทําดัชนี สมมติว่าคุณต้องการส่งรหัสของนักเรียน 3 คนเป็นพารามิเตอร์การค้นหา ก็ทำได้ดังนี้

https://myorg-test.apigee.net/v1/basepath?school_name=NPS&id=1&id=2&id=3

จากนั้น สมมติว่าคุณพยายามเข้าถึงพารามิเตอร์การค้นหาเหล่านี้ด้วยหมายเลขดัชนี 0, 1 และ 2 ในนโยบายกำหนดข้อความ ดังนี้

id.0
id.1 and
id.2

ในกรณีนี้ การทำให้พร็อกซีใช้งานได้จะล้มเหลว เนื่องจากดัชนีต้องเริ่มต้นด้วย 1 ซึ่งหมายความว่า คุณสามารถเข้าถึงพารามิเตอร์การค้นหาแรก "id=1" เป็น "id.1" หากต้องการเข้าถึงพารามิเตอร์การค้นหาที่ 2 "id=2" คุณต้องใช้ดัชนี 2 นั่นคือ "id.2" ในทำนองเดียวกัน หากต้องการเข้าถึงพารามิเตอร์การค้นหาที่ 3 "id=3" คุณสามารถใช้ "id.3"

ลองดูข้อมูลเพิ่มเติมได้ที่นี่

การวินิจฉัย

  1. ระบุนโยบาย "กำหนดข้อความ" ที่เกิดข้อผิดพลาด ชื่อแอตทริบิวต์ และดัชนีที่ไม่ถูกต้อง คุณจะพบรายการเหล่านี้ทั้งหมดในข้อความแสดงข้อผิดพลาด ตัวอย่างเช่น ในข้อผิดพลาดต่อไปนี้ ชื่อนโยบายคือ GeneratingGeocodingRequest ชื่อของแอตทริบิวต์คือ id และดัชนีคือ 0:

    AssignMessage[GenerateStudentsRequest]: index must be greater than zero in id.0
    
  2. ตรวจสอบว่าชื่อแอตทริบิวต์และดัชนีที่ใช้ใน 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 หรือจำนวนลบ นั่นเป็นสาเหตุของข้อผิดพลาด

    ในตัวอย่างนโยบาย Assign Message ที่แสดงข้างต้น คุณพยายามเข้าถึงค่าแรกของพารามิเตอร์การค้นหา "id" โดยใช้ดัชนี 0 ดังนั้นการทำให้พร็อกซี API ใช้งานได้ไม่สำเร็จโดยมีข้อผิดพลาด:

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

ความละเอียด

ในส่วน "กำหนดข้อความ" เมื่อคุณเข้าถึงส่วนหัว พารามิเตอร์การค้นหา หรือพารามิเตอร์อื่นๆ ที่ใช้ชื่อเดียวกันหลายรายการ โปรดตรวจสอบว่าดัชนีมีค่ามากกว่า 0 เสมอ เช่น

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

InvalidVariableName

ข้อความแสดงข้อผิดพลาด

การติดตั้งใช้งานพร็อกซี API ผ่าน Edge UI หรือ Edge Management API ล้มเหลวโดยมีข้อความแสดงข้อผิดพลาดนี้

Error Saving Revision [revision_number]
The revision is deployed, but traffic cannot flow. AssignMessage schema validation failed: invalid variable name - null - in assign variable.

ตัวอย่างข้อความแสดงข้อผิดพลาด

Error Saving Revision 3
AssignMessage schema validation failed: invalid variable name - null - in assign variable.

ภาพหน้าจอตัวอย่าง

สาเหตุ

หากองค์ประกอบย่อย <Name> ว่างเปล่าหรือไม่ได้ระบุในองค์ประกอบ <AssignVariable> การทำให้พร็อกซี API ใช้งานได้จะไม่สำเร็จเนื่องจากไม่มีชื่อตัวแปรที่ถูกต้องที่จะกำหนดค่า ต้องระบุชื่อตัวแปรที่ถูกต้อง

การวินิจฉัย

ตรวจสอบนโยบาย Assign Message ทั้งหมดในพร็อกซี API ที่เกิดข้อผิดพลาด หากมีนโยบาย Assign Message ที่องค์ประกอบย่อย <Name> ว่างเปล่าหรือไม่ได้ระบุในองค์ประกอบ <AssignVariable> ก็หมายถึงสาเหตุของข้อผิดพลาด

ตัวอย่างที่ 1: นโยบายมอบหมายข้อความต่อไปนี้ไม่ได้กำหนดองค์ประกอบ <Name> ไว้

<AssignMessage async="false" continueOnError="false" enabled="true" name="Assign-Message-1">
    <DisplayName>Assign Message-1</DisplayName>
    <Properties/>
    <AssignVariable>
        <Value>abcd1234</Value>
    </AssignVariable>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
    <AssignTo createNew="true" transport="http" type="request">googleBookReq</AssignTo>
</AssignMessage>

ตัวอย่างที่ 2: นโยบาย "กำหนดข้อความ" ต่อไปนี้มีองค์ประกอบ <Name> ที่ว่างเปล่า

<AssignMessage async="false" continueOnError="false" enabled="true" name="Assign-Message-1">
    <DisplayName>Assign Message-1</DisplayName>
    <Properties/>
    <AssignVariable>
        <Name></Name>
        <Value>abcd1234</Value>
    </AssignVariable>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
    <AssignTo createNew="true" transport="http" type="request">googleBookReq</AssignTo>
</AssignMessage>

ความละเอียด

ตรวจสอบว่ามีการระบุองค์ประกอบย่อย <Name> เสมอและในองค์ประกอบ <AssignVariable> ของนโยบายมอบหมายข้อความ เช่น

<AssignMessage async="false" continueOnError="false" enabled="true" name="Assign-Message-1">
    <DisplayName>Assign Message-1</DisplayName>
    <Properties/>
        <AssignVariable>
        <Name>appSecret</Name>
        <Value>abcd1234</Value>
    </AssignVariable>
    <IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
    <AssignTo createNew="true" transport="http" type="request">googleBookReq</AssignTo>
</AssignMessage>