- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- IAM Permissions
Lists instances.
HTTP request
GET https://financialservices.googleapis.com/v1/{parent=projects/*/locations/*}/instances
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
parent |
Required. The parent of the Instance is the location for that Instance. Every location has exactly one instance. Authorization requires the following IAM permission on the specified resource
|
Query parameters
Parameters | |
---|---|
pageSize |
The number of resources to be included in the response. The response contains a nextPageToken, which can be used to retrieve the next page of resources. |
pageToken |
In case of paginated results, this is the token that was returned in the previous ListInstancesResponse. It should be copied here to retrieve the next page of resources. This will be empty for the first instance of ListInstancesRequest. |
filter |
Specify a filter to narrow search results. |
orderBy |
Specify a field to use for ordering. |
Request body
The request body must be empty.
Response body
Response for retrieving a list of Instances
If successful, the response body contains data with the following structure:
JSON representation |
---|
{
"instances": [
{
object ( |
Fields | |
---|---|
instances[] |
List of Instance resources |
nextPageToken |
This token should be passed to the next ListInstancesRequest to retrieve the next page of Instances. |
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.
IAM Permissions
Requires the following IAM permission on the parent
resource:
financialservices.v1instances.list
For more information, see the IAM documentation.