פתרון בעיות הקשורות לשגיאות בפריסה של מדיניות תוסף היתרונות המרכזיים

כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של Apigee X. מידע

InvalidConnectorInstance

הודעת שגיאה

כשפורסים את ה-API של ה-API דרך ממשק המשתמש של Edge או Edge management API, מוצגת הודעת השגיאה הבאה:

Error Saving Revision revision_number
In policy_name: Connector must not be empty.

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

Error Saving Revision 1
In Extension Callout-1: Connector must not be empty.

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

הודעת שגיאה לא חוקית של מופע מחבר

סיבה

השגיאה הזו מתרחשת אם הרכיב <Connector> במדיניות 'יתרונות מרכזיים של תוסף' חסר או מוגדר בו ערך ריק.

אבחון

  1. מזהים את השם של מדיניות היתרונות המרכזיים בהודעת השגיאה. לדוגמה, בשגיאה הבאה, שם המדיניות של 'יתרונות מרכזיים של תוסף' הוא Extension Callout-1:

    Error Saving Revision 1
In Extension Callout-1: Connector must not be empty

  2. יש לבדוק את ה-XML של המדיניות מסוג 'יתרונות מרכזיים של תוסף' שנכשל ולוודא שהרכיב <Connector> קיים ושאינו ריק. לדוגמה, במדיניות שמתחת לרכיב <Connector> הוא ריק ולא מכיל את שם התוסף:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Extension-Callout-1">
    <DisplayName>Extension Callout-1</DisplayName>
    <Connector></Connector>
    <Action>downloadFile</Action>
    <Input><![CDATA[
         {}
     ]]></Input>
    <Output>context-variable-name</Output>
</ConnectorCallout>

מכיוון שהרכיב <Connector> ריק, הפריסה של שרת ה-proxy ל-API נכשלת.

רזולוציה

יש לוודא שהערך של הרכיב <Connector> במדיניות בנושא יתרונות מרכזיים של תוסף מצוין תמיד, ותואם לשם של התוסף שנוצר בפועל בארגון.

כדי לתקן את הדוגמה של מדיניות היתרונות המרכזיים של תוסף היתרונות המרכזיים שמוצגת למעלה, אפשר להגדיר את הרכיב <Connector> לשם התוסף שקיים בסביבה הספציפית שבה נפרס שרת ה-API של שרת ה-proxy.

כדי לדעת את שם התוסף, אפשר לעבור אל ניהול > תוספים בממשק המשתמש של Edge. השמות של כל התוספים בארגון שלך יוצגו שם. שם התוסף צריך להיות מוגדר ברכיב <Connector>.

הצגת השם של כל התוספים בממשק המשתמש של Edge.

לפניכם דוגמה שבה שם התוסף מוגדר כראוי ברכיב <Connector>:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Extension-Callout-1">
    <DisplayName>Extension Callout-1</DisplayName>
    <Connector>cloud_storage_ext</Connector>
    <Action>downloadFile</Action>
    <Input><![CDATA[
         {}
     ]]></Input>
    <Output>context-variable-name</Output>
</ConnectorCallout>

ConnectorInstanceDoesNotExists

הודעת שגיאה

כשפורסים את ה-API של ה-API דרך ממשק המשתמש של Edge או Edge management API, מוצגת הודעת השגיאה הבאה:

Error Deploying Revision revision_number to environment
In policy_name: Connector <extension_name> does not exist in environment environment.

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

Error Deploying Revision 1 to test
In Extension Callout-1: Connector cloud_storage does not exist in environment test.

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

הודעת שגיאה לגבי מופע המחבר לא קיים

סיבה

השגיאה הזו מתרחשת אם הרכיב <Connector> במדיניות ExtensionExtension מוגדר לשם שלא קיים בסביבה שבה נפרס שרת ה-proxy של ה-API.

אבחון

  1. זהה את שם המדיניות של 'יתרונות מרכזיים של תוסף', את שם התוסף הלא חוקי שבו נעשה שימוש ברכיב <Connector> של המדיניות 'יתרונות מרכזיים של תוסף' ואת הסביבה שבה אירעה השגיאה. תוכלו למצוא את כל הפריטים האלה בהודעת השגיאה.

    לדוגמה, בשגיאה הבאה, שם המדיניות של 'יתרונות מרכזיים של תוסף' הוא Extension Callout-1,invalid שם התוסף הוא cloud_storage ושם הסביבה הוא test:

        Error Deploying Revision 1 to test
    In Extension Callout-1: Connector cloud_storage does not exist in environment test.

  2. יש לבדוק את קובץ ה-XML של המדיניות מסוג 'יתרונות מרכזיים של תוסף' שנכשל ולוודא ששם התוסף שצוין עבור הרכיב <Connector> תואם לשם שמופיע בהודעת השגיאה.

    בדוגמה הזו, שם התוסף שמופיע ברכיב <Connector> הוא cloud_storage:

        <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <ConnectorCallout async="false" continueOnError="true" enabled="true" name="Extension-Callout-1">
        <DisplayName>Extension Callout-1</DisplayName>
        <Connector>cloud_storage</Connector>
        <Action>downloadFile</Action>
        <Input><![CDATA[
             {}
         ]]></Input>
        <Output>context-variable-name</Output>
    </ConnectorCallout>

  3. בודקים אם שם התוסף נוצר בסביבה (נקבע בשלב 1).

    בממשק המשתמש של Edge, עוברים אל ניהול > תוספים ובודקים אם התוסף קיים ושהשם תואם לזה שצוין ברכיב <Connector> במדיניות 'יתרונות מרכזיים של תוסף'.

    בצילום המסך כאן ניתן לראות שהתוסף cloud_storage_ext קיים, אבל הוא לא תואם לרכיב <Connector> שצוין במדיניות לדוגמה של 'יתרונות מרכזיים של תוסף' שמוצגת למעלה:

    הצגת השם של כל התוספים בממשק המשתמש של Edge.

    מכיוון ששם התוסף שצוין באלמנט <Connector> לא קיים, מופיעה שגיאת הפריסה:

    In Extension Callout-1: Connector cloud_storage does not exist in environment test.

רזולוציה

יש לוודא שהתוסף שצוין באלמנט <Connector> במדיניות 'יתרונות מרכזיים של תוסף' נוצר ושהשם צוין כראוי.

במדריך: שימוש בתוספים מוסבר איך ליצור את התוסף.

כדי לתקן את הדוגמה שלמעלה, תקן את השם כך שיתאים לתוסף עצמו:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Extension-Callout-1">
    <DisplayName>Extension Callout-1</DisplayName>
    <Connector>cloud_storage_ext</Connector>
    <Action>downloadFile</Action>
    <Input><![CDATA[
         {}
     ]]></Input>
    <Output>context-variable-name</Output>
</ConnectorCallout>

InvalidAction

הודעת שגיאה

כשפורסים את ה-API של ה-API דרך ממשק המשתמש של Edge או Edge management API, מוצגת הודעת השגיאה הבאה:

Error Saving Revision revision_number
In policy_name: Action must not be empty.

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

Error Saving Revision 1
In Extension Callout-1: Action must not be empty.

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

הודעת השגיאה &#39;פעולה לא חוקית&#39;

סיבה

השגיאה הזו מתרחשת אם הרכיב <Action> במדיניות 'יתרונות מרכזיים של תוסף' חסר או מוגדר בו ערך ריק.

אבחון

  1. מזהים את שם המדיניות של 'יתרונות מרכזיים של תוסף'. המידע הזה מופיע בהודעת השגיאה. לדוגמה, בשגיאה הבאה, שם המדיניות של 'יתרונות מרכזיים של תוסף' הוא Extension Callout-1:

        Error Saving Revision 1
    In Extension Callout-1: Action must not be empty.

  2. יש לבדוק את קובץ ה-XML של המדיניות מסוג 'יתרונות מרכזיים של תוסף' שנכשל ולוודא שהפעולה מצוינת ברכיב <Action>. אם הרכיב <Action> חסר או אם הוא ריק, זו הסיבה לשגיאה.

    בדוגמה הזו, הרכיב <Action> הוא ריק:

        <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <ConnectorCallout async="false" continueOnError="true" enabled="true" name="Extension-Callout-1">
        <DisplayName>Extension Callout-1</DisplayName>
        <Connector>cloud_storage_ext</Connector>
        <Action></Action>
        <Input><![CDATA[
             {}
         ]]></Input>
        <Output>context-variable-name</Output>
    </ConnectorCallout>

רזולוציה

צריך לוודא שהרכיב <Action> תמיד מצוין ואינו ריק במדיניות של תוסף יתרונות מרכזיים.

אפשר לעיין במדריך: שימוש בתוספים לקבלת מידע על יצירת תוסף ואיך להשתמש בו במדיניות עם רכיב <Action> הנכון.

כדי לתקן את הבעיה שלמעלה, יש לציין את הפעולה הנכונה לגבי התוסף:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <ConnectorCallout async="false" continueOnError="true" enabled="true" name="Extension-Callout-1">
    <DisplayName>Extension Callout-1</DisplayName>
    <Connector>cloud_storage_ext</Connector>
    <Action>downloadFile</Action>
    <Input><![CDATA[
         {}
     ]]></Input>
    <Output>context-variable-name</Output>
</ConnectorCallout>

AllowExtensionsInPostClientFlow

הודעת שגיאה

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

Error Deploying Revision revision_number to environment
In policy_name: Policy is not allowed in PostClientFlow.

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

Error Deploying Revision 1 to test
In Extension Callout-1: Policy is not allowed in PostClientFlow.

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

הודעת שגיאה לגבי הרשאה לשימוש בתוספים בזרימת לקוח הפוסט

סיבה

אסור להציג מדיניות 'יתרונות מרכזיים של תוסף' בזרימת PostClient. אם מדיניות ExtensionExtension ממוקמת בזרימת PostClient, הפריסה של שרת ה-Proxy של API נכשלת ושגיאה זו תיכשל.

אבחון

  1. מזהים את שם המדיניות של 'יתרונות מרכזיים של תוסף'. המידע הזה מופיע בהודעת השגיאה. לדוגמה, בשגיאה הבאה, שם המדיניות של 'יתרונות מרכזיים של תוסף' הוא Extension Callout-1:

    In Extension Callout-1: Policy is not allowed in PostClientFlow.

  2. בדיקת כל הזרימה של PostClient בכל נקודות הקצה של שרת ה-proxy הספציפי של ה-API שבו אירעה הכשל. כדאי לעיין במאמר שליטה באופן שבו שרת proxy פועל באמצעות זרימה.

    אם שמת לב שהמדיניות 'יתרונות מרכזיים של תוסף' (שנקבעה בשלב 1) בזרימת PostClient, זו הסיבה לשגיאה.

    לדוגמה, בתהליך הבא של PostClient יש מדיניות ExtensionExtension:

        ...
    <PostClientFlow>
            <Request/>
            <Response>
                <Step>
                    <Name>Extension-Callout-1</Name>
                </Step>
            </Response>
        </PostClientFlow>
    ...

רזולוציה

יש לוודא שהמדיניות ExtensionCallout (הסבר על תוסף יתרונות מרכזיים) לא ממוקמת בזרימת PostClient.

כדי לתקן את הבעיה שצוינה למעלה, עליך להעביר את המדיניות של 'יתרונות מרכזיים של תוסף' לכל תהליך אחר.

...
<PreFlow name="PreFlow">
    <Request/>
    <Response>
        <Step>
            <Name>Extension-Callout-1</Name>
        </Step>
    </Response>
</PreFlow>
...