REST Resource: projects.locations.clusters

משאב: אשכול

אשכול Kubernetes ב-Google Distributed Cloud Edge.

ייצוג ב-JSON
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "fleet": {
    object (Fleet)
  },
  "networking": {
    object (ClusterNetworking)
  },
  "authorization": {
    object (Authorization)
  },
  "defaultMaxPodsPerNode": integer,
  "endpoint": string,
  "port": integer,
  "clusterCaCertificate": string,
  "maintenancePolicy": {
    object (MaintenancePolicy)
  },
  "controlPlaneVersion": string,
  "nodeVersion": string,
  "controlPlane": {
    object (ControlPlane)
  },
  "systemAddonsConfig": {
    object (SystemAddonsConfig)
  },
  "externalLoadBalancerIpv4AddressPools": [
    string
  ],
  "controlPlaneEncryption": {
    object (ControlPlaneEncryption)
  },
  "status": enum (Status),
  "maintenanceEvents": [
    {
      object (MaintenanceEvent)
    }
  ],
  "targetVersion": string,
  "releaseChannel": enum (ReleaseChannel),
  "survivabilityConfig": {
    object (SurvivabilityConfig)
  },
  "externalLoadBalancerIpv6AddressPools": [
    string
  ],
  "connectionState": {
    object (ConnectionState)
  },
  "externalLoadBalancerAddressPools": [
    {
      object (ExternalLoadBalancerPool)
    }
  ],
  "zoneStorageEncryption": {
    object (ZoneStorageEncryption)
  }
}
שדות
name

string

חובה. שם המשאב של האשכול.

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)

תוויות שמשויכות למשאב הזה.

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

fleet

object (Fleet)

חובה. הגדרת ה-Fleet.

networking

object (ClusterNetworking)

חובה. הגדרת רשתות ברמת האשכול.

authorization

object (Authorization)

חובה. לא ניתן לשינוי. מדיניות RBAC שתופעל ותנוהל על ידי GEC.

defaultMaxPodsPerNode

integer

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

endpoint

string

פלט בלבד. כתובת ה-IP של שרת ה-API של Kubernetes.

port

integer

פלט בלבד. מספר היציאה של שרת ה-API של Kubernetes.

clusterCaCertificate

string

פלט בלבד. האישור הציבורי בקידוד PEM של רשות האישורים (CA) של האשכול.

maintenancePolicy

object (MaintenancePolicy)

זה שינוי אופציונלי. הגדרת מדיניות התחזוקה בכל האשכול.

controlPlaneVersion

string

פלט בלבד. גרסת ההפצה של מישור הבקרה

nodeVersion

string

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

controlPlane

object (ControlPlane)

זה שינוי אופציונלי. ההגדרה של מישור הבקרה של האשכול.

systemAddonsConfig

object (SystemAddonsConfig)

זה שינוי אופציונלי. ההגדרות של התוספים למערכת.

externalLoadBalancerIpv4AddressPools[]

string

זה שינוי אופציונלי. מאגרים של כתובות IPv4 לאיזון עומסים חיצוני במישור הנתונים של האשכול.

controlPlaneEncryption

object (ControlPlaneEncryption)

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

status

enum (Status)

פלט בלבד. הסטטוס הנוכחי של האשכול.

maintenanceEvents[]

object (MaintenanceEvent)

פלט בלבד. כל אירועי התחזוקה שתוזמנו לאשכול, כולל אלה שמתבצעים, מתוכננים לעתיד ובוצעו בעבר (עד 90 יום).

targetVersion

string

זה שינוי אופציונלי. גרסת אשכול היעד. לדוגמה: "1.5.0".

releaseChannel

enum (ReleaseChannel)

זה שינוי אופציונלי. ערוץ ההפצה שאליו האשכול רשום.

survivabilityConfig

object (SurvivabilityConfig)

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

externalLoadBalancerIpv6AddressPools[]

string

זה שינוי אופציונלי. מאגרי כתובות IPv6 לאיזון עומסים חיצוני במישור הנתונים של האשכול.

connectionState

object (ConnectionState)

פלט בלבד. מצב החיבור הנוכחי של האשכול.

externalLoadBalancerAddressPools[]

object (ExternalLoadBalancerPool)

זה שינוי אופציונלי. מאגרים של מאזני עומסים חיצוניים לאשכול.

zoneStorageEncryption

object (ZoneStorageEncryption)

זה שינוי אופציונלי. הגדרת ההצפנה של האחסון באזור

Fleet

הגדרות שקשורות ל-Fleet.

"ציים" הוא מושג ב-Google Cloud שמתייחס לארגון לוגי של אשכולות, שמאפשר להשתמש ביכולות של כמה אשכולות ולנהל אותן, ולהחיל כללי מדיניות עקביים על כל המערכות.

ייצוג ב-JSON
{
  "project": string,
  "membership": string
}
שדות
project

string

חובה. שם הפרויקט המארח של ה-Fleet שבו האשכול הזה יירשם.

שמות הפרויקטים הם בפורמט projects/<project-number>.

membership

string

פלט בלבד. השם של משאב המינוי המנוהל ב-Hub שמשויך לאשכול הזה.

שמות המינויים מופיעים בפורמט projects/<project-number>/locations/global/membership/<cluster-id>.

ClusterNetworking

הגדרת רשתות ברמת האשכול.

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

string

חובה. לכל ה-Pods באשכול מוקצית כתובת RFC1918 IPv4 מהבלוקים האלה. יש תמיכה רק בבלוק אחד. אי אפשר לשנות את השדה הזה אחרי שיוצרים את המרחב.

servicesIpv4CidrBlocks[]

string

חובה. כל השירותים באשכול מקבלים כתובת RFC1918 IPv4 מהבלוקים האלה. יש תמיכה רק בבלוק אחד. אי אפשר לשנות את השדה הזה אחרי שיוצרים את המרחב.

הרשאה

מדיניות RBAC שתופעל ותנוהל על ידי GEC.

ייצוג ב-JSON
{
  "adminUsers": {
    object (ClusterUser)
  }
}
שדות
adminUsers

object (ClusterUser)

חובה. המשתמש שיקבל את התפקיד "אדמין של אשכול" באשכול, שנותן גישה מלאה לאשכול. כרגע זה שדה יחיד, אבל בעתיד הוא יורחב כדי לאפשר כמה אדמינים.

ClusterUser

חשבון משתמש למדיניות RBAC.

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

string

חובה. שם משתמש פעיל ב-Google.

MaintenancePolicy

הגדרת מדיניות התחזוקה.

ייצוג ב-JSON
{
  "window": {
    object (MaintenanceWindow)
  },
  "maintenanceExclusions": [
    {
      object (MaintenanceExclusionWindow)
    }
  ]
}
שדות
window

object (MaintenanceWindow)

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

maintenanceExclusions[]

object (MaintenanceExclusionWindow)

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

MaintenanceWindow

הגדרת חלון זמן לתחזוקה

ייצוג ב-JSON
{
  "recurringWindow": {
    object (RecurringTimeWindow)
  }
}
שדות
recurringWindow

object (RecurringTimeWindow)

הגדרה של חלון זמן לתחזוקה חוזר.

RecurringTimeWindow

מייצג חלון זמן שרירותי שחוזר על עצמו.

ייצוג ב-JSON
{
  "window": {
    object (TimeWindow)
  },
  "recurrence": string
}
שדות
window

object (TimeWindow)

חלון הזמנים של החזרה הראשונה.

recurrence

string

כלל חזרה (RRULE) ‏(https://tools.ietf.org/html/rfc5545#section-3.8.5.3) שמגדיר את החזרה של חלון הזמנים הזה. הם נמשכים לאורך פרק הזמן שבין שעת ההתחלה לשעת הסיום.

TimeWindow

מייצג חלון זמן שרירותי.

ייצוג ב-JSON
{
  "startTime": string,
  "endTime": string
}
שדות
startTime

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".

endTime

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".

MaintenanceExclusionWindow

מייצג חלון החרגה של תחזוקה.

ייצוג ב-JSON
{
  "window": {
    object (TimeWindow)
  },
  "id": string
}
שדות
window

object (TimeWindow)

זה שינוי אופציונלי. חלון הזמן.

id

string

זה שינוי אופציונלי. מזהה ייחודי (לכל אשכול) של החלון.

ControlPlane

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

ייצוג ב-JSON
{

  // Union field config can be only one of the following:
  "remote": {
    object (Remote)
  },
  "local": {
    object (Local)
  }
  // End of list of possible types for union field config.
}
שדות

שדה של איחוד config.

הערך config יכול להיות רק אחד מהבאים:

remote

object (Remote)

הגדרת מישור בקרה מרחוק.

local

object (Local)

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

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

אפליקציה עם פעולה מרחוק

בסוג הזה אין שדות.

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

מקומי

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

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

ייצוג ב-JSON
{
  "nodeLocation": string,
  "nodeCount": integer,
  "machineFilter": string,
  "sharedDeploymentPolicy": enum (SharedDeploymentPolicy),
  "controlPlaneNodeStorageSchema": string
}
שדות
nodeLocation

string

השם של אזורי Google Distributed Cloud Edge שבהם ייווצר מאגר הצמתים הזה. לדוגמה: us-central1-edge-customer-a.

nodeCount

integer

מספר הצמתים שישמשו כרפליקות של מישור הבקרה.

machineFilter

string

רק מכונות שתואמות למסנן הזה יוכלו לארח צומתי מישור בקרה. שפת הסינון מקבלת מחרוזות כמו "name=", והיא מתועדת כאן: AIP-160.

sharedDeploymentPolicy

enum (SharedDeploymentPolicy)

הגדרת המדיניות לגבי פריסת אפליקציות של משתמשים.

controlPlaneNodeStorageSchema

string

זה שינוי אופציונלי. שם לסכימת האחסון של צומתי מישור הבקרה.

אזהרה: התכונה "סכימה ניתנת להגדרה של אחסון מקומי בצומת" היא תכונה ניסיונית, ולא מומלץ להשתמש בה באופן כללי באשכולות או במאגרי צמתים בסביבת הייצור.

SharedDeploymentPolicy

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

טיפוסים בני מנייה (enum)
SHARED_DEPLOYMENT_POLICY_UNSPECIFIED לא צוין.
ALLOWED אפשר לפרוס אפליקציות של משתמשים גם במישור הבקרה וגם בצומתי העובדים.
DISALLOWED אי אפשר לפרוס אפליקציות של משתמשים בצמתים של מישור הבקרה, אלא רק בצמתים של עובדים.

SystemAddonsConfig

הגדרות שהלקוחות יכולים להגדיר לתוספים של מערכת GDCE.

ייצוג ב-JSON
{
  "ingress": {
    object (Ingress)
  },
  "vmServiceConfig": {
    object (VMServiceConfig)
  }
}
שדות
ingress

object (Ingress)

זה שינוי אופציונלי. הגדרות ל-Ingress.

vmServiceConfig

object (VMServiceConfig)

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

תעבורת נתונים נכנסת (Ingress)

הגדרת התוסף Ingress שמאפשר ללקוחות ליצור אובייקט Ingress כדי לנהל את הגישה החיצונית לשרתים באשכול. התוסף מורכב מ-istiod ומ-istio-ingress.

ייצוג ב-JSON
{
  "disabled": boolean,
  "ipv4Vip": string
}
שדות
disabled

boolean

זה שינוי אופציונלי. אם Ingress מושבת.

ipv4Vip

string

זה שינוי אופציונלי. ‫Ingress VIP.

VMServiceConfig

‫VMServiceConfig מגדיר את התצורה של שירות GDCE VM.

ייצוג ב-JSON
{
  "vmmEnabled": boolean
}
שדות
vmmEnabled

boolean

זה שינוי אופציונלי. אם VMM מופעל.

ControlPlaneEncryption

הגדרת התמיכה במפתח KMS בניהול הלקוח לצומתי מישור הבקרה.

ייצוג ב-JSON
{
  "kmsKey": string,
  "kmsKeyActiveVersion": string,
  "kmsKeyState": enum (KmsKeyState),
  "kmsStatus": {
    object (Status)
  },
  "resourceState": enum (ResourceState)
}
שדות
kmsKey

string

זה שינוי אופציונלי. מפתח ההצפנה של Cloud KMS, למשל projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey}, שמשמש להגנה על הדיסקים של מישור הבקרה. אם לא תציינו מפתח, המערכת תשתמש במפתח בניהול Google.

kmsKeyActiveVersion

string

פלט בלבד. הגרסה של Cloud KMS CryptoKeyVersion שמשמשת כרגע להגנה על דיסקים של מישור הבקרה. רלוונטי רק אם kmsKey מוגדר.

kmsKeyState

enum (KmsKeyState)

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

kmsStatus

object (Status)

פלט בלבד. סטטוס השגיאה שמוחזר על ידי Cloud KMS כשמשתמשים במפתח הזה. אפשר לאכלס את השדה הזה רק אם הערך של kmsKeyState הוא לא KMS_KEY_STATE_KEY_AVAILABLE. אם השדה הזה מאוכלס, הוא מכיל את סטטוס השגיאה שדווח על ידי Cloud KMS.

resourceState

enum (ResourceState)

פלט בלבד. מצב המשאב הנוכחי שמשויך ל-CMEK.

סטטוס

מציין את סטטוס האשכול.

טיפוסים בני מנייה (enum)
STATUS_UNSPECIFIED הסטטוס לא ידוע.
PROVISIONING האשכול נוצר.
RUNNING האשכול נוצר ומוכן לשימוש.
DELETING האשכול נמחק.
ERROR הסטטוס מציין שאירעו כמה שגיאות במהלך ההתאמה או המחיקה של האשכול.
RECONCILING האשכול עובר תהליך מסוים, כמו שדרוגי גרסאות וכו'.

MaintenanceEvent

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

ייצוג ב-JSON
{
  "uuid": string,
  "targetVersion": string,
  "operation": string,
  "type": enum (Type),
  "schedule": enum (Schedule),
  "state": enum (State),
  "createTime": string,
  "startTime": string,
  "endTime": string,
  "updateTime": string
}
שדות
uuid

string

פלט בלבד. ה-UUID של אירוע התחזוקה.

targetVersion

string

פלט בלבד. גרסת היעד של האשכול.

operation

string

פלט בלבד. הפעולה להרצת אירוע התחזוקה. מצוין בפורמט projects/*/locations/*/operations/*. אם אירוע התחזוקה מפוצל לכמה פעולות (למשל, בגלל חלונות זמן לתחזוקה), הפעולה האחרונה מתועדת.

type

enum (Type)

פלט בלבד. סוג אירוע התחזוקה.

schedule

enum (Schedule)

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

state

enum (State)

פלט בלבד. המצב של אירוע התחזוקה.

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".

startTime

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".

endTime

string (Timestamp format)

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

משתמש ב-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".

סוג

מציין את סוג אירוע התחזוקה.

טיפוסים בני מנייה (enum)
TYPE_UNSPECIFIED לא צוין.
USER_INITIATED_UPGRADE המשתמשים התחילו את השדרוג.
GOOGLE_DRIVEN_UPGRADE השדרוג מבוצע על ידי Google.

תזמון

מציין מתי צריך לבצע את אירוע התחזוקה.

טיפוסים בני מנייה (enum)
SCHEDULE_UNSPECIFIED לא צוין.
IMMEDIATELY מיד אחרי קבלת הבקשה.

מדינה

מציין את מצב אירוע התחזוקה.

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED לא צוין.
RECONCILING אירוע התחזוקה נמשך. יכול להיות שלא ניתן להשתמש באשכול.
SUCCEEDED אירוע התחזוקה הסתיים בהצלחה.
FAILED אירוע התחזוקה נכשל.

ReleaseChannel

ערוץ ההפצה שאליו האשכול רשום.

טיפוסים בני מנייה (enum)
RELEASE_CHANNEL_UNSPECIFIED ערוץ הפצה לא מוגדר. כברירת מחדל, הערוץ יהיה ערוץ רגיל.
NONE אין ערוץ הפצה.
REGULAR ערוץ הפצה רגיל.

SurvivabilityConfig

הגדרת השרידות של האשכול, למשל במקרה של אובדן החיבור לרשת.

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

string (Duration format)

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

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

ConnectionState

‫ConnectionState מכיל את מצב החיבור הנוכחי מהאשכול ל-Google.

ייצוג ב-JSON
{
  "state": enum (State),
  "updateTime": string
}
שדות
state

enum (State)

פלט בלבד. מצב החיבור הנוכחי.

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".

מדינה

מצב החיבור.

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED מצב החיבור לא ידוע.
DISCONNECTED האשכול הזה מנותק כרגע מ-Google.
CONNECTED האשכול הזה מחובר כרגע ל-Google.
CONNECTED_AND_SYNCING האשכול הזה מחובר כרגע ל-Google, אבל יכול להיות שהוא התחבר מחדש לאחרונה אחרי שהתנתק. הסנכרון עדיין מתבצע.

ExternalLoadBalancerPool

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

ייצוג ב-JSON
{
  "addressPool": string,
  "ipv4Range": [
    string
  ],
  "ipv6Range": [
    string
  ],
  "avoidBuggyIps": boolean,
  "manualAssign": boolean
}
שדות
addressPool

string

זה שינוי אופציונלי. השם של מאגר מאזני העומסים החיצוניים.

ipv4Range[]

string

חובה. טווח כתובות IPv4 שלא חופף למאגר של מאזן העומסים החיצוני.

ipv6Range[]

string

זה שינוי אופציונלי. טווח כתובות IPv6 שלא חופף למאגר של מאזן העומסים החיצוני.

avoidBuggyIps

boolean

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

manualAssign

boolean

זה שינוי אופציונלי. אם הערך הוא True, הכתובות במאגר הזה לא מוקצות באופן אוטומטי לשירותי Kubernetes. אם הערך הוא True, כתובת IP במאגר הזה משמשת רק כששירות מציין אותה במפורש. ערך ברירת המחדל הוא False.

ZoneStorageEncryption

הגדרת תמיכה ב-CMEK לאחסון אזורי

ייצוג ב-JSON
{
  "kmsKey": string,
  "kmsKeyActiveVersion": string,
  "resourceState": enum (ResourceState)
}
שדות
kmsKey

string

זה שינוי אופציונלי. מפתח Cloud KMS

kmsKeyActiveVersion

string

פלט בלבד. הגרסה של Cloud KMS CryptoKeyVersion שמשמשת כרגע להצפנה או לפענוח

resourceState

enum (ResourceState)

פלט בלבד. מצב המשאב הנוכחי של ה-CMEK

Methods

create

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

delete

מחיקת אשכול אחד.

generateAccessToken

יצירת טוקן גישה לאשכול.

generateOfflineCredential

יוצר פרטי כניסה אופליין לאשכול.

get

קבלת פרטים של אשכול יחיד.

list

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

patch

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

upgrade

שדרוג של אשכול אחד.