Method: operations.list

Lists service operations that match the specified filter in the request.

HTTP request

GET https://servicemanagement.googleapis.com/v1/operations

The URL uses gRPC Transcoding syntax.

Query parameters

Parameters
name

string

Not used.

filter

string

A string for filtering Operations. The following filter fields are supported:

  • serviceName: Required. Only = operator is allowed.
  • startTime: The time this job was started, in ISO 8601 format. Allowed operators are >=, >, <=, and <.
  • status: Can be done, in_progress, or failed. Allowed operators are =, and !=.

Filter expression supports conjunction (AND) and disjunction (OR) logical operators. However, the serviceName restriction must be at the top-level and can only be combined with other restrictions via the AND logical operator.

Examples:

  • serviceName={some-service}.googleapis.com
  • serviceName={some-service}.googleapis.com AND startTime>="2017-02-01"
  • serviceName={some-service}.googleapis.com AND status=done
  • serviceName={some-service}.googleapis.com AND (status=done OR startTime>="2017-02-01")
pageSize

integer

The maximum number of operations to return. If unspecified, defaults to 50. The maximum value is 100.

pageToken

string

The standard list page token.

Request body

The request body must be empty.

Response body

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

The response message for Operations.ListOperations.

JSON representation
{
  "operations": [
    {
      object (Operation)
    }
  ],
  "nextPageToken": string
}
Fields
operations[]

object (Operation)

A list of operations that matches the specified filter in the request.

nextPageToken

string

The standard List next-page token.

Authorization Scopes

Requires one of the following OAuth scopes:

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

For more information, see the Authentication Overview.