REST Resource: projects.locations.privateClouds

Risorsa: PrivateCloud

Rappresenta una risorsa cloud privato. I cloud privati di tipo STANDARD e TIME_LIMITED sono risorse a livello di zona, mentre i cloud privati STRETCHED sono risorse a livello di regione.

Rappresentazione JSON 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "deleteTime": string,
  "expireTime": string,
  "state": enum (State),
  "networkConfig": {
    object (NetworkConfig)
  },
  "managementCluster": {
    object (ManagementCluster)
  },
  "description": string,
  "hcx": {
    object (Hcx)
  },
  "nsx": {
    object (Nsx)
  },
  "vcenter": {
    object (Vcenter)
  },
  "uid": string,
  "type": enum (Type)
}
Campi
name

string

Solo output. Identificatore. Il nome della risorsa di questo 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-a/privateClouds/my-cloud
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".
deleteTime

string (Timestamp format)

Solo output. Ora in cui è stata pianificata l'eliminazione 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".
expireTime

string (Timestamp format)

Solo output. Ora in cui la risorsa verrà eliminata definitivamente.

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. All'enum possono essere aggiunti nuovi valori, se necessario.
networkConfig

object (NetworkConfig)

Obbligatorio. Configurazione di rete del cloud privato.
managementCluster

object (ManagementCluster)

Obbligatorio. Solo input. Il cluster di gestione per questo cloud privato. Questo campo è obbligatorio durante la creazione del cloud privato per fornire i dettagli del cluster predefinito.

I seguenti campi non possono essere modificati dopo la creazione del cloud privato: ManagementCluster.clusterId, ManagementCluster.nodeTypeId.
description

string

Descrizione fornita dall'utente per questo cloud privato.
hcx

object (Hcx)

Solo output. HCX Appliance.
nsx

object (Nsx)

Solo output. Appliance NSX.
vcenter

object (Vcenter)

Solo output. Appliance vCenter.
uid

string

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

enum (Type)

Facoltativo. Tipo di cloud privato. Il valore predefinito è STANDARD.

Stato

L'enumerazione State definisce i possibili stati dei cloud privati.

Enum
STATE_UNSPECIFIED Il valore predefinito. Questo valore non deve mai essere utilizzato.
ACTIVE Il cloud privato è pronto.
CREATING Il cloud privato è in fase di creazione.
UPDATING Il cloud privato è in fase di aggiornamento.
FAILED Il cloud privato è in stato di errore.
DELETED L'eliminazione del cloud privato è pianificata. La procedura di eliminazione può essere annullata utilizzando il metodo di annullamento dell'eliminazione corrispondente.
PURGING Il cloud privato viene eliminato in modo irreversibile e rimosso dal sistema.

NetworkConfig

Configurazione di rete nel progetto consumer con cui deve essere eseguito il peering.

Rappresentazione JSON 
{
  "managementCidr": string,
  "vmwareEngineNetwork": string,
  "vmwareEngineNetworkCanonical": string,
  "managementIpAddressLayoutVersion": integer,
  "dnsServerIp": string
}
Campi
managementCidr

string

Obbligatorio. CIDR di gestione utilizzato dagli appliance di gestione VMware.
vmwareEngineNetwork

string

Facoltativo. Il nome della risorsa relativa della rete VMware Engine collegata al cloud privato. Specifica il nome nel seguente formato: projects/{project}/locations/{location}/vmwareEngineNetworks/{vmwareEngineNetworkId}, dove {project} può essere un numero o un ID progetto.
vmwareEngineNetworkCanonical

string

Solo output. Il nome canonico della rete VMware Engine nel formato: projects/{projectNumber}/locations/{location}/vmwareEngineNetworks/{vmwareEngineNetworkId}
managementIpAddressLayoutVersion

integer

Solo output. La versione del layout dell'indirizzo IP dell'intervallo di indirizzi IP di gestione. Le versioni possibili includono: * managementIpAddressLayoutVersion=1: indica il layout dell'indirizzo IP legacy utilizzato da alcuni cloud privati esistenti. Questa opzione non è più supportata per i nuovi cloud privati, in quanto non supporta tutte le funzionalità. * managementIpAddressLayoutVersion=2: indica l'ultimo layout dell'indirizzo IP utilizzato da tutti i cloud privati appena creati. Questa versione supporta tutte le funzionalità attuali.
dnsServerIp

string

Solo output. IP del server DNS del Private Cloud. Tutte le query DNS possono essere inoltrate a questo indirizzo per la risoluzione dei nomi delle entità di gestione di Private Cloud come vCenter, NSX-T Manager e gli host ESXi.

ManagementCluster

Configurazione del cluster di gestione.

Rappresentazione JSON 
{
  "clusterId": string,
  "nodeTypeConfigs": {
    string: {
      object (NodeTypeConfig)
    },
    ...
  },
  "stretchedClusterConfig": {
    object (StretchedClusterConfig)
  }
}
Campi
clusterId

string

Obbligatorio. L'identificatore fornito dall'utente del nuovo Cluster. L'identificatore 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)
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 cloud privati estesi.

Hcx

Dettagli di un'appliance HCX Cloud Manager.

Rappresentazione JSON 
{
  "internalIp": string,
  "version": string,
  "state": enum (State),
  "fqdn": string
}
Campi
internalIp

string

L'indirizzo IP interno dell'appliance.
version

string

Versione dell'appliance.
state

enum (State)

Solo output. Lo stato dell'appliance.
fqdn

string

Nome di dominio completo dell'appliance.

Stato

Stato dell'appliance

Enum
STATE_UNSPECIFIED Stato dell'appliance non specificato. Questo è il valore predefinito.
ACTIVE L'apparecchio è funzionante e può essere utilizzato.
CREATING L'appliance è in fase di deployment.
ACTIVATING L'appliance è in fase di attivazione.

Nsx

Dettagli di un'appliance NSX Manager.

Rappresentazione JSON 
{
  "internalIp": string,
  "version": string,
  "state": enum (State),
  "fqdn": string
}
Campi
internalIp

string

L'indirizzo IP interno dell'appliance.
version

string

Versione dell'appliance.
state

enum (State)

Solo output. Lo stato dell'appliance.
fqdn

string

Nome di dominio completo dell'appliance.

Stato

Stato dell'appliance

Enum
STATE_UNSPECIFIED Stato dell'appliance non specificato. Questo è il valore predefinito.
ACTIVE L'apparecchio è funzionante e può essere utilizzato.
CREATING L'appliance è in fase di deployment.

vCenter

Dettagli su un'appliance di gestione di vCenter Server.

Rappresentazione JSON 
{
  "internalIp": string,
  "version": string,
  "state": enum (State),
  "fqdn": string
}
Campi
internalIp

string

L'indirizzo IP interno dell'appliance.
version

string

Versione dell'appliance.
state

enum (State)

Solo output. Lo stato dell'appliance.
fqdn

string

Nome di dominio completo dell'appliance.

Stato

Stato dell'appliance

Enum
STATE_UNSPECIFIED Stato dell'appliance non specificato. Questo è il valore predefinito.
ACTIVE L'apparecchio è funzionante e può essere utilizzato.
CREATING L'appliance è in fase di deployment.

Tipo

Enum Type definisce il tipo di cloud privato.

Enum
STANDARD Standard privato è una risorsa di zona con almeno tre nodi. Tipo predefinito.
TIME_LIMITED Il cloud privato con limite di tempo è una risorsa di zona, può avere un solo nodo e ha una durata limitata. Verrà eliminato dopo un periodo di tempo definito e può essere convertito in un cloud privato standard espandendolo fino a 3 o più nodi.
STRETCHED Il cloud privato esteso è una risorsa di regione con ridondanza, con un minimo di 6 nodi e un numero pari di nodi.

Metodi

create

 Crea una nuova risorsa PrivateCloud in un progetto e una località specifici.

delete

 Pianifica l'eliminazione di una risorsa PrivateCloud.

get

 Recupera una risorsa PrivateCloud in base al nome della risorsa.

getDnsForwarding

 Recupera i dettagli della configurazione DnsForwarding.

getIamPolicy

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

list

 Elenca le risorse PrivateCloud in un progetto e una località specifici.

patch

 Modifica una risorsa PrivateCloud.

privateCloudDeletionNow

 Accelera l'eliminazione di un cloud privato attualmente in eliminazione temporanea. Una risorsa PrivateCloud in eliminazione temporanea ha PrivateCloud.state impostato su SOFT_DELETED e PrivateCloud.expireTime impostato sull'ora in cui l'eliminazione non può più essere annullata.

resetNsxCredentials

 Reimposta le credenziali dell'appliance NSX.

resetVcenterCredentials

 Reimposta le credenziali dell'appliance vCenter.

setIamPolicy

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

showNsxCredentials

 Recupera i dettagli delle credenziali per l'appliance NSX.

showVcenterCredentials

 Recupera i dettagli delle credenziali per l'appliance vCenter.

testIamPermissions

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

undelete

 Ripristina un cloud privato la cui eliminazione era stata pianificata in precedenza per il giorno DeletePrivateCloud.

updateDnsForwarding

 Aggiorna i parametri della configurazione DnsForwarding, come i domini associati.