REST Resource: projects.locations.privateClouds.clusters

Recurso: Cluster

Es un clúster en una nube privada.

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

string

Solo salida. Es el identificador. Es el nombre del recurso de este clúster. 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/clusters/my-cluster.
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".
state

enum (State)

Solo salida. Estado del recurso.
management

boolean

Solo salida. Es verdadero si el clúster es de administración; de lo contrario, es falso. Solo puede haber un clúster de administración en una nube privada, y debe ser el primero.
autoscalingSettings

object (AutoscalingSettings)

Es opcional. Es la configuración del ajuste de escala automático que se aplica a este clúster.
uid

string

Solo salida. Es el identificador único generado por el sistema para el recurso.
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. Se requiere para los clústeres que pertenecen a una nube privada AMPLIADA.
datastoreMountConfig[]

object (DatastoreMountConfig)

Solo salida. Es la configuración de un almacén de datos activado.

Estado

El enum State define los posibles estados de los clústeres de la nube privada.

Enums
STATE_UNSPECIFIED Es el valor predeterminado. Este valor nunca debe usarse.
ACTIVE El clúster está operativo y el usuario puede usarlo.
CREATING Se está implementando el clúster.
UPDATING Se agrega o quita un nodo del clúster, o se realizan otras actualizaciones específicas del clúster.
DELETING Se está borrando el clúster.
REPAIRING El clúster está en mantenimiento, por ejemplo, se está reemplazando un nodo con errores.

AutoscalingSettings

La configuración del ajuste de escala automático define las reglas que usa VMware Engine para ajustar automáticamente la escala vertical y horizontal de los clústeres en una nube privada.

Representación JSON 
{
  "autoscalingPolicies": {
    string: {
      object (AutoscalingPolicy)
    },
    ...
  },
  "minClusterNodeCount": integer,
  "maxClusterNodeCount": integer,
  "coolDownPeriod": string
}
Campos
autoscalingPolicies

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

Obligatorio. Es el mapa con las políticas de ajuste de escala automático aplicadas al clúster. La clave es el identificador de la política. 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)

Actualmente, el mapa solo debe contener un elemento que describa la política de ajuste de escala automático para los nodos de procesamiento.

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

integer

Es opcional. Es la cantidad mínima de nodos de cualquier tipo en un clúster. Si no se especifica, se aplican los límites predeterminados.
maxClusterNodeCount

integer

Es opcional. Es la cantidad máxima de nodos de cualquier tipo en un clúster. Si no se especifica, se aplican los límites predeterminados.
coolDownPeriod

string (Duration format)

Es opcional. Es la duración mínima entre operaciones de ajuste de escala automático consecutivas. Comienza una vez que se completa la adición o eliminación de nodos. Si no se especifica, el valor predeterminado es 30 minutos. El período de enfriamiento debe expresarse en minutos enteros (por ejemplo, 30, 31, 50 o 180 minutos).

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

AutoscalingPolicy

La política de ajuste de escala automático describe el comportamiento del ajuste de escala automático con respecto al uso de recursos. La operación de expansión se inicia si el uso supera CUALQUIERA de los umbrales respectivos. La operación de reducción se inicia si la utilización está por debajo de TODOS los umbrales respectivos.

Representación JSON 
{
  "nodeTypeId": string,
  "scaleOutSize": integer,
  "cpuThresholds": {
    object (Thresholds)
  },
  "grantedMemoryThresholds": {
    object (Thresholds)
  },
  "consumedMemoryThresholds": {
    object (Thresholds)
  },
  "storageThresholds": {
    object (Thresholds)
  }
}
Campos
nodeTypeId

string

Obligatorio. Es el identificador canónico del tipo de nodo que se agregará o quitará. Corresponde a NodeType.
scaleOutSize

integer

Obligatorio. Cantidad de nodos que se agregarán a un clúster durante una operación de escalamiento horizontal. Debe ser divisible por 2 para los clústeres extendidos. Durante una operación de reducción, solo se quita un nodo (o 2 en el caso de los clústeres extendidos) en una sola iteración.
cpuThresholds

object (Thresholds)

Es opcional. Son los umbrales de uso relacionados con el uso de CPU.
grantedMemoryThresholds

object (Thresholds)

Es opcional. Son los umbrales de utilización relacionados con la cantidad de memoria asignada.
consumedMemoryThresholds

object (Thresholds)

Es opcional. Son los umbrales de utilización relacionados con la cantidad de memoria consumida.
storageThresholds

object (Thresholds)

Es opcional. Son los umbrales de utilización relacionados con la cantidad de almacenamiento consumido.

Umbrales

Los umbrales definen el uso de los recursos que activan las operaciones de escalamiento horizontal y vertical.

Representación JSON 
{
  "scaleOut": integer,
  "scaleIn": integer
}
Campos
scaleOut

integer

Obligatorio. Es el porcentaje de uso que activa la operación de escalamiento horizontal.
scaleIn

integer

Obligatorio. Es el porcentaje de uso que activa la operación de reducción.

DatastoreMountConfig

Configuración de Datastore Mount

Representación JSON 
{
  "fileShare": string,
  "datastore": string,
  "datastoreNetwork": {
    object (DatastoreNetwork)
  },
  "accessMode": enum (AccessMode),
  "nfsVersion": enum (NfsVersion),
  "servers": [
    string
  ]
}
Campos
fileShare

string

Solo salida. Nombre del recurso compartido de archivos.
datastore

string

Obligatorio. Es el nombre del recurso del almacén de datos que se activará. 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/datastores/my-datastore.
datastoreNetwork

object (DatastoreNetwork)

Obligatorio. Es la configuración de red del almacén de datos.
accessMode

enum (AccessMode)

Es opcional. Es el modo de acceso del volumen de NFS. Es opcional. Se usará el valor predeterminado READ_WRITE
nfsVersion

enum (NfsVersion)

Es opcional. Es el protocolo NFS que admite el volumen NFS. El valor predeterminado que se usará será NFS_V3
servers[]

string

Solo salida. Son las direcciones IP del servidor del volumen NFS. En el caso de NFS 3, solo puedes proporcionar una dirección IP del servidor o nombres de DNS.

DatastoreNetwork

Es la configuración de red del almacén de datos.

Representación JSON 
{
  "subnet": string,
  "mtu": integer,
  "networkPeering": string,
  "connectionCount": integer
}
Campos
subnet

string

Obligatorio. Nombre del recurso de la subred.Los nombres de los recursos son URIs sin esquema que siguen las convenciones que se indican en https://cloud.google.com/apis/design/resource_names, p.ej., projects/my-project/locations/us-central1/subnets/my-subnet
mtu

integer

Es opcional. El valor de MTU se establece en el adaptador de VMkernel para el tráfico de NFS. Si no se proporciona, se usa el MTU de 1500. Para usar marcos jumbo, establece este valor en 8896. Te recomendamos que ajustes este valor según el rendimiento del tráfico de NFS. El rendimiento se puede determinar con herramientas de E/S de comparativas, como la utilidad fio (Flexible I/O Tester).
networkPeering

string

Solo salida. Es el nombre del recurso de la conexión de red, que se usa para que los clientes de la nube privada accedan al archivo compartido. Los nombres de recursos son URIs sin esquema que siguen las convenciones en https://cloud.google.com/apis/design/resource_names, p. ej., projects/my-project/locations/us-central1/networkPeerings/my-network-peering.
connectionCount

integer

Opcional. connectionCount se usa para establecer varias conexiones desde el cliente de NFS en el host de ESXi al servidor de NFS. Una mayor cantidad de conexiones genera un mejor rendimiento en los almacenes de datos. En la API de clusters.mountDatastore, se configuran de forma predeterminada un máximo de 4 conexiones. El usuario puede establecer el valor de connectionCount entre 1 y 4. Connection_count se admite desde vSphere 8.0u1. Para versiones anteriores, se establece el recuento de conexiones de la versión 1 en los hosts ESXi.

AccessMode

Es el modo de acceso del volumen de NFS.

Enums
ACCESS_MODE_UNSPECIFIED Es el valor predeterminado. Este valor nunca debe usarse.
READ_ONLY Los hosts acceden a NFS en modo de lectura
READ_WRITE Los hosts acceden a NFS en modo de lectura y escritura

NfsVersion

Es el protocolo NFS que admite el volumen NFS.

Enums
NFS_VERSION_UNSPECIFIED Es el valor predeterminado. Este valor nunca debe usarse.
NFS_V3 NFS 3

Métodos

create

 Crea un clúster nuevo en una nube privada determinada.

delete

 Borra un recurso Cluster.

get

 Recupera un recurso Cluster por su nombre.

getIamPolicy

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

list

 Enumera los recursos Cluster en una nube privada determinada.

mountDatastore

 Cómo se vincula un Datastore a un recurso de clúster

patch

 Modifica un recurso Cluster.

setIamPolicy

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

testIamPermissions

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

unmountDatastore

 Desmonta un Datastore en un recurso de clúster.