REST Resource: projects.locations.zones

Ressource: Zone

Eine Zone mit einer Reihe von Hardwaregeräten.

JSON-Darstellung 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "displayName": string,
  "state": enum (State),
  "contacts": [
    {
      object (Contact)
    }
  ],
  "ciqUri": string,
  "networkConfig": {
    object (ZoneNetworkConfig)
  },
  "globallyUniqueId": string,
  "subscriptionConfigs": [
    {
      object (SubscriptionConfig)
    }
  ],
  "provisioningState": enum (ProvisioningState),
  "skipClusterProvisioning": boolean,
  "clusterIntentRequired": boolean,
  "clusterIntentVerified": boolean,
  "aiCapable": boolean,
  "intelPccsKey": string
}
Felder
name

string

ID. Name dieser Zone. Format: projects/{project}/locations/{location}/zones/{zone}
createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem diese Zone 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. Zeitpunkt der letzten Aktualisierung dieser Zone.

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

map (key: string, value: string)

Optional. Labels, die dieser Zone als Schlüssel/Wert-Paare zugeordnet sind. Weitere Informationen zu Labels finden Sie unter Labels erstellen und verwalten.

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

string

Optional. Nutzerfreundlicher Anzeigename dieser Zone.
state

enum (State)

Nur Ausgabe. Der aktuelle Status für diese Zone.
contacts[]

object (Contact)

Erforderlich. Die Ansprechpartner der Zone (Name, E-Mail-Adresse, Telefonnummer). Reihenfolgeabhängig: Der erste Kontakt in der Liste ist der primäre Kontakt, der zweite der sekundäre usw.
ciqUri

string

Nur Ausgabe. Link zum CIQ-Arbeitsblatt (Customer Intake Questionnaire) für diese Zone.
networkConfig

object (ZoneNetworkConfig)

Optional. Netzwerkkonfiguration für diese Zone.
globallyUniqueId

string

Nur Ausgabe. Global eindeutige Kennung, die für diese Edge-Zone generiert wurde.
subscriptionConfigs[]

object (SubscriptionConfig)

Nur Ausgabe. Abokonfigurationen für diese Zone.
provisioningState

enum (ProvisioningState)

Nur Ausgabe. Bereitstellungsstatus für Konfigurationen wie MAC-Adressen.
skipClusterProvisioning

boolean

Optional. Gibt an, ob der Schritt zur Clusterbereitstellung während der Inbetriebnahme übersprungen werden soll. Ist dieser Wert „true“, wird der Kubernetes-Cluster erstellt, nachdem die Hardware der Zone am Standort des Kunden installiert wurde.
clusterIntentRequired

boolean

Nur Ausgabe. Gibt an, ob der Kunde eine gültige Cluster-Intention angeben muss, bevor die Bestellung angenommen werden kann. Wenn „true“, kann die Bestellung erst angenommen werden, wenn der Cluster-Intent vorhanden ist. Damit soll eine frühzeitige Validierung erzwungen und Verzögerungen durch fehlende Konfiguration verhindert werden.
clusterIntentVerified

boolean

Nur Ausgabe. Gibt an, ob die bereitgestellte Cluster-Absicht erfolgreich überprüft wurde. Dieses Flag sorgt dafür, dass der Cluster-Intent vorhanden ist, bevor die Bestellung angenommen werden kann.
aiCapable

boolean

Nur Ausgabe. Gibt an, ob diese Zone für den Gemini auf GDC Software-Cluster vorgesehen ist.
intelPccsKey

string

Optional. PCCS-Schlüssel (Intel Platform Config and Attestation Service) zum Bereitstellen und Attestieren von KI-Beschleunigerhardware. Wird von Zonen verwendet, die Gemini im GDC-Softwarecluster bereitstellen.

Bundesland

Gültige Status für eine Zone.

Enums
STATE_UNSPECIFIED Der Status der Zone ist nicht angegeben.
ADDITIONAL_INFO_NEEDED Damit wir mit der Bearbeitung fortfahren können, sind weitere Informationen vom Kunden erforderlich.
INFO_COMPLETE Die Zone enthält alle erforderlichen Informationen, um mit der Vorbereitung der Zone zu beginnen.
PREPARING Google bereitet die Zone vor.
READY_FOR_CUSTOMER_FACTORY_TURNUP_CHECKS Die Einrichtung in der Fabrik war erfolgreich.
CUSTOMER_FACTORY_TURNUP_CHECKS_STARTED In der Zone werden Prüfungen zur Inbetriebnahme ausgeführt.
READY_FOR_PROVISIONING Die Zone kann bereitgestellt werden.
READY_FOR_SITE_TURNUP Die Zone ist für die Inbetriebnahme der Website bereit.
PROVISIONING_STARTED Die Bereitstellung der Zone hat begonnen.
PROVISIONING_FAILED Die Bereitstellung der Zone ist fehlgeschlagen.
CUSTOMER_FACTORY_TURNUP_CHECKS_FAILED Die Zone hat die Prüfungen bei der Inbetriebnahme im Werk nicht bestanden.
ACTIVE Die Zone kann verwendet werden.
CANCELLED Die Zone wurde gekündigt.

ZoneNetworkConfig

Netzwerkkonfiguration für eine Zone.

JSON-Darstellung 
{
  "machineMgmtIpv4Range": string,
  "kubernetesNodeIpv4Range": string,
  "kubernetesControlPlaneIpv4Range": string,
  "managementIpv4Subnet": {
    object (Subnet)
  },
  "kubernetesIpv4Subnet": {
    object (Subnet)
  },
  "dnsIpv4Addresses": [
    string
  ],
  "kubernetesPrimaryVlanId": integer,
  "aiCapableIpv4Subnet": {
    object (Subnet)
  },
  "bgpConfig": {
    object (BGPConfig)
  },
  "topLevelDomain": string,
  "torSwitchType": string
}
Felder
machineMgmtIpv4Range

string

Erforderlich. Ein IPv4-Adressblock für die Maschinenverwaltung. Muss ein privater RFC1918- oder öffentlicher CIDR-Block sein, der groß genug ist, um mindestens eine Adresse pro Maschine in der Zone zuzuweisen. Muss in managementIpv4Subnet liegen und darf sich nicht mit anderen Adressbereichen überschneiden.
kubernetesNodeIpv4Range

string

Erforderlich. Ein IPv4-Adressblock für Kubernetes-Knoten. Muss ein privater RFC1918- oder öffentlicher CIDR-Block sein, der groß genug ist, um mindestens eine Adresse pro Maschine in der Zone zuzuweisen. Muss in kubernetesIpv4Subnet liegen und darf sich nicht mit anderen Adressbereichen überschneiden.
kubernetesControlPlaneIpv4Range

string

Erforderlich. Ein IPv4-Adressblock für die Kubernetes-Steuerungsebene. Sollte ein privater RFC1918- oder öffentlicher CIDR-Block sein, der groß genug ist, um mindestens eine Adresse pro Cluster in der Zone zuzuweisen. Muss in kubernetesIpv4Subnet liegen und darf sich nicht mit anderen Adressbereichen überschneiden.
managementIpv4Subnet

object (Subnet)

Erforderlich. Ein IPv4-Subnetz für das Verwaltungsnetzwerk.
kubernetesIpv4Subnet

object (Subnet)

Optional. Ein IPv4-Subnetz für das Kubernetes-Netzwerk. Wenn nichts angegeben ist, ist das Kubernetes-Subnetz dasselbe wie das Verwaltungs-Subnetz.
dnsIpv4Addresses[]

string

Optional. DNS-Nameserver. Die GDC-Infrastruktur löst DNS-Abfragen über diese IP-Adressen auf. Wenn keine Angabe erfolgt, wird Google DNS verwendet.
kubernetesPrimaryVlanId

integer

Optional. Kubernetes-VLAN-ID. Standardmäßig befinden sich der Kubernetes-Knoten und das primäre Kubernetes-Netzwerk im selben VLAN wie das Netzwerk für die Maschinenverwaltung. Zur Netzwerksegmentierung können diese optional getrennt werden.
aiCapableIpv4Subnet

object (Subnet)

Optional. IPv4-Subnetz für eine Zone, in der Gemini in einem GDC-Softwarecluster bereitgestellt wird. Das letzte /29-Subnetz des angegebenen Bereichs ist für DHCP reserviert.
bgpConfig

object (BGPConfig)

Optional. BGP-spezifische Konfiguration (Border Gateway Protocol) für diese Zone. Wird von Zonen verwendet, die Gemini im GDC-Softwarecluster bereitstellen.
topLevelDomain

string

Optional. Benutzerdefinierte Top-Level-Domain für diese Zone. Wird von Zonen verwendet, die Gemini im GDC-Softwarecluster bereitstellen.
torSwitchType

string

Optional. Zusätzliche Informationen zum ToR-Switch-Typ des Kunden. Wird von Zonen verwendet, die Gemini im GDC-Softwarecluster bereitstellen.

Subnetz

Stellt ein Subnetz dar.

JSON-Darstellung 
{
  "addressRange": string,
  "defaultGatewayIpAddress": string
}
Felder
addressRange

string

Erforderlich. Adressbereich für dieses Subnetz in CIDR-Notation.
defaultGatewayIpAddress

string

Erforderlich. Standardgateway für dieses Subnetz.

BGPConfig

Konfiguration des Border Gateway Protocol (BGP).

JSON-Darstellung 
{
  "asn": string,
  "l3PeerIps": [
    string
  ]
}
Felder
asn

string

Erforderlich. BGP-ASN (Autonomous System Number).
l3PeerIps[]

string

Erforderlich. BGP-Peer-IP-Adressen. Mindestens zwei L3-Peer-IPs sind erforderlich.

ProvisioningState

Gültige Bereitstellungsstatus für Konfigurationen wie MAC-Adressen.

Enums
PROVISIONING_STATE_UNSPECIFIED Der Status der Nutzerverwaltung ist nicht angegeben.
PROVISIONING_REQUIRED Die Bereitstellung ist erforderlich. Von Google festgelegt.
PROVISIONING_IN_PROGRESS Die Bereitstellung läuft. Vom Kunden festgelegt.
PROVISIONING_COMPLETE Die Bereitstellung ist abgeschlossen. Vom Kunden festgelegt.

Methoden

create

 Erstellt eine neue Zone in einem bestimmten Projekt und an einem bestimmten Standort.

delete

 Löscht eine Zone.

get

 Ruft Details zu einer Zone ab.

list

 Listet Zonen in einem bestimmten Projekt und an einem bestimmten Standort auf.

patch

 Aktualisiert die Parameter einer Zone.

signal

 Gibt den Status einer Zone an.