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

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.
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_SITE_TURNUP Die Zone ist für die Inbetriebnahme der Website bereit.
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
}
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.

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.

SubscriptionConfig

Eine Nachricht zum Speichern einer Abo-Konfiguration.

JSON-Darstellung 
{
  "subscriptionId": string,
  "billingId": string,
  "state": enum (SubscriptionState)
}
Felder
subscriptionId

string

Nur Ausgabe. Die eindeutige ID des Abos.
billingId

string

Nur Ausgabe. Die Google Cloud Billing-ID, unter der das Abo erstellt wird.
state

enum (SubscriptionState)

Nur Ausgabe. Der aktuelle Status des Abos.

SubscriptionState

Enum-Wert, der den Status des Abos darstellt.

Enums
SUBSCRIPTION_STATE_UNSPECIFIED Kein Status angegeben
ACTIVE Der Status „Aktiv“ bedeutet, dass das Abo erfolgreich erstellt wurde und die Abrechnung erfolgt.
INACTIVE „Inaktiv“ bedeutet, dass das Abo erfolgreich erstellt wurde, die Abrechnung aber noch nicht begonnen hat.
ERROR Das Abo hat einen Fehlerstatus.
FAILED_TO_RETRIEVE Der Abostatus konnte nicht abgerufen werden. Möglicherweise handelt es sich dabei um ein vorübergehendes Problem. Der Nutzer sollte die Anfrage noch einmal senden.
COMPLETED Das Abo wurde beendet, weil das Enddatum erreicht wurde.

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.