Method: projects.locations.instances.list

Lists instances in a given project and location.

HTTP request

GET https://notebooks.googleapis.com/v1beta1/{parent}/instances

Path parameters

Parameters
parent

string

Required. Format: parent=projects/{projectId}/locations/{location}

Authorization requires the following IAM permission on the specified resource parent:

  • notebooks.instances.list

Query parameters

Parameters
pageSize

integer

Maximum return size of the list call.

pageToken

string

A previous returned page token that can be used to continue listing from the last result.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

Response for listing notebook instances.

JSON representation
{
  "instances": [
    {
      object (Instance)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Fields
instances[]

object (Instance)

A list of returned instances.

nextPageToken

string

Page token that can be used to continue listing from the last result in the next list call.

unreachable[]

string

Locations that could not be reached. For example, ['us-west1-a', 'us-central1-b']. A ListInstancesResponse will only contain either instances or unreachables,

Authorization Scopes

Requires the following OAuth scope:

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

For more information, see the Authentication Overview.