Method: projects.locations.hardware.list

Listet Hardware in einem angegebenen Projekt und an einem angegebenen Standort auf.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Das Projekt und der Standort, an dem die Hardware aufgelistet werden soll. Format: projects/{project}/locations/{location}

Wenn Sie Hardware an allen Standorten auflisten möchten, ersetzen Sie den Standort durch - (das Bindestrichzeichen) und prüfen Sie das Feld „unreachable“ in der Antwortnachricht.

Suchparameter

Parameter
pageSize

integer

Optional. Angeforderte Seitengröße. Der Server gibt möglicherweise weniger Elemente als angefordert zurück. Wenn kein Wert angegeben wurde, wählt der Server einen geeigneten Standardwert aus.
pageToken

string

Optional. Ein Token, das eine Ergebnisseite identifiziert, die der Server liefern soll
filter

string

Optional. Filterbedingung. Siehe AIP-160.
orderBy

string

Optional. Hinweis zur Sortierung der Ergebnisse.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Eine Liste der Hardware.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "hardware": [
    {
      object (Hardware)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Felder
hardware[]

object (Hardware)

Die Liste der Hardware.
nextPageToken

string

Ein Token, das eine Ergebnisseite identifiziert, die der Server liefern soll.
unreachable[]

string

Standorte, die nicht erreicht werden konnten. Wird nur für Anfragen an den Platzhalterort - verwendet. Wenn der Wert nicht leer ist, bedeutet das, dass die Ergebnisse unvollständig sind.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.

IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource parent:

  • gdchardwaremanagement.hardware.list

Weitere Informationen finden Sie in der IAM-Dokumentation.