פתרון בעיות שקשורות לפריסת מדיניות של PythonScript

אתם צופים במסמכי התיעוד של Apigee ושל Apigee Hybrid.
לעיון במסמכי התיעוד של Apigee Edge.

האם המדריך הזה לפתרון בעיות היה שימושי? נשמח לקבל משוב בלחיצה על שליחת משוב .

InvalidResourceUrlFormat

הודעת השגיאה

פריסת proxy ל-API דרך ממשק המשתמש או ה-API של Apigee נכשלת ומוצגת הודעת השגיאה הבאה:

Error Deploying Revision revision_number to environment
Invalid resource url format. Resource url is invalid_URL.

הודעת שגיאה לדוגמה

Error Deploying Revision 2 to prod
Invalid resource url format. Resource url is py:myscript.py.

דוגמה לצילום מסך

מטרה

אם הפורמט של כתובת ה-URL של המשאב שצוינה ברכיב <ResourceURL> או ברכיב <IncludeURL> של מדיניות PythonScript לא תקין, ה-Deployment (פריסה) של proxy ל-API תיכשל.

הפורמט הנכון הוא כמו שמוצג בהמשך:

<ResourceURL>py://file_name.py</ResourceURL>
<IncludeURL>py://file_name.py</IncludeURL>

לדוגמה, אם הרכיב <ResourceURL> מצוין כמו בדוגמה שלמטה, הפריסה של proxy ל-API נכשלת כי הוא לא תואם לתבנית הנדרשת:

<ResourceURL>py:myscript.py</ResourceURL>

אבחון

1. מזהים את פורמט כתובת ה-URL הלא תקין של המשאב שנעשה בו שימוש במדיניות PythonScript. המידע הזה מופיע בהודעת השגיאה. לדוגמה, בשגיאה הבאה, פורמט כתובת ה-URL של המשאב לא תקין: py:myscript.py:

   Invalid resource url format. Resource url is py:myscript.py.

2. בודקים את כל כללי המדיניות של PythonScript ב-API Proxy הספציפי שבו התרחשה הכשל. אם יש מדיניות PythonScript שבה כתובת ה-URL של המשאב שצוינה ברכיב <ResourceURL> או ברכיב <IncludeURL> תואמת לרשומה הלא תקינה שזוהתה בשלב 1 למעלה, אז זו הסיבה לשגיאה.

   לדוגמה, במדיניות הבאה כתובת ה-URL של המשאב היא py:myscript.py, שזהה לכתובת שמופיעה בהודעת השגיאה:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <Script async="false" continueOnError="false" enabled="true" timeLimit="200" name="py-TotalVariable">
       <DisplayName>py-TotalVariable</DisplayName>
       <Properties/>
       <ResourceURL>py:myscript.py</ResourceURL>
   </Script>

   מכיוון שכתובת ה-URL של המשאב מוגדרת כ-py:myscript.py, שהיא לא חוקית, הפריסה של ה-API Proxy נכשלת עם השגיאה:

   Invalid resource url format. Resource url is py:myscript.py.

רזולוציה

מוודאים שפורמט כתובת ה-URL של המשאב שצוין ברכיב <ResourceURL> של מדיניות PythonScript תקין. לדוגמה:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Script async="false" continueOnError="false" enabled="true" timeLimit="200" name="py-TotalVariable">
    <DisplayName>py-TotalVariable</DisplayName>
    <Properties/>
    <ResourceURL>py://myscript.py</ResourceURL>
</Script>

InvalidResourceUrlReference

הודעת השגיאה

פריסת proxy ל-API דרך ממשק המשתמש או ה-API של Apigee נכשלת ומוצגת הודעת השגיאה הבאה:

Error Deploying Revision revision_number to environment
Invalid resource url ref invalid_reference in policy policy_name in org_name

הודעת שגיאה לדוגמה

Error Deploying Revision 2 to prod
Invalid resource url ref py://myscript.py in policy Python_script in myorg

דוגמה לצילום מסך

מטרה

אם הרכיבים <ResourceURL> ו-<IncludeURL> מתייחסים לקובץ PythonScript שלא קיים, ה-Deployment (פריסה) של proxy ל-API תיכשל. אם אתם פורסים חבילת proxy מהמחשב המקומי, קובצי המקור של PythonScript צריכים להיות מאוחסנים בתיקייה /apiproxy/resources/py(בטווח של proxy ל-API).

בממשק המשתמש של Apigee, קובצי המקור של PythonScript מופיעים בקטע Scripts, מתחת ל-py, בחלונית Navigator של עורך ה-proxy ל-API, כמו שמוצג בהמשך:

אפשר גם לאחסן קובצי משאבים במאגרי מידע ברמת הסביבה (לדוגמה, כדי להפוך קוד PythonScript לזמין לכל ה-proxy בסביבה). השגיאה הזו מתרחשת אם לא ניתן למצוא קובצי משאבים שצוינו במדיניות.

אבחון

1. מזהים את מדיניות PythonScript שבה התרחשה השגיאה ואת ההפניה הלא תקינה לכתובת ה-URL של המשאב. המידע הזה מופיע בהודעת השגיאה. לדוגמה, בשגיאה הבאה, שם המדיניות הוא Python_script וההפניה הלא חוקית לכתובת ה-URL של המשאב היא py://myscript.py:

   Invalid resource url ref py://myscript.py in policy Python_script in myorg

2. מוודאים שההפניה לכתובת ה-URL של המשאב שצוינה במדיניות PythonScript שנכשלה תואמת לערך שזוהה בהודעת השגיאה (שלב 1 למעלה). לדוגמה, במדיניות הבאה מצוינת הפניה לכתובת ה-URL של המשאב כ-py://myscript.py, שזהה למה שמופיע בהודעת השגיאה:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <Script async="false" continueOnError="false" enabled="true" name="Python_script">
       <DisplayName>Python-1</DisplayName>
       <Properties/>
       <ResourceURL>py://myscript.py</ResourceURL>
   </Script>

3. בודקים אם הקובץ שזוהה בשלב 1 הוא חלק מחבילת ה-API Proxy הספציפית, או שהוא קיים בהיקף הסביבה.

   1. כדי לבדוק אם הקובץ הוא חלק מחבילת ה-API Proxy הספציפית, פועלים לפי אחד מהשלבים הבאים:
      1. בממשק המשתמש של Apigee, בודקים אם הקובץ נמצא בקטע Scripts של proxy ל-API.
      2. מורידים את חבילת ה-API Proxy ומחפשים אם הקובץ קיים.
   2. אם הקובץ לא נכלל בחבילת ה-API Proxy הספציפית, צריך לבדוק אם הוא קיים ברמת הסביבה. אפשר להשתמש ב-Resource Files API לחקירה הזו.

   אם הקובץ לא קיים ברמת ה-API Proxy או הסביבה, זו הסיבה לשגיאה.

   בדוגמה שלמעלה, שם הקובץ הלא תקין של PythonScript הוא myscript.py. בצילום המסך שלמטה, אפשר לראות שהקובץ שצוין ככתובת URL של משאב במדיניות לא מופיע בקטע Scripts (סקריפטים). בנוסף, הקובץ לא קיים ברמת הסביבה. לכן, פריסת ה-API Proxy נכשלת עם השגיאה:

   Invalid resource url ref py://myscript.py in policy Python_script in myorg

רזולוציה

מוודאים שקבצי PythonScript שצוינו ברכיבי <ResourceURL> ו-<IncludeURL> מתייחסים לקובץ תקין שקיים ברמת ה-API Proxy או הסביבה.

כדי לתקן את מדיניות PythonScript שמוצגת בדוגמה שלמעלה, מוסיפים את הקובץ myscript.py לחבילת ה-API Proxy. בצילום המסך שלמטה אפשר לראות שקבצי PythonScript שצוינו באלמנטים <ResourceURL> ו-<IncludeURL> מוצגים בקטע Scripts של חבילת ה-API Proxy: