Method: projects.locations.hardware.list

Enumera el hardware en una ubicación y un proyecto determinados.

Solicitud HTTP

GET https://gdchardwaremanagement.googleapis.com/v1alpha/{parent=projects/*/locations/*}/hardware

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

Parámetros de ruta

Parámetros
parent

string

Obligatorio. Es el proyecto y la ubicación en los que se enumerará el hardware. Formato: projects/{project}/locations/{location}

Para enumerar el hardware en todas las ubicaciones, sustituye - (el carácter de guion o guion corto) por la ubicación y verifica el campo inalcanzable en el mensaje de respuesta.

Parámetros de consulta

Parámetros
pageSize

integer

Opcional. Indica el tamaño de la página solicitada. Es posible que el servidor devuelva menos elementos de los que se solicitaron. Si no se especifica, el servidor elegirá un valor predeterminado adecuado.
pageToken

string

Opcional. Un token que identifica una página de resultados que el servidor debe devolver.
filter

string

Es opcional. Es la condición de filtrado. Consulta AIP-160.
orderBy

string

Es opcional. Es una sugerencia sobre cómo ordenar los resultados.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es una lista de hardware.

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

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

object (Hardware)

Es la lista de hardware.
nextPageToken

string

Un token que identifica una página de resultados que el servidor debe devolver.
unreachable[]

string

Ubicaciones a las que no se pudo llegar. Solo se usa para las consultas a la ubicación comodín -. Si no está vacío, indica que los resultados están incompletos.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

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

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso parent:

  • gdchardwaremanagement.hardware.list

Para obtener más información, consulta la documentación de IAM.