REST Resource: projects.locations.agentGateways

משאב: AgentGateway

‫AgentGateway מייצג את המשאב של Agent Gateway.

ייצוג ב-JSON 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "description": string,
  "etag": string,
  "protocols": [
    enum (Protocol)
  ],
  "registries": [
    string
  ],
  "networkConfig": {
    object (NetworkConfig)
  },
  "agentGatewayCard": {
    object (AgentGatewayOutputCard)
  },

  // Union field deployment_mode can be only one of the following:
  "googleManaged": {
    object (GoogleManaged)
  },
  "selfManaged": {
    object (SelfManaged)
  }
  // End of list of possible types for union field deployment_mode.
}
שדות
name

string

מזהה. השם של משאב AgentGateway. הוא תואם לתבנית projects/*/locations/*/agentGateways/<agentGateway>.
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".
labels

map (key: string, value: string)

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

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

string

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

string

זה שינוי אופציונלי. תג הישות (Etag) של המשאב. אם הוא מסופק, הוא חייב להתאים ל-etag של השרת. אם ה-etag שסופק לא תואם ל-etag של השרת, הבקשה תיכשל ותוצג השגיאה 409 ABORTED.
protocols[]

enum (Protocol)

חובה. רשימת הפרוטוקולים שנתמכים על ידי Agent Gateway
registries[]

string

זה שינוי אופציונלי. רשימה של מאגרי Agent Registry שמכילים את הסוכנים, שרתי ה-MCP והכלים הכפופים ל-Agent Gateway. הערה: כרגע מוגבל למאגרים ברמת הפרויקט. חייב להיות בפורמט `//agentregistry.googleapis.com/projects/{project}/locations/{location}/‎
networkConfig

object (NetworkConfig)

זה שינוי אופציונלי. הגדרת הרשת של AgentGateway.
agentGatewayCard

object (AgentGatewayOutputCard)

פלט בלבד. שדה לכרטיס AgentGateway מאוכלס.
שדה של איחוד deployment_mode. מצב הפריסה של שרת ה-Proxy ברשת. צריך להגדיר אחד מהשדות ב-oneof הזה. הערך deployment_mode יכול להיות רק אחד מהבאים:
googleManaged

object (GoogleManaged)

זה שינוי אופציונלי. שרת ה-Proxy מנוהל על ידי Google Cloud בפרויקט של דייר.
selfManaged

object (SelfManaged)

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

GoogleManaged

הגדרות למצב פריסה בניהול Google. שרת ה-Proxy מנוהל על ידי Google Cloud בפרויקט של דייר.

ייצוג ב-JSON 
{
  "governedAccessPath": enum (GovernedAccessPath)
}
שדות
governedAccessPath

enum (GovernedAccessPath)

זה שינוי אופציונלי. מצב הפעולה של Agent Gateway.

GovernedAccessPath

הערך GovernedAccessPath מגדיר את סוג הגישה שצריך להגן עליה.

טיפוסים בני מנייה (enum)
GOVERNED_ACCESS_PATH_UNSPECIFIED לא צוין נתיב גישה מנוהל.
AGENT_TO_ANYWHERE לנהל את החיבורים של הסוכנים ליעדים.
CLIENT_TO_AGENT הגנה על החיבור לסוכן או לכלי.

SelfManaged

הגדרה למצב פריסה בניהול עצמי. צירוף למאזני עומסים קיימים של אפליקציות או לשרתי proxy מאובטחים לאינטרנט.

ייצוג ב-JSON 
{
  "resourceUri": string
}
שדות
resourceUri

string

זה שינוי אופציונלי. שרת proxy נתמך של רשת Google Cloud בפרויקט ובמיקום

פרוטוקול

רשימות של כל הפרוטוקולים הנתמכים

טיפוסים בני מנייה (enum)
PROTOCOL_UNSPECIFIED פרוטוקול לא מוגדר.
MCP פרוטוקול מישור הבקרה של העברת ההודעות.

NetworkConfig

‫NetworkConfig מכיל הגדרות רשת ל-AgentGateway.

ייצוג ב-JSON 
{
  "egress": {
    object (Egress)
  },
  "dnsPeeringConfig": {
    object (DnsPeeringConfig)
  }
}
שדות
egress

object (Egress)

זה שינוי אופציונלי. מחבר רשת אופציונלי של ממשק PSC לקישוריות לרשת ה-VPC הפרטית שלכם.
dnsPeeringConfig

object (DnsPeeringConfig)

זה שינוי אופציונלי. הגדרה אופציונלית של קישור בין רשתות שכנות (peering) ב-DNS לקישוריות לרשת ה-VPC הפרטית.

תעבורת נתונים יוצאת (egress)

הגדרת תעבורת נתונים יוצאת (egress)

ייצוג ב-JSON 
{
  "networkAttachment": string
}
שדות
networkAttachment

string

זה שינוי אופציונלי. ה-URI של המשאב "מחבר רשת".

DnsPeeringConfig

הגדרת קישור בין רשתות שכנות (peering) ב-DNS לרשת ה-VPC של המשתמש.

ייצוג ב-JSON 
{
  "domains": [
    string
  ],
  "targetProject": string,
  "targetNetwork": string
}
שדות
domains[]

string

חובה. שמות דומיינים ששאילתות ה-DNS שלהם צריכות להיות מועברות לרשת היעד.
targetProject

string

חובה. מזהה פרויקט היעד שאליו צריך להעביר את שאילתות ה-DNS. זה יכול להיות אותו פרויקט שמכיל את AgentGateway או פרויקט אחר.
targetNetwork

string

חובה. רשת היעד ב"פרויקט היעד" שאליה צריך להעביר את שאילתות ה-DNS. חייב להיות בפורמט projects/{project}/global/networks/{network}.

AgentGatewayOutputCard

‫AgentGatewayOutputCard מכיל שדות מידע לפלט בלבד

ייצוג ב-JSON 
{
  "mtlsEndpoint": string,
  "rootCertificates": [
    string
  ],
  "serviceExtensionsServiceAccount": string
}
שדות
mtlsEndpoint

string

פלט בלבד. נקודת קצה של mTLS שמשויכת ל-AgentGateway הזה
rootCertificates[]

string

פלט בלבד. אישורי בסיס לסוכנים לאימות של AgentGateway הזה
serviceExtensionsServiceAccount

string

פלט בלבד. חשבון שירות שמשמש להפעלת Service Extensions.

Methods

create

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

delete

 מחיקה של AgentGateway יחיד.

get

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

list

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

patch

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