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

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.

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.
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_SITE_TURNUP La zona è pronta per l'attivazione del sito.
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
}
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.

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.

SubscriptionConfig

Un messaggio per memorizzare una configurazione di sottoscrizione.

Rappresentazione JSON
{
  "subscriptionId": string,
  "billingId": string,
  "state": enum (SubscriptionState)
}
Campi
subscriptionId

string

Solo output. L'identificatore univoco dell'abbonamento.

billingId

string

Solo output. L'ID fatturazione Google Cloud in cui viene creato l'abbonamento.

state

enum (SubscriptionState)

Solo output. Lo stato attuale dell'abbonamento.

SubscriptionState

Enumerazione per rappresentare lo stato dell'abbonamento.

Enum
SUBSCRIPTION_STATE_UNSPECIFIED Lo stato non è specificato.
ACTIVE Lo stato Attivo indica che l'abbonamento è stato creato correttamente e la fatturazione è in corso.
INACTIVE Inattivo significa che l'abbonamento è stato creato correttamente, ma la fatturazione non è ancora iniziata.
ERROR L'abbonamento è in uno stato di errore.
FAILED_TO_RETRIEVE Impossibile recuperare lo stato dell'abbonamento. Potrebbe trattarsi di un problema temporaneo. L'utente deve riprovare a inviare la richiesta.
COMPLETED L'abbonamento è stato completato perché è stata raggiunta la data di fine.

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.