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

Les URL utilisent la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Parent à partir duquel lister 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 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. Expression permettant de filtrer les résultats.
orderBy

string

Facultatif. Triez les résultats selon 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.

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 {location} demandée était "-", la réponse contient une liste d'instances de tous les lieux. Les instances situées dans des zones inaccessibles seront ignorées.
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.

Niveaux d'accès des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/memorystore.read-write
  • https://www.googleapis.com/auth/memorystore.read-only

Autorisations IAM

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

  • memorystore.instances.list

Pour en savoir plus, consultez la documentation IAM.