Method: projects.locations.hardware.list

Lista o hardware em um projeto e local especificados.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O projeto e o local em que o hardware será listado. Formato: projects/{project}/locations/{location}

Para listar o hardware em todos os locais, substitua - (o caractere de hífen ou traço) pelo local e marque o campo inacessível na mensagem de resposta.

Parâmetros de consulta

Parâmetros
pageSize

integer

Opcional. Tamanho da página solicitada. O servidor pode retornar menos resultados do que o solicitado. Se não for especificado, o servidor escolherá um padrão apropriado.
pageToken

string

Opcional. Um token que identifica a página de resultados que o servidor vai retornar.
filter

string

Opcional. Condição de filtragem. Consulte AIP-160 (em inglês).
orderBy

string

Opcional. Dica de como organizar os resultados.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Uma lista de hardware.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "hardware": [
    {
      object (Hardware)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Campos
hardware[]

object (Hardware)

A lista de hardware.
nextPageToken

string

Um token que identifica a página de resultados que o servidor vai retornar.
unreachable[]

string

Locais que não puderam ser alcançados. Usado apenas para consultas no local curinga -. Se não estiver vazio, indica que os resultados estão incompletos.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • gdchardwaremanagement.hardware.list

Para mais informações, consulte a documentação do IAM.