Stay organized with collections
Save and categorize content based on your preferences.
Lists all instances in the given project.
For more information about retries and long-running operations, see
Understand connectors.
Arguments
Parameters
parent
string
Required. The name of the project for which a list of instances is requested. Values are of the form projects/.
filter
string
An expression for filtering the results of the request. Filter rules are case insensitive. The fields eligible for filtering are: * name * display_name * labels.key where key is the name of a label Some examples of using filters are: * name:* --> The instance has a name. * name:Howl --> The instance's name contains the string "howl". * name:HOWL --> Equivalent to above. * NAME:howl --> Equivalent to above. * labels.env:* --> The instance has the label "env". * labels.env:dev --> The instance has the label "env" and the value of the label contains the string "dev". * name:howl labels.env:dev --> The instance's name contains "howl" and it has the label "env" with its value containing "dev".
Deadline used while retrieving metadata for instances. Instances whose metadata cannot be retrieved within this deadline will be added to unreachable in ListInstancesResponse.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Method: googleapis.spanner.v1.projects.instances.list\n\nLists all instances in the given project.\n\nFor more information about retries and long-running operations, see\n[Understand connectors]().\n\nArguments\n---------\n\nRaised exceptions\n-----------------\n\nResponse\n--------\n\nIf successful, the response contains an instance of [`ListInstancesResponse`](https://cloud.google.com/workflows/docs/reference/googleapis/spanner/v1/Overview#ListInstancesResponse).\n\nSubworkflow snippet\n-------------------\n\nSome fields might be optional or required.\nTo identify required fields, refer to the [API documentation](https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instances/list). \n\n### YAML\n\n```yaml\n- list:\n call: googleapis.spanner.v1.projects.instances.list\n args:\n parent: ...\n filter: ...\n instanceDeadline: ...\n pageSize: ...\n pageToken: ...\n result: listResult\n```\n\n### JSON\n\n```json\n[\n {\n \"list\": {\n \"call\": \"googleapis.spanner.v1.projects.instances.list\",\n \"args\": {\n \"parent\": \"...\",\n \"filter\": \"...\",\n \"instanceDeadline\": \"...\",\n \"pageSize\": \"...\",\n \"pageToken\": \"...\"\n },\n \"result\": \"listResult\"\n }\n }\n]\n```"]]