REST Resource: projects.locations.bareMetalAdminClusters

Risorsa: BareMetalAdminCluster

Risorsa che rappresenta un cluster di amministrazione on bare metal.

Rappresentazione 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)
  }
}
Campi
name

string

Immutabile. Il nome della risorsa del cluster di amministrazione bare metal.
description

string

Una descrizione leggibile di questo cluster di amministrazione on bare metal.
uid

string

Solo output. L'identificatore univoco del cluster di amministrazione on bare metal.
bareMetalVersion

string

La versione di Anthos clusters on bare metal per il cluster di amministrazione bare metal.
state

enum (State)

Solo output. Lo stato attuale del cluster di amministrazione bare metal.
endpoint

string

Solo output. Il nome dell'indirizzo IP del server API del cluster di amministrazione bare metal.
reconciling

boolean

Solo output. Se impostato, al momento sono in corso modifiche al cluster di amministrazione on bare metal.
createTime

string (Timestamp format)

Solo output. L'ora in cui è stato creato questo cluster di amministrazione bare metal.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. L'ora dell'ultimo aggiornamento di questo cluster di amministrazione bare metal.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
deleteTime

string (Timestamp format)

Solo output. La data e l'ora in cui questo cluster di amministrazione bare metal è stato eliminato. Se la risorsa non viene eliminata, questo campo deve essere vuoto

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
localName

string

Solo output. Il nome dell'oggetto della risorsa personalizzata del cluster bare metal. Questo campo viene utilizzato per supportare i nomi in conflitto durante la registrazione di cluster esistenti nell'API. Se utilizzato nell'ambito della registrazione del cluster, questo campo sarà diverso dall'ID nel nome della risorsa. Per i nuovi cluster, questo campo corrisponderà al nome del cluster fornito dall'utente e sarà visibile nell'ultimo componente del nome della risorsa. Non è modificabile.

Tutti gli utenti devono utilizzare questo nome per accedere al cluster utilizzando gkectl o kubectl e devono aspettarsi di vedere il nome locale quando visualizzano i log del controller del cluster di amministrazione.
etag

string

Questo checksum viene calcolato dal server in base al valore di altri campi e può essere inviato per le richieste di aggiornamento ed eliminazione per garantire che il client abbia un valore aggiornato prima di procedere. Consente ai client di eseguire letture, modifiche e scritture coerenti tramite il controllo della concorrenza ottimistico.
annotations

map (key: string, value: string)

Annotazioni sul cluster di amministrazione on bare metal. Questo campo ha le stesse limitazioni delle annotazioni Kubernetes. La dimensione totale di tutte le chiavi e i valori combinati è limitata a 256 KB. La chiave può avere due segmenti: un prefisso (facoltativo) e un nome (obbligatorio), separati da una barra (/). Il prefisso deve essere un sottodominio DNS. Il nome deve avere una lunghezza massima di 63 caratteri, deve iniziare e terminare con caratteri alfanumerici e può comprendere trattini (-), trattini bassi (_), punti (.) e caratteri alfanumerici.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
networkConfig

object (BareMetalAdminNetworkConfig)

Configurazione di rete.
controlPlane

object (BareMetalAdminControlPlaneConfig)

Configurazione del piano di controllo.
loadBalancer

object (BareMetalAdminLoadBalancerConfig)

Configurazione del bilanciatore del carico.
storage

object (BareMetalAdminStorageConfig)

Configurazione dello spazio di archiviazione.
fleet

object (Fleet)

Solo output. Configurazione del parco risorse per il cluster.
clusterOperations

object (BareMetalAdminClusterOperationsConfig)

Configurazione delle operazioni del cluster.
status

object (ResourceStatus)

Solo output. ResourceStatus che rappresenta lo stato dettagliato del cluster.
maintenanceConfig

object (BareMetalAdminMaintenanceConfig)

Configurazione della manutenzione.
maintenanceStatus

object (BareMetalAdminMaintenanceStatus)

Solo output. MaintenanceStatus che rappresenta lo stato della manutenzione.
validationCheck

object (ValidationCheck)

Solo output. ValidationCheck che rappresenta il risultato del controllo preliminare.
nodeConfig

object (BareMetalAdminWorkloadNodeConfig)

Configurazione del nodo del workload.
proxy

object (BareMetalAdminProxyConfig)

Configurazione del proxy.
securityConfig

object (BareMetalAdminSecurityConfig)

Configurazione relativa alla sicurezza.
nodeAccessConfig

object (BareMetalAdminNodeAccessConfig)

Configurazioni relative all'accesso ai nodi.
osEnvironmentConfig

object (BareMetalAdminOsEnvironmentConfig)

Configurazioni relative all'ambiente del sistema operativo.
binaryAuthorization

object (BinaryAuthorization)

Configurazioni relative all'autorizzazione binaria.

Stato

Lo stato del ciclo di vita del cluster di amministrazione on bare metal.

Enum
STATE_UNSPECIFIED Non impostato.
PROVISIONING Lo stato PROVISIONING indica che il cluster è in fase di creazione.
RUNNING Lo stato RUNNING indica che il cluster è stato creato ed è completamente utilizzabile.
RECONCILING Lo stato RECONCILING indica che il cluster è in fase di aggiornamento. Rimane disponibile, ma con un potenziale calo delle prestazioni.
STOPPING Lo stato STOPPING indica che il cluster è in fase di eliminazione.
ERROR Lo stato ERROR indica che il cluster è in uno stato non recuperabile non funzionante.
DEGRADED Lo stato DEGRADED indica che il cluster richiede un'azione da parte dell'utente per ripristinare la funzionalità completa.

BareMetalAdminNetworkConfig

BareMetalAdminNetworkConfig specifica la configurazione di rete del cluster.

Rappresentazione 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.
}
Campi
Campo unione cluster_cidr_configuration. La configurazione CIDR da utilizzare nel cluster di amministrazione. cluster_cidr_configuration può essere solo uno dei seguenti:
islandModeCidr

object (BareMetalAdminIslandModeCidrConfig)

Configurazione per il CIDR in modalità Isola.

BareMetalAdminIslandModeCidrConfig

BareMetalAdminIslandModeCidrConfig specifica la configurazione CIDR del cluster durante l'esecuzione in modalità isola.

Rappresentazione JSON 
{
  "serviceAddressCidrBlocks": [
    string
  ],
  "podAddressCidrBlocks": [
    string
  ]
}
Campi
serviceAddressCidrBlocks[]

string

Obbligatorio. A tutti i servizi del cluster viene assegnato un indirizzo IPv4 RFC1918 da questi intervalli. Questo campo non può essere modificato dopo la creazione.
podAddressCidrBlocks[]

string

Obbligatorio. A tutti i pod del cluster viene assegnato un indirizzo IPv4 RFC1918 da questi intervalli. Questo campo non può essere modificato dopo la creazione.

BareMetalAdminControlPlaneConfig

BareMetalAdminControlPlaneConfig specifica la configurazione del control plane.

Rappresentazione JSON 
{
  "controlPlaneNodePoolConfig": {
    object (BareMetalAdminControlPlaneNodePoolConfig)
  },
  "apiServerArgs": [
    {
      object (BareMetalAdminApiServerArgument)
    }
  ]
}
Campi
controlPlaneNodePoolConfig

object (BareMetalAdminControlPlaneNodePoolConfig)

Obbligatorio. Configura il pool di nodi che esegue il piano di controllo. Se specificato, verrà creato il NodePool corrispondente per il piano di controllo del cluster. Il node pool avrà lo stesso nome e lo stesso spazio dei nomi del cluster.
apiServerArgs[]

object (BareMetalAdminApiServerArgument)

Personalizza gli argomenti del server API predefiniti. È supportato solo un sottoinsieme di flag personalizzati. Per conoscere il formato esatto, consulta la documentazione del server API riportata di seguito: https://kubernetes.io/docs/reference/command-line-tools-reference/kube-apiserver/

BareMetalAdminControlPlaneNodePoolConfig

BareMetalAdminControlPlaneNodePoolConfig specifica la configurazione del pool di nodi del control plane. Abbiamo una configurazione del pool di nodi specifica per il piano di controllo, in modo da poter supportare in modo flessibile i campi specifici del piano di controllo in futuro.

Rappresentazione JSON 
{
  "nodePoolConfig": {
    object (BareMetalNodePoolConfig)
  }
}
Campi
nodePoolConfig

object (BareMetalNodePoolConfig)

Obbligatorio. La configurazione generica per un pool di nodi che esegue il piano di controllo.

BareMetalAdminApiServerArgument

BareMetalAdminApiServerArgument rappresenta una coppia nome->valore dell'argomento. È supportato solo un sottoinsieme di flag personalizzati. Per conoscere il formato esatto, consulta la documentazione del server API riportata di seguito: https://kubernetes.io/docs/reference/command-line-tools-reference/kube-apiserver/

Rappresentazione JSON 
{
  "argument": string,
  "value": string
}
Campi
argument

string

Obbligatorio. Assicurati di rimuovere i trattini iniziali dal nome dell'argomento visualizzato nella riga di comando del server API.
value

string

Obbligatorio. Il valore dell'argomento che verrà passato alla riga di comando del server API.

BareMetalAdminLoadBalancerConfig

BareMetalAdminLoadBalancerConfig specifica la configurazione del bilanciatore del carico.

Rappresentazione 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.
}
Campi
vipConfig

object (BareMetalAdminVipConfig)

I VIP utilizzati dal bilanciatore del carico.
portConfig

object (BareMetalAdminPortConfig)

Configura le porte su cui il bilanciatore del carico rimarrà in ascolto.
Campo unione load_balancer_configuration. La configurazione del bilanciatore del carico da utilizzare nel cluster di amministrazione. load_balancer_configuration può essere solo uno dei seguenti:
manualLbConfig

object (BareMetalAdminManualLbConfig)

Bilanciatori del carico configurati manualmente.

BareMetalAdminVipConfig

BareMetalAdminVipConfig per le configurazioni del bilanciatore del carico bare metal.

Rappresentazione JSON 
{
  "controlPlaneVip": string
}
Campi
controlPlaneVip

string

Il VIP che hai riservato in precedenza per l'API Kubernetes di questo cluster di amministrazione bare metal.

BareMetalAdminPortConfig

BareMetalAdminPortConfig è la specifica delle porte del bilanciatore del carico.

Rappresentazione JSON 
{
  "controlPlaneLoadBalancerPort": integer
}
Campi
controlPlaneLoadBalancerPort

integer

La porta su cui i bilanciatori del carico ospitati dal control plane saranno in ascolto.

BareMetalAdminManualLbConfig

BareMetalAdminManualLbConfig rappresenta i parametri di configurazione per un bilanciatore del carico manuale.

Rappresentazione JSON 
{
  "enabled": boolean
}
Campi
enabled

boolean

Indica se il bilanciamento del carico manuale è abilitato.

BareMetalAdminStorageConfig

BareMetalAdminStorageConfig specifica la configurazione dello spazio di archiviazione del cluster.

Rappresentazione JSON 
{
  "lvpShareConfig": {
    object (BareMetalLvpShareConfig)
  },
  "lvpNodeMountsConfig": {
    object (BareMetalLvpConfig)
  }
}
Campi
lvpShareConfig

object (BareMetalLvpShareConfig)

Obbligatorio. Specifica la configurazione per i volumi permanenti locali supportati da sottodirectory in un file system condiviso. Queste sottodirectory vengono create automaticamente durante la creazione del cluster.
lvpNodeMountsConfig

object (BareMetalLvpConfig)

Obbligatorio. Specifica la configurazione per i volumi permanenti locali supportati dai dischi dei nodi montati. Questi dischi devono essere formattati e montati dall'utente prima o dopo la creazione del cluster.

BareMetalAdminClusterOperationsConfig

BareMetalAdminClusterOperationsConfig specifica l'infrastruttura di osservabilità del cluster di amministrazione.

Rappresentazione JSON 
{
  "enableApplicationLogs": boolean
}
Campi
enableApplicationLogs

boolean

Indica se deve essere attivata la raccolta di metriche/log delle applicazioni (oltre a quelle di sistema).

BareMetalAdminMaintenanceConfig

BareMetalAdminMaintenanceConfig specifica le configurazioni per mettere in manutenzione e rimuovere dalla manutenzione i nodi CR del cluster di amministrazione bare metal.

Rappresentazione JSON 
{
  "maintenanceAddressCidrBlocks": [
    string
  ]
}
Campi
maintenanceAddressCidrBlocks[]

string

Obbligatorio. Tutti gli indirizzi IPv4 di questi intervalli verranno inseriti in modalità di manutenzione. I nodi in modalità di manutenzione verranno messi in isolamento e svuotati. Se entrambe le condizioni sono vere, l'annotazione "baremetal.cluster.gke.io/maintenance" verrà impostata sulla risorsa del nodo.

BareMetalAdminMaintenanceStatus

BareMetalAdminMaintenanceStatus rappresenta lo stato della manutenzione per i nodi del cluster di amministrazione bare metal.

Rappresentazione JSON 
{
  "machineDrainStatus": {
    object (BareMetalAdminMachineDrainStatus)
  }
}
Campi
machineDrainStatus

object (BareMetalAdminMachineDrainStatus)

Rappresenta lo stato dei nodi macchina in fase di svuotamento e svuotati. Viene utilizzato per mostrare l'avanzamento dell'upgrade del cluster.

BareMetalAdminMachineDrainStatus

BareMetalAdminMachineDrainStatus rappresenta lo stato delle macchine bare metal in fase di operazioni di svuotamento.

Rappresentazione JSON 
{
  "drainingMachines": [
    {
      object (BareMetalAdminDrainingMachine)
    }
  ],
  "drainedMachines": [
    {
      object (BareMetalAdminDrainedMachine)
    }
  ]
}
Campi
drainingMachines[]

object (BareMetalAdminDrainingMachine)

L'elenco delle macchine di pompaggio.
drainedMachines[]

object (BareMetalAdminDrainedMachine)

L'elenco delle macchine prosciugate.

BareMetalAdminDrainingMachine

BareMetalAdminDrainingMachine rappresenta le macchine attualmente in svuotamento.

Rappresentazione JSON 
{
  "nodeIp": string,
  "podCount": integer
}
Campi
nodeIp

string

Indirizzo IP della macchina di svuotamento.
podCount

integer

Il conteggio dei pod da svuotare.

BareMetalAdminDrainedMachine

BareMetalAdminDrainedMachine rappresenta le macchine che sono state prosciugate.

Rappresentazione JSON 
{
  "nodeIp": string
}
Campi
nodeIp

string

Indirizzo IP della macchina svuotata.

BareMetalAdminWorkloadNodeConfig

BareMetalAdminWorkloadNodeConfig specifica le configurazioni dei nodi del workload.

Rappresentazione JSON 
{
  "maxPodsPerNode": string
}
Campi
maxPodsPerNode

string (int64 format)

Il numero massimo di pod che un nodo può eseguire. La dimensione dell'intervallo CIDR assegnato al nodo verrà ricavata da questo parametro. Per impostazione predefinita, vengono creati 110 pod per nodo. Il limite superiore è 250 sia per i cluster di amministrazione ad alta disponibilità che per quelli non ad alta disponibilità. Il limite inferiore è 64 per il cluster di amministrazione non HA e 32 per il cluster di amministrazione ad alta disponibilità.

BareMetalAdminProxyConfig

BareMetalAdminProxyConfig specifica la configurazione del proxy del cluster.

Rappresentazione JSON 
{
  "uri": string,
  "noProxy": [
    string
  ]
}
Campi
uri

string

Obbligatorio. Specifica l'indirizzo del server proxy. Esempi: http://domain

ATTENZIONE: non fornire le credenziali nel formato http://(username:password@)domain, in quanto verranno rifiutate dal server.
noProxy[]

string

Un elenco di IP, nomi host e domini che devono saltare il proxy. Esempi: ["127.0.0.1", "example.com", ".corp", "localhost"].

BareMetalAdminSecurityConfig

Specifica le impostazioni relative alla sicurezza per il cluster di amministrazione on bare metal.

Rappresentazione JSON 
{
  "authorization": {
    object (Authorization)
  }
}
Campi
authorization

object (Authorization)

Configura l'accesso utente al cluster di amministrazione.

BareMetalAdminNodeAccessConfig

Specifica le impostazioni relative all'accesso ai nodi per il cluster di amministrazione bare metal.

Rappresentazione JSON 
{
  "loginUser": string
}
Campi
loginUser

string

Obbligatorio. LoginUser è il nome utente utilizzato per accedere alle macchine dei nodi. Se non viene impostato, il valore predefinito è "root".

BareMetalAdminOsEnvironmentConfig

Specifica le impostazioni di funzionamento del sistema operativo per il provisioning del cluster.

Rappresentazione JSON 
{
  "packageRepoExcluded": boolean
}
Campi
packageRepoExcluded

boolean

Indica se il repository dei pacchetti deve essere aggiunto durante l'inizializzazione delle macchine bare metal.

Metodi

create

 Crea un nuovo cluster di amministrazione on bare metal in un determinato progetto e località.

enroll

 Registra un cluster di amministrazione bare metal esistente nell'API Anthos On-Prem in un determinato progetto e località.

get

 Recupera i dettagli di un singolo cluster di amministrazione on bare metal.

list

 Elenca i cluster di amministrazione bare metal in un determinato progetto e località.

patch

 Aggiorna i parametri di un singolo cluster di amministrazione on bare metal.

queryVersionConfig

 Esegue query sulla configurazione della versione del cluster di amministrazione on bare metal.