REST Resource: projects.locations.tlsRoutes

משאב: TlsRoute

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

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

string

מזהה. השם של משאב ה-TlsRoute. הוא תואם לתבנית projects/*/locations/*/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 מגדיר רשימה של רשתות שירות (mesh) שאליהן מחובר ה-TlsRoute הזה, כאחד מכללי הניתוב לניתוב הבקשות שמטופלות על ידי רשת השירות.

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

ה-Mesh המצורף צריך להיות מסוג SIDECAR

gateways[]

string

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

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

targetProxies[]

string

זה שינוי אופציונלי. ‫TargetProxies מגדיר רשימה של TargetTcpProxies שאליהם מחובר ה-TlsRoute הזה, כאחד מכללי הניתוב לניתוב הבקשות שמטופלות על ידי TargetTcpProxy.

כל הפניה ל-TargetTcpProxy צריכה להתאים לתבנית: projects/*/locations/*/targetTcpProxies/<target_tcp_proxy_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 (אינדיקטור של שם השרת) להתאמה. ה-SNI יותאם לכל הדומיינים עם התווים הכלליים לחיפוש, כלומר www.example.com יותאם קודם ל-www.example.com, אחר כך ל-*.example.com ואז ל-*.com.. אין תמיכה בתווים כלליים חלקיים לחיפוש, וערכים כמו ‎ *w.example.com לא תקינים. צריך להזין לפחות אחד מהשדות sniHost ו-alpn. אפשר להגדיר עד 100 מארחי SNI בכל ההתאמות.

alpn[]

string

זה שינוי אופציונלי. ‫ALPN ‏ (Application-Layer Protocol Negotiation) להתאמה. דוגמאות: "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 יחיד.

list

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

patch

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

setIamPolicy

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

testIamPermissions

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