REST Resource: projects.locations.bareMetalAdminClusters

Ressource: BareMetalAdminCluster

Ressource, die einen Bare-Metal-Administratorcluster darstellt.

JSON-Darstellung 
{
  "name": string,
  "description": string,
  "uid": string,
  "bareMetalVersion": string,
  "state": enum (State),
  "endpoint": string,
  "reconciling": boolean,
  "createTime": string,
  "updateTime": string,
  "deleteTime": string,
  "localName": string,
  "etag": string,
  "annotations": {
    string: string,
    ...
  },
  "networkConfig": {
    object (BareMetalAdminNetworkConfig)
  },
  "controlPlane": {
    object (BareMetalAdminControlPlaneConfig)
  },
  "loadBalancer": {
    object (BareMetalAdminLoadBalancerConfig)
  },
  "storage": {
    object (BareMetalAdminStorageConfig)
  },
  "fleet": {
    object (Fleet)
  },
  "clusterOperations": {
    object (BareMetalAdminClusterOperationsConfig)
  },
  "status": {
    object (ResourceStatus)
  },
  "maintenanceConfig": {
    object (BareMetalAdminMaintenanceConfig)
  },
  "maintenanceStatus": {
    object (BareMetalAdminMaintenanceStatus)
  },
  "validationCheck": {
    object (ValidationCheck)
  },
  "nodeConfig": {
    object (BareMetalAdminWorkloadNodeConfig)
  },
  "proxy": {
    object (BareMetalAdminProxyConfig)
  },
  "securityConfig": {
    object (BareMetalAdminSecurityConfig)
  },
  "nodeAccessConfig": {
    object (BareMetalAdminNodeAccessConfig)
  },
  "osEnvironmentConfig": {
    object (BareMetalAdminOsEnvironmentConfig)
  },
  "binaryAuthorization": {
    object (BinaryAuthorization)
  }
}
Felder
name

string

Nicht veränderbar. Der Ressourcenname des Bare-Metal-Administratorclusters.
description

string

Eine für Menschen lesbare Beschreibung dieses Bare-Metal-Administratorclusters.
uid

string

Nur Ausgabe. Die eindeutige ID des Bare-Metal-Administratorclusters.
bareMetalVersion

string

Die Anthos-Cluster auf Bare Metal-Version für den Bare Metal-Administratorcluster.
state

enum (State)

Nur Ausgabe. Der aktuelle Status des Bare-Metal-Administratorclusters.
endpoint

string

Nur Ausgabe. Der IP-Adressname des API-Servers des Bare-Metal-Administratorclusters.
reconciling

boolean

Nur Ausgabe. Wenn festgelegt, werden aktuell Änderungen am Bare-Metal-Administratorcluster durchgeführt.
createTime

string (Timestamp format)

Nur Ausgabe. Die Zeit, zu der dieser Bare-Metal-Administratorcluster erstellt wurde.

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. Die Zeit, zu der dieser Bare-Metal-Administratorcluster zuletzt aktualisiert wurde.

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

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem dieser Bare-Metal-Administratorcluster gelöscht wurde. Wenn die Ressource nicht gelöscht wird, muss dieses Feld leer sein.

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

string

Nur Ausgabe. Der Objektname der benutzerdefinierten Ressource des Bare-Metal-Clusters. Dieses Feld wird verwendet, um Konflikte bei Namen zu vermeiden, wenn vorhandene Cluster in der API registriert werden. Wenn dieses Feld im Rahmen der Clusterregistrierung verwendet wird, unterscheidet es sich von der ID im Ressourcennamen. Bei neuen Clustern entspricht dieses Feld dem vom Nutzer angegebenen Clusternamen und ist in der letzten Komponente des Ressourcennamens sichtbar. Sie kann nicht geändert werden.

Alle Nutzer sollten diesen Namen verwenden, um mit gkectl oder kubectl auf ihren Cluster zuzugreifen. In den Controllerlogs des Administratorclusters wird der lokale Name angezeigt.
etag

string

Diese Prüfsumme wird vom Server anhand des Werts anderer Felder berechnet und kann bei Aktualisierungs- und Löschanfragen gesendet werden, um sicherzustellen, dass der Client vor dem Fortfahren einen aktuellen Wert hat. Ermöglicht Clients durch optimistische Nebenläufigkeitserkennung, konsistente Read-Modify-Write-Vorgänge auszuführen.
annotations

map (key: string, value: string)

Annotationen zum Bare-Metal-Administratorcluster. Für dieses Feld gelten die gleichen Einschränkungen wie für Kubernetes-Annotationen. Die Gesamtgröße aller Schlüssel und Werte ist auf 256 KB begrenzt. Der Schlüssel kann zwei Segmente haben: Präfix (optional) und Name (erforderlich), getrennt durch einen Schrägstrich (/). Das Präfix muss eine DNS-Subdomain sein. Der Name darf maximal 63 Zeichen lang sein und muss mit alphanumerischen Zeichen beginnen und enden. Dazwischen müssen Bindestriche (-), Unterstriche (_), Punkte (.) und alphanumerische Zeichen liegen.

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

object (BareMetalAdminNetworkConfig)

Netzwerkkonfiguration.
controlPlane

object (BareMetalAdminControlPlaneConfig)

Konfiguration der Steuerungsebene.
loadBalancer

object (BareMetalAdminLoadBalancerConfig)

Load-Balancer-Konfiguration.
storage

object (BareMetalAdminStorageConfig)

Speicherkonfiguration.
fleet

object (Fleet)

Nur Ausgabe. Flottenkonfiguration für den Cluster.
clusterOperations

object (BareMetalAdminClusterOperationsConfig)

Konfiguration von Clustervorgängen.
status

object (ResourceStatus)

Nur Ausgabe. ResourceStatus, der den detaillierten Clusterstatus darstellt.
maintenanceConfig

object (BareMetalAdminMaintenanceConfig)

Wartungskonfiguration.
maintenanceStatus

object (BareMetalAdminMaintenanceStatus)

Nur Ausgabe. MaintenanceStatus, der den Status der Wartung darstellt.
validationCheck

object (ValidationCheck)

Nur Ausgabe. ValidationCheck, der das Ergebnis der Preflight-Prüfung darstellt.
nodeConfig

object (BareMetalAdminWorkloadNodeConfig)

Konfiguration von Arbeitslastknoten.
proxy

object (BareMetalAdminProxyConfig)

Proxykonfiguration.
securityConfig

object (BareMetalAdminSecurityConfig)

Sicherheitsbezogene Konfiguration.
nodeAccessConfig

object (BareMetalAdminNodeAccessConfig)

Konfigurationen für den Knotenzugriff.
osEnvironmentConfig

object (BareMetalAdminOsEnvironmentConfig)

Konfigurationen im Zusammenhang mit der Betriebssystemumgebung.
binaryAuthorization

object (BinaryAuthorization)

Konfigurationen im Zusammenhang mit der Binärautorisierung.

Bundesland

Der Lebenszyklusstatus des Bare-Metal-Administratorclusters.

Enums
STATE_UNSPECIFIED Nicht definiert.
PROVISIONING Der Status PROVISIONING gibt an, dass der Cluster erstellt wird.
RUNNING Der Status „RUNNING“ gibt an, dass der Cluster erstellt wurde und vollständig nutzbar ist.
RECONCILING Der Status RECONCILING gibt an, dass der Cluster aktualisiert wird. Er ist weiterhin verfügbar, aber die Leistung ist möglicherweise beeinträchtigt.
STOPPING Der Status STOPPING gibt an, dass der Cluster gelöscht wird.
ERROR Der Status „ERROR“ gibt an, dass sich der Cluster in einem fehlerhaften, nicht wiederherstellbaren Zustand befindet.
DEGRADED Der Status „DEGRADED“ gibt an, dass zum Wiederherstellen der vollen Funktionalität des Clusters eine Nutzeraktion erforderlich ist.

BareMetalAdminNetworkConfig

BareMetalAdminNetworkConfig gibt die Cluster-Netzwerkkonfiguration an.

JSON-Darstellung 
{

  // Union field cluster_cidr_configuration can be only one of the following:
  "islandModeCidr": {
    object (BareMetalAdminIslandModeCidrConfig)
  }
  // End of list of possible types for union field cluster_cidr_configuration.
}
Felder
Union-Feld cluster_cidr_configuration. Die CIDR-Konfiguration, die im Administratorcluster verwendet werden soll. Für cluster_cidr_configuration ist nur einer der folgenden Werte zulässig:
islandModeCidr

object (BareMetalAdminIslandModeCidrConfig)

Konfiguration für den CIDR-Block des Inselmodus.

BareMetalAdminIslandModeCidrConfig

BareMetalAdminIslandModeCidrConfig gibt die Cluster-CIDR-Konfiguration an, wenn der Inselmodus ausgeführt wird.

JSON-Darstellung 
{
  "serviceAddressCidrBlocks": [
    string
  ],
  "podAddressCidrBlocks": [
    string
  ]
}
Felder
serviceAddressCidrBlocks[]

string

Erforderlich. Allen Diensten im Cluster wird eine RFC1918-IPv4-Adresse aus diesen Bereichen zugewiesen. Dieses Feld kann nach dem Erstellen nicht mehr geändert werden.
podAddressCidrBlocks[]

string

Erforderlich. Allen Pods im Cluster wird eine RFC1918-IPv4-Adresse aus diesen Bereichen zugewiesen. Dieses Feld kann nach dem Erstellen nicht mehr geändert werden.

BareMetalAdminControlPlaneConfig

BareMetalAdminControlPlaneConfig gibt die Konfiguration der Steuerungsebene an.

JSON-Darstellung 
{
  "controlPlaneNodePoolConfig": {
    object (BareMetalAdminControlPlaneNodePoolConfig)
  },
  "apiServerArgs": [
    {
      object (BareMetalAdminApiServerArgument)
    }
  ]
}
Felder
controlPlaneNodePoolConfig

object (BareMetalAdminControlPlaneNodePoolConfig)

Erforderlich. Konfiguriert den Knotenpool, auf dem die Steuerungsebene ausgeführt wird. Falls angegeben, wird der entsprechende NodePool für die Steuerungsebene des Clusters erstellt. Der NodePool hat denselben Namen und Namespace wie der Cluster.
apiServerArgs[]

object (BareMetalAdminApiServerArgument)

Passt die Standardargumente des API-Servers an. Es wird nur eine Teilmenge der benutzerdefinierten Flags unterstützt. Das genaue Format finden Sie in der API-Server-Dokumentation unter https://kubernetes.io/docs/reference/command-line-tools-reference/kube-apiserver/.

BareMetalAdminControlPlaneNodePoolConfig

BareMetalAdminControlPlaneNodePoolConfig gibt die Konfiguration des Knotenpools der Steuerungsebene an. Wir haben eine Knotenpoolkonfiguration für die Steuerungsebene, damit wir in Zukunft flexibel Felder für die Steuerungsebene unterstützen können.

JSON-Darstellung 
{
  "nodePoolConfig": {
    object (BareMetalNodePoolConfig)
  }
}
Felder
nodePoolConfig

object (BareMetalNodePoolConfig)

Erforderlich. Die generische Konfiguration für einen Knotenpool, auf dem die Steuerungsebene ausgeführt wird.

BareMetalAdminApiServerArgument

BareMetalAdminApiServerArgument stellt ein Name->Wert-Paar für ein Argument dar. Es wird nur eine Teilmenge der benutzerdefinierten Flags unterstützt. Das genaue Format finden Sie in der API-Server-Dokumentation unter https://kubernetes.io/docs/reference/command-line-tools-reference/kube-apiserver/.

JSON-Darstellung 
{
  "argument": string,
  "value": string
}
Felder
argument

string

Erforderlich. Der Argumentname, wie er in der Befehlszeile des API-Servers angezeigt wird. Entfernen Sie die führenden Bindestriche.
value

string

Erforderlich. Der Wert des Arguments, wie er an die Befehlszeile des API-Servers übergeben wird.

BareMetalAdminLoadBalancerConfig

BareMetalAdminLoadBalancerConfig gibt die Load-Balancer-Konfiguration an.

JSON-Darstellung 
{
  "vipConfig": {
    object (BareMetalAdminVipConfig)
  },
  "portConfig": {
    object (BareMetalAdminPortConfig)
  },

  // Union field load_balancer_configuration can be only one of the following:
  "manualLbConfig": {
    object (BareMetalAdminManualLbConfig)
  }
  // End of list of possible types for union field load_balancer_configuration.
}
Felder
vipConfig

object (BareMetalAdminVipConfig)

Die vom Load-Balancer verwendeten VIPs.
portConfig

object (BareMetalAdminPortConfig)

Konfiguriert die Ports, an denen der Load-Balancer auf Anfragen wartet.
Union-Feld load_balancer_configuration. Die Load-Balancer-Konfiguration, die im Administratorcluster verwendet werden soll. Für load_balancer_configuration ist nur einer der folgenden Werte zulässig:
manualLbConfig

object (BareMetalAdminManualLbConfig)

Manuell konfigurierte Load-Balancer.

BareMetalAdminVipConfig

BareMetalAdminVipConfig für Bare Metal-Load-Balancer-Konfigurationen.

JSON-Darstellung 
{
  "controlPlaneVip": string
}
Felder
controlPlaneVip

string

Die VIP, die Sie zuvor für die Kubernetes API dieses Bare-Metal-Administratorclusters reserviert haben.

BareMetalAdminPortConfig

BareMetalAdminPortConfig ist die Spezifikation von Load-Balancer-Ports.

JSON-Darstellung 
{
  "controlPlaneLoadBalancerPort": integer
}
Felder
controlPlaneLoadBalancerPort

integer

Der Port, den von der Steuerungsebene gehostete Load Balancer überwachen.

BareMetalAdminManualLbConfig

BareMetalAdminManualLbConfig stellt Konfigurationsparameter für einen manuellen Load Balancer dar.

JSON-Darstellung 
{
  "enabled": boolean
}
Felder
enabled

boolean

Gibt an, ob das manuelle Load-Balancing aktiviert ist.

BareMetalAdminStorageConfig

BareMetalAdminStorageConfig gibt die Clusterspeicherkonfiguration an.

JSON-Darstellung 
{
  "lvpShareConfig": {
    object (BareMetalLvpShareConfig)
  },
  "lvpNodeMountsConfig": {
    object (BareMetalLvpConfig)
  }
}
Felder
lvpShareConfig

object (BareMetalLvpShareConfig)

Erforderlich. Gibt die Konfiguration für lokale PersistentVolumes an, die von Unterverzeichnissen in einem freigegebenen Dateisystem gestützt werden. Diese Unterverzeichnisse werden bei der Clustererstellung automatisch erstellt.
lvpNodeMountsConfig

object (BareMetalLvpConfig)

Erforderlich. Gibt die Konfiguration für lokale PersistentVolumes an, die durch bereitgestellte Knotenlaufwerke gestützt werden. Diese Laufwerke müssen vom Nutzer formatiert und bereitgestellt werden, was vor oder nach der Clustererstellung erfolgen kann.

BareMetalAdminClusterOperationsConfig

BareMetalAdminClusterOperationsConfig gibt die Observability-Infrastruktur des Administratorclusters an.

JSON-Darstellung 
{
  "enableApplicationLogs": boolean
}
Felder
enableApplicationLogs

boolean

Gibt an, ob die Erfassung von Anwendungslogs/-messwerten (zusätzlich zu Systemlogs/-messwerten) aktiviert werden soll.

BareMetalAdminMaintenanceConfig

BareMetalAdminMaintenanceConfig gibt Konfigurationen an, um Knoten von CRs des Bare Metal-Administratorclusters in den Wartungsmodus zu versetzen und aus dem Wartungsmodus zu entfernen.

JSON-Darstellung 
{
  "maintenanceAddressCidrBlocks": [
    string
  ]
}
Felder
maintenanceAddressCidrBlocks[]

string

Erforderlich. Alle IPv4-Adressen aus diesen Bereichen werden in den Wartungsmodus versetzt. Knoten im Wartungsmodus werden gesperrt und entleert. Wenn beides zutrifft, wird die Annotation „baremetal.cluster.gke.io/maintenance“ für die Knotenressource festgelegt.

BareMetalAdminMaintenanceStatus

BareMetalAdminMaintenanceStatus stellt den Wartungsstatus für die Knoten des Bare-Metal-Administratorclusters dar.

JSON-Darstellung 
{
  "machineDrainStatus": {
    object (BareMetalAdminMachineDrainStatus)
  }
}
Felder
machineDrainStatus

object (BareMetalAdminMachineDrainStatus)

Stellt den Status von Knoten dar, die gerade geleert werden oder bereits geleert wurden. Damit wird der Fortschritt des Clusterupgrades angezeigt.

BareMetalAdminMachineDrainStatus

BareMetalAdminMachineDrainStatus stellt den Status von Bare-Metal-Knotencomputern dar, die gerade geleert werden.

JSON-Darstellung 
{
  "drainingMachines": [
    {
      object (BareMetalAdminDrainingMachine)
    }
  ],
  "drainedMachines": [
    {
      object (BareMetalAdminDrainedMachine)
    }
  ]
}
Felder
drainingMachines[]

object (BareMetalAdminDrainingMachine)

Die Liste der Maschinen, die Strom verbrauchen.
drainedMachines[]

object (BareMetalAdminDrainedMachine)

Die Liste der entleerten Maschinen.

BareMetalAdminDrainingMachine

BareMetalAdminDrainingMachine steht für die Maschinen, die derzeit entleert werden.

JSON-Darstellung 
{
  "nodeIp": string,
  "podCount": integer
}
Felder
nodeIp

string

IP-Adresse der Maschine, die per Drain beendet wird.
podCount

integer

Die Anzahl der Pods, die noch entleert werden müssen.

BareMetalAdminDrainedMachine

BareMetalAdminDrainedMachine steht für die Maschinen, die geleert wurden.

JSON-Darstellung 
{
  "nodeIp": string
}
Felder
nodeIp

string

IP-Adresse des geleerten Geräts.

BareMetalAdminWorkloadNodeConfig

BareMetalAdminWorkloadNodeConfig gibt die Konfigurationen für Arbeitslastknoten an.

JSON-Darstellung 
{
  "maxPodsPerNode": string
}
Felder
maxPodsPerNode

string (int64 format)

Die maximale Anzahl von Pods, die auf einem Knoten ausgeführt werden können. Die Größe des CIDR-Bereichs, der dem Knoten zugewiesen wird, wird aus diesem Parameter abgeleitet. Standardmäßig werden 110 Pods pro Knoten erstellt. Die Obergrenze liegt sowohl für HA- als auch für Nicht-HA-Administratorcluster bei 250. Die Untergrenze liegt bei 64 für Administratorcluster ohne Hochverfügbarkeit und bei 32 für Administratorcluster mit Hochverfügbarkeit.

BareMetalAdminProxyConfig

BareMetalAdminProxyConfig gibt die Cluster-Proxykonfiguration an.

JSON-Darstellung 
{
  "uri": string,
  "noProxy": [
    string
  ]
}
Felder
uri

string

Erforderlich. Gibt die Adresse Ihres Proxyservers an. Beispiele: http://domain

ACHTUNG: Geben Sie keine Anmeldedaten im Format http://(username:password@)domain an, da diese vom Server abgelehnt werden.
noProxy[]

string

Eine Liste von IP-Adressen, Hostnamen und Domains, die den Proxy umgehen sollen. Beispiele: ["127.0.0.1", "beispiel.de", ".corp", "localhost"].

BareMetalAdminSecurityConfig

Gibt die sicherheitsbezogenen Einstellungen für den Bare-Metal-Administratorcluster an.

JSON-Darstellung 
{
  "authorization": {
    object (Authorization)
  }
}
Felder
authorization

object (Authorization)

Konfiguriert den Nutzerzugriff auf den Administratorcluster.

BareMetalAdminNodeAccessConfig

Gibt die Einstellungen für den Knotenzugriff für den Bare-Metal-Administratorcluster an.

JSON-Darstellung 
{
  "loginUser": string
}
Felder
loginUser

string

Erforderlich. „LoginUser“ ist der Nutzername, der für den Zugriff auf Knotenmaschinen verwendet wird. Wenn nichts festgelegt ist, wird standardmäßig „root“ verwendet.

BareMetalAdminOsEnvironmentConfig

Gibt die Betriebssystemeinstellungen für die Clusterbereitstellung an.

JSON-Darstellung 
{
  "packageRepoExcluded": boolean
}
Felder
packageRepoExcluded

boolean

Gibt an, ob das Paket-Repository beim Initialisieren von Bare-Metal-Maschinen hinzugefügt werden soll.

Methoden

create

 Erstellt einen neuen Bare-Metal-Administratorcluster in einem bestimmten Projekt und an einem bestimmten Standort.

enroll

 Registriert einen vorhandenen Bare-Metal-Administratorcluster in der Anthos On-Prem API in einem bestimmten Projekt und an einem bestimmten Standort.

get

 Ruft Details zu einem einzelnen Bare-Metal-Administratorcluster ab.

list

 Listet Bare-Metal-Administratorcluster in einem angegebenen Projekt und an einem angegebenen Standort auf.

patch

 Aktualisiert die Parameter eines einzelnen Bare-Metal-Administratorclusters.

queryVersionConfig

 Fragt die Versionskonfiguration des Bare Metal-Administratorclusters ab.