REST Resource: projects.locations.privateClouds

Recurso: PrivateCloud

Representa un recurso de nube privada. Las nubes privadas de tipo STANDARD y TIME_LIMITED son recursos zonales, mientras que las nubes privadas de tipo STRETCHED son regionales.

Representación 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)
}
Campos
name

string

Solo salida. Es el identificador. Es el nombre del recurso de esta nube privada. Los nombres de recursos son URIs sin esquema que siguen las convenciones que se indican en https://cloud.google.com/apis/design/resource_names. Por ejemplo: projects/my-project/locations/us-central1-a/privateClouds/my-cloud.
createTime

string (Timestamp format)

Solo salida. Es la fecha y hora de creación de este recurso.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo salida. Es la fecha y hora de la última actualización de este recurso.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
deleteTime

string (Timestamp format)

Solo salida. Fecha y hora en que se programó la eliminación del recurso.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
expireTime

string (Timestamp format)

Solo salida. Fecha y hora en que se borrará el recurso de forma irreversible.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
state

enum (State)

Solo salida. Estado del recurso. Se pueden agregar valores nuevos a esta enumeración cuando sea apropiado.
networkConfig

object (NetworkConfig)

Obligatorio. Es la configuración de red de la nube privada.
managementCluster

object (ManagementCluster)

Obligatorio. Solo entrada. Es el clúster de administración de esta nube privada. Este campo es obligatorio durante la creación de la nube privada para proporcionar detalles sobre el clúster predeterminado.

Los siguientes campos no se pueden cambiar después de la creación de la nube privada: ManagementCluster.clusterId, ManagementCluster.nodeTypeId.
description

string

Es la descripción que proporciona el usuario para esta nube privada.
hcx

object (Hcx)

Solo salida. Dispositivo de HCX
nsx

object (Nsx)

Solo salida. Dispositivo NSX
vcenter

object (Vcenter)

Solo salida. Es un dispositivo de vCenter.
uid

string

Solo salida. Es el identificador único generado por el sistema para el recurso.
type

enum (Type)

Es opcional. Es el tipo de nube privada. La configuración predeterminada es STANDARD.

Estado

El enum State define los posibles estados de las nubes privadas.

Enums
STATE_UNSPECIFIED Es el valor predeterminado. Este valor nunca debe usarse.
ACTIVE La nube privada está lista.
CREATING Se está creando la nube privada.
UPDATING Se está actualizando la nube privada.
FAILED La nube privada está en estado de error.
DELETED Se programó la eliminación de la nube privada. El proceso de eliminación se puede cancelar con el método de recuperación correspondiente.
PURGING La nube privada se borró de forma irreversible y se está quitando del sistema.

NetworkConfig

Es la configuración de red en el proyecto del consumidor con el que se debe realizar el intercambio de tráfico.

Representación JSON 
{
  "managementCidr": string,
  "vmwareEngineNetwork": string,
  "vmwareEngineNetworkCanonical": string,
  "managementIpAddressLayoutVersion": integer,
  "dnsServerIp": string
}
Campos
managementCidr

string

Obligatorio. Es el CIDR de administración que usan los dispositivos de administración de VMware.
vmwareEngineNetwork

string

Es opcional. Es el nombre del recurso relativo de la red de VMware Engine conectada a la nube privada. Especifica el nombre con el siguiente formato: projects/{project}/locations/{location}/vmwareEngineNetworks/{vmwareEngineNetworkId}, en el que {project} puede ser un número o un ID del proyecto.
vmwareEngineNetworkCanonical

string

Solo salida. Nombre canónico de la red de VMware Engine con el siguiente formato: projects/{projectNumber}/locations/{location}/vmwareEngineNetworks/{vmwareEngineNetworkId}
managementIpAddressLayoutVersion

integer

Solo salida. Es la versión del diseño de direcciones IP del rango de direcciones IP de administración. Las versiones posibles incluyen las siguientes: * managementIpAddressLayoutVersion=1: Indica el diseño de direcciones IP heredado que usan algunas nubes privadas existentes. Esta opción ya no es compatible con las nubes privadas nuevas, ya que no admite todas las funciones. * managementIpAddressLayoutVersion=2: Indica el diseño de direcciones IP más reciente que usan todas las nubes privadas creadas recientemente. Esta versión admite todas las funciones actuales.
dnsServerIp

string

Solo salida. Es la dirección IP del servidor DNS de la nube privada. Todas las consultas de DNS se pueden reenviar a esta dirección para la resolución de nombres de las entidades de administración de la nube privada, como vCenter, NSX-T Manager y los hosts ESXi.

ManagementCluster

Configuración del clúster de administración

Representación JSON 
{
  "clusterId": string,
  "nodeTypeConfigs": {
    string: {
      object (NodeTypeConfig)
    },
    ...
  },
  "stretchedClusterConfig": {
    object (StretchedClusterConfig)
  }
}
Campos
clusterId

string

Obligatorio. Es el identificador proporcionado por el usuario del nuevo Cluster. El identificador debe cumplir con los siguientes requisitos:

  • Solo contiene entre 1 y 63 caracteres alfanuméricos y guiones
  • Comienza con un carácter alfabético.
  • Termina con un carácter que no es un guion.
  • No tiene el formato de un UUID
  • Cumple con RFC 1034 (sección 3.5)
nodeTypeConfigs

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

Obligatorio. Es el mapa de los tipos de nodos del clúster en este clúster, en el que la clave es el identificador canónico del tipo de nodo (corresponde a NodeType).

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
stretchedClusterConfig

object (StretchedClusterConfig)

Es opcional. Es la configuración de un clúster extendido. Es obligatorio para las nubes privadas AMPLIADAS.

Hcx

Son los detalles sobre un dispositivo de HCX Cloud Manager.

Representación JSON 
{
  "internalIp": string,
  "version": string,
  "state": enum (State),
  "fqdn": string
}
Campos
internalIp

string

Es la dirección IP interna del dispositivo.
version

string

Es la versión del dispositivo.
state

enum (State)

Solo salida. Es el estado del dispositivo.
fqdn

string

Nombre de dominio completamente calificado del dispositivo.

Estado

Estado del dispositivo

Enums
STATE_UNSPECIFIED No se especificó el estado del electrodoméstico. Este es el valor predeterminado.
ACTIVE El electrodoméstico funciona y se puede usar.
CREATING Se está implementando el dispositivo.
ACTIVATING Se está activando el dispositivo.

Nsx

Son los detalles sobre un dispositivo de NSX Manager.

Representación JSON 
{
  "internalIp": string,
  "version": string,
  "state": enum (State),
  "fqdn": string
}
Campos
internalIp

string

Es la dirección IP interna del dispositivo.
version

string

Es la versión del dispositivo.
state

enum (State)

Solo salida. Es el estado del dispositivo.
fqdn

string

Nombre de dominio completamente calificado del dispositivo.

Estado

Estado del dispositivo

Enums
STATE_UNSPECIFIED No se especificó el estado del electrodoméstico. Este es el valor predeterminado.
ACTIVE El electrodoméstico funciona y se puede usar.
CREATING Se está implementando el dispositivo.

vCenter

Son los detalles sobre un dispositivo de administración de vCenter Server.

Representación JSON 
{
  "internalIp": string,
  "version": string,
  "state": enum (State),
  "fqdn": string
}
Campos
internalIp

string

Es la dirección IP interna del dispositivo.
version

string

Es la versión del dispositivo.
state

enum (State)

Solo salida. Es el estado del dispositivo.
fqdn

string

Nombre de dominio completamente calificado del dispositivo.

Estado

Estado del dispositivo

Enums
STATE_UNSPECIFIED No se especificó el estado del electrodoméstico. Este es el valor predeterminado.
ACTIVE El electrodoméstico funciona y se puede usar.
CREATING Se está implementando el dispositivo.

Tipo

El tipo de enumeración define el tipo de nube privada.

Enums
STANDARD Estándar privada es un recurso zonal con más de 3 nodos. Es el tipo predeterminado.
TIME_LIMITED La nube privada de tiempo limitado es un recurso zonal, solo puede tener 1 nodo y tiene una vida útil limitada. Se borrará después del período definido y se puede convertir en una nube privada estándar si se expande a 3 o más nodos.
STRETCHED La nube privada extendida es un recurso regional con redundancia, con un mínimo de 6 nodos, y la cantidad de nodos debe ser par.

Métodos

create

 Crea un recurso PrivateCloud nuevo en un proyecto y una ubicación determinados.

delete

 Programa un recurso PrivateCloud para su eliminación.

get

 Recupera un recurso PrivateCloud por su nombre.

getDnsForwarding

 Obtiene detalles de la configuración de DnsForwarding.

getIamPolicy

 Permite obtener la política de control de acceso de un recurso.

list

 Enumera los recursos PrivateCloud en una ubicación y un proyecto determinados.

patch

 Modifica un recurso PrivateCloud.

privateCloudDeletionNow

 Acelera la eliminación de una nube privada que se encuentra actualmente en eliminación no definitiva. Un recurso PrivateCloud en eliminación no definitiva tiene PrivateCloud.state establecido en SOFT_DELETED y PrivateCloud.expireTime establecido en la fecha y hora en que ya no se puede revertir la eliminación.

resetNsxCredentials

 Restablece las credenciales del dispositivo NSX.

resetVcenterCredentials

 Restablece las credenciales del dispositivo de Vcenter.

setIamPolicy

 Permite configurar la política de control de acceso en el recurso especificado.

showNsxCredentials

 Obtiene detalles de las credenciales del dispositivo NSX.

showVcenterCredentials

 Obtiene detalles de las credenciales del dispositivo de vCenter.

testIamPermissions

 Permite mostrar los permisos que tiene un emisor para un recurso específico.

undelete

 Restablece una nube privada que DeletePrivateCloud había programado para su eliminación.

updateDnsForwarding

 Actualiza los parámetros de la configuración de DnsForwarding, como los dominios asociados.