Method: projects.locations.bareMetalClusters.list

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

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

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

Parámetros de consulta

Parámetros
pageSize

integer

Indica el tamaño de la página solicitada. Es posible que el servidor devuelva menos elementos de los solicitados. Si no se especifica, se devolverán, como máximo, 50 clústeres. El valor máximo es 1,000; valores superiores a 1,000 se convertirán en 1,000.
pageToken

string

Es un token que identifica una página de resultados que debe devolver el servidor.
filter

string

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

enum (ClusterView)

Es la vista de los clústeres de Bare Metal. Cuando se especifica BASIC, solo se devuelven el nombre del recurso del clúster y la membresía del clúster de administrador. El valor predeterminado o no establecido CLUSTER_VIEW_UNSPECIFIED es el mismo que "FULL", que devuelve los detalles completos de la configuración del clúster.
allowMissing

boolean

Opcional. Si es verdadero, 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

Es el mensaje de respuesta para la enumeración de clústeres de Bare Metal.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

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

object (BareMetalCluster)

Es la lista de clústeres de Bare Metal.
nextPageToken

string

Es un token que identifica una página de resultados que debe devolver el servidor. Si el token no está vacío, significa que hay más resultados disponibles y que se deben recuperar repitiendo la solicitud con el token de página proporcionado.
unreachable[]

string

Ubicaciones en las que no se pudo acceder.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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

ClusterView

Es una vista para los recursos del clúster.

Enums
CLUSTER_VIEW_UNSPECIFIED Si no se establece el 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 membresía del clúster de administrador.
FULL Incluye la configuración completa del recurso del clúster de Bare Metal. Este es el valor predeterminado para el método ListBareMetalClustersRequest.