משאב: TlsRoute
TlsRoute מגדיר איך התנועה צריכה להיות מנותבת על סמך SNI ומאפייני L3 תואמים אחרים.
| ייצוג ב-JSON |
|---|
{
"name": string,
"selfLink": string,
"createTime": string,
"updateTime": string,
"description": string,
"rules": [
{
object ( |
| שדות | |
|---|---|
name |
מזהה. השם של משאב ה-TlsRoute. הוא תואם לתבנית |
selfLink |
פלט בלבד. כתובת ה-URL של המשאב הזה, כפי שהוגדרה בשרת |
createTime |
פלט בלבד. חותמת הזמן של מועד יצירת המשאב. השימוש הוא ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: |
updateTime |
פלט בלבד. חותמת הזמן של מועד העדכון של המשאב. השימוש הוא ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: |
description |
זה שינוי אופציונלי. תיאור של המשאב בטקסט חופשי. אורך מקסימלי של 1,024 תווים. |
rules[] |
חובה. כללים שמגדירים איך התנועה מנותבת ומטופלת. צריך לספק לפחות RouteRule אחד. אם יש כמה כללים, הפעולה שתתבצע תהיה הכלל הראשון שתואם. |
meshes[] |
זה שינוי אופציונלי. השדה Meshes מגדיר רשימה של רשתות שירות (mesh) שאליהן מחובר ה-TlsRoute הזה, כאחד מכללי הניתוב לניתוב הבקשות שמטופלות על ידי רשת השירות. כל הפניה לרשת צריכה להתאים לתבנית: ה-Mesh המצורף צריך להיות מסוג SIDECAR |
gateways[] |
זה שינוי אופציונלי. שערי כניסה מגדירים רשימה של שערי כניסה שאליהם מחובר ה-TlsRoute הזה, כאחד מכללי הניתוב לניתוב הבקשות שמטופלות על ידי שער הכניסה. כל הפניה לשער צריכה להתאים לתבנית: |
targetProxies[] |
זה שינוי אופציונלי. TargetProxies מגדיר רשימה של TargetTcpProxies שאליהם מחובר ה-TlsRoute הזה, כאחד מכללי הניתוב לניתוב הבקשות שמטופלות על ידי TargetTcpProxy. כל הפניה ל-TargetTcpProxy צריכה להתאים לתבנית: |
labels |
זה שינוי אופציונלי. קבוצה של תגי תוויות שמשויכים למשאב TlsRoute. אובייקט שמכיל רשימה של זוגות |
RouteRule
מציינת איך להתאים את התנועה ואיך לנתב אותה כשהיא תואמת.
| ייצוג ב-JSON |
|---|
{ "matches": [ { object ( |
| שדות | |
|---|---|
matches[] |
חובה. השדה RouteMatch מגדיר את הפרדיקט שמשמש להתאמת בקשות לפעולה נתונה. כדי לבדוק כמה סוגי התאמה, משתמשים באופרטור הלוגי OR. צריך לספק לפחות RouteMatch אחד. |
action |
חובה. הכלל המפורט שמגדיר איך לנתב תנועה תואמת. |
RouteMatch
השדה RouteMatch מגדיר את הפרדיקט שמשמש להתאמת בקשות לפעולה נתונה. כמה סוגי התאמה משולבים באמצעות לוגיקת AND לצורך הערכה.
| ייצוג ב-JSON |
|---|
{ "sniHost": [ string ], "alpn": [ string ] } |
| שדות | |
|---|---|
sniHost[] |
זה שינוי אופציונלי. SNI (אינדיקטור של שם השרת) להתאמה. ה-SNI יותאם לכל הדומיינים עם התווים הכלליים לחיפוש, כלומר |
alpn[] |
זה שינוי אופציונלי. ALPN (Application-Layer Protocol Negotiation) להתאמה. דוגמאות: "http/1.1", "h2". צריך להזין לפחות אחד מהשדות sniHost ו-alpn. אפשר להגדיר עד 5 פרוטוקולי ALPN בכל ההתאמות. |
RouteAction
המפרטים לניתוב תנועה ולהחלת כללי מדיניות משויכים.
| ייצוג ב-JSON |
|---|
{
"destinations": [
{
object ( |
| שדות | |
|---|---|
destinations[] |
חובה. שירותי היעד שאליהם צריך להעביר את התנועה. צריך לבחור לפחות שירות יעד אחד. |
idleTimeout |
זה שינוי אופציונלי. מציינת את הזמן הקצוב לתפוגה במצב חוסר פעילות של המסלול שנבחר. זמן קצוב לתפוגה במצב חוסר פעילות מוגדר כפרק הזמן שבו לא נשלחים או מתקבלים בייטים בחיבור במעלה הזרם או במורד הזרם. אם לא מגדירים את המדיניות, ברירת המחדל של זמן הקצוב לתפוגה במצב חוסר פעילות היא שעה אחת. אם מגדירים את הערך 0s, הזמן הקצוב לתפוגה מושבת. משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-" |
RouteDestination
תארו את היעד שאליו תנותב התנועה.
| ייצוג ב-JSON |
|---|
{ "serviceName": string, "weight": integer } |
| שדות | |
|---|---|
serviceName |
חובה. כתובת ה-URL של BackendService שאליה תנותב התנועה. |
weight |
זה שינוי אופציונלי. מציין את שיעור הבקשות שמועברות לקצה העורפי שאליו מתייחס השדה serviceName. החישוב מתבצע באופן הבא: - משקל/סכום(משקלים ביעדים). סכום המשקלים בכל היעדים לא צריך להיות 100. |
Methods |
|
|---|---|
|
יצירת TlsRoute חדש בפרויקט ובמיקום נתונים. |
|
מחיקה של TlsRoute אחד. |
|
אחזור פרטים של TlsRoute יחיד. |
|
הצגת רשימה של TlsRoute בפרויקט ובמיקום נתונים. |
|
עדכון הפרמטרים של TlsRoute יחיד. |
|
מגדירה את מדיניות בקרת הגישה במשאב שצוין. |
|
הפונקציה מחזירה את ההרשאות שיש לפונקציית קריאה חוזרת (caller) במשאב שצוין. |