REST Resource: projects.locations.bareMetalAdminClusters

Recurso: BareMetalAdminCluster

Recurso que representa un clúster de administrador de Bare Metal.

Representación JSON 
{
  "name": string,
  "description": string,
  "uid": string,
  "bareMetalVersion": string,
  "state": enum (State),
  "endpoint": string,
  "reconciling": boolean,
  "createTime": string,
  "updateTime": string,
  "deleteTime": string,
  "localName": string,
  "etag": string,
  "annotations": {
    string: string,
    ...
  },
  "networkConfig": {
    object (BareMetalAdminNetworkConfig)
  },
  "controlPlane": {
    object (BareMetalAdminControlPlaneConfig)
  },
  "loadBalancer": {
    object (BareMetalAdminLoadBalancerConfig)
  },
  "storage": {
    object (BareMetalAdminStorageConfig)
  },
  "fleet": {
    object (Fleet)
  },
  "clusterOperations": {
    object (BareMetalAdminClusterOperationsConfig)
  },
  "status": {
    object (ResourceStatus)
  },
  "maintenanceConfig": {
    object (BareMetalAdminMaintenanceConfig)
  },
  "maintenanceStatus": {
    object (BareMetalAdminMaintenanceStatus)
  },
  "validationCheck": {
    object (ValidationCheck)
  },
  "nodeConfig": {
    object (BareMetalAdminWorkloadNodeConfig)
  },
  "proxy": {
    object (BareMetalAdminProxyConfig)
  },
  "securityConfig": {
    object (BareMetalAdminSecurityConfig)
  },
  "nodeAccessConfig": {
    object (BareMetalAdminNodeAccessConfig)
  },
  "osEnvironmentConfig": {
    object (BareMetalAdminOsEnvironmentConfig)
  },
  "binaryAuthorization": {
    object (BinaryAuthorization)
  }
}
Campos
name

string

Inmutable. Nombre de recurso del clúster de administrador de Bare Metal.
description

string

Descripción legible por humanos de este clúster de administrador de metal desnudo.
uid

string

Solo de salida. Identificador único del clúster de administrador de metal desnudo.
bareMetalVersion

string

Versión de clústeres de Anthos en Bare Metal del clúster de administrador de Bare Metal.
state

enum (State)

Solo de salida. El estado actual del clúster de administrador de Bare Metal.
endpoint

string

Solo de salida. Nombre de la dirección IP del servidor de la API del clúster de administrador de metal desnudo.
reconciling

boolean

Solo de salida. Si se define, actualmente hay cambios en curso en el clúster de administración de hardware.
createTime

string (Timestamp format)

Solo de salida. Hora a la que se creó este clúster de administrador de bare metal.

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "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 de salida. Hora a la que se actualizó por última vez este clúster de administrador de metal desnudo.

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "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 de salida. La hora a la que se eliminó este clúster de administrador de metal desnudo. Si el recurso no se elimina, este campo debe estar vacío.

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
localName

string

Solo de salida. Nombre del objeto del recurso personalizado del clúster de metal desnudo. Este campo se usa para admitir nombres conflictivos al registrar clústeres en la API. Cuando se usa como parte del registro de clústeres, este campo será diferente del ID del nombre del recurso. En los clústeres nuevos, este campo coincidirá con el nombre del clúster proporcionado por el usuario y se mostrará en el último componente del nombre del recurso. No se puede modificar.

Todos los usuarios deben usar este nombre para acceder a su clúster mediante gkectl o kubectl y deben ver el nombre local al consultar los registros del controlador del clúster de administrador.
etag

string

El servidor calcula esta suma de comprobación en función del valor de otros campos y puede enviarse en solicitudes de actualización y eliminación para asegurarse de que el cliente tiene un valor actualizado antes de continuar. Permite a los clientes realizar lecturas, modificaciones y escrituras coherentes mediante el control de simultaneidad optimista.
annotations

map (key: string, value: string)

Anotaciones en el clúster de administrador de bare metal. Este campo tiene las mismas restricciones que las anotaciones de Kubernetes. El tamaño total de todas las claves y valores combinados no puede superar los 256 k. La clave puede tener dos segmentos: un prefijo (opcional) y un nombre (obligatorio), separados por una barra (/). El prefijo debe ser un subdominio de DNS. El nombre debe tener 63 caracteres como máximo, empezar y terminar con caracteres alfanuméricos, e incluir guiones (-), guiones bajos (_), puntos (.) y caracteres alfanuméricos.

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

object (BareMetalAdminNetworkConfig)

Configuración de red.
controlPlane

object (BareMetalAdminControlPlaneConfig)

Configuración del plano de control.
loadBalancer

object (BareMetalAdminLoadBalancerConfig)

Configuración del balanceador de carga.
storage

object (BareMetalAdminStorageConfig)

Configuración del almacenamiento.
fleet

object (Fleet)

Solo de salida. Configuración de la flota del clúster.
clusterOperations

object (BareMetalAdminClusterOperationsConfig)

Configuración de las operaciones del clúster.
status

object (ResourceStatus)

Solo de salida. ResourceStatus que representa el estado detallado del clúster.
maintenanceConfig

object (BareMetalAdminMaintenanceConfig)

Configuración de mantenimiento.
maintenanceStatus

object (BareMetalAdminMaintenanceStatus)

Solo de salida. MaintenanceStatus que representa el estado del mantenimiento.
validationCheck

object (ValidationCheck)

Solo de salida. ValidationCheck que representa el resultado de la comprobación preparatoria.
nodeConfig

object (BareMetalAdminWorkloadNodeConfig)

Configuración de nodos de carga de trabajo.
proxy

object (BareMetalAdminProxyConfig)

Configuración de proxy.
securityConfig

object (BareMetalAdminSecurityConfig)

Configuración relacionada con la seguridad.
nodeAccessConfig

object (BareMetalAdminNodeAccessConfig)

Configuraciones relacionadas con el acceso a los nodos.
osEnvironmentConfig

object (BareMetalAdminOsEnvironmentConfig)

Configuraciones relacionadas con el entorno del SO.
binaryAuthorization

object (BinaryAuthorization)

Configuraciones relacionadas con la autorización binaria.

Estado

El estado del ciclo de vida del clúster de administrador de Bare Metal.

Enumeraciones
STATE_UNSPECIFIED Sin definir.
PROVISIONING El estado PROVISIONING indica que se está creando el clúster.
RUNNING El estado RUNNING indica que el clúster se ha creado y se puede usar por completo.
RECONCILING El estado RECONCILING indica que el clúster se está actualizando. Sigue estando disponible, pero es posible que su rendimiento se vea afectado.
STOPPING El estado DETENIENDO indica que se está eliminando el clúster.
ERROR El estado ERROR indica que el clúster está en un estado dañado irrecuperable.
DEGRADED El estado DEGRADED indica que el clúster requiere que el usuario realice alguna acción para restaurar todas las funciones.

BareMetalAdminNetworkConfig

BareMetalAdminNetworkConfig especifica la configuración de la red del clúster.

Representación JSON 
{

  // Union field cluster_cidr_configuration can be only one of the following:
  "islandModeCidr": {
    object (BareMetalAdminIslandModeCidrConfig)
  }
  // End of list of possible types for union field cluster_cidr_configuration.
}
Campos
Campo de unión cluster_cidr_configuration. La configuración de CIDR que se va a usar en el clúster de administrador. cluster_cidr_configuration solo puede ser una de estas dos opciones:
islandModeCidr

object (BareMetalAdminIslandModeCidrConfig)

Configuración de CIDR del modo Island.

BareMetalAdminIslandModeCidrConfig

BareMetalAdminIslandModeCidrConfig especifica la configuración de CIDR del clúster cuando se ejecuta en el modo aislado.

Representación JSON 
{
  "serviceAddressCidrBlocks": [
    string
  ],
  "podAddressCidrBlocks": [
    string
  ]
}
Campos
serviceAddressCidrBlocks[]

string

Obligatorio. A todos los servicios del clúster se les asigna una dirección IPv4 RFC1918 de estos intervalos. Este campo no se puede cambiar después de crearse.
podAddressCidrBlocks[]

string

Obligatorio. Se ha asignado una dirección IPv4 de RFC1918 de estos intervalos a todos los pods del clúster. Este campo no se puede cambiar después de crearse.

BareMetalAdminControlPlaneConfig

BareMetalAdminControlPlaneConfig especifica la configuración del plano de control.

Representación JSON 
{
  "controlPlaneNodePoolConfig": {
    object (BareMetalAdminControlPlaneNodePoolConfig)
  },
  "apiServerArgs": [
    {
      object (BareMetalAdminApiServerArgument)
    }
  ]
}
Campos
controlPlaneNodePoolConfig

object (BareMetalAdminControlPlaneNodePoolConfig)

Obligatorio. Configura el grupo de nodos que ejecuta el plano de control. Si se especifica, se creará el NodePool correspondiente para el plano de control del clúster. El NodePool tendrá el mismo nombre y espacio de nombres que el clúster.
apiServerArgs[]

object (BareMetalAdminApiServerArgument)

Personaliza los argumentos predeterminados del servidor de la API. Solo se admite un subconjunto de las marcas personalizadas. Consulta la documentación del servidor de la API que aparece más abajo para conocer el formato exacto: https://kubernetes.io/docs/reference/command-line-tools-reference/kube-apiserver/.

BareMetalAdminControlPlaneNodePoolConfig

BareMetalAdminControlPlaneNodePoolConfig especifica la configuración del grupo de nodos del plano de control. Tenemos una configuración de grupo de nodos específica del plano de control para poder admitir campos específicos del plano de control en el futuro.

Representación JSON 
{
  "nodePoolConfig": {
    object (BareMetalNodePoolConfig)
  }
}
Campos
nodePoolConfig

object (BareMetalNodePoolConfig)

Obligatorio. La configuración genérica de un grupo de nodos que ejecuta el plano de control.

BareMetalAdminApiServerArgument

BareMetalAdminApiServerArgument representa un par nombre->valor de un argumento. Solo se admite un subconjunto de las marcas personalizadas. Consulta la documentación del servidor de la API que aparece más abajo para conocer el formato exacto: https://kubernetes.io/docs/reference/command-line-tools-reference/kube-apiserver/.

Representación JSON 
{
  "argument": string,
  "value": string
}
Campos
argument

string

Obligatorio. El nombre del argumento tal como aparece en la línea de comandos del servidor de la API. Asegúrate de quitar los guiones iniciales.
value

string

Obligatorio. El valor del argumento tal como se enviará a la línea de comandos del servidor de la API.

BareMetalAdminLoadBalancerConfig

BareMetalAdminLoadBalancerConfig especifica la configuración del balanceador de carga.

Representación JSON 
{
  "vipConfig": {
    object (BareMetalAdminVipConfig)
  },
  "portConfig": {
    object (BareMetalAdminPortConfig)
  },

  // Union field load_balancer_configuration can be only one of the following:
  "manualLbConfig": {
    object (BareMetalAdminManualLbConfig)
  }
  // End of list of possible types for union field load_balancer_configuration.
}
Campos
vipConfig

object (BareMetalAdminVipConfig)

Las IPs virtuales que usa el balanceador de carga.
portConfig

object (BareMetalAdminPortConfig)

Configura los puertos en los que escuchará el balanceador de carga.
Campo de unión load_balancer_configuration. La configuración del balanceador de carga que se va a usar en el clúster de administrador. load_balancer_configuration solo puede ser una de estas dos opciones:
manualLbConfig

object (BareMetalAdminManualLbConfig)

Balanceadores de carga configurados manualmente.

BareMetalAdminVipConfig

BareMetalAdminVipConfig para configuraciones de balanceadores de carga de Bare Metal.

Representación JSON 
{
  "controlPlaneVip": string
}
Campos
controlPlaneVip

string

La dirección IP virtual que has reservado para la API de Kubernetes de este clúster de administrador de hardware desnudo.

BareMetalAdminPortConfig

BareMetalAdminPortConfig es la especificación de los puertos del balanceador de carga.

Representación JSON 
{
  "controlPlaneLoadBalancerPort": integer
}
Campos
controlPlaneLoadBalancerPort

integer

Puerto en el que escucharán los balanceadores de carga alojados en el plano de control.

BareMetalAdminManualLbConfig

BareMetalAdminManualLbConfig representa los parámetros de configuración de un balanceador de carga manual.

Representación JSON 
{
  "enabled": boolean
}
Campos
enabled

boolean

Indica si el balanceo de carga manual está habilitado.

BareMetalAdminStorageConfig

BareMetalAdminStorageConfig especifica la configuración del almacenamiento del clúster.

Representación JSON 
{
  "lvpShareConfig": {
    object (BareMetalLvpShareConfig)
  },
  "lvpNodeMountsConfig": {
    object (BareMetalLvpConfig)
  }
}
Campos
lvpShareConfig

object (BareMetalLvpShareConfig)

Obligatorio. Especifica la configuración de los PersistentVolumes locales respaldados por subdirectorios de un sistema de archivos compartido. Estos subdirectorios se crean automáticamente durante la creación del clúster.
lvpNodeMountsConfig

object (BareMetalLvpConfig)

Obligatorio. Especifica la configuración de los PersistentVolumes locales respaldados por discos de nodos montados. El usuario debe formatear y montar estos discos, lo que puede hacer antes o después de crear el clúster.

BareMetalAdminClusterOperationsConfig

BareMetalAdminClusterOperationsConfig especifica la infraestructura de observabilidad del clúster de administrador.

Representación JSON 
{
  "enableApplicationLogs": boolean
}
Campos
enableApplicationLogs

boolean

Indica si se debe habilitar la recogida de registros o métricas de aplicaciones (además de los registros o métricas del sistema).

BareMetalAdminMaintenanceConfig

BareMetalAdminMaintenanceConfig especifica las configuraciones para poner los nodos de CR del clúster de administrador de Bare Metal en mantenimiento y fuera de él.

Representación JSON 
{
  "maintenanceAddressCidrBlocks": [
    string
  ]
}
Campos
maintenanceAddressCidrBlocks[]

string

Obligatorio. Todas las direcciones IPv4 de estos intervalos se pondrán en modo de mantenimiento. Los nodos en modo de mantenimiento se acordonarán y se drenarán. Cuando se cumplen ambas condiciones, se define la anotación "baremetal.cluster.gke.io/maintenance" en el recurso de nodo.

BareMetalAdminMaintenanceStatus

BareMetalAdminMaintenanceStatus representa el estado de mantenimiento de los nodos de CR del clúster de administrador de Bare Metal.

Representación JSON 
{
  "machineDrainStatus": {
    object (BareMetalAdminMachineDrainStatus)
  }
}
Campos
machineDrainStatus

object (BareMetalAdminMachineDrainStatus)

Representa el estado de los nodos de máquina que se están agotando y los que ya se han agotado. Se usa para mostrar el progreso de la actualización del clúster.

BareMetalAdminMachineDrainStatus

BareMetalAdminMachineDrainStatus representa el estado de las máquinas de nodos de metal desnudo que están sometidas a operaciones de drenaje.

Representación JSON 
{
  "drainingMachines": [
    {
      object (BareMetalAdminDrainingMachine)
    }
  ],
  "drainedMachines": [
    {
      object (BareMetalAdminDrainedMachine)
    }
  ]
}
Campos
drainingMachines[]

object (BareMetalAdminDrainingMachine)

Lista de máquinas de drenaje.
drainedMachines[]

object (BareMetalAdminDrainedMachine)

Lista de máquinas agotadas.

BareMetalAdminDrainingMachine

BareMetalAdminDrainingMachine representa las máquinas que se están drenando.

Representación JSON 
{
  "nodeIp": string,
  "podCount": integer
}
Campos
nodeIp

string

Dirección IP de la máquina de drenaje.
podCount

integer

Número de pods que aún no se han drenado.

BareMetalAdminDrainedMachine

BareMetalAdminDrainedMachine representa las máquinas que se han drenado.

Representación JSON 
{
  "nodeIp": string
}
Campos
nodeIp

string

Dirección IP de la máquina drenada.

BareMetalAdminWorkloadNodeConfig

BareMetalAdminWorkloadNodeConfig especifica las configuraciones de los nodos de carga de trabajo.

Representación JSON 
{
  "maxPodsPerNode": string
}
Campos
maxPodsPerNode

string (int64 format)

Número máximo de pods que puede ejecutar un nodo. El tamaño del intervalo CIDR asignado al nodo se derivará de este parámetro. De forma predeterminada, se crean 110 pods por nodo. El límite superior es de 250 tanto para los clústeres de administración de alta disponibilidad como para los que no lo son. El límite inferior es 64 para los clústeres de administradores que no son de alta disponibilidad y 32 para los clústeres de administradores de alta disponibilidad.

BareMetalAdminProxyConfig

BareMetalAdminProxyConfig especifica la configuración del proxy del clúster.

Representación JSON 
{
  "uri": string,
  "noProxy": [
    string
  ]
}
Campos
uri

string

Obligatorio. Especifica la dirección de tu servidor proxy. Ejemplos: http://domain

ADVERTENCIA: No proporciones credenciales en el formato http://(username:password@)domain, ya que el servidor las rechazará.
noProxy[]

string

Lista de IPs, nombres de host y dominios que deben omitir el proxy. Ejemplos: ["127.0.0.1", "example.com", ".corp", "localhost"].

BareMetalAdminSecurityConfig

Especifica los ajustes relacionados con la seguridad del clúster de administrador de metal desnudo.

Representación JSON 
{
  "authorization": {
    object (Authorization)
  }
}
Campos
authorization

object (Authorization)

Configura el acceso de los usuarios al clúster de administrador.

BareMetalAdminNodeAccessConfig

Especifica los ajustes relacionados con el acceso a nodos del clúster de administrador de metal desnudo.

Representación JSON 
{
  "loginUser": string
}
Campos
loginUser

string

Obligatorio. LoginUser es el nombre de usuario que se usa para acceder a las máquinas de nodos. Si no se define ningún valor, el valor predeterminado será "root".

BareMetalAdminOsEnvironmentConfig

Especifica la configuración de funcionamiento del sistema operativo para el aprovisionamiento del clúster.

Representación JSON 
{
  "packageRepoExcluded": boolean
}
Campos
packageRepoExcluded

boolean

Indica si se debe añadir el repositorio de paquetes al inicializar máquinas Bare Metal.

Métodos

create

 Crea un clúster de administrador de metal desnudo en un proyecto y una ubicación determinados.

enroll

 Registra un clúster de administrador de metal desnudo en la API Anthos On-Prem en un proyecto y una ubicación determinados.

get

 Obtiene los detalles de un solo clúster de administrador de bare metal.

list

 Muestra los clústeres de administrador de metal desnudo de un proyecto y una ubicación determinados.

patch

 Actualiza los parámetros de un solo clúster de administrador de bare metal.

queryVersionConfig

 Consulta la configuración de la versión del clúster de administradores de Bare Metal.