REST Resource: projects.locations.privateClouds

Ressource: PrivateCloud

Stellt eine Ressource für eine private Cloud dar. Private Clouds vom Typ STANDARD und TIME_LIMITED sind zonale Ressourcen, STRETCHED-Private Clouds sind regional.

JSON-Darstellung 
{
  "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)
}
Felder
name

string

Nur Ausgabe. ID. Der Ressourcenname dieser privaten Cloud. Ressourcennamen sind schemalose URIs, die den Konventionen unter https://cloud.google.com/apis/design/resource_names entsprechen. Beispiel: projects/my-project/locations/us-central1-a/privateClouds/my-cloud
createTime

string (Timestamp format)

Nur Ausgabe. Erstellungszeitpunkt dieser Ressource.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
updateTime

string (Timestamp format)

Nur Ausgabe. Zeitpunkt der letzten Aktualisierung dieser Ressource.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
deleteTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem die Ressource zum Löschen geplant wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
expireTime

string (Timestamp format)

Nur Ausgabe. Zeitpunkt, zu dem die Ressource endgültig gelöscht wird.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
state

enum (State)

Nur Ausgabe. Status der Ressource. Bei Bedarf können dieser Enumeration neue Werte hinzugefügt werden.
networkConfig

object (NetworkConfig)

Erforderlich. Netzwerkkonfiguration der privaten Cloud.
managementCluster

object (ManagementCluster)

Erforderlich. Nur Eingabe. Der Verwaltungscluster für diese private Cloud. Dieses Feld ist bei der Erstellung der Private Cloud erforderlich, um Details für den Standardcluster anzugeben.

Die folgenden Felder können nach der Erstellung der Private Cloud nicht mehr geändert werden: ManagementCluster.clusterId, ManagementCluster.nodeTypeId.
description

string

Vom Nutzer angegebene Beschreibung für diese private Cloud.
hcx

object (Hcx)

Nur Ausgabe. HCX-Appliance.
nsx

object (Nsx)

Nur Ausgabe. NSX-Appliance
vcenter

object (Vcenter)

Nur Ausgabe. vCenter-Appliance.
uid

string

Nur Ausgabe. Vom System generierte eindeutige Kennung für die Ressource.
type

enum (Type)

Optional. Typ der privaten Cloud. Die Standardeinstellung ist STANDARD.

Bundesland

Die Enum „State“ definiert die möglichen Status von Private Clouds.

Enums
STATE_UNSPECIFIED Der Standardwert. Dieser Wert sollte niemals verwendet werden.
ACTIVE Die private Cloud ist bereit.
CREATING Die private Cloud wird erstellt.
UPDATING Die private Cloud wird aktualisiert.
FAILED Die private Cloud hat den Status „Fehler“.
DELETED Die private Cloud wird zum Löschen vorgemerkt. Der Löschvorgang kann mit der entsprechenden Methode zum Wiederherstellen abgebrochen werden.
PURGING Die private Cloud wird endgültig gelöscht und aus dem System entfernt.

NetworkConfig

Netzwerkkonfiguration im Nutzerprojekt, mit der das Peering erfolgen muss.

JSON-Darstellung 
{
  "managementCidr": string,
  "vmwareEngineNetwork": string,
  "vmwareEngineNetworkCanonical": string,
  "managementIpAddressLayoutVersion": integer,
  "dnsServerIp": string
}
Felder
managementCidr

string

Erforderlich. Verwaltungs-CIDR, das von VMware-Verwaltungs-Appliances verwendet wird.
vmwareEngineNetwork

string

Optional. Der relative Ressourcenname des VMware Engine-Netzwerks, das an die private Cloud angehängt ist. Geben Sie den Namen im folgenden Format an: projects/{project}/locations/{location}/vmwareEngineNetworks/{vmwareEngineNetworkId}, wobei {project} entweder eine Projektnummer oder eine Projekt-ID sein kann.
vmwareEngineNetworkCanonical

string

Nur Ausgabe. Der kanonische Name des VMware Engine-Netzwerks im Format projects/{projectNumber}/locations/{location}/vmwareEngineNetworks/{vmwareEngineNetworkId}.
managementIpAddressLayoutVersion

integer

Nur Ausgabe. Die IP-Adresslayoutversion des IP-Adressbereichs für die Verwaltung. Mögliche Versionen: * managementIpAddressLayoutVersion=1: Gibt das alte IP-Adresslayout an, das von einigen bestehenden privaten Clouds verwendet wird. Diese Option wird für neue private Clouds nicht mehr unterstützt, da sie nicht alle Funktionen unterstützt. * managementIpAddressLayoutVersion=2: Gibt das aktuelle IP-Adresslayout an, das von allen neu erstellten privaten Clouds verwendet wird. Diese Version unterstützt alle aktuellen Funktionen.
dnsServerIp

string

Nur Ausgabe. DNS-Server-IP der Private Cloud. Alle DNS-Abfragen können an diese Adresse weitergeleitet werden, um die Namen der Verwaltungseinheiten der privaten Cloud wie vCenter, NSX-T Manager und ESXi-Hosts aufzulösen.

ManagementCluster

Konfiguration des Verwaltungsclusters.

JSON-Darstellung 
{
  "clusterId": string,
  "nodeTypeConfigs": {
    string: {
      object (NodeTypeConfig)
    },
    ...
  },
  "stretchedClusterConfig": {
    object (StretchedClusterConfig)
  }
}
Felder
clusterId

string

Erforderlich. Die vom Nutzer angegebene Kennung des neuen Cluster. Die Kennung muss die folgenden Anforderungen erfüllen:

  • Darf nur 1 bis 63 alphanumerische Zeichen und Bindestriche enthalten
  • Beginnt mit einem Buchstaben
  • Endet mit einem Zeichen, das kein Bindestrich ist
  • Nicht als UUID formatiert
  • Entspricht RFC 1034 (Abschnitt 3.5)
nodeTypeConfigs

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

Erforderlich. Die Zuordnung der Clusterknotentypen in diesem Cluster, wobei der Schlüssel der kanonische Bezeichner des Knotentyps ist (entspricht NodeType).

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
stretchedClusterConfig

object (StretchedClusterConfig)

Optional. Konfiguration eines Stretched Cluster. Erforderlich für ERWEITERTE private Clouds.

Hcx

Details zu einer HCX Cloud Manager-Appliance.

JSON-Darstellung 
{
  "internalIp": string,
  "version": string,
  "state": enum (State),
  "fqdn": string
}
Felder
internalIp

string

Interne IP-Adresse der Appliance.
version

string

Version des Geräts.
state

enum (State)

Nur Ausgabe. Der Status des Geräts.
fqdn

string

Voll qualifizierter Domainname des Geräts.

Bundesland

Status des Geräts

Enums
STATE_UNSPECIFIED Nicht angegebener Gerätestatus. Dies ist der Standardwert.
ACTIVE Das Gerät ist betriebsbereit und kann verwendet werden.
CREATING Die Appliance wird bereitgestellt.
ACTIVATING Das Gerät wird aktiviert.

Nsx

Details zu einer NSX Manager-Appliance.

JSON-Darstellung 
{
  "internalIp": string,
  "version": string,
  "state": enum (State),
  "fqdn": string
}
Felder
internalIp

string

Interne IP-Adresse der Appliance.
version

string

Version des Geräts.
state

enum (State)

Nur Ausgabe. Der Status des Geräts.
fqdn

string

Voll qualifizierter Domainname des Geräts.

Bundesland

Status des Geräts

Enums
STATE_UNSPECIFIED Nicht angegebener Gerätestatus. Dies ist der Standardwert.
ACTIVE Das Gerät ist betriebsbereit und kann verwendet werden.
CREATING Die Appliance wird bereitgestellt.

vCenter

Details zu einer vCenter Server-Verwaltungsappliance.

JSON-Darstellung 
{
  "internalIp": string,
  "version": string,
  "state": enum (State),
  "fqdn": string
}
Felder
internalIp

string

Interne IP-Adresse der Appliance.
version

string

Version des Geräts.
state

enum (State)

Nur Ausgabe. Der Status des Geräts.
fqdn

string

Voll qualifizierter Domainname des Geräts.

Bundesland

Status des Geräts

Enums
STATE_UNSPECIFIED Nicht angegebener Gerätestatus. Dies ist der Standardwert.
ACTIVE Das Gerät ist betriebsbereit und kann verwendet werden.
CREATING Die Appliance wird bereitgestellt.

Typ

Der Enum-Typ definiert den Typ der privaten Cloud.

Enums
STANDARD Standard Private ist eine zonale Ressource mit mindestens drei Knoten. Standardtyp.
TIME_LIMITED Eine zeitlich begrenzte private Cloud ist eine zonale Ressource, kann nur einen Knoten haben und hat eine begrenzte Lebensdauer. Wird nach einem bestimmten Zeitraum gelöscht. Kann in eine Standard-Private Cloud umgewandelt werden, indem sie auf mindestens drei Knoten erweitert wird.
STRETCHED Eine erweiterte private Cloud ist eine regionale Ressource mit Redundanz und muss mindestens 6 Knoten haben. Die Anzahl der Knoten muss gerade sein.

Methoden

create

 Erstellt eine neue PrivateCloud-Ressource in einem bestimmten Projekt und an einem bestimmten Standort

delete

 Plant das Löschen einer PrivateCloud-Ressource.

get

 Ruft eine PrivateCloud-Ressource anhand ihres Ressourcennamens ab.

getDnsForwarding

 Ruft Details zur DnsForwarding-Konfiguration ab.

getIamPolicy

 Ruft die Zugriffssteuerungsrichtlinie für eine Ressource ab.

list

 Listet PrivateCloud in einem bestimmten Projekt und an einem bestimmten Standort auf

patch

 Ändert eine PrivateCloud-Ressource.

privateCloudDeletionNow

 Beschleunigt das Löschen einer privaten Cloud, die sich derzeit im Status „Vorläufig gelöscht“ befindet. Für eine PrivateCloud-Ressource im Status „Vorläufig gelöscht“ ist PrivateCloud.state auf SOFT_DELETED und PrivateCloud.expireTime auf den Zeitpunkt festgelegt, zu dem das Löschen nicht mehr rückgängig gemacht werden kann.

resetNsxCredentials

 Setzt die Anmeldedaten der NSX-Appliance zurück.

resetVcenterCredentials

 Setzt die Anmeldedaten der vCenter-Appliance zurück.

setIamPolicy

 Legt die Zugriffssteuerungsrichtlinie für die angegebene Ressource fest.

showNsxCredentials

 Ruft Details zu Anmeldedaten für die NSX-Appliance ab.

showVcenterCredentials

 Ruft Details zu Anmeldedaten für die vCenter-Appliance ab.

testIamPermissions

 Gibt die Berechtigungen des Aufrufers für die angegebene Ressource zurück.

undelete

 Stellt eine private Cloud wieder her, die zuvor für das Löschen durch DeletePrivateCloud geplant war.

updateDnsForwarding

 Aktualisiert die Parameter der DnsForwarding-Konfiguration, z. B. zugehörige Domains.