Method: projects.locations.instances.list

Répertorie les instances dans un emplacement donné.

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/{projectId}/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. Quelle que soit la valeur pageSize, la réponse peut inclure une liste partielle et l'appelant ne doit s'appuyer que sur le nextPageToken de la réponse pour déterminer s'il reste d'autres instances à interroger.
pageToken

string

La valeur nextPageToken renvoyée par une requête List précédente, 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

Réponse pour instances.list

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

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 niveau d'accès OAuth suivant :

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

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