כרגע מוצג התיעוד של 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>
במדיניות 'יתרונות מרכזיים של תוסף' חסר או מוגדר בו ערך ריק.
אבחון
מזהים את השם של מדיניות היתרונות המרכזיים בהודעת השגיאה. לדוגמה, בשגיאה הבאה, שם המדיניות של 'יתרונות מרכזיים של תוסף' הוא
Extension Callout-1
:Error Saving Revision 1 In Extension Callout-1: Connector must not be empty
יש לבדוק את ה-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>
.
לפניכם דוגמה שבה שם התוסף מוגדר כראוי ברכיב <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.
אבחון
זהה את שם המדיניות של 'יתרונות מרכזיים של תוסף', את שם התוסף הלא חוקי שבו נעשה שימוש ברכיב
<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.
יש לבדוק את קובץ ה-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>
בודקים אם שם התוסף נוצר בסביבה (נקבע בשלב 1).
בממשק המשתמש של Edge, עוברים אל ניהול > תוספים ובודקים אם התוסף קיים ושהשם תואם לזה שצוין ברכיב
<Connector>
במדיניות 'יתרונות מרכזיים של תוסף'.בצילום המסך כאן ניתן לראות שהתוסף
cloud_storage_ext
קיים, אבל הוא לא תואם לרכיב<Connector>
שצוין במדיניות לדוגמה של 'יתרונות מרכזיים של תוסף' שמוצגת למעלה:מכיוון ששם התוסף שצוין באלמנט
<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.
צילום מסך של שגיאה לדוגמה
סיבה
השגיאה הזו מתרחשת אם הרכיב <Action>
במדיניות 'יתרונות מרכזיים של תוסף' חסר או מוגדר בו ערך ריק.
אבחון
מזהים את שם המדיניות של 'יתרונות מרכזיים של תוסף'. המידע הזה מופיע בהודעת השגיאה. לדוגמה, בשגיאה הבאה, שם המדיניות של 'יתרונות מרכזיים של תוסף' הוא
Extension Callout-1:
Error Saving Revision 1 In Extension Callout-1: Action must not be empty.
יש לבדוק את קובץ ה-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 נכשלת ושגיאה זו תיכשל.
אבחון
מזהים את שם המדיניות של 'יתרונות מרכזיים של תוסף'. המידע הזה מופיע בהודעת השגיאה. לדוגמה, בשגיאה הבאה, שם המדיניות של 'יתרונות מרכזיים של תוסף' הוא
Extension Callout-1:
In Extension Callout-1: Policy is not allowed in PostClientFlow.
בדיקת כל הזרימה של 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> ...