REST Resource: projects.locations.agentGateways

משאב: AgentGateway

‫AgentGateway מייצג את משאב שער הסוכן.

ייצוג 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[]
(deprecated)

enum (Protocol)

זה שינוי אופציונלי. הוצאה משימוש,
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 בפרויקט דייר (tenant).
selfManaged

object (SelfManaged)

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

GoogleManaged

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

ייצוג 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,
  "resourceUris": [
    string
  ]
}
שדות
resourceUri

string

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

string

זה שינוי אופציונלי. רשימה של שרתי proxy נתמכים ברשת של Google Cloud בפרויקט ובמיקום. resourceUris לא יכול להיות ביחד עם resourceUri.

פרוטוקול

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

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

NetworkConfig

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

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

object (Egress)

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

object (DnsPeeringConfig)

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

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

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

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

string

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

DnsPeeringConfig

הגדרת קישור 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 יחיד.