Method: projects.groups.members.list

Lists the monitored resources that are members of a group.

HTTP request

GET https://monitoring.googleapis.com/v3/{name}/members

Path parameters

Parameters
name

string

Required. The group whose members are listed. The format is:

projects/[PROJECT_ID_OR_NUMBER]/groups/[GROUP_ID]

Query parameters

Parameters
pageSize

integer

A positive number that is the maximum number of results to return.

pageToken

string

If this field is not empty then it must contain thenextPageToken value returned by a previous call to this method. Using this field causes the method to return additional results from the previous method call.

filter

string

An optionallist filter describing the members to be returned. The filter may reference the type, labels, and metadata of monitored resources that comprise the group. For example, to return only resources representing Compute Engine VM instances, use this filter:

`resource.type = "gce_instance"`
interval

object (TimeInterval)

An optional time interval for which results should be returned. Only members that were part of the group during the specified interval are included in the response. If no interval is provided then the group membership over the last minute is returned.

Request body

The request body must be empty.

Response body

Themembers.list response.

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

JSON representation
{"members":[{object (MonitoredResource)}],"nextPageToken":string,"totalSize":integer}
Fields
members[]

object (MonitoredResource)

A set of monitored resources in the group.

nextPageToken

string

If there are more results than have been returned, then this field is set to a non-empty value. To see the additional results, use that value aspageToken in the next call to this method.

totalSize

integer

The total number of elements matching this request.

Authorization scopes

Requires one of the following OAuth scopes:

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

For more information, see theAuthentication Overview.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-07-23 UTC.