Method: projects.locations.bareMetalClusters.list

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

Solicitud HTTP

GET https://gkeonprem.googleapis.com/v1/{parent=projects/*/locations/*}/bareMetalClusters

La URL utiliza la sintaxis de transcodificación a gRPC.

Parámetros de ruta

Parámetros
parent

string

Obligatorio. El elemento superior del proyecto y la ubicación en los que se enumeran los clústeres. Formato: "projects/{project}/locations/{location}"

Los parámetros de consulta

Parámetros
pageSize

integer

Tamaño de la página solicitado. El servidor puede devolver menos elementos de los solicitados. Si no se especifica, se devolverán 50 clústeres como máximo. El valor máximo es 1000; los valores superiores a este límite se convertirán a 1000.
pageToken

string

Un token con el que se identifica la página de resultados que el servidor debería devolver.
filter

string

Una expresión de filtrado de recursos que sigue https://google.aip.dev/160. Si no está vacío, solo se devuelven los recursos cuyo campo de atributos coincida con el filtro.
view

enum (ClusterView)

Vista de los clústeres de Bare Metal. Si se especifica BASIC, solo se devuelven el nombre del recurso del clúster y la pertenencia al clúster de administrador. El valor predeterminado o sin definir CLUSTER_VIEW_UNSPECIFIED es el mismo que `FULL`, que devuelve los detalles de configuración completos del clúster.
allowMissing

boolean

Opcional. Si es true, devuelve la lista de clústeres de Bare Metal, incluidos los que solo existen en RMS.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Mensaje de respuesta para enumerar clústeres de Bare Metal.

Si la solicitud se realiza correctamente, el cuerpo de la respuesta proporciona datos con la siguiente estructura:

Representación JSON 
{
  "bareMetalClusters": [
    {
      object (BareMetalCluster)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Campos
bareMetalClusters[]

object (BareMetalCluster)

Lista de clústeres de Bare Metal.
nextPageToken

string

Un token con el que se identifica la página de resultados que el servidor debería devolver. Si el token no está vacío, significa que hay más resultados disponibles y que se deben obtener repitiendo la solicitud con el token de página proporcionado.
unreachable[]

string

Ubicaciones a las que no se ha podido acceder.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta el Authentication Overview.

ClusterView

Una vista de los recursos del clúster.

Enumeraciones
CLUSTER_VIEW_UNSPECIFIED Si no se define ningún valor, se usa la vista predeterminada FULL.
BASIC Incluye información básica de un recurso de clúster, como el nombre del recurso de clúster y la pertenencia al clúster de administrador.
FULL Incluye la configuración completa del recurso de clúster de hardware desnudo. Este es el valor predeterminado del método ListBareMetalClustersRequest.