REST Resource: projects.locations.zones

Risorsa: Zone

Una zona che contiene un insieme di hardware.

Rappresentazione JSON 
{
  "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
}
Campi
name

string

Identificatore. Il nome di questa zona. Formato: projects/{project}/locations/{location}/zones/{zone}
createTime

string (Timestamp format)

Solo output. Ora in cui è stata creata questa zona.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. Ora dell'ultimo aggiornamento di questa zona.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
labels

map (key: string, value: string)

Facoltativo. Etichette associate a questa zona come coppie chiave-valore. Per saperne di più sulle etichette, consulta Creare e gestire le etichette.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
displayName

string

Facoltativo. Nome visualizzato intuitivo di questa zona.
state

enum (State)

Solo output. Lo stato attuale di questa zona.
contacts[]

object (Contact)

Obbligatorio. I punti di contatto della zona (nome, email, telefono). Dipendente dall'ordine: il primo contatto nell'elenco è il contatto principale, il secondo è il contatto secondario e così via.
ciqUri

string

Solo output. Link al foglio del questionario di acquisizione del cliente (CIQ) per questa zona.
networkConfig

object (ZoneNetworkConfig)

Facoltativo. Configurazione di Networking per questa zona.
globallyUniqueId

string

Solo output. Identificatore univoco globale generato per questa zona perimetrale.
subscriptionConfigs[]

object (SubscriptionConfig)

Solo output. Configurazioni di sottoscrizione per questa zona.
provisioningState

enum (ProvisioningState)

Solo output. Stato di provisioning per configurazioni come gli indirizzi MAC.
skipClusterProvisioning

boolean

Facoltativo. Se saltare o meno il passaggio di provisioning del cluster durante l'attivazione di fabbrica. Se è true, indica che il cluster Kubernetes verrà creato dopo l'installazione dell'hardware della zona presso la sede del cliente.
clusterIntentRequired

boolean

Solo output. Indica se il cliente deve fornire un intento di cluster valido prima di accettare l'ordine. Se impostato su true, l'ordine non può essere accettato finché non è presente l'intent del cluster. Viene utilizzato per applicare la convalida anticipata ed evitare ritardi causati dalla configurazione mancante.
clusterIntentVerified

boolean

Solo output. Indica se l'intent del cluster fornito è stato verificato correttamente. Questo flag garantisce che l'intent del cluster esista prima che l'ordine possa essere accettato.
aiCapable

boolean

Solo output. Indica se questa zona è per Gemini sul cluster software GDC.
intelPccsKey

string

Facoltativo. Chiave del servizio di configurazione e attestazione della piattaforma Intel (PCCS) per il provisioning e l'attestazione dell'hardware dell'acceleratore AI. Utilizzato dalle zone che forniscono Gemini sul cluster software GDC.

Stato

Stati validi per una zona.

Enum
STATE_UNSPECIFIED Lo stato della zona non è specificato.
ADDITIONAL_INFO_NEEDED Per procedere, sono necessarie ulteriori informazioni da parte del cliente.
INFO_COMPLETE La zona contiene tutte le informazioni necessarie per iniziare la preparazione.
PREPARING Google sta preparando la zona.
READY_FOR_CUSTOMER_FACTORY_TURNUP_CHECKS L'attivazione di fabbrica è riuscita.
CUSTOMER_FACTORY_TURNUP_CHECKS_STARTED La zona sta eseguendo i controlli di attivazione di fabbrica.
READY_FOR_PROVISIONING La zona è pronta per il provisioning.
READY_FOR_SITE_TURNUP La zona è pronta per l'attivazione del sito.
PROVISIONING_STARTED È stato avviato il provisioning della zona.
PROVISIONING_FAILED Il provisioning della zona non è riuscito.
CUSTOMER_FACTORY_TURNUP_CHECKS_FAILED La zona non ha superato i controlli di attivazione di fabbrica.
ACTIVE La zona è disponibile per l'uso.
CANCELLED La zona è stata annullata.

ZoneNetworkConfig

Configurazione di Networking per una zona.

Rappresentazione JSON 
{
  "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
}
Campi
machineMgmtIpv4Range

string

Obbligatorio. Un blocco di indirizzi IPv4 per la gestione delle macchine. Deve essere un blocco CIDR privato RFC1918 o pubblico sufficientemente grande da allocare almeno un indirizzo per macchina nella zona. Deve essere in managementIpv4Subnet e disgiunto da altri intervalli di indirizzi.
kubernetesNodeIpv4Range

string

Obbligatorio. Un blocco di indirizzi IPv4 per i nodi Kubernetes. Deve essere un blocco CIDR privato RFC1918 o pubblico sufficientemente grande da allocare almeno un indirizzo per macchina nella zona. Deve essere in kubernetesIpv4Subnet e disgiunto da altri intervalli di indirizzi.
kubernetesControlPlaneIpv4Range

string

Obbligatorio. Un blocco di indirizzi IPv4 per il control plane Kubernetes. Deve essere un blocco CIDR privato RFC1918 o pubblico sufficientemente grande da allocare almeno un indirizzo per cluster nella zona. Deve essere in kubernetesIpv4Subnet e disgiunto da altri intervalli di indirizzi.
managementIpv4Subnet

object (Subnet)

Obbligatorio. Una subnet IPv4 per la rete di gestione.
kubernetesIpv4Subnet

object (Subnet)

Facoltativo. Una subnet IPv4 per la rete Kubernetes. Se non specificata, la subnet Kubernetes sarà uguale alla subnet di gestione.
dnsIpv4Addresses[]

string

Facoltativo. Nameserver DNS. L'infrastruttura GDC risolverà le query DNS tramite questi IP. Se non specificato, viene utilizzato il DNS di Google.
kubernetesPrimaryVlanId

integer

Facoltativo. ID VLAN di Kubernetes. Per impostazione predefinita, il nodo Kubernetes, inclusa la rete Kubernetes principale, si trova nella stessa VLAN della rete di gestione delle macchine. A fini di segmentazione della rete, questi elementi possono essere separati in modo facoltativo.
aiCapableIpv4Subnet

object (Subnet)

Facoltativo. Subnet IPv4 per una zona che gestisce Gemini sul cluster software GDC. L'ultima subnet /29 dell'intervallo fornito è riservata a DHCP.
bgpConfig

object (BGPConfig)

Facoltativo. Configurazione specifica del Border Gateway Protocol (BGP) per questa zona. Utilizzato dalle zone che forniscono Gemini sul cluster software GDC.
topLevelDomain

string

Facoltativo. Dominio di primo livello personalizzato per questa zona. Utilizzato dalle zone che forniscono Gemini sul cluster software GDC.
torSwitchType

string

Facoltativo. Informazioni aggiuntive sul tipo di switch ToR del cliente. Utilizzato dalle zone che forniscono Gemini sul cluster software GDC.

Subnet

Rappresenta una subnet.

Rappresentazione JSON 
{
  "addressRange": string,
  "defaultGatewayIpAddress": string
}
Campi
addressRange

string

Obbligatorio. Intervallo di indirizzi per questa subnet in notazione CIDR.
defaultGatewayIpAddress

string

Obbligatorio. Gateway predefinito per questa subnet.

BGPConfig

Configurazione del Border Gateway Protocol (BGP).

Rappresentazione JSON 
{
  "asn": string,
  "l3PeerIps": [
    string
  ]
}
Campi
asn

string

Obbligatorio. Numero di sistema autonomo (ASN) BGP.
l3PeerIps[]

string

Obbligatorio. IP peer BGP. Sono richiesti almeno due IP peer L3.

ProvisioningState

Stati di provisioning validi per configurazioni come gli indirizzi MAC.

Enum
PROVISIONING_STATE_UNSPECIFIED Lo stato del provisioning non è specificato.
PROVISIONING_REQUIRED Il provisioning è obbligatorio. Impostata da Google.
PROVISIONING_IN_PROGRESS Il provisioning è in corso. Impostato dal cliente.
PROVISIONING_COMPLETE Il provisioning è stato completato. Impostato dal cliente.

Metodi

create

 Crea una nuova zona in un progetto e una località specifici.

delete

 Elimina una zona.

get

 Recupera i dettagli di una zona.

list

 Elenca le zone in un progetto e una località specifici.

patch

 Aggiorna i parametri di una zona.

signal

 Indica lo stato di una zona.