REST Resource: projects.locations.tlsRoutes

משאב: TlsRoute

‫TlsRoute מגדיר איך לנתב תנועה על סמך SNI ומאפיינים אחרים של התאמה ברמה 3.

ייצוג ב-JSON 
{
  "name": string,
  "selfLink": string,
  "createTime": string,
  "updateTime": string,
  "description": string,
  "rules": [
    {
      object (RouteRule)
    }
  ],
  "meshes": [
    string
  ],
  "gateways": [
    string
  ],
  "labels": {
    string: string,
    ...
  }
}
שדות
name

string

מזהה. השם של משאב TlsRoute. הוא תואם לתבנית projects/*/locations/global/tlsRoutes/tls_route_name>.
createTime

string (Timestamp format)

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

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

פלט בלבד. חותמת הזמן של מועד העדכון של המשאב.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
description

string

זה שינוי אופציונלי. תיאור של המשאב בטקסט חופשי. אורך מקסימלי של 1,024 תווים.
rules[]

object (RouteRule)

חובה. כללים שמגדירים איך התנועה מנותבת ומטופלת. צריך לספק לפחות RouteRule אחד. אם יש כמה כללים, הפעולה שתתבצע תהיה הפעולה של הכלל הראשון שתואם.
meshes[]

string

זה שינוי אופציונלי. השדה Meshes מגדיר רשימה של רשתות שאליהן מצורף TlsRoute הזה, כאחד מכללי הניתוב לניתוב הבקשות שמטופלות על ידי הרשת.

כל הפניה לרשת צריכה להתאים לתבנית: projects/*/locations/global/meshes/<mesh_name>

השגיאה: The attached Mesh should be of a type SIDECAR
gateways[]

string

זה שינוי אופציונלי. השדה Gateways מגדיר רשימה של שערים שאליהם מצורף TlsRoute, כאחד מכללי הניתוב לניתוב הבקשות שמטופלות על ידי השער.

כל הפניה לשער צריכה להתאים לתבנית: projects/*/locations/global/gateways/<gateway_name>
labels

map (key: string, value: string)

זה שינוי אופציונלי. קבוצה של תגי לייבל שמשויכים למשאב TlsRoute.

אובייקט שמכיל רשימה של "key": value זוגות. לדוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

RouteRule

מציינת איך להתאים תנועה ואיך לנתב תנועה כשיש התאמה.

ייצוג ב-JSON 
{
  "matches": [
    {
      object (RouteMatch)
    }
  ],
  "action": {
    object (RouteAction)
  }
}
שדות
matches[]

object (RouteMatch)

חובה. המאפיין RouteMatch מגדיר את התנאי שמשמש להתאמת בקשות לפעולה נתונה. כדי לבצע הערכה, המערכת משתמשת באופרטור OR בין כמה סוגי התאמה. צריך לספק לפחות RouteMatch אחד.
action

object (RouteAction)

חובה. הכלל המפורט שמגדיר איך לנתב תעבורה תואמת.

RouteMatch

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

ייצוג ב-JSON 
{
  "sniHost": [
    string
  ],
  "alpn": [
    string
  ]
}
שדות
sniHost[]

string

זה שינוי אופציונלי. ‫SNI (server name indicator)‎ להתאמה. ה-SNI יותאם לכל הדומיינים עם תו כללי לחיפוש, כלומר www.example.com יותאם קודם ל-www.example.com, אחר כך ל-*.example.com ואז ל-*.com.. אין תמיכה בתווים כלליים לחיפוש חלקיים, וערכים כמו ‎ *w.example.com הם לא חוקיים. צריך להזין לפחות אחד מהערכים sniHost ו-alpn. אפשר להגדיר עד 100 מארחי SNI בכל המשחקים.
alpn[]

string

זה שינוי אופציונלי. ‫ALPN (משא ומתן על פרוטוקול בשכבת האפליקציה) להתאמה. דוגמאות: 'http/1.1',‏ 'h2'. צריך להזין לפחות אחד מהערכים sniHost ו-alpn. אפשר להגדיר עד 5 מספרי ALPN בכל ההתאמות.

RouteAction

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

ייצוג ב-JSON 
{
  "destinations": [
    {
      object (RouteDestination)
    }
  ],
  "idleTimeout": string
}
שדות
destinations[]

object (RouteDestination)

חובה. שירותי היעד שאליהם התנועה תועבר. צריך לבחור לפחות שירות יעד אחד.
idleTimeout

string (Duration format)

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

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-'s'. דוגמה: "3.5s".

RouteDestination

מתארים את היעד שאליו התנועה תנותב.

ייצוג ב-JSON 
{
  "serviceName": string,
  "weight": integer
}
שדות
serviceName

string

חובה. כתובת ה-URL של BackendService שאליה תנותב התנועה.
weight

integer

זה שינוי אופציונלי. מציין את שיעור הבקשות שמועברות לחלק האחורי שאליו מתייחס השדה serviceName. החישוב מתבצע באופן הבא: משקל חלקי סכום המשקלים ביעדים. סכום המשקלים בכל היעדים לא צריך להיות 100.

Methods

create

 יוצרת TlsRoute חדש בפרויקט ובמיקום נתונים מסוימים.

delete

 מחיקת TlsRoute יחיד.

get

 קבלת פרטים של TlsRoute יחיד.

getIamPolicy

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

list

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

patch

 מעדכן את הפרמטרים של TlsRoute יחיד.

setIamPolicy

 הגדרת מדיניות בקרת הגישה במשאב שצוין.

testIamPermissions

 מחזירה את ההרשאות שיש לפונקציית קריאה חוזרת (caller) במשאב שצוין.