Method: projects.locations.hardware.list

Liste le matériel d'un projet et d'un emplacement donnés.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Projet et emplacement dans lesquels lister le matériel. Format : projects/{project}/locations/{location}

Pour lister le matériel dans tous les lieux, remplacez l'emplacement par - (le caractère tiret) et vérifiez le champ "unreachable" (inaccessible) dans le message de réponse.

Paramètres de requête

Paramètres
pageSize

integer

Facultatif. Taille de la page demandée. Le serveur peut renvoyer un nombre d'éléments inférieur à celui demandé. Si aucune valeur n'est spécifiée, le serveur sélectionne une valeur par défaut appropriée.
pageToken

string

Facultatif. Jeton identifiant une page de résultats que le serveur doit renvoyer.
filter

string

Facultatif. Condition de filtrage. Voir AIP-160.
orderBy

string

Facultatif. Indication sur la façon d'organiser les résultats.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Liste du matériel.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "hardware": [
    {
      object (Hardware)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Champs
hardware[]

object (Hardware)

Liste du matériel.
nextPageToken

string

Jeton identifiant une page de résultats que le serveur doit renvoyer.
unreachable[]

string

Emplacements inaccessibles. Utilisé uniquement pour les requêtes adressées à l'emplacement générique -. Si cette valeur n'est pas vide, cela signifie que les résultats sont incomplets.

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour plus d'informations, consultez la Authentication Overview.

Autorisations IAM

Nécessite l'autorisation IAM suivante sur la ressource parent :

  • gdchardwaremanagement.hardware.list

Pour en savoir plus, consultez la documentation IAM.