List Instances. Results are sorted by creation time, descending.
HTTP request
GET https://run.googleapis.com/apis/run.googleapis.com/v1/{parent}/instances
Path parameters
parent
string
Required. The parent from where the resources should be listed. In Cloud Run, it may be one of the following:
-
{project_id_or_number} -
namespaces/{project_id_or_number} -
namespaces/{project_id_or_number}/instances -
projects/{project_id_or_number}/locations/{region} -
projects/{project_id_or_number}/regions/{region}
Parent resource namespace. It takes the form namespaces/{namespace}
.
Authorization requires the following IAM
permission on the specified resource parent
:
-
run.instances.list
Query parameters
| Parameters | |
|---|---|
limit
|
Optional. The maximum number of records that should be returned. |
includeUninitialized
|
Optional. Not supported by Cloud Run. |
fieldSelector
|
Optional. Not supported by Cloud Run. |
labelSelector
|
Optional. Allows to filter resources based on a label. Supported operations are =, !=, exists, in, and notIn. |
resourceVersion
|
Optional. Not supported by Cloud Run. |
watch
|
Optional. Not supported by Cloud Run. |
continue
|
Optional. Optional encoded string to continue paging. |
Request body
The request body must be empty.
Response body
ListInstancesResponse is a list of Instances resources.
If successful, the response body contains data with the following structure:
| JSON representation |
|---|
{ "items" : [ { object ( |
| Fields | |
|---|---|
items[]
|
List of Instances. |
apiVersion
|
The API version for this call such as "run.googleapis.com/v1". |
kind
|
The kind of this resource, in this case "InstancesList". |
metadata
|
Metadata associated with this Instances list. |
unreachable[]
|
Locations that could not be reached. |
Authorization scopes
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview .

