REST Resource: projects.locations.zones

Risorsa: Zone

Una zona contenente 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,
  "currentResourceOperation": {
    object (ResourceOperation)
  },
  "resourceOperations": [
    {
      object (ResourceOperation)
    }
  ],
  "errors": [
    {
      object (Status)
    }
  ],
  "site": string
}
Campi
name

string

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

string (Timestamp format)

Solo output. Data e ora di creazione della 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. Data e ora dell'ultimo aggiornamento della 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 Crea e gestisci 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. 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 è quello secondario e così via.
ciqUri

string

Solo output. Link al foglio del Questionario di assunzione 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. Indica se saltare il passaggio di provisioning del cluster durante l'attivazione della 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 intent del 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 da una 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

Facoltativo. Indica se questa zona è per il cluster Gemini on GDC Software.
intelPccsKey

string

Facoltativo. Chiave Intel Platform Config and Attestation Service (PCCS) per il provisioning e l'attestazione dell'hardware dell'acceleratore AI. Utilizzato dalle zone che gestiscono Gemini sul cluster software GDC.
currentResourceOperation

object (ResourceOperation)

Solo output. L'operazione corrente sulla risorsa per la zona.
resourceOperations[]

object (ResourceOperation)

Facoltativo. Elenco di tutte le operazioni sulle risorse eseguite nella zona.
errors[]

object (Status)

Solo output. Gli errori riscontrati durante l'attivazione della zona. I metadati ErrorInfo includeranno il timestamp e se l'errore è ripetibile.
site

string

Facoltativo. Specifica il nome della sede in cui si trova l'hardware di questa zona. Formato: projects/{project}/locations/{location}/sites/{site} Obbligatorio per le zone Gemini on GDC Software.

Stato

Stati validi per una zona.

Enum
STATE_UNSPECIFIED Lo stato della zona non è specificato.
ADDITIONAL_INFO_NEEDED Il cliente deve fornire ulteriori informazioni per procedere.
INFO_COMPLETE La zona dispone di tutte le informazioni necessarie per avviare la preparazione della zona.
PREPARING Google sta preparando la zona.
READY_FOR_CUSTOMER_FACTORY_TURNUP_CHECKS L'attivazione della fabbrica è riuscita.
CUSTOMER_FACTORY_TURNUP_CHECKS_STARTED La zona sta eseguendo i controlli di attivazione della fabbrica.
READY_FOR_PROVISIONING La zona è pronta per il provisioning.
READY_FOR_SITE_TURNUP La zona è pronta per l'attivazione del sito.
PROVISIONING_STARTED Il provisioning della zona è stato avviato.
PROVISIONING_FAILED Il provisioning della zona non è riuscito.
OFFLINE La Zona è offline.
CUSTOMER_FACTORY_TURNUP_CHECKS_FAILED La zona non ha superato i controlli di attivazione di fabbrica.
ACTIVE La zona è disponibile per l'uso.
CANCELLED The Zone è stato annullato.
AWAITING_HARDWARE La zona è in attesa dell'associazione dell'hardware.

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,
  "boundaryProxyPublicIpv4Range": string,
  "boundaryProxyPrivateEdgeCoreIpv4Range": string,
  "boundaryProxyPrivateCoreEdgeIpv4Range": string,
  "bastionHostPublicIpv4Range": string,
  "bastionHostPrivateIpv4Range": string,
  "tlsPublicRootCertificatePem": string
}
Campi
machineMgmtIpv4Range

string

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

string

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

string

Obbligatorio. Un blocco di indirizzi IPv4 per il control plane Kubernetes. Deve essere un blocco CIDR RFC1918 privato o pubblico di dimensioni sufficienti per allocare almeno un indirizzo per cluster nella zona. Deve essere compreso in kubernetesIpv4Subnet e non deve sovrapporsi ad 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à la stessa della 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 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 nel cluster software GDC. L'ultima subnet /29 dell'intervallo fornito è riservata per DHCP.
bgpConfig

object (BGPConfig)

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

string

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

string

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

string

Facoltativo. Intervallo IPv4 pubblico del proxy di confine in notazione CIDR. Al momento è previsto /32. Utilizzato dalle zone che gestiscono Gemini sul cluster software GDC.
boundaryProxyPrivateEdgeCoreIpv4Range

string

Facoltativo. Intervallo IPv4 privato da perimetro a core del proxy di confine in notazione CIDR. Al momento è previsto /32. Utilizzato dalle zone che gestiscono Gemini sul cluster software GDC.
boundaryProxyPrivateCoreEdgeIpv4Range

string

Facoltativo. Intervallo IPv4 privato da core a perimetro del proxy di confine in notazione CIDR. Al momento è previsto /32. Utilizzato dalle zone che gestiscono Gemini sul cluster software GDC.
bastionHostPublicIpv4Range

string

Facoltativo. Intervallo IPv4 pubblico del bastion host in notazione CIDR. Al momento è previsto /32. Utilizzato dalle zone che gestiscono Gemini sul cluster software GDC.
bastionHostPrivateIpv4Range

string

Facoltativo. Intervallo IPv4 privato del bastion host in notazione CIDR. Al momento è previsto /32. Utilizzato dalle zone che gestiscono Gemini sul cluster software GDC.
tlsPublicRootCertificatePem

string

Facoltativo. Certificato radice pubblico TLS in formato PEM. Utilizzato dalle zone che gestiscono 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. Impostato 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

 Segnala lo stato di una zona.