Method: projects.locations.previews.resourceChanges.list

Lists ResourceChanges for a given preview.

HTTP request

GET https://config.googleapis.com/v1/{parent=projects/*/locations/*/previews/*}/resourceChanges

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The parent in whose context the ResourceChanges are listed. The parent value is in the format: 'projects/{projectId}/locations/{location}/previews/{preview}'. It takes the form projects/{project}/locations/{location}/previews/{preview}.

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

  • config.resourcechanges.list

Query parameters

Parameters
pageSize

integer

Optional. When requesting a page of resource changes, 'pageSize' specifies number of resource changes to return. If unspecified, at most 500 will be returned. The maximum value is 1000.
pageToken

string

Optional. Token returned by previous call to 'resourceChanges.list' which specifies the position in the list from where to continue listing the resource changes.
filter

string

Optional. Lists the resource changes that match the filter expression. A filter expression filters the resource changes listed in the response. The expression must be of the form '{field} {operator} {value}' where operators: '<', '>', '<=', '>=', '!=', '=', ':' are supported (colon ':' represents a HAS operator which is roughly synonymous with equality). {field} can refer to a proto or JSON field, or a synthetic field. Field names can be camelCase or snake_case.

Examples: - Filter by name: name = "projects/foo/locations/us-central1/previews/dep/resourceChanges/baz
orderBy

string

Optional. Field to use to sort the list.

Request body

The request body must be empty.

Response body

A response to a 'resourceChanges.list' call. Contains a list of ResourceChanges.

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

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

object (ResourceChange)

List of ResourceChanges.
nextPageToken

string

A token to request the next page of resources from the 'resourceChanges.list' method. The value of an empty string means that there are no more resources to return.
unreachable[]

string

Unreachable resources, if any.

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:

  • config.googleapis.com/config.resourcechanges.list

For more information, see the IAM documentation.