REST Resource: projects.locations.vmwareAdminClusters

משאב: VmwareAdminCluster

משאב שמייצג אשכול אדמין של VMware.

ייצוג ב-JSON 
{
  "name": string,
  "description": string,
  "uid": string,
  "etag": string,
  "createTime": string,
  "updateTime": string,
  "annotations": {
    string: string,
    ...
  },
  "state": enum (State),
  "endpoint": string,
  "reconciling": boolean,
  "localName": string,
  "bootstrapClusterMembership": string,
  "onPremVersion": string,
  "fleet": {
    object (Fleet)
  },
  "imageType": string,
  "vcenter": {
    object (VmwareAdminVCenterConfig)
  },
  "networkConfig": {
    object (VmwareAdminNetworkConfig)
  },
  "loadBalancer": {
    object (VmwareAdminLoadBalancerConfig)
  },
  "controlPlaneNode": {
    object (VmwareAdminControlPlaneNodeConfig)
  },
  "addonNode": {
    object (VmwareAdminAddonNodeConfig)
  },
  "antiAffinityGroups": {
    object (VmwareAAGConfig)
  },
  "autoRepairConfig": {
    object (VmwareAutoRepairConfig)
  },
  "status": {
    object (ResourceStatus)
  },
  "platformConfig": {
    object (VmwarePlatformConfig)
  },
  "preparedSecrets": {
    object (VmwareAdminPreparedSecretsConfig)
  },
  "authorization": {
    object (VmwareAdminAuthorizationConfig)
  },
  "validationCheck": {
    object (ValidationCheck)
  },
  "privateRegistryConfig": {
    object (VmwareAdminPrivateRegistryConfig)
  },
  "proxy": {
    object (VmwareAdminProxy)
  },
  "enableAdvancedCluster": boolean
}
שדות
name

string

אי אפשר לשנות. שם המשאב של אשכול האדמין ב-VMware.
description

string

תיאור קריא (לבני אדם) של אשכול האדמין הזה ב-VMware.
uid

string

פלט בלבד. המזהה הייחודי של אשכול האדמין ב-VMware.
etag

string

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

string (Timestamp format)

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

הפורמט הוא 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)

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

הפורמט הוא 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".
annotations

map (key: string, value: string)

הערות באשכול האדמין של VMware. ההגבלות בשדה הזה זהות להגבלות של הערות ב-Kubernetes. הגודל הכולל של כל המפתחות והערכים יחד מוגבל ל-256k. למפתח יכולים להיות שני מקטעים: קידומת (אופציונלית) ושם (חובה), שמופרדים באמצעות לוכסן (/). הקידומת חייבת להיות תת-דומיין של DNS. השם צריך להיות באורך של עד 63 תווים, להתחיל ולהסתיים בתווים אלפאנומריים, ולהכיל מקפים (-), קווים תחתונים (_), נקודות (.) ותווים אלפאנומריים בין לבין.

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

enum (State)

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

string

פלט בלבד. שם ה-DNS של שרת ה-API של אשכול האדמין ב-VMware.
reconciling

boolean

פלט בלבד. אם ההגדרה מוגדרת, כרגע מתבצעים שינויים באשכול הניהול של VMware.
localName

string

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

כל המשתמשים צריכים להשתמש בשם הזה כדי לגשת לאשכול באמצעות gkectl או kubectl, והם צריכים לצפות לראות את השם המקומי כשהם מעיינים ביומנים של בקר אשכול האדמין.
bootstrapClusterMembership

string

אשכול האתחול שאליו שייך אשכול הניהול הזה של VMware.
onPremVersion

string

הגרסה של אשכול הניהול של Anthos ב-VMware.
fleet

object (Fleet)

פלט בלבד. הגדרת כלל המכשירים בארגון עבור האשכול.
imageType

string

סוג תמונת מערכת ההפעלה של אשכול הניהול של VMware.
vcenter

object (VmwareAdminVCenterConfig)

ההגדרה של VCenter באשכול הניהול של VMware.
networkConfig

object (VmwareAdminNetworkConfig)

הגדרת הרשת של אשכול הניהול של VMware.
loadBalancer

object (VmwareAdminLoadBalancerConfig)

ההגדרה של מאזן העומסים באשכול הניהול של VMware.
controlPlaneNode

object (VmwareAdminControlPlaneNodeConfig)

הגדרת צומת מישור הבקרה של אשכול הניהול ב-VMware.
addonNode

object (VmwareAdminAddonNodeConfig)

ההגדרה של צומת התוסף באשכול האדמין של VMware.
antiAffinityGroups

object (VmwareAAGConfig)

ההגדרה של קבוצת אנטי-אפיניות באשכול הניהול של VMware.
autoRepairConfig

object (VmwareAutoRepairConfig)

ההגדרה של תיקון אוטומטי באשכול הניהול של VMware.
status

object (ResourceStatus)

פלט בלבד. ‫ResourceStatus שמייצג את הסטטוס המפורט של האשכול.
platformConfig

object (VmwarePlatformConfig)

ההגדרה של פלטפורמת VMware.
preparedSecrets

object (VmwareAdminPreparedSecretsConfig)

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

object (VmwareAdminAuthorizationConfig)

הגדרת ההרשאה של אשכול האדמין ב-VMware.
validationCheck

object (ValidationCheck)

פלט בלבד. ‫ValidationCheck מייצג את התוצאה של עבודת הבדיקה לפני ההפעלה.
privateRegistryConfig

object (VmwareAdminPrivateRegistryConfig)

הגדרות לרישום.
proxy

object (VmwareAdminProxy)

הגדרת שרת proxy.
enableAdvancedCluster

boolean

הפעלת אשכול מתקדם.

מדינה

מצב מחזור החיים של אשכול האדמין ב-VMware.

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

VmwareAdminVCenterConfig

‫VmwareAdminVCenterConfig מכיל הגדרות של VCenter עבור אשכול אדמין של VMware.

ייצוג ב-JSON 
{
  "resourcePool": string,
  "datastore": string,
  "datacenter": string,
  "cluster": string,
  "folder": string,
  "caCertData": string,
  "address": string,
  "dataDisk": string,
  "storagePolicyName": string
}
שדות
resourcePool

string

השם של מאגר המשאבים של vCenter עבור אשכול האדמין.
datastore

string

השם של מאגר הנתונים של vCenter עבור אשכול האדמין.
datacenter

string

השם של מרכז הנתונים של vCenter עבור אשכול האדמין.
cluster

string

השם של אשכול vCenter עבור אשכול האדמין.
folder

string

השם של תיקיית vCenter עבור אשכול האדמין.
caCertData

string

מכיל את המפתח הציבורי של אישור CA של vCenter לאימות SSL.
address

string

כתובת ה-IP של vCenter.
dataDisk

string

השם של דיסק המכונה הווירטואלית (VMDK) של אשכול האדמין.
storagePolicyName

string

השם של מדיניות האחסון ב-vCenter עבור אשכול המשתמשים.

VmwareAdminNetworkConfig

‫VmwareAdminNetworkConfig מכיל את הגדרות הרשת של אשכול הניהול של VMware.

ייצוג ב-JSON 
{
  "serviceAddressCidrBlocks": [
    string
  ],
  "podAddressCidrBlocks": [
    string
  ],
  "vcenterNetwork": string,
  "hostConfig": {
    object (VmwareHostConfig)
  },
  "haControlPlaneConfig": {
    object (VmwareAdminHAControlPlaneConfig)
  },

  // Union field ip_configuration can be only one of the following:
  "staticIpConfig": {
    object (VmwareStaticIpConfig)
  },
  "dhcpIpConfig": {
    object (VmwareDhcpIpConfig)
  }
  // End of list of possible types for union field ip_configuration.
}
שדות
serviceAddressCidrBlocks[]

string

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

string

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

string

‫vcenterNetwork מציין את שם הרשת של vCenter.
hostConfig

object (VmwareHostConfig)

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

object (VmwareAdminHAControlPlaneConfig)

הגדרה של מישור הבקרה של אשכול אדמין עם זמינות גבוהה.
שדה איחוד ip_configuration. סוג הגדרת ה-IP שמשמשת את אשכול האדמין של VMware. הערך ip_configuration יכול להיות רק אחד מהבאים:
staticIpConfig

object (VmwareStaticIpConfig)

הגדרות התצורה של כתובת IP קבועה.
dhcpIpConfig

object (VmwareDhcpIpConfig)

הגדרות התצורה של כתובת IP ב-DHCP.

VmwareAdminHAControlPlaneConfig

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

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

object (VmwareIpBlock)

כתובות IP סטטיות לצמתים של מישור הבקרה של האדמין.

VmwareAdminLoadBalancerConfig

‫VmwareAdminLoadBalancerConfig מכיל את ההגדרות של מאזן העומסים עבור אשכול הניהול של VMware.

ייצוג ב-JSON 
{
  "vipConfig": {
    object (VmwareAdminVipConfig)
  },

  // Union field load_balancer_configuration can be only one of the following:
  "f5Config": {
    object (VmwareAdminF5BigIpConfig)
  },
  "manualLbConfig": {
    object (VmwareAdminManualLbConfig)
  },
  "metalLbConfig": {
    object (VmwareAdminMetalLbConfig)
  },
  "seesawConfig": {
    object (VmwareAdminSeesawConfig)
  }
  // End of list of possible types for union field load_balancer_configuration.
}
שדות
vipConfig

object (VmwareAdminVipConfig)

כתובות ה-VIP שבהן נעשה שימוש במאזן העומסים.
שדה איחוד load_balancer_configuration. הגדרת מאזן העומסים שבה יש להשתמש באשכול האדמין של VMware. הערך load_balancer_configuration יכול להיות רק אחד מהבאים:
f5Config

object (VmwareAdminF5BigIpConfig)

הגדרות למאזני עומסים מוקלדים של F5 Big IP.
manualLbConfig

object (VmwareAdminManualLbConfig)

מאזני עומסים שהוגדרו באופן ידני.
metalLbConfig

object (VmwareAdminMetalLbConfig)

מאזני עומסים של MetalLB.
seesawConfig

object (VmwareAdminSeesawConfig)

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

VmwareAdminVipConfig

‫VmwareAdminVipConfig להגדרות של מאזן עומסים של VMware.

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

string

כתובת ה-VIP שהגדרתם בעבר עבור Kubernetes API של אשכול האדמין.
addonsVip

string

כתובת ה-VIP להגדרת מאזן העומסים לתוספים.

VmwareAdminF5BigIpConfig

‫VmwareAdminF5BigIpConfig מייצג פרמטרים של הגדרה למאזן עומסים F5 BIG-IP.

ייצוג ב-JSON 
{
  "address": string,
  "partition": string,
  "snatPool": string
}
שדות
address

string

כתובת ה-IP של מאזן העומסים.
partition

string

המחיצה הקיימת שבה מאזן העומסים ישתמש. המחיצה הזו נוצרת בדרך כלל עבור אשכול האדמין, לדוגמה: my-f5-admin-partition.
snatPool

string

שם המאגר. נדרש רק אם משתמשים ב-SNAT.

VmwareAdminManualLbConfig

ייצוג ב-JSON 
{
  "ingressHttpNodePort": integer,
  "ingressHttpsNodePort": integer,
  "controlPlaneNodePort": integer,
  "konnectivityServerNodePort": integer,
  "addonsNodePort": integer
}
שדות
ingressHttpNodePort

integer

‫NodePort ל-http של שירות הכניסה. שירות הכניסה באשכול האדמין מיושם כשירות מסוג NodePort (לדוגמה, 32527).
ingressHttpsNodePort

integer

‫NodePort ל-HTTPS של שירות הכניסה. שירות הכניסה באשכול האדמין מיושם כשירות מסוג NodePort (לדוגמה, 30139).
controlPlaneNodePort

integer

‫NodePort לשירות של מישור הבקרה. שרת ה-API של Kubernetes באשכול האדמין מיושם כשירות מסוג NodePort (לדוגמה, 30968).
konnectivityServerNodePort

integer

‫NodePort לשירות של שרת konnectivity שפועל כ-sidecar בכל פוד kube-apiserver (לדוגמה, 30564).
addonsNodePort

integer

‫NodePort לשרת התוספים באשכול האדמין.

VmwareAdminMetalLbConfig

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

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

boolean

האם MetalLB מופעל.

VmwareAdminSeesawConfig

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

חשוב: שימו לב ש-Anthos On-Prem API לא ייצור או יעדכן הגדרות של Seesaw, אלא רק ישייך הגדרה קיימת לאוסף חדש של משתמשים.

חשוב: כשמנסים ליצור אשכול משתמשים עם איזון עומסים קיים של Seesaw, צריך לבצע כמה שלבי הכנה לפני שמפעילים את שיטת ה-API ‏vmwareClusters.create. קודם צריך ליצור את מרחב השמות של אשכול המשתמשים באמצעות kubectl. צריך להשתמש במוסכמת השמות הבאה למרחב השמות : ‎-gke-onprem-mgmt או ‎-gke-onprem-mgmt, בהתאם לשאלה אם השתמשתם ב-VmwareCluster.local_name כדי להבחין בין התנגשויות. למידע נוסף, אפשר לעיין במסמכי התיעוד של VmwareCluster.local_name. אחרי שיוצרים את מרחב השמות, צריך ליצור משאב סודי באמצעות kubectl. הסוד הזה יכיל עותקים של פרטי הכניסה שלכם ל-Seesaw. הסוד צריך להיקרא user-cluster-creds ולהכיל את פרטי הכניסה של SSH ו-Cert של Seesaw. האישורים צריכים להיות ממופתחים עם השמות הבאים: seesaw-ssh-private-key,‏ seesaw-ssh-public-key,‏ seesaw-ssh-ca-key,‏ seesaw-ssh-ca-cert.

ייצוג ב-JSON 
{
  "group": string,
  "masterIp": string,
  "ipBlocks": [
    {
      object (VmwareIpBlock)
    }
  ],
  "enableHa": boolean,
  "vms": [
    string
  ],
  "stackdriverName": string
}
שדות
group

string

באופן כללי, צריך להשתמש בפורמט הבא לשם הקבוצה ב-Seesaw: seesaw-for-[שם האשכול].
masterIp

string

‫MasterIP הוא כתובת ה-IP שמוכרזת על ידי השרת הראשי בקבוצת Seesaw.
ipBlocks[]

object (VmwareIpBlock)

בלוקים של כתובות IP שבהם מאזן העומסים של Seesaw ישתמש
enableHa

boolean

הפעלת שתי מכונות וירטואליות של מאזן עומסים כדי להשיג מאזן עומסים של Seesaw עם זמינות גבוהה.
vms[]

string

שמות המכונות הווירטואליות שנוצרו לקבוצת Seesaw הזו.
stackdriverName

string

השם שבו ישתמש Stackdriver.

VmwareAdminControlPlaneNodeConfig

‫VmwareAdminControlPlaneNodeConfig מכיל הגדרות של צומת מישור הבקרה עבור אשכול אדמין של VMware.

ייצוג ב-JSON 
{
  "cpus": string,
  "memory": string,
  "replicas": string
}
שדות
cpus

string (int64 format)

מספר יחידות ה-vCPU של צומת מישור הבקרה של אשכול האדמין.
memory

string (int64 format)

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

string (int64 format)

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

VmwareAdminAddonNodeConfig

‫VmwareAdminAddonNodeConfig מכיל הגדרות של צמתים של תוספים לאשכול Admin של VMware.

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

object (VmwareAutoResizeConfig)

ההגדרה VmwareAutoResizeConfig מציינת את הגדרת השינוי האוטומטי של הגודל.

VmwarePlatformConfig

‫VmwarePlatformConfig מייצג את ההגדרה של פלטפורמת VMware.

ייצוג ב-JSON 
{
  "requiredPlatformVersion": string,
  "platformVersion": string,
  "bundles": [
    {
      object (VmwareBundleConfig)
    }
  ],
  "status": {
    object (ResourceStatus)
  }
}
שדות
requiredPlatformVersion

string

קלט בלבד. גרסת הפלטפורמה הנדרשת, למשל 1.13.1. אם גרסת הפלטפורמה הנוכחית נמוכה מגרסת היעד, גרסת הפלטפורמה תעודכן לגרסת היעד. אם גרסת היעד לא מותקנת בפלטפורמה (גרסאות חבילה), מורידים את חבילת גרסת היעד.
platformVersion

string

פלט בלבד. גרסת הפלטפורמה, למשל 1.13.2.
bundles[]

object (VmwareBundleConfig)

פלט בלבד. רשימת חבילות ה-bundles שהותקנו באשכול האדמין.
status

object (ResourceStatus)

פלט בלבד. סטטוס המשאב בפלטפורמה.

VmwareBundleConfig

‫VmwareBundleConfig מייצג את ההגדרה של החבילה.

ייצוג ב-JSON 
{
  "version": string,
  "status": {
    object (ResourceStatus)
  }
}
שדות
version

string

גרסת החבילה.
status

object (ResourceStatus)

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

VmwareAdminPreparedSecretsConfig

‫VmwareAdminPreparedSecretsConfig מייצג את ההגדרה של סודות מוכנים של אשכול אדמין.

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

boolean

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

VmwareAdminAuthorizationConfig

‫VmwareAdminAuthorizationConfig מייצג את ההגדרה של הרשאות לאשכול אדמין.

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

object (ClusterUser)

עבור אשכולות אדמין של VMware, למשתמשים תוקצה הרשאת צפייה באשכול.

VmwareAdminPrivateRegistryConfig

‫VmwareAdminPrivateRegistryConfig מייצג הגדרה של רישום אדמין של אשכול.

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

string

כתובת המרשם.
caCert

string

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

VmwareAdminProxy

‫VmwareAdminProxy מייצג את ההגדרה של שרת proxy של אשכול אדמין.

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

string

כתובת ה-HTTP של שרת ה-Proxy.
noProxy

string

רשימה מופרדת בפסיקים של כתובות IP, טווחי כתובות IP, שמות מארחים ושמות דומיינים שלא צריכים לעבור דרך שרת ה-proxy. כש-Google Distributed Cloud שולח בקשה לאחת מהכתובות, המארחים או הדומיינים האלה, הבקשה נשלחת ישירות.

Methods

create

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

enroll

 רושם אשכול אדמין קיים של VMware ל-Anthos On-Prem API בפרויקט ובמיקום נתונים.

get

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

list

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

patch

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