REST Resource: projects.locations.privateClouds.clusters

Ressource: Cluster

Ein Cluster in einer privaten Cloud.

JSON-Darstellung 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "state": enum (State),
  "management": boolean,
  "autoscalingSettings": {
    object (AutoscalingSettings)
  },
  "uid": string,
  "nodeTypeConfigs": {
    string: {
      object (NodeTypeConfig)
    },
    ...
  },
  "stretchedClusterConfig": {
    object (StretchedClusterConfig)
  },
  "datastoreMountConfig": [
    {
      object (DatastoreMountConfig)
    }
  ]
}
Felder
name

string

Nur Ausgabe. ID. Der Ressourcenname dieses Clusters. Ressourcennamen sind schemalose URIs, die den Konventionen unter https://cloud.google.com/apis/design/resource_names entsprechen. Beispiel: projects/my-project/locations/us-central1-a/privateClouds/my-cloud/clusters/my-cluster
createTime

string (Timestamp format)

Nur Ausgabe. Erstellungszeitpunkt dieser Ressource.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
updateTime

string (Timestamp format)

Nur Ausgabe. Zeitpunkt der letzten Aktualisierung dieser Ressource.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
state

enum (State)

Nur Ausgabe. Status der Ressource.
management

boolean

Nur Ausgabe. „True“, wenn der Cluster ein Verwaltungscluster ist, andernfalls „false“. Es kann nur einen Verwaltungscluster in einer privaten Cloud geben und er muss der erste sein.
autoscalingSettings

object (AutoscalingSettings)

Optional. Konfiguration des auf diesen Cluster angewendeten Autoscalings.
uid

string

Nur Ausgabe. Vom System generierte eindeutige Kennung für die Ressource.
nodeTypeConfigs

map (key: string, value: object (NodeTypeConfig))

Erforderlich. Die Zuordnung der Clusterknotentypen in diesem Cluster, wobei der Schlüssel der kanonische Bezeichner des Knotentyps ist (entspricht NodeType).

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
stretchedClusterConfig

object (StretchedClusterConfig)

Optional. Konfiguration eines Stretched Cluster. Erforderlich für Cluster, die zu einer ERWEITERTEN privaten Cloud gehören.
datastoreMountConfig[]

object (DatastoreMountConfig)

Nur Ausgabe. Konfiguration eines eingebundenen Datenspeichers.

Bundesland

Die Enum „State“ definiert die möglichen Status von privaten Cloud-Clustern.

Enums
STATE_UNSPECIFIED Der Standardwert. Dieser Wert sollte niemals verwendet werden.
ACTIVE Der Cluster ist betriebsbereit und kann vom Nutzer verwendet werden.
CREATING Der Cluster wird bereitgestellt.
UPDATING Hinzufügen oder Entfernen eines Knotens im Cluster, alle anderen clusterspezifischen Aktualisierungen.
DELETING Der Cluster wird gelöscht.
REPAIRING Der Cluster wird gerade gewartet, z. B. wird ein ausgefallener Knoten ersetzt.

AutoscalingSettings

Autoscaling-Einstellungen definieren die Regeln, die von VMware Engine verwendet werden, um die Cluster in einer privaten Cloud automatisch zu skalieren.

JSON-Darstellung 
{
  "autoscalingPolicies": {
    string: {
      object (AutoscalingPolicy)
    },
    ...
  },
  "minClusterNodeCount": integer,
  "maxClusterNodeCount": integer,
  "coolDownPeriod": string
}
Felder
autoscalingPolicies

map (key: string, value: object (AutoscalingPolicy))

Erforderlich. Die Karte mit auf den Cluster angewendeten Autoscaling-Richtlinien. Der Schlüssel ist die Kennung der Richtlinie. Es muss die folgenden Anforderungen erfüllen:

  • Darf nur 1 bis 63 alphanumerische Zeichen und Bindestriche enthalten
  • Beginnt mit einem Buchstaben
  • Endet mit einem Zeichen, das kein Bindestrich ist
  • Nicht als UUID formatiert
  • Entspricht RFC 1034 (Abschnitt 3.5)

Derzeit darf die Map nur ein Element enthalten, das die Autoscaling-Richtlinie für Compute-Knoten beschreibt.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
minClusterNodeCount

integer

Optional. Mindestanzahl von Knoten eines beliebigen Typs in einem Cluster. Wenn nichts angegeben ist, gelten die Standardlimits.
maxClusterNodeCount

integer

Optional. Maximale Anzahl von Knoten eines beliebigen Typs in einem Cluster. Wenn nichts angegeben ist, gelten die Standardlimits.
coolDownPeriod

string (Duration format)

Optional. Die Mindestdauer zwischen aufeinanderfolgenden Autoscaling-Vorgängen. Sie beginnt, sobald das Hinzufügen oder Entfernen von Knoten abgeschlossen ist. Wenn keine Angabe erfolgt, wird standardmäßig 30 Minuten verwendet. Die Cooldown-Dauer muss in vollen Minuten angegeben werden (z. B. 30, 31, 50, 180 Minuten).

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „s“. Beispiel: "3.5s".

AutoscalingPolicy

Die Autoscaling-Richtlinie beschreibt das Verhalten des Autoscalings in Bezug auf die Ressourcennutzung. Der Scale-out-Vorgang wird eingeleitet, wenn die Auslastung EINEN der entsprechenden Grenzwerte überschreitet. Der Vorgang zum Herunterskalieren wird eingeleitet, wenn die Auslastung unter ALLEN entsprechenden Schwellenwerten liegt.

JSON-Darstellung 
{
  "nodeTypeId": string,
  "scaleOutSize": integer,
  "cpuThresholds": {
    object (Thresholds)
  },
  "grantedMemoryThresholds": {
    object (Thresholds)
  },
  "consumedMemoryThresholds": {
    object (Thresholds)
  },
  "storageThresholds": {
    object (Thresholds)
  }
}
Felder
nodeTypeId

string

Erforderlich. Die kanonische Kennung des Knotentyps, der hinzugefügt oder entfernt werden soll. Entspricht dem NodeType.
scaleOutSize

integer

Erforderlich. Anzahl der Knoten, die einem Cluster während eines Scale-out-Vorgangs hinzugefügt werden sollen. Muss für gestreckte Cluster durch 2 teilbar sein. Bei einem Vorgang zum Herunterskalieren wird in einer einzelnen Iteration nur ein Knoten (oder zwei bei gestreckten Clustern) entfernt.
cpuThresholds

object (Thresholds)

Optional. Auslastungsschwellenwerte für die CPU-Auslastung.
grantedMemoryThresholds

object (Thresholds)

Optional. Auslastungsgrenzwerte für die Menge des gewährten Arbeitsspeichers.
consumedMemoryThresholds

object (Thresholds)

Optional. Auslastungsschwellenwerte in Bezug auf die Menge des verbrauchten Arbeitsspeichers.
storageThresholds

object (Thresholds)

Optional. Auslastungsgrenzwerte in Bezug auf die Menge des verbrauchten Speichers.

Grenzwerte

Schwellenwerte definieren die Nutzung von Ressourcen, die Scale-out- und Scale-in-Vorgänge auslösen.

JSON-Darstellung 
{
  "scaleOut": integer,
  "scaleIn": integer
}
Felder
scaleOut

integer

Erforderlich. Die Auslastung, die den Scale-out-Vorgang in Prozent auslöst.
scaleIn

integer

Erforderlich. Die Auslastung, die den Scale-in-Vorgang in Prozent auslöst.

DatastoreMountConfig

Konfiguration der Datastore-Bereitstellung

JSON-Darstellung 
{
  "fileShare": string,
  "datastore": string,
  "datastoreNetwork": {
    object (DatastoreNetwork)
  },
  "accessMode": enum (AccessMode),
  "nfsVersion": enum (NfsVersion),
  "servers": [
    string
  ]
}
Felder
fileShare

string

Nur Ausgabe. Name der Dateifreigabe.
datastore

string

Erforderlich. Der Ressourcenname des Datenspeichers, der bereitgestellt werden soll. Ressourcennamen sind schemalose URIs, die den Konventionen unter https://cloud.google.com/apis/design/resource_names entsprechen. Beispiel: projects/my-project/locations/us-central1/datastores/my-datastore
datastoreNetwork

object (DatastoreNetwork)

Erforderlich. Die Netzwerkkonfiguration für den Datastore.
accessMode

enum (AccessMode)

Optional. Der Zugriffsmodus des NFS-Volumes. Optional. Der Standardwert READ_WRITE wird verwendet.
nfsVersion

enum (NfsVersion)

Optional. Das vom NFS-Volume unterstützte NFS-Protokoll. Der verwendete Standardwert ist NFS_V3
servers[]

string

Nur Ausgabe. Server-IP-Adressen des NFS-Volumes. Für NFS 3 können Sie nur eine einzelne Server-IP-Adresse oder DNS-Namen angeben.

DatastoreNetwork

Die Netzwerkkonfiguration für den Datastore.

JSON-Darstellung 
{
  "subnet": string,
  "mtu": integer,
  "networkPeering": string,
  "connectionCount": integer
}
Felder
subnet

string

Erforderlich. Der Ressourcenname des Subnetzes. Ressourcennamen sind schemalose URIs, die den Konventionen unter https://cloud.google.com/apis/design/resource_names folgen, z. B. „projects/my-project/locations/us-central1/subnets/my-subnet“.
mtu

integer

Optional. Der MTU-Wert wird für den NFS-Traffic auf dem VMKernel-Adapter festgelegt. Wenn nicht angegeben, wird eine MTU von 1.500 verwendet. Wenn Sie Jumbo Frames verwenden möchten, legen Sie diesen Wert auf 8.896 fest. Wir empfehlen, diesen Wert basierend auf der Leistung des NFS-Traffics anzupassen. Die Leistung kann mit Benchmarking-E/A-Tools wie dem Dienstprogramm „fio“ (Flexibler E/A-Tester) ermittelt werden.
networkPeering

string

Nur Ausgabe. Der Ressourcenname des Netzwerk-Peerings, der für den Zugriff auf die Dateifreigabe durch Clients in der privaten Cloud verwendet wird. Ressourcennamen sind schemalose URIs, die den Konventionen unter https://cloud.google.com/apis/design/resource_names folgen, z. B. „projects/my-project/locations/us-central1/networkPeerings/my-network-peering“.
connectionCount

integer

Optional. Mit „connectionCount“ werden mehrere Verbindungen vom NFS-Client auf dem ESXi-Host zum NFS-Server festgelegt. Eine höhere Anzahl von Verbindungen führt zu einer besseren Leistung bei Datenspeichern. In der API „clusters.mountDatastore“ sind standardmäßig maximal vier Verbindungen konfiguriert. Der Nutzer kann den Wert von „connectionCount“ zwischen 1 und 4 festlegen. „Connection_count“ wird ab vSphere 8.0u1 unterstützt. Bei früheren Versionen wird die Anzahl der Verbindungen auf den ESXi-Hosts auf 1 festgelegt.

AccessMode

Der Zugriffsmodus des NFS-Volumes.

Enums
ACCESS_MODE_UNSPECIFIED Der Standardwert. Dieser Wert sollte niemals verwendet werden.
READ_ONLY Auf NFS wird von Hosts im Lesemodus zugegriffen.
READ_WRITE Auf NFS wird von Hosts im Lese- und Schreibmodus zugegriffen

NfsVersion

Das vom NFS-Volume unterstützte NFS-Protokoll.

Enums
NFS_VERSION_UNSPECIFIED Der Standardwert. Dieser Wert sollte niemals verwendet werden.
NFS_V3 NFS 3

Methoden

create

 Erstellt einen neuen Cluster in einer bestimmten privaten Cloud.

delete

 Löscht eine Cluster-Ressource.

get

 Ruft eine Cluster-Ressource anhand ihres Ressourcennamens ab.

getIamPolicy

 Ruft die Zugriffssteuerungsrichtlinie für eine Ressource ab.

list

 Listet Cluster-Ressourcen in einer bestimmten privaten Cloud auf.

mountDatastore

 Stellt ein Datastore in einer Clusterressource bereit

patch

 Ändert eine Cluster-Ressource.

setIamPolicy

 Legt die Zugriffssteuerungsrichtlinie für die angegebene Ressource fest.

testIamPermissions

 Gibt die Berechtigungen des Aufrufers für die angegebene Ressource zurück.

unmountDatastore

 Hebt die Bereitstellung eines Datastore für eine Clusterressource auf.