REST Resource: projects.locations.privateClouds.clusters

Risorsa: cluster

Un cluster in un cloud privato.

Rappresentazione JSON 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "state": enum (State),
  "management": boolean,
  "autoscalingSettings": {
    object (AutoscalingSettings)
  },
  "uid": string,
  "nodeTypeConfigs": {
    string: {
      object (NodeTypeConfig)
    },
    ...
  },
  "stretchedClusterConfig": {
    object (StretchedClusterConfig)
  },
  "datastoreMountConfig": [
    {
      object (DatastoreMountConfig)
    }
  ]
}
Campi
name

string

Solo output. Identificatore. Il nome della risorsa di questo cluster. I nomi delle risorse sono URI senza schema che seguono le convenzioni riportate in https://cloud.google.com/apis/design/resource_names. Ad esempio: projects/my-project/locations/us-central1-a/privateClouds/my-cloud/clusters/my-cluster
createTime

string (Timestamp format)

Solo output. Data e ora di creazione della risorsa.

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 di questa risorsa.

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

enum (State)

Solo output. Stato della risorsa.
management

boolean

Solo output. Vero se il cluster è un cluster di gestione; falso in caso contrario. Può esserci un solo cluster di gestione in un cloud privato e deve essere il primo.
autoscalingSettings

object (AutoscalingSettings)

Facoltativo. Configurazione della scalabilità automatica applicata a questo cluster.
uid

string

Solo output. Identificatore univoco generato dal sistema per la risorsa.
nodeTypeConfigs

map (key: string, value: object (NodeTypeConfig))

Obbligatorio. La mappa dei tipi di nodi del cluster in questo cluster, dove la chiave è l'identificatore canonico del tipo di nodo (corrisponde a NodeType).

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

object (StretchedClusterConfig)

Facoltativo. Configurazione di un cluster esteso. Obbligatorio per i cluster che appartengono a un cloud privato ESTESO.
datastoreMountConfig[]

object (DatastoreMountConfig)

Solo output. Configurazione di un datastore montato.

Stato

Enum State definisce i possibili stati dei cluster cloud privato.

Enum
STATE_UNSPECIFIED Il valore predefinito. Questo valore non deve mai essere utilizzato.
ACTIVE Il cluster è operativo e può essere utilizzato dall'utente.
CREATING Il cluster è in fase di deployment.
UPDATING Aggiunta o rimozione di un nodo al cluster, altri aggiornamenti specifici del cluster.
DELETING Il cluster è in fase di eliminazione.
REPAIRING Il cluster è in manutenzione, ad esempio: un nodo non riuscito viene sostituito.

AutoscalingSettings

Le impostazioni di scalabilità automatica definiscono le regole utilizzate da VMware Engine per scalare automaticamente orizzontalmente e verticalmente i cluster in un cloud privato.

Rappresentazione JSON 
{
  "autoscalingPolicies": {
    string: {
      object (AutoscalingPolicy)
    },
    ...
  },
  "minClusterNodeCount": integer,
  "maxClusterNodeCount": integer,
  "coolDownPeriod": string
}
Campi
autoscalingPolicies

map (key: string, value: object (AutoscalingPolicy))

Obbligatorio. La mappa con i criteri di scalabilità automatica applicati al cluster. La chiave è l'identificatore della policy. Deve soddisfare i seguenti requisiti:

  • Contiene solo caratteri alfanumerici e trattini (da 1 a 63)
  • Inizia con un carattere alfabetico
  • Termina con un carattere diverso dal trattino
  • Non formattato come UUID
  • Conforme a RFC 1034 (sezione 3.5)

Attualmente, la mappa deve contenere un solo elemento che descrive la policy di scalabilità automatica per i nodi di calcolo.

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

integer

Facoltativo. Numero minimo di nodi di qualsiasi tipo in un cluster. Se non specificati, vengono applicati i limiti predefiniti.
maxClusterNodeCount

integer

Facoltativo. Numero massimo di nodi di qualsiasi tipo in un cluster. Se non specificati, vengono applicati i limiti predefiniti.
coolDownPeriod

string (Duration format)

Facoltativo. La durata minima tra operazioni di scalabilità automatica consecutive. Inizia una volta completata l'aggiunta o la rimozione dei nodi. Se non specificato, il valore predefinito è 30 minuti. Il periodo di raffreddamento deve essere espresso in minuti interi (ad esempio 30, 31, 50, 180 minuti).

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

AutoscalingPolicy

Il criterio di scalabilità automatica descrive il comportamento della scalabilità automatica rispetto all'utilizzo delle risorse. L'operazione di scalabilità orizzontale viene avviata se l'utilizzo supera UNA QUALSIASI delle rispettive soglie. L'operazione di riduzione viene avviata se l'utilizzo è inferiore a TUTTE le soglie rispettive.

Rappresentazione JSON 
{
  "nodeTypeId": string,
  "scaleOutSize": integer,
  "cpuThresholds": {
    object (Thresholds)
  },
  "grantedMemoryThresholds": {
    object (Thresholds)
  },
  "consumedMemoryThresholds": {
    object (Thresholds)
  },
  "storageThresholds": {
    object (Thresholds)
  }
}
Campi
nodeTypeId

string

Obbligatorio. L'identificatore canonico del tipo di nodo da aggiungere o rimuovere. Corrisponde a NodeType.
scaleOutSize

integer

Obbligatorio. Numero di nodi da aggiungere a un cluster durante un'operazione di scale out. Deve essere divisibile per 2 per i cluster estesi. Durante un'operazione di riduzione, viene rimosso un solo nodo (o due per i cluster estesi) in una singola iterazione.
cpuThresholds

object (Thresholds)

Facoltativo. Soglie di utilizzo relative all'utilizzo della CPU.
grantedMemoryThresholds

object (Thresholds)

Facoltativo. Soglie di utilizzo relative alla quantità di memoria concessa.
consumedMemoryThresholds

object (Thresholds)

Facoltativo. Soglie di utilizzo relative alla quantità di memoria utilizzata.
storageThresholds

object (Thresholds)

Facoltativo. Soglie di utilizzo relative alla quantità di spazio di archiviazione consumato.

Soglie

Le soglie definiscono l'utilizzo delle risorse che attivano le operazioni di scalabilità orizzontale e riduzione della scalabilità.

Rappresentazione JSON 
{
  "scaleOut": integer,
  "scaleIn": integer
}
Campi
scaleOut

integer

Obbligatorio. L'utilizzo che attiva l'operazione di scalabilità orizzontale in percentuale.
scaleIn

integer

Obbligatorio. L'utilizzo che attiva l'operazione di riduzione delle risorse in percentuale.

DatastoreMountConfig

Configurazione del montaggio di Datastore

Rappresentazione JSON 
{
  "fileShare": string,
  "datastore": string,
  "datastoreNetwork": {
    object (DatastoreNetwork)
  },
  "accessMode": enum (AccessMode),
  "nfsVersion": enum (NfsVersion),
  "servers": [
    string
  ]
}
Campi
fileShare

string

Solo output. Nome della condivisione file.
datastore

string

Obbligatorio. Il nome della risorsa del datastore da montare. I nomi delle risorse sono URI senza schema che seguono le convenzioni riportate in https://cloud.google.com/apis/design/resource_names. Ad esempio: projects/my-project/locations/us-central1/datastores/my-datastore
datastoreNetwork

object (DatastoreNetwork)

Obbligatorio. La configurazione di rete per il datastore.
accessMode

enum (AccessMode)

Facoltativo. La modalità di accesso del volume NFS. Facoltativo. Il valore predefinito utilizzato sarà READ_WRITE
nfsVersion

enum (NfsVersion)

Facoltativo. Il protocollo NFS supportato dal volume NFS. Il valore predefinito utilizzato sarà NFS_V3
servers[]

string

Solo output. Indirizzi IP server del volume NFS. Per NFS 3, puoi fornire un solo indirizzo IP del server o nomi DNS.

DatastoreNetwork

La configurazione di rete per il datastore.

Rappresentazione JSON 
{
  "subnet": string,
  "mtu": integer,
  "networkPeering": string,
  "connectionCount": integer
}
Campi
subnet

string

Obbligatorio. Il nome risorsa della subnet. I nomi risorsa sono URI senza schema che seguono le convenzioni riportate all'indirizzo https://cloud.google.com/apis/design/resource_names. Ad esempio, projects/my-project/locations/us-central1/subnets/my-subnet
mtu

integer

Facoltativo. Il valore MTU è impostato sull'adattatore VMKernel per il traffico NFS. Se non viene fornito, viene utilizzato l'MTU di 1500. Per utilizzare i frame jumbo, imposta questo valore su 8896. Ti consigliamo di ottimizzare questo valore in base alle prestazioni del traffico NFS. Il rendimento può essere determinato utilizzando strumenti di I/O di benchmarking come l'utilità fio (Flexible I/O Tester).
networkPeering

string

Solo output. Il nome della risorsa del peering di rete, utilizzato per accedere alla condivisione file da parte dei client sul cloud privato. I nomi delle risorse sono URI senza schema che seguono le convenzioni riportate in https://cloud.google.com/apis/design/resource_names. Ad esempio, projects/my-project/locations/us-central1/networkPeerings/my-network-peering
connectionCount

integer

Facoltativo. connectionCount viene utilizzato per impostare più connessioni dal client NFS sull'host ESXi al server NFS. Un numero maggiore di connessioni si traduce in prestazioni migliori sui datastore. Nell'API clusters.mountDatastore, per impostazione predefinita sono configurate al massimo 4 connessioni. L'utente può impostare il valore di connectionCount tra 1 e 4. Connection_count è supportato da vSphere 8.0u1. Per le versioni precedenti, il conteggio delle connessioni è impostato su 1 sugli host ESXi.

AccessMode

La modalità di accesso del volume NFS.

Enum
ACCESS_MODE_UNSPECIFIED Il valore predefinito. Questo valore non deve mai essere utilizzato.
READ_ONLY NFS viene letto dagli host
READ_WRITE A NFS si accede dagli host in modalità di lettura e scrittura

NfsVersion

Il protocollo NFS supportato dal volume NFS.

Enum
NFS_VERSION_UNSPECIFIED Il valore predefinito. Questo valore non deve mai essere utilizzato.
NFS_V3 NFS 3

Metodi

create

 Crea un nuovo cluster in un determinato cloud privato.

delete

 Elimina una risorsa Cluster.

get

 Recupera una risorsa Cluster in base al nome della risorsa.

getIamPolicy

 Recupera la policy di controllo dell'accesso per una risorsa.

list

 Elenca le risorse Cluster in un cloud privato specifico.

mountDatastore

 Monta un Datastore su una risorsa cluster

patch

 Modifica una risorsa Cluster.

setIamPolicy

 Imposta la policy di controllo dell'accesso sulla risorsa specificata.

testIamPermissions

 Restituisce le autorizzazioni di cui dispone un chiamante per la risorsa specificata.

unmountDatastore

 Smonta un Datastore su una risorsa cluster