REST Resource: projects.locations.privateClouds

Ressource : PrivateCloud

Représente une ressource de cloud privé. Les clouds privés de type STANDARD et TIME_LIMITED sont des ressources zonales, tandis que les clouds privés STRETCHED sont des ressources régionales.

Représentation 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)
}
Champs
name

string

Uniquement en sortie. Identifiant. Nom de ressource de ce cloud privé. Les noms de ressources sont des URI sans schéma qui suivent les conventions décrites sur https://cloud.google.com/apis/design/resource_names. Par exemple : projects/my-project/locations/us-central1-a/privateClouds/my-cloud
createTime

string (Timestamp format)

Uniquement en sortie. Heure de création de cette ressource.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Uniquement en sortie. Heure de la dernière mise à jour de cette ressource.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
deleteTime

string (Timestamp format)

Uniquement en sortie. Heure à laquelle la suppression de la ressource a été planifiée.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
expireTime

string (Timestamp format)

Uniquement en sortie. Heure à laquelle la ressource sera définitivement supprimée.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
state

enum (State)

Uniquement en sortie. État de la ressource. De nouvelles valeurs peuvent être ajoutées à cette énumération, le cas échéant.
networkConfig

object (NetworkConfig)

Obligatoire. Configuration réseau du cloud privé.
managementCluster

object (ManagementCluster)

Obligatoire. Uniquement en entrée. Cluster de gestion de ce cloud privé. Ce champ est obligatoire lors de la création du cloud privé pour fournir des informations sur le cluster par défaut.

Les champs suivants ne peuvent pas être modifiés après la création du cloud privé : ManagementCluster.clusterId, ManagementCluster.nodeTypeId.
description

string

Description de ce cloud privé fournie par l'utilisateur.
hcx

object (Hcx)

Uniquement en sortie. Dispositif HCX.
nsx

object (Nsx)

Uniquement en sortie. Appliance NSX.
vcenter

object (Vcenter)

Uniquement en sortie. Appliance vCenter.
uid

string

Uniquement en sortie. Identifiant unique généré par le système pour la ressource.
type

enum (Type)

Facultatif. Type de cloud privé. La valeur par défaut est "STANDARD".

État

L'état Enum définit les états possibles des clouds privés.

Enums
STATE_UNSPECIFIED Valeur par défaut. Cette valeur ne doit jamais être utilisée.
ACTIVE Le cloud privé est prêt.
CREATING Le cloud privé est en cours de création.
UPDATING Le cloud privé est en cours de mise à jour.
FAILED Le cloud privé est à l'état "Échec".
DELETED Le cloud privé est programmé pour suppression. Vous pouvez annuler le processus de suppression à l'aide de la méthode de récupération correspondante.
PURGING Le cloud privé est supprimé de manière irréversible et est en cours de suppression du système.

NetworkConfig

Configuration réseau dans le projet client avec lequel l'appairage doit être effectué.

Représentation JSON 
{
  "managementCidr": string,
  "vmwareEngineNetwork": string,
  "vmwareEngineNetworkCanonical": string,
  "managementIpAddressLayoutVersion": integer,
  "dnsServerIp": string
}
Champs
managementCidr

string

Obligatoire. CIDR de gestion utilisé par les appliances de gestion VMware.
vmwareEngineNetwork

string

Facultatif. Nom de ressource relatif du réseau VMware Engine associé au cloud privé. Spécifiez le nom au format suivant : projects/{project}/locations/{location}/vmwareEngineNetworks/{vmwareEngineNetworkId}, où {project} peut être un numéro ou un ID de projet.
vmwareEngineNetworkCanonical

string

Uniquement en sortie. Nom canonique du réseau VMware Engine au format projects/{projectNumber}/locations/{location}/vmwareEngineNetworks/{vmwareEngineNetworkId}.
managementIpAddressLayoutVersion

integer

Uniquement en sortie. Version de la disposition des adresses IP de la plage d'adresses IP de gestion. Les versions possibles incluent : * managementIpAddressLayoutVersion=1 : indique l'ancienne mise en page d'adresse IP utilisée par certains clouds privés existants. Cette option n'est plus disponible pour les nouveaux clouds privés, car elle n'est pas compatible avec toutes les fonctionnalités. * managementIpAddressLayoutVersion=2 : indique la dernière disposition d'adresse IP utilisée par tous les clouds privés nouvellement créés. Cette version est compatible avec toutes les fonctionnalités actuelles.
dnsServerIp

string

Uniquement en sortie. Adresse IP du serveur DNS du cloud privé. Toutes les requêtes DNS peuvent être transférées vers cette adresse pour la résolution de noms des entités de gestion du cloud privé, telles que vCenter, NSX-T Manager et les hôtes ESXi.

ManagementCluster

Configuration du cluster de gestion.

Représentation JSON 
{
  "clusterId": string,
  "nodeTypeConfigs": {
    string: {
      object (NodeTypeConfig)
    },
    ...
  },
  "stretchedClusterConfig": {
    object (StretchedClusterConfig)
  }
}
Champs
clusterId

string

Obligatoire. Identifiant fourni par l'utilisateur pour le nouveau Cluster. L'identifiant doit répondre aux exigences suivantes :

  • Ne contient que 1 à 63 caractères alphanumériques et des tirets
  • Commence par un caractère alphabétique
  • Se termine par un caractère autre qu'un tiret
  • Format non UUID
  • Conforme à la norme RFC 1034 (section 3.5)
nodeTypeConfigs

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

Obligatoire. Mappage des types de nœuds de cluster dans ce cluster, où la clé est l'identifiant canonique du type de nœud (correspond à NodeType).

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
stretchedClusterConfig

object (StretchedClusterConfig)

Facultatif. Configuration d'un cluster étendu. Obligatoire pour les clouds privés ÉTENDUS.

Hcx

Informations sur un dispositif HCX Cloud Manager.

Représentation JSON 
{
  "internalIp": string,
  "version": string,
  "state": enum (State),
  "fqdn": string
}
Champs
internalIp

string

Adresse IP interne de l'appliance.
version

string

Version de l'appareil.
state

enum (State)

Uniquement en sortie. État de l'appareil.
fqdn

string

Nom de domaine complet de l'appliance.

État

État de l'appareil

Enums
STATE_UNSPECIFIED État de l'appareil non spécifié. Il s'agit de la valeur par défaut.
ACTIVE L'appareil est opérationnel et peut être utilisé.
CREATING L'appliance est en cours de déploiement.
ACTIVATING L'appareil est en cours d'activation.

Nsx

Informations sur un dispositif NSX Manager.

Représentation JSON 
{
  "internalIp": string,
  "version": string,
  "state": enum (State),
  "fqdn": string
}
Champs
internalIp

string

Adresse IP interne de l'appliance.
version

string

Version de l'appareil.
state

enum (State)

Uniquement en sortie. État de l'appareil.
fqdn

string

Nom de domaine complet de l'appliance.

État

État de l'appareil

Enums
STATE_UNSPECIFIED État de l'appareil non spécifié. Il s'agit de la valeur par défaut.
ACTIVE L'appareil est opérationnel et peut être utilisé.
CREATING L'appliance est en cours de déploiement.

vCenter

Détails sur une appliance de gestion vCenter Server.

Représentation JSON 
{
  "internalIp": string,
  "version": string,
  "state": enum (State),
  "fqdn": string
}
Champs
internalIp

string

Adresse IP interne de l'appliance.
version

string

Version de l'appareil.
state

enum (State)

Uniquement en sortie. État de l'appareil.
fqdn

string

Nom de domaine complet de l'appliance.

État

État de l'appareil

Enums
STATE_UNSPECIFIED État de l'appareil non spécifié. Il s'agit de la valeur par défaut.
ACTIVE L'appareil est opérationnel et peut être utilisé.
CREATING L'appliance est en cours de déploiement.

Type

Le type Enum définit le type de cloud privé.

Enums
STANDARD Standard Private est une ressource zonale avec au moins trois nœuds. Type par défaut.
TIME_LIMITED Un cloud privé à durée limitée est une ressource zonale qui ne peut comporter qu'un seul nœud et dont la durée de vie est limitée. Sera supprimé après une période définie. Vous pouvez le convertir en cloud privé standard en l'étendant à trois nœuds ou plus.
STRETCHED Un cloud privé étendu est une ressource régionale avec redondance, qui doit comporter au moins six nœuds (en nombre pair).

Méthodes

create

 Crée une ressource PrivateCloud dans un projet et un emplacement donnés.

delete

 Planifie la suppression d'une ressource PrivateCloud.

get

 Récupère une ressource PrivateCloud par son nom de ressource.

getDnsForwarding

 Obtient les détails de la configuration DnsForwarding.

getIamPolicy

 Récupère la stratégie de contrôle d'accès d'une ressource.

list

 Liste les ressources PrivateCloud d'un projet et d'un emplacement donnés.

patch

 Modifie une ressource PrivateCloud.

privateCloudDeletionNow

 Accélère la suppression d'un cloud privé actuellement en suppression réversible. Une ressource PrivateCloud en suppression réversible a la valeur PrivateCloud.state définie sur SOFT_DELETED et la valeur PrivateCloud.expireTime définie sur l'heure à laquelle la suppression ne peut plus être annulée.

resetNsxCredentials

 Réinitialise les identifiants de l'appliance NSX.

resetVcenterCredentials

 Réinitialise les identifiants de l'appliance vCenter.

setIamPolicy

 Définit la stratégie de contrôle d'accès de la ressource spécifiée.

showNsxCredentials

 Obtient les détails des identifiants pour le dispositif NSX.

showVcenterCredentials

 Obtient les détails des identifiants pour l'appliance vCenter.

testIamPermissions

 Renvoie les autorisations qu'un appelant a sur la ressource spécifiée.

undelete

 Restaure un cloud privé dont la suppression était prévue pour le DeletePrivateCloud.

updateDnsForwarding

 Met à jour les paramètres de la configuration DnsForwarding, comme les domaines associés.