Méthode : projects.locations.instances.list

Répertorie les instances d'un projet et d'un emplacement donnés.

Requête HTTP

GET https://memcache.googleapis.com/v1beta2/{parent=projects/*/locations/*}/instances

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Nom de ressource de l'emplacement de l'instance au format projects/{project_id}/locations/{locationId}, où locationId fait référence à une région GCP.

Paramètres de requête

Paramètres
pageSize

integer

Le nombre maximum d'éléments à afficher.

Si aucune valeur n'est spécifiée, une valeur par défaut de 1 000 est utilisée par le service. Indépendamment de la valeur pageSize, la réponse peut inclure une liste partielle et un appelant ne doit s'appuyer que sur la valeur [nextPageToken][CloudMemcache.ListInstancesResponse.next_page_token] pour déterminer s'il reste d'autres instances à interroger.

pageToken

string

La valeur nextPageToken affichée par une requête "List" antérieure, le cas échéant.

filter

string

Filtre de liste. Par exemple, excluez toutes les instances Memcached dont le nom est "my-instance" en spécifiant "name!= my-instance".

orderBy

string

Tri des résultats. Les valeurs acceptées sont "name", "name desc" ou "" (non triées).

Corps de la requête

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

Corps de la réponse

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

Réponse pour instances.list

Représentation JSON

{
  "resources": [
    {
      object (Instance)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Champs
resources[]

object (Instance)

Liste des instances Memcached dans le projet à l'emplacement spécifié ou à tous les emplacements.

Si la valeur locationId dans le champ parent de la requête est "-", toutes les régions disponibles pour le projet sont interrogées et les résultats agrégés.

nextPageToken

string

Jeton permettant de récupérer la page suivante des résultats ou non renseigné si la liste ne contient plus de résultats.

unreachable[]

string

Emplacements inaccessibles.

Champs d'application des autorisations

Requiert le champ d'application OAuth suivant :

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

Pour en savoir plus, consultez Présentation de l'authentification.