הסבר על משתני זרימה

מוצג המסמך של Apigee Edge.
עוברים אל מסמכי תיעוד של Apigee X.
מידע

קטע זה מספק מידע שימושי על משתני הזרימה.

Apigee Edge מגדיר את משתני הזרימה הבאים:

apigee              loadbalancing        router
apiproxy            message              servicecallout
application         messageid            system
client              organization         target
current             proxy                variable
environment         request              virtualhost
error               response
is                  route

כל אחד מהמשתנים האלה מתואר בסעיפים הבאים.

apigee

משתנה עזר שמספק מידע על זמן הביצוע של המדיניות.

בטבלה הבאה מתוארים המאפיינים של המשתנה apigee:

נכס סוג קריאה/כתיבה תיאור ההיקף מתחיל
apigee.metrics.policy.policy_name.timeTaken מספר שלם קריאה בלבד הזמן (בננו-שניות) שנדרש להפעלת המדיניות. מדיניות

apiproxy

מתאר את שרת ה-proxy ל-API.

בטבלה הבאה מתוארים המאפיינים של המשתנה apiproxy:

נכס סוג קריאה/כתיבה תיאור ההיקף מתחיל
apiproxy.name מחרוזת קריאה בלבד השם של ה-Proxy ל-API. לדוגמה, 'שרת ה-Proxy שלי'. בקשה לשרת proxy
apiproxy.revision מחרוזת קריאה בלבד מספר הגרסה של שרת proxy ל-API. לדוגמה, '6'. בקשה לשרת proxy

למידע נוסף על עבודה עם שרתי proxy ל-API: הבנת ממשקי API ממשקי proxy ל-API.

application

מאגר של המאפיין application.basepath.

בטבלה הבאה מתוארים המאפיינים של המשתנה application:

נכס סוג קריאה/כתיבה תיאור ההיקף מתחיל
application.basepath מחרוזת קריאה בלבד הנתיב הבסיסי לפריסה (מצוין במהלך פריסת ה-API). בקשה לשרת proxy

client

האפליקציה או המערכת ששלחו את הבקשה לנתב Edge.

בטבלה הבאה מתוארים המאפיינים של המשתנה client:

נכס סוג קריאה/כתיבה תיאור ההיקף מתחיל
client.cn מחרוזת קריאה בלבד

השם הנפוץ שצוין באישור ה-TLS/SSL שמוצג על ידי אפליקציית הלקוח.

בקשה לשרת proxy
client.country מחרוזת קריאה בלבד

המדינה באישור ה-TLS/SSL שמוצג על ידי אפליקציית הלקוח.

בקשה לשרת proxy
client.email.address מחרוזת קריאה בלבד

כתובת האימייל באישור ה-TLS/SSL שמוצג על ידי אפליקציית הלקוח.

בקשה לשרת proxy
client.host מחרוזת קריאה בלבד

כתובת ה-IP של מארח ה-HTTP שמשויכת לבקשה שהתקבלה ב-ProxyEndpoint.

בקשה לשרת proxy
client.ip מחרוזת קריאה בלבד

כתובת ה-IP של הלקוח או המערכת ששלחו את ההודעה לנתב Edge. עבור לדוגמה, זו יכולה להיות כתובת ה-IP המקורית של הלקוח או כתובת ה-IP של מאזן עומסים.

בקשה לשרת proxy
client.locality מחרוזת קריאה בלבד

הרשות המוניציפאלית (עיר) באישור ה-TLS/SSL שמוצג על ידי הלקוח.

בקשה לשרת proxy
client.organization מחרוזת קריאה בלבד הארגון באישור ה-TLS/SSL שמוצג על ידי הלקוח. (לא בהכרח מקבילה לארגון ב-Apigee Edge). בקשה לשרת proxy
client.organization.unit מחרוזת קריאה בלבד

היחידה הארגונית באישור ה-TLS/SSL שמוצג על ידי הלקוח.

בקשה לשרת proxy
client.port מספר שלם קריאה בלבד

יציאת ה-HTTP שמשויכת לבקשת הלקוח המקורית אל ProxyEndpoint.

בקשה לשרת proxy
client.received.end.time מחרוזת קריאה בלבד

השעה, במחרוזת, שבה שרת ה-proxy סיים לקבל את הבקשה מהלקוח המקורי ב-ProxyEndpoint. לדוגמה: יום רביעי, 21 באוגוסט 2013 19:16:47 שעון UTC.

ערך הזמן הזה הוא הייצוג של המחרוזת של חותמת הזמן המתאימה של 32 ביט. quantity. לדוגמה, 'יום רביעי, 21 באוגוסט 2013 19:16:47 UTC' תואם לערך של חותמת הזמן של 1377112607413.

בקשה לשרת proxy
client.received.end.timestamp ארוך קריאה בלבד

ערך חותמת הזמן שמציין מתי שרת ה-proxy סיים לקבל את הבקשה הלקוח המקורי ב-ProxyEndpoint. הערך הזה הוא מספר שלם באורך 64 ביט (ארוך) שמכיל מספר אלפיות השנייה שחלפו מאז חצות, ב-1 בינואר 1970 (שעון UTC).

בקשה לשרת proxy
client.received.start.time מחרוזת קריאה בלבד

השעה, במחרוזת, שבה שרת ה-proxy התחיל לקבל את הבקשה מהלקוח המקורי ב-ProxyEndpoint. לדוגמה: יום רביעי, 21 באוגוסט 2013 19:16:47 שעון UTC

ערך הזמן הזה הוא הייצוג של המחרוזת של חותמת הזמן המתאימה של 32 ביט. quantity. לדוגמה, 'יום רביעי, 21 באוגוסט 2013 19:16:47 UTC' תואם לערך של חותמת הזמן של 1377112607413.

בקשה לשרת proxy
client.received.start.timestamp ארוך קריאה בלבד

ערך חותמת הזמן שמציין מתי שרת ה-proxy התחיל לקבל את הבקשה מ- הלקוח המקורי ב-ProxyEndpoint. הערך הזה הוא מספר שלם באורך 64 ביט (ארוך) שמכיל מספר אלפיות השנייה שחלפו מאז חצות, ב-1 בינואר 1970 (שעון UTC).

בקשה לשרת proxy
client.scheme מחרוזת קריאה בלבד

הפונקציה מחזירה http או https, בהתאם לתעבורה המשמשת את אפליקציית הלקוח לשליחת עם הודעת הבקשה.

בקשה לשרת proxy
client.sent.end.time מחרוזת קריאה בלבד

השעה, במחרוזת, שבה שרת ה-proxy סיים לשלוח את התגובה מ-ProxyEndpoint ללקוח. לדוגמה: 'יום רביעי, 21 באוגוסט 2013 19:16:47 UTC'.

הערך הזה הוא ייצוג מחרוזת של הנתונים התואמים של 32 סיביות client.sent.end.timestamp לדוגמה, 'יום רביעי, 21 באוגוסט 2013 19:16:47 UTC' תואם לערך חותמת הזמן של 1377112607413.

PostClientFlow
client.sent.end.timestamp ארוך קריאה בלבד ערך חותמת הזמן שמציין מתי ProxyEndpoint סיים להחזיר את התגובה לאפליקציית הלקוח המקורית. הערך הזה הוא מספר שלם באורך 64 ביט (ארוך) שמכיל את הפונקציה מספר אלפיות השנייה שחלפו מאז חצות, ב-1 בינואר 1970 (שעון UTC). PostClientFlow
client.sent.start.time מחרוזת קריאה בלבד השעה, מבוטאת במחרוזת, שבה נקודת ה-ProxyEndpoint התחילה להחזיר את התגובה לאפליקציית הלקוח המקורית. לדוגמה, "יום רביעי, 21 באוגוסט 2013 19:16:47 UTC".

הערך הזה הוא ייצוג מחרוזת של הנתונים התואמים של 32 סיביות client.sent.start.timestamp לדוגמה, 'יום רביעי, 21 באוגוסט 2013 19:16:47 UTC' תואם לערך חותמת הזמן של 1377112607413.

PostClientFlow
client.sent.start.timestamp ארוך קריאה בלבד כששרת ה-proxy התחיל לשלוח את התגובה ללקוח מ-ProxyEndpoint. הזה מבוטאת כמספר שלם בן 64 ביט (ארוך) שמכיל את מספר אלפיות השנייה עבר מאז חצות, ב-1 בינואר 1970 לפי שעון UTC. PostClientFlow
client.ssl.enabled מחרוזת קריאה בלבד

"true" אם ProxyEndpoint מוגדר ל-TLS/SSL; אחרת הוא 'FALSE'.

בקשה לשרת proxy
client.state מחרוזת קריאה בלבד

המצב באישור ה-TLS/SSL שמוצג על ידי הלקוח.

בקשה לשרת proxy

current

מכיל מידע על הזרימה הנוכחית של שרת ה-proxy ל-API.

בטבלה הבאה מתוארים המאפיינים של המשתנה current:

נכס סוג קריאה/כתיבה תיאור ההיקף מתחיל
current.flow.name מחרוזת קריאה בלבד שם התהליך המתבצע כרגע (כגון "PreFlow", "PostFlow" או השם של התהליך המותנה). בקשה לשרת proxy
current.flow.description מחרוזת קריאה בלבד תיאור התהליך שרץ כרגע. היא זהה לזו של הרכיב <Description> בתצורת ה-XML של הזרימה. בקשה לשרת proxy

אפשר לראות את המאפיינים האלה בתצוגת 'מעקב' בממשק המשתמש של Edge. עם זאת, המאפיינים האלו לא גלוי כברירת מחדל בתצוגת 'מעקב' של ממשק המשתמש הקלאסי.

environment

מאגר של המאפיין environment.name.

בטבלה הבאה מתוארים המאפיינים של המשתנה environment:

נכס סוג קריאה/כתיבה תיאור ההיקף מתחיל
environment.name מחרוזת קריאה בלבד שם הסביבה שבה העסקה פעלה. בקשה לשרת proxy

error

אובייקט הקשרי שמייצג הודעת שגיאה תהליך שגיאות.

בטבלה הבאה מתוארים המאפיינים של המשתנה error:

נכס סוג קריאה/כתיבה תיאור ההיקף מתחיל
error message קריאה/כתיבה שגיאה מסוג message, שהיא אובייקט לפי הקשר בתהליך השגיאה. שגיאה
error.content מחרוזת קריאה/כתיבה תוכן השגיאה. שגיאה
error.message מחרוזת קריאה בלבד

הודעה המשויכת לשגיאה, שהערך שלה זמין רק לפני זרימת השגיאה מבוצעת.

שגיאה
error.status.code מספר שלם קריאה בלבד

קוד מצב ה-HTTP שמשויך לשגיאה. לדוגמה, '400'.

שגיאה
error.reason.phrase מחרוזת קריאה בלבד

ביטוי הסיבה שמשויך לשגיאה. לדוגמה: 'בקשה שגויה'.

שגיאה
error.transport.message TransportMessage קריאה בלבד

כל שגיאה מסוג TransportMessage.

שגיאה
error.state מספר שלם קריאה בלבד

המצב בתהליך שבו אירעה שגיאה.

שגיאה
error.header.header_name מחרוזת קריאה/כתיבה

מקבלים או מגדירים את כותרת התשובה.

שגיאה

fault

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

נכס סוג קריאה/כתיבה תיאור ההיקף מתחיל
fault.fault_name מחרוזת קריאה בלבד fault_name הוא שם השגיאה, כפי שמתואר בטבלה שגיאות זמן ריצה שכלולות בכל אחד מנושאי ההפניה למדיניות. שגיאה

is

מאגר של המאפיין is.error.

בטבלה הבאה מתוארים המאפיינים של המשתנה is:

נכס סוג קריאה/כתיבה תיאור ההיקף מתחיל
is.error בוליאני קריאה בלבד

סימון שגיאה.

בקשה לשרת proxy

loadbalancing

מספקת מידע על סטטוס איזון העומסים של נקודת הקצה (TargetEndpoint).

בטבלה הבאה מתוארים המאפיינים של המשתנה loadbalancing:

נכס סוג קריאה/כתיבה תיאור ההיקף מתחיל
loadbalancing.failedservers Array of Strings קריאה בלבד

רשימה של שרתי TargetServer שנכשלו במהלך איזון העומסים ב-TargetEndpoint.

יעד תגובה
loadbalancing.isfallback בוליאני קריאה בלבד

"true" אם החלופה מופעלת עבור TargetServer שמופעל במהלך איזון העומסים ב-TargetEndpoint.

יעד תגובה
loadbalancing.targetserver מחרוזת קריאה בלבד

TargetServer הופעל במהלך איזון העומסים ב-TargetEndpoint. יש להגדיר רק אם הרכיב <Path> מוגדר בזמן הגדרת רכיב מאזן העומסים.

יעד תגובה

message

אובייקט לפי הקשר, עם ערך זהה לזה של request בתהליך הבקשה או כ-response בתהליך התשובה או כ-error בשגיאה .

בטבלה הבאה מתוארים המאפיינים של המשתנה message:

נכס סוג קריאה/כתיבה תיאור ההיקף מתחיל
message message קריאה/כתיבה

אובייקט לפי הקשר, עם ערך זהה ל-request בתהליך הבקשה או כ-response בתהליך התשובה או כ-error בשגיאה .

בקשה לשרת proxy
message.content מחרוזת קריאה/כתיבה

התוכן של הבקשה, התגובה או הודעת השגיאה.

בקשה לשרת proxy
message.formparam.param_name מחרוזת קריאה/כתיבה

הערך של פרמטר הטופס שצוין.

בקשה לשרת proxy
message.formparam.param_name.
 values
אוסף קריאה בלבד

כל הערכים של פרמטר הטופס שצוין בהודעה.

בקשה לשרת proxy
message.formparam.param_name.
 values.count
מספר שלם קריאה בלבד

ספירת הערכים של הפרמטרים שצוינו בטופס בהודעה./p>

בקשה לשרת proxy
message.formparams.count מספר שלם קריאה בלבד

ספירת כל הפרמטרים של הטופס בהודעה.

בקשה לשרת proxy
message.formparams.names אוסף קריאה בלבד

הערך של כל הפרמטרים של הטופס בהודעה.

בקשה לשרת proxy
message.formstring מחרוזת קריאה בלבד

הערך של מחרוזת הטופס בהודעה.

בקשה לשרת proxy
message.header.header_name מחרוזת קריאה/כתיבה

מקבל או מגדיר את הערך של כותרת ה-HTTP שצוינה בהודעה. אם הכותרת מכיל פסיק. בזמן הקריאה יתקבל רק קטע של הטקסט עד פסיק. כדי לקבל את הכותרת המלאה, אפשר להשתמש בטופס request.header.header_name.
 values

בקשה לשרת proxy
message.header.header_name.N מחרוזת קריאה/כתיבה

ערך הכותרת הספציפית N בהודעה, או בקשה או בהתאם למצב הזרימה. Apigee Edge מפצלת את ערכי הטקסט של הכותרת לפי פסיקים. שימו לב שהאינדקס שהערך שלו משמש ל-N מבוסס על 1 ולא על 0.

לדוגמה: אם הכותרת של Cache-control היא "public,maxage=16544", אז הערך המוחזר של message.header.cache-control.1 הוא 'maxage=16544'.

בקשה לשרת proxy
message.header.header_name.
 values
אוסף קריאה בלבד

כל הערכים של שם כותרת ה-HTTP שצוין בהודעה.

בקשה לשרת proxy
message.header.header_name.
 values.count
מספר שלם קריאה בלבד

ספירת הערכים של שם כותרת ה-HTTP שצוין בהודעה.

בקשה לשרת proxy
message.headers.count מספר שלם קריאה בלבד

ספירה של כל כותרות ה-HTTP בהודעה.

בקשה לשרת proxy
message.headers.names אוסף קריאה בלבד

הערך של כל כותרות ה-HTTP בהודעה

בקשה לשרת proxy
message.path מחרוזת קריאה/כתיבה

נתיב ההודעה המלא של הבקשה בכתובת ה-URL, לא כולל פרמטרים של שאילתה.

בקשה לשרת proxy
message.queryparam.param_name מחרוזת קריאה בלבד

הפונקציה מחזירה את הפרמטר שצוין של שאילתת ההודעה.

בקשה לשרת proxy
message.queryparam.param_name.N מחרוזת קריאה/כתיבה

הערך של פרמטר השאילתה Nth בהודעה. לדוגמה, אם request.querystring הוא 'a=hello&a=world', ואז הערך המוחזר של message.queryparam.a.1 הוא "שלום".

דוגמה לכתיבת ערכים מרובים לשם פרמטר של שאילתה אחת, כמו "type=siteid:1&type=language:us-en&type=currency:USD", מגדירים את הדברים הבאים:

  • message.queryparam.type.1 ל-"siteid:1"
  • message.queryparam.type.2 ל-"language:en-us"
  • message.queryparam.type.3 ל-"currency:USD"
בקשה לשרת proxy
message.queryparam.param_name.
 values
אוסף קריאה בלבד

כל הערכים של פרמטר שאילתה מסוים בהודעה, בפורמט של רשימה מופרדת בפסיקים.

לדוגמה, אם מחרוזת השאילתה היא a=hello&a=world, הערך של message.queryparam.a.values הוא "['hello', 'world']".

בקשה לשרת proxy
message.queryparam.param_name.
 values.count
מספר שלם קריאה בלבד

המספר הכולל של פרמטר שאילתה שצוין המשויך לבקשה שנשלחה אל ProxyEndpoint מאפליקציית הלקוח.

בקשה לשרת proxy
message.queryparams.count מספר שלם קריאה בלבד

המספר הכולל של כל הפרמטרים של השאילתות שמשויכים לבקשה שנשלחה אל ProxyEndpoint מאפליקציית הלקוח.

בקשה לשרת proxy
message.queryparams.names אוסף קריאה בלבד

רשימה של כל שמות הפרמטרים של השאילתות שמשויכים לבקשה שנשלחה אל ProxyEndpoint מאפליקציית הלקוח.

כדי לבצע איטרציה לשמות הפרמטרים של השאילתות באמצעות JavaScript, ראו את Apigee הבאה פוסט לקהילה: איך אפשר לחזור על איסוף מ-"request.queryparams.names" ב-JS? בקהילת Apigee.

בקשה לשרת proxy
message.querystring מחרוזת קריאה בלבד

מחרוזת שמכילה את כל השמות והערכים של הפרמטרים של השאילתה שמשויכים לבקשה נשלחה אל ProxyEndpoint מאפליקציית הלקוח.

לדוגמה, לבקשה "http://api.apiעובד.com/inventors?name=nick&surname=danger", הערך של message.querystring הוא 'name=nick&surname=danger'.

בקשה לשרת proxy
message.reason.phrase מחרוזת קריאה בלבד

הסיבה לביטוי של הודעת התשובה מהיעד.

יעד תגובה
message.status.code מספר שלם קריאה בלבד

קוד מצב ה-HTTP של הודעת התגובה מהיעד.

יעד תגובה
message.transport.message TransportMessage קריאה בלבד

הודעה מסוג TransportMessage, אובייקט לפי הקשר.

בקשה לשרת proxy
message.uri מחרוזת קריאה בלבד

נתיב ה-URI המלא (אחרי כתובת ה-URL של הדומיין), כולל פרמטרים של שאילתה.

לדוגמה, עבור הבקשה "http://api.apiprocess.com/inventors?name=nikola&surname=tesla", המשתנה הזה מחזיר 'inventors?name=nikola&surname=tesla'.

בקשה לשרת proxy
message.verb מחרוזת קריאה בלבד

פועל ה-HTTP (GET, PUT, POST, DELETE, וכו') המשויכים לבקשה.

בקשה לשרת proxy
message.version מחרוזת קריאה/כתיבה

גרסת ה-HTTP שמשויכת לבקשה שנשלחה ל-ProxyEndpoint מהלקוח תרגום מכונה.

בקשה לשרת proxy

למידע נוסף על הודעות: הסבר על פונקציות של תבניות להודעות

messageid

מאגר של המזהה הייחודי הגלובלי של הבקשה.

בטבלה הבאה מתוארים המאפיינים של המשתנה messageid:

נכס סוג קריאה/כתיבה תיאור ההיקף מתחיל
messageid מחרוזת קריאה בלבד

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

המזהה הזה רשום ביומני השגיאות של Edge כדי לבצע קורלציה בין messageid לבין שגיאות.

בקשה לשרת proxy

organization

מאגר של המאפיין organization.name.

בטבלה הבאה מתוארים המאפיינים של המשתנה organization:

נכס סוג קריאה/כתיבה תיאור ההיקף מתחיל
organization.name מחרוזת קריאה בלבד

שם הארגון.

בקשה לשרת proxy

למידע נוסף על ארגונים, ראו הבנה ארגונים.

proxy

הגדרות ה-Proxy ל-API.

בטבלה הבאה מתוארים המאפיינים של המשתנה proxy:

נכס סוג קריאה/כתיבה תיאור ההיקף מתחיל
proxy.basepath מחרוזת קריאה בלבד

הערך של הנתיב הבסיסי בהגדרה של שרת ה-proxy ל-API. הנתיב הבסיסי הוא ה-URI אחרי המארח בכתובת ה-URL. מזהי URI של זרימה מותנית מופיעים אחרי הבסיס נתיב.

בכתובת ה-URL "http://myorg-test.apigee.net/v2/weatherapi/forecastrss?w=12797282":

  • המארח הוא "myorg-test.apigee.net" (כולל השם והסביבה של הארגון)
  • הנתיב הבסיסי הוא ' /v2/weatherapi'

הדרך היחידה לדעת את זה הוא על ידי בדיקת ההגדרה של שרת ה-proxy ל-API או בדיקת הערך של שרת proxy.basepath מותאם אישית. הסיומת של נתיב שרת ה-proxy עוקבת אחר הנתיב הבסיסי ("/forecastrss"), יחד עם פרמטרים של שאילתה.

אם מגדירים נתיב בסיס דינמי בשרת ה-proxy ל-API למשל ' /v2/*/weatherapi', המשתנה הזה מוגדר לנתיב הדינמי ("/v2/*/weatherapi"), למרות שנתיב הבסיס מוביל לערך סטטי, כמו &quot;/v2/foo/weatherapi&quot;.

בקשה לשרת proxy
proxy.client.ip מחרוזת קריאה בלבד

כתובת ה-X-Forwarded-For של השיחה הנכנסת, שהיא כתובת ה-IP ש-Edge התקבל מלחיצת היד החיצונית האחרונה של TCP. זאת יכולה להיות השיחה לקוח או מאזן עומסים.

בקשה לשרת proxy
proxy.name מחרוזת קריאה בלבד

מאפיין השם שהוגדר ל-ProxyEndpoint.

בקשה לשרת proxy
proxy.pathsuffix מחרוזת קריאה בלבד

הערך של סיומת הבסיס של שרת ה-proxy ל-API שנשלח מהלקוח ומתקבל ב- נקודת ה-ProxyEndpoint.

Basepath מוגדר כרכיב הנתיב שמזהה באופן ייחודי את שרת ה-proxy של ה-API. כתובת ה-URL הציבורית של שרת proxy ל-API מורכבת משם הארגון, שבה שרת ה-proxy נפרס, ה-basepath, סיומת הבסיס (basepath) וכל שאילתה .

לדוגמה, בבקשה שנשלחת אל http://myorg-test.apigee.net/v2/weatherapi/forecastrss?w=12797282, הסיומת Basepath היא " /forecastrss".

בקשה לשרת proxy
proxy.url מחרוזת קריאה בלבד

הפונקציה מקבלת את כתובת ה-URL המלאה שמשויכת לבקשת שרת ה-proxy שהתקבלה ב-ProxyEndpoint. כולל כל הפרמטרים הקיימים של השאילתה. המארח של כתובת ה-URL תמיד יהיה localhost אם ה-Proxy מופעל עם <LocalTargetConnection> כדי לבצע שרשורים לשרת proxy.

דוגמה שיוצרת כתובת URL מסוג request על סמך כתובת ה-URL המקורית מארח, ראו הודעות של בקשות גישה.

בקשה לשרת proxy

למידע נוסף על עבודה עם שרתי proxy ל-API: הבנת ממשקי API ממשקי proxy ל-API.

request

הבקשה המלאה, כולל כל המטען הייעודי (Payload) שקיים.

למידע נוסף על נתוני בקשות אפשר לעיין במאמר איך נתוני הבקשה מועברים לשרת העורפי?

בטבלה הבאה מתוארים המאפיינים של המשתנה request:

נכס סוג קריאה/כתיבה תיאור ההיקף מתחיל
request message קריאה בלבד

הבקשה המלאה, כולל כל המטען הייעודי (Payload) שקיים.

בקשה לשרת proxy
request.content מחרוזת קריאה/כתיבה

מקבלת או מגדירה את המטען הייעודי (Payload) של הודעת הבקשה.

בקשה לשרת proxy
request.formparam.param_name מחרוזת קריאה/כתיבה

הפונקציה מקבלת או מגדירה את הערך של פרמטר הטופס שצוין בבקשה שנשלחת מ: את אפליקציית הלקוח.

בקשה לשרת proxy
request.formparam.param_name.
 values
אוסף קריאה בלבד

כל הערכים של פרמטר טופס מסוים בבקשה, בפורמט של רשימה מופרדת בפסיקים.

לדוגמה, אם המטען הייעודי (Payload) הוא "a=hello&x=greeting&a=world", ואז הערך של request.formparam.a.values הוא "['hello', 'world']".

בקשה לשרת proxy
request.formparam.param_name.
 values.count
מספר שלם קריאה בלבד

ספירת כל הערכים עבור פרמטר הטופס שצוין המשויך לבקשה.

בקשה לשרת proxy
request.formparam.param_name.N מחרוזת קריאה/כתיבה

הערך של פרמטר הטופס הספציפי Nth בהודעה. לדוגמה, אם מחרוזת הצורה היא "a=hello&a=world", ואז הערך המוחזר של request.formparam.a.1 הוא "שלום".

בקשה לשרת proxy
request.formparams.count מספר שלם קריאה בלבד

מספר כל הפרמטרים של הטופס שמשויכים לבקשה שנשלחה מהלקוח תרגום מכונה.

בקשה לשרת proxy
request.formparams.names אוסף קריאה בלבד

רשימה של כל שמות הפרמטרים של הטפסים שמשויכים לבקשה.

בקשה לשרת proxy
request.formstring מחרוזת קריאה בלבד

הערך המלא של formparam בבקשה שנשלחה מאפליקציית הלקוח.

לדוגמה, "name=test&type=first&group=A".

בקשה לשרת proxy
request.header.header_name מחרוזת קריאה/כתיבה

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

כדי לקבל את הכותרת המלאה, אפשר להשתמש בטופס request.header.header_name.values

בקשה לשרת proxy
request.header.header_name.N מחרוזת קריאה/כתיבה

הערך של ערך הכותרת המסוים N בבקשה. Apigee Edge מפצלת את ערכי טקסט הכותרת בפסיקים. שימו לב שהאינדקס שהערך שלו משמש ל-N הוא שמבוססים על 1 ולא על 0.

לדוגמה, אם הכותרת Cache-control היא "public, maxage=16544", הערך המוחזר של request.header.cache-control.1 הוא 'maxage=16544'.

בקשה לשרת proxy
request.header.header_name.
 values
אוסף קריאה בלבד

כל הערכים של כותרת מסוימת בבקשה.

בקשה לשרת proxy
request.header.header_name.
 values.count
מספר שלם קריאה בלבד

ספירה של כל הערכים של כותרת מסוימת בבקשה.

בקשה לשרת proxy
request.headers.count מספר שלם קריאה בלבד

ספירה של כל הכותרות בבקשה.

בקשה לשרת proxy
request.headers.names אוסף קריאה בלבד

השמות של כל הכותרות בבקשה.

בקשה לשרת proxy
request.path מחרוזת קריאה בלבד

נתיב המשאב ללא שרת proxy (לא כולל המארח) לשירות לקצה העורפי, בלי פרמטרים של שאילתה.

לדוגמה, ה-URI לשירות לקצה העורפי הוא "https://example.com/rest/api/previous", ואז הערך של request.path הוא /rest/api/previous.

בקשה לשרת proxy
request.queryparam.param_name מחרוזת קריאה/כתיבה

הערך של פרמטר שאילתה מסוים שנמצא בבקשה.

בקשה לשרת proxy
request.queryparam.param_name.N מחרוזת קריאה/כתיבה

הערך של פרמטר השאילתה Nth בבקשה.

לדוגמה, אם request.querystring הוא 'a=hello&a=world', הערך המוחזר הוא request.queryparam.a.1 הוא "שלום".

דוגמה לכתיבת ערכים מרובים לשם פרמטר של שאילתה אחת, כמו "type=siteid:1&type=language:us-en&type=currency:USD", מגדירים את הדברים הבאים:

  • request.queryparam.type.1 ל-"siteid:1"
  • request.queryparam.type.2 ל-"language:en-us"
  • request.queryparam.type.3 ל-"currency:USD"
בקשה לשרת proxy
request.queryparam.param_name.
 values
אוסף קריאה בלבד

כל הערכים של פרמטר שאילתה מסוים בבקשה, בפורמט רשימה מופרדת בפסיקים.

לדוגמה, אם request.querystring הוא "a=hello&b=lovely&a=world", הערך של request.queryparam.a.values הוא "['hello', 'world']".

בקשה לשרת proxy
request.queryparam.param_name.
 values.count
מספר שלם קריאה בלבד

ספירת כל הערכים של פרמטר שאילתה מסוים בבקשה.

בקשה לשרת proxy
request.queryparams.count מספר שלם קריאה בלבד

מספר הפרמטרים של השאילתה בבקשה.

בקשה לשרת proxy
request.queryparams.names אוסף קריאה בלבד

שמות כל הפרמטרים של השאילתה בבקשה.

כדי לבצע איטרציה לשמות הפרמטרים של שאילתות באמצעות JavaScript: איך חוזרים על איסוף מ-"request.queryparams.names" ב-JS? בתוך קהילת Apigee.

בקשה לשרת proxy
request.querystring מחרוזת קריאה בלבד

הרשימה המלאה של הפרמטרים של שאילתות בבקשה שנשלחה מאפליקציית הלקוח.

לדוגמה, אם הבקשה היא "http://host.com/123?name=first&surname=Second&place=address", המשתנה הזה מחזיר 'name=first&surname=second&place=address'.

בקשה לשרת proxy
request.transportid מחרוזת קריאה בלבד

מזהה הבקשה מסוג TransportMessage, שהוא אובייקט הקשרי.

בקשה לשרת proxy
request.transport.message הודעת העברה קריאה בלבד

בקשה מסוג TransportMessage שהוא אובייקט שיתופי.

בקשה לשרת proxy
request.uri מחרוזת קריאה בלבד

ב-proxy ל-API, שרת ה-proxy <BasePath> נמצא ב-ProxyEndpoint (ב- בנוסף לכתובת ה-URL הבסיסית של שרת ה-proxy), ממופה לכתובת ה-URL של שירות היעד נקודת היעד. לדוגמה:

<ProxyEndpoint>
...
  <BasePath>/my-mock-proxy</BasePath>

מפנה אל

<TargetEndpoint>
...
  <HTTPTargetConnection>
    http://mocktarget.apigee.net
  </HTTPTargetConnection>

בבקשה, request.uri הוא הנתיב הבסיסי של שרת ה-proxy + שאר הכתובת, כולל פרמטרים של שאילתה.

בתגובה, request.uri הוא שארית כולל פרמטרים של שאילתה, אחרי HTTPTargetConnection.

הסיבה לכך היא שהבקשה המקורית הגיעה לשרת ה-proxy, אבל שרת ה-proxy שולח בקשה נוספת לשירות היעד.

נניח שהקריאה הבאה נשלחת לשרת ה-Proxy לדוגמה שלנו, שיש לו נתיב בסיס של "/my-mock-proxy":

http://my_org-test.apigee.net/my-mock-proxy/user?user=Dude

וקריאות ה-Proxy:

http://mocktarget.apigee.net

איזה מצרף "/user?user=Dude" לכתובת ה-URL הזו.

  • הבקשה: request.uri = "/my-mock-proxy/user?user=Dude"
  • תשובה: request.uri = "/user?user=Dude"
בקשת Proxy (שונה בתגובה)
request.url מחרוזת קריאה בלבד

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

לדוגמה, אם מבצעים קריאה לשרת proxy לדוגמה "http://my_org-test.apigee.net/my-mock-proxy/user?user=Dude" ונקודת הקצה כיעד הוא "http://example.com:8080", אז הערך הוא:

  • הבקשה: לא זמין
  • תשובה: "http://example.com/user?user=Dude"
יעד תגובה
request.verb מחרוזת קריאה בלבד

פועל ה-HTTP המשמש לבקשה. לדוגמה, GET, PUT ו-DELETE.

בקשה לשרת proxy
request.version מחרוזת קריאה בלבד

גרסת ה-HTTP של הבקשה. לדוגמה, '1.1'.

בקשה לשרת proxy

response

התגובה המלאה, כולל כל המטען הייעודי (Payload) שקיים.

בטבלה הבאה מתוארים המאפיינים של המשתנה response:

נכס סוג קריאה/כתיבה תיאור ההיקף מתחיל
response message קריאה/כתיבה

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

יעד תגובה
response.content מחרוזת קריאה/כתיבה

התוכן של המטען הייעודי (Payload) של הודעת התשובה שהוחזרה על ידי היעד.

יעד תגובה
response.formparam.param_name מחרוזת קריאה/כתיבה

הערך של פרמטר טופס בתגובה.

יעד תגובה
response.formparam.param_name.
 values.count
מספר שלם קריאה בלבד

ספירת כל הערכים של פרמטר הטופס שצוין בתגובה.

יעד תגובה
response.formparams.count מספר שלם קריאה בלבד

מספר הפרמטרים של הטופס בתגובה.

יעד תגובה
response.formparams.names אוסף קריאה בלבד

שמות כל הפרמטרים של הטופס בתגובה.

יעד תגובה
response.header.header_name מחרוזת קריאה/כתיבה

הפונקציה מקבלת או מגדירה את הערך של כותרת HTTP שצוינה בתשובה.

אם טקסט הכותרת כולל פסיק, Apigee Edge מסיקה ערכים מרובים. במקרה הזה, הפונקציה response.header.header_name מחזירה את הערך הראשון בלבד.

כדי לקרוא את הכותרת במלואה, יש להשתמש בטופס response.header.header_name.values.

יעד תגובה
response.header.header_name.
 values
אוסף קריאה בלבד

כל הערכים של כותרת HTTP שצוינה בתגובה.

יעד תגובה
response.header.header_name.
 values.count
מספר שלם קריאה בלבד

ספירה של כל הערכים של כותרת ה-HTTP שצוינה בתגובה.

יעד תגובה
response.header.header_name.N מחרוזת קריאה/כתיבה

הערך של ערך הכותרת המסוים N בתגובה. Apigee Edge מפצלת את ערכי טקסט הכותרת בפסיקים. שימו לב שהאינדקס שהערך שלו משמש ל-N הוא שמבוססים על 1 ולא על 0.

לדוגמה, אם הכותרת Cache-control היא 'public, maxage=16544' ואז חזרה response.header.cache-control.1 'maxage=16544'.

יעד תגובה
response.headers.count מספר שלם קריאה בלבד

ספירה של כל הכותרות בתגובה.

יעד תגובה
response.headers.names אוסף קריאה בלבד

השמות של כל הכותרות בתשובה.

יעד תגובה
response.reason.phrase מחרוזת קריאה/כתיבה

הביטוי של הסיבה לתגובה לבקשה מסוימת.

יעד תגובה
response.status.code מספר שלם קריאה/כתיבה

קוד התגובה שהוחזר לבקשה. אפשר להשתמש במשתנה הזה כדי לשנות את קוד הסטטוס של התשובה, שנשמר ב-message.status.code. לקבלת מידע נוסף, ראה message.

יעד תגובה
response.transport.message מחרוזת קריאה בלבד

תגובה מסוג TransportMessage שהוא אובייקט קונטיקס.

יעד תגובה

route

משמש לציון השמות של <RouteRule> ו-TargetEndpoint.

בטבלה הבאה מתוארים המאפיינים של המשתנה route:

נכס סוג קריאה/כתיבה תיאור ההיקף מתחיל
route.name מחרוזת קריאה בלבד

השם של <RouteRule> שהופעל ב-ProxyEndpoint. לדוגמה, 'ברירת מחדל'. RouteRule מפנה לנקודת יעד של שרת proxy ל-API להפעלה.

בקשת יעד
route.target מחרוזת קריאה בלבד

השם של נקודת הקצה (TargetEndpoint) שבוצעה. לדוגמה: 'ברירת מחדל'.

בקשת יעד

router

מאגר של המאפיין router.uuid, שהוצא משימוש.

בטבלה הבאה מתוארים המאפיינים של המשתנה router:

נכס סוג קריאה/כתיבה תיאור ההיקף מתחיל
router.uuid מחרוזת קריאה בלבד

הוצא משימוש ומחזיר את הערך null. (לשעבר UUID של הנתב שמטפל proxy.)

בקשה לשרת proxy

servicecallout

מיועד לתיאור של נקודת הקצה (TargetEndpoint) של מדיניות ServiceCallout.

בטבלה הבאה מתוארים המאפיינים של המשתנה servicecallout:

נכס סוג קריאה/כתיבה תיאור ההיקף מתחיל
servicecallout.policy_name.expectedcn מחרוזת קריאה/כתיבה

השם המשותף הצפוי של נקודת הקצה (TargetEndpoint) כפי שנקרא המדיניות של ServiceCallout. יש לכך משמעות רק כאשר נקודת היעד (TargetEndpoint) לנקודת קצה של TLS/SSL.

בקשה לשרת proxy
servicecallout.policy_name.target.url מחרוזת קריאה/כתיבה

כתובת ה-URL של נקודת הקצה של מדיניות ServiceCallout ספציפית.

בקשה לשרת proxy
servicecallout.requesturi מחרוזת קריאה/כתיבה

ה-URI של targetEndpoint למדיניות ServiceCallout. ה-URI הוא כתובת URL של נקודת קצה (יעד) ללא הפרוטוקול ומפרט הדומיין.

בקשה לשרת proxy

system

מציין את כתובת ה-IP של המערכת, וכן פרטים על שרת ה-proxy.

בטבלה הבאה מתוארים המאפיינים של המשתנה system:

נכס סוג קריאה/כתיבה תיאור ההיקף מתחיל
system.interface.interface_name מחרוזת קריאה בלבד

כתובת ה-IP של המערכת.

בקשה לשרת proxy
system.pod.name מחרוזת קריאה בלבד

שם ה-Pod שבו פועל שרת ה-Proxy.

בקשה לשרת proxy
system.region.name מחרוזת קריאה בלבד

השם של מרכז הנתונים אזור שבו שרת ה-proxy פועל.

בקשה לשרת proxy
system.time מחרוזת קריאה בלבד

השעה שבה המשתנה הזה נקרא. לדוגמה, "יום רביעי, 21 באוגוסט 2013 19:16:47 UTC".

הערך הזה הוא ייצוג המחרוזת של הערך התואם של system.timestamp לדוגמה, 'יום רביעי, 21 באוגוסט 2013 19:16:47 UTC' תואם ל- חותמת זמן של '1377112607413'.

בקשה לשרת proxy
system.time.year מספר שלם קריאה בלבד

החלק בשנה של system.time.

בקשה לשרת proxy
system.time.month מספר שלם קריאה בלבד

החלק החודשי בsystem.time.

בקשה לשרת proxy
system.time.day מספר שלם קריאה בלבד

החלק של היום בחודש בsystem.time.

בקשה לשרת proxy
system.time.dayofweek מספר שלם קריאה בלבד

החלק של היום בשבוע בsystem.time.

בקשה לשרת proxy
system.time.hour מספר שלם קריאה בלבד

החלק של השעה בsystem.time.

בקשה לשרת proxy
system.time.minute מספר שלם קריאה בלבד

החלק בדקה של system.time.

בקשה לשרת proxy
system.time.second מספר שלם קריאה בלבד

החלק השני מתוך system.time.

בקשה לשרת proxy
system.time.millisecond מספר שלם קריאה בלבד

אלפית השנייה של system.time.

בקשה לשרת proxy
system.time.zone מחרוזת קריאה בלבד

אזור הזמן של המערכת.

בקשה לשרת proxy
system.timestamp ארוך קריאה בלבד

המספר השלם באורך 64 ביט (ארוך) שמייצג את הזמן שבו המשתנה הזה נקרא. הערך הוא מספר אלפיות השנייה שחלפו מאז חצות, ב-1 בינואר 1970 (שעון UTC). לדוגמה, '1534783015000'.

בקשה לשרת proxy
system.uuid מחרוזת קריאה בלבד

המזהה הייחודי של מעבד ההודעות שמטפל בשרת ה-proxy.

בקשה לשרת proxy

target

מתאר את יעד הבקשה.

בטבלה הבאה מתוארים המאפיינים של המשתנה target:

נכס סוג קריאה/כתיבה תיאור ההיקף מתחיל
target.basepath מחרוזת קריאה בלבד

נתיב המשאב (לא כולל הדומיין) לשירות היעד, לא כולל השאילתה שמוגדרים ב-TargetEndpoint של שרת ה-proxy.

לדוגמה, נניח ששרת proxy ל-API קורא ליעד הבא:

<TargetEndpoint name="default">
...
  <HTTPTargetConnection>
    <URL>http://mocktarget.apigee.net/user?user=Dude</URL>
  </HTTPTargetConnection>

בדוגמה הזו, הערך של target.basepath הוא ' /user'.

אם היעד היה:

<TargetEndpoint name="default">
...
  <HTTPTargetConnection>
    <URL>http://mocktarget.apigee.net</URL>
  </HTTPTargetConnection>

הערך target.basepath יהיה null.

בקשת יעד
target.copy.pathsuffix בוליאני קריאה/כתיבה

כשהערך הוא 'TRUE', הבקשה שמועברת מ-ProxyEndpoint ל-TargetEndpoint שומרת את הנתיב סיומת (הקטע של נתיב ה-URI שמופיע אחרי ה-URI המוגדר בבסיס של נקודת הקצה של ProxyEndpoint) ).

בקשת יעד
target.copy.queryparams בוליאני קריאה/כתיבה

כאשר הערך הוא 'TRUE', הבקשה שמועברת מ-ProxyEndpoint ל-TargetEndpoint שומרת את השאילתה .

בקשת יעד
target.country מחרוזת קריאה בלבד

המדינה שבה נמצא אישור ה-TLS/SSL שמוצג על ידי שרת היעד

יעד תגובה
target.cn מחרוזת קריאה בלבד

השם הנפוץ של נקודת היעד. יש לכך משמעות רק כאשר נקודת הקצה (TargetEndpoint) מתייחס לנקודת קצה של TLS/SSL.

בקשת יעד
target.email.address מחרוזת קריאה בלבד

כתובת האימייל של אישור ה-TLS/SSL שמוצג על ידי שרת היעד

יעד תגובה
target.expectedcn מחרוזת קריאה/כתיבה

השם המשותף הצפוי של נקודת הקצה (TargetEndpoint). יש לכך משמעות רק כאשר TargetEndpoint מתייחסת לנקודת קצה (endpoint) של TLS/SSL.

בקשה לשרת proxy
target.host מחרוזת קריאה בלבד

שם הדומיין של שירות היעד שמחזיר את התגובה לשרת ה-proxy ל-API.

יעד תגובה
target.ip מחרוזת קריאה בלבד

כתובת ה-IP של שירות היעד שמחזיר את התגובה לשרת ה-proxy ל-API.

יעד תגובה
target.locality מחרוזת קריאה בלבד

הרשות המוניציפאלית (עיר) של אישור ה-TLS/SSL שמוצג על ידי שרת היעד

יעד תגובה
target.name מחרוזת קריאה בלבד

היעד שאליו ההודעה מגיעה מנקודת היעד.

בקשת יעד
target.organization מחרוזת קריאה בלבד

הארגון של אישור ה-TLS/SSL שמוצג על ידי שרת היעד.

יעד תגובה
target.organization.unit מחרוזת קריאה בלבד

היחידה הארגונית של אישור ה-TLS/SSL שמוצג על ידי שרת היעד.

יעד תגובה
target.port מספר שלם קריאה בלבד

מספר היציאה של שירות היעד שמחזיר את התגובה ל-Proxy ל-API.

יעד תגובה
target.received.end.time מחרוזת קריאה בלבד

השעה, במחרוזת, שבה נקודת הקצה (TargetEndpoint) סיימה לקבל את תגובה מהיעד. לדוגמה, "יום רביעי, 21 באוגוסט 2013 19:16:47 UTC".

ערך הזמן הזה הוא הייצוג של המחרוזת של חותמת הזמן המתאימה של 32 ביט. quantity. לדוגמה, 'יום רביעי, 21 באוגוסט 2013 19:16:47 UTC' תואם לערך של חותמת הזמן של '1377112607413'..

יעד תגובה
target.received.end.
  timestamp
ארוך קריאה בלבד

ערך חותמת הזמן שמציין מתי נקודת היעד (TargetEndpoint) סיימה לקבל את התגובה מהיעד. לדוגמה, '1534783015000'. הערך הזה הוא מספר שלם בפורמט 64 ביט (ארוך) מציין את מספר אלפיות השנייה שחלפו מאז חצות, ב-1 בינואר 1970 (שעון UTC).

יעד תגובה
target.received.start.time מחרוזת קריאה בלבד

השעה, מבוטאת במחרוזת, שבה נקודת היעד (TargetEndpoint) התחילה לקבל את תגובה מהיעד. לדוגמה, "יום רביעי, 21 באוגוסט 2013 19:16:47 UTC".

ערך הזמן הזה הוא הייצוג של המחרוזת של חותמת הזמן המתאימה של 32 ביט. quantity. לדוגמה, 'יום רביעי, 21 באוגוסט 2013 19:16:47 UTC' תואם לערך של חותמת הזמן של '1377112607413'.

יעד תגובה
target.received.start.
  timestamp
ארוך קריאה בלבד

ערך חותמת הזמן שמציין מתי נקודת היעד התחילה לקבל את התגובה מהיעד. לדוגמה, '1534783015000'. הערך הזה הוא מספר שלם בפורמט 64 ביט (ארוך) מציין את מספר אלפיות השנייה שחלפו מאז חצות, ב-1 בינואר 1970 (שעון UTC).

יעד תגובה
target.scheme מחרוזת קריאה בלבד

ההיקף התחיל: יעד תגובה
סוג: String
הרשאה: קריאה/כתיבה

הפונקציה מחזירה http או https, בהתאם להודעת הבקשה.

בקשת יעד
target.sent.end.time מחרוזת קריאה בלבד

השעה, במחרוזת, שבה שרת ה-proxy הפסיק לשלוח את הבקשה אל כתובת ה-URL שצוינה בנקודת הקצה (TargetEndpoint). לדוגמה, "יום רביעי, 21 באוגוסט 2013 19:16:47 UTC".

ערך הזמן הזה הוא הייצוג של המחרוזת של חותמת הזמן המתאימה של 32 ביט. quantity. לדוגמה, 'יום רביעי, 21 באוגוסט 2013 19:16:47 UTC' תואם לערך של חותמת הזמן של '1377112607413'.

בקשת יעד
target.sent.end.timestamp ארוך קריאה בלבד

ערך חותמת הזמן שמציין מתי שרת ה-proxy סיים לשלוח את הבקשה לכתובת ה-URL שצוינו בנקודת הקצה (TargetEndpoint). לדוגמה, "1377112607413". הערך הזה הוא 64-ביט מספר שלם (ארוך) שמכיל את מספר אלפיות השנייה שחלפו מאז חצות, ב-1 בינואר, 1970 UTC.

בקשת יעד
target.sent.start.time מחרוזת קריאה בלבד

השעה, במחרוזת, שבה שרת ה-proxy התחיל לשלוח את הבקשה אל כתובת ה-URL שצוינה בנקודת הקצה (TargetEndpoint). לדוגמה, "יום רביעי, 21 באוגוסט 2013 19:16:47 UTC".

ערך הזמן הזה הוא הייצוג של המחרוזת של חותמת הזמן המתאימה של 32 ביט. quantity. לדוגמה, 'יום רביעי, 21 באוגוסט 2013 19:16:47 UTC' תואם לערך של חותמת הזמן של '1377112607413'.

בקשת יעד
target.sent.start.timestamp ארוך קריאה בלבד

ערך חותמת הזמן שמציין מתי שרת ה-proxy התחיל לשלוח את הבקשה לכתובת ה-URL שצוינו בנקודת הקצה (TargetEndpoint). לדוגמה, '1534783015000'. הערך הזה הוא 64-ביט מספר שלם (long) שמציין את מספר אלפיות השנייה שחלפו מאז חצות, בתאריך 1 בינואר, 1970 (UTC).

בקשת יעד
target.ssl.enabled בוליאני קריאה בלבד

האם TargetEndpoint פועלת ב-TLS/SSL.

בקשה לשרת proxy
target.state מחרוזת קריאה בלבד

המצב של אישור ה-TLS/SSL שמוצג על ידי שרת היעד.

יעד תגובה
target.url מחרוזת קריאה/כתיבה

כתובת ה-URL שהוגדרה בקובץ ה-XML של TargetEndpoint או כתובת ה-URL של היעד הדינמי (אם target.url מוגדר במהלך העברת ההודעה). המשתנה לא כולל רכיבי נתיב נוספים או פרמטרים של שאילתה. פונקציה זו מחזירה ערך null אם קריאה לא נכללת בטווח, או אחרת הוא לא מוגדר.

בקשת יעד

variable

מאגר של המאפיין variable.expectedcn.

בטבלה הבאה מתוארים המאפיינים של המשתנה variable:

נכס סוג קריאה/כתיבה תיאור ההיקף מתחיל
variable.expectedcn מחרוזת קריאה/כתיבה

המשתנה חשוף לשם הנפוץ אם הוא פועל ב-TLS/SSL.

בקשה לשרת proxy

למידע נוסף על עבודה עם TLS, ראו את מבוא ל-TLS/SSL.

virtualhost

מציינת פרטים לגבי המארח הווירטואלי.

בטבלה הבאה מתוארים המאפיינים של המשתנה virtualhost:

נכס סוג קריאה/כתיבה תיאור ההיקף מתחיל
virtualhost.aliases.values Array of Strings קריאה בלבד

כינויי המארח של המארח הווירטואלי שמקבל התאמה במהלך בקשה מסוימת.

בקשה לשרת proxy
virtualhost.name מחרוזת קריאה בלבד

השם של המארח הווירטואלי שממלא את בקשת הלקוח המקורית.

בקשה לשרת proxy
virtualhost.ssl.enabled בוליאני קריאה בלבד

הפונקציה מחזירה את הערך 'true'. אם TLS/SSL מופעל בתצורת המארח הווירטואלי.

בקשה לשרת proxy

למידע נוסף על עבודה עם מארחים וירטואליים, ראו הגדרת מארחים וירטואליים