Method: projects.locations.instances.list

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

Requête HTTP

GET https://memorystore.googleapis.com/v1beta/{parent=projects/*/locations/*}/instances

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Parent à partir duquel répertorier les instances. Format : projects/{project}/locations/{location}

Paramètres de requête

Paramètres
pageSize

integer

Facultatif. Taille de la page demandée. Le serveur peut renvoyer moins d'éléments que 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. Expression permettant de filtrer les résultats.
orderBy

string

Facultatif. Triez les résultats dans un ordre défini. Valeurs acceptées: "name", "createTime".

Corps de la requête

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

Corps de la réponse

Message de réponse pour [instances.list][]. Liste des instances à l'emplacement spécifié.

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

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

object (Instance)

Si la valeur {location} demandée était "-", la réponse contient une liste d'instances de tous les emplacements. Les instances situées dans des zones inaccessibles seront omises.
nextPageToken

string

Jeton pouvant être envoyé en tant que pageToken pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.
unreachable[]

string

Emplacements inaccessibles.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Autorisations IAM

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

  • memorystore.instances.list

Pour en savoir plus, consultez la documentation IAM.