Query Parameters
The maximum number of instances to return. The service may return fewer than this value. If unspecified, at most 10 instances will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
A page token, received from a previous ListInstances
call.
Provide this to retrieve the subsequent page.
When paginating, all other parameters provided to ListInstances
must match
the call that provided the page token.
Show deleted instances if specified.
Filter the instance. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec
Supported filters:
- name: the instance name, support "==" and ".matches()" operator.
- resource_id: the instance id, support "==" and ".matches()" operator.
- environment: the environment full name in "environments/{id}" format, support "==" operator.
- state: the instance state, check State enum for values, support "==" operator.
- engine: the instance engine, check Engine enum for values. Support "==", "in [xx]", "!(in [xx])" operator.
- host: the instance host, support "==" and ".matches()" operator.
- port: the instance port, support "==" and ".matches()" operator.
- project: the project full name in "projects/{id}" format, support "==" operator.
For example: name == "sample instance" name.matches("sample") resource_id = "sample-instance" resource_id.matches("sample") state == "DELETED" environment == "environments/test" environment == "" (find instances which environment is not set) engine == "MYSQL" engine in ["MYSQL", "POSTGRES"] !(engine in ["MYSQL", "POSTGRES"]) host == "127.0.0.1" host.matches("127.0") port == "54321" port.matches("543") project == "projects/sample-project" You can combine filter conditions like: name.matches("sample") && environment == "environments/test" host == "127.0.0.1" && port == "54321"