Method: namespaces.services.list

Stay organized with collections Save and categorize content based on your preferences.

Lists services for the given project and region.

HTTP request

GET https://{endpoint}/apis/serving.knative.dev/v1/{parent}/services

Where {endpoint} is one of the supported service endpoints.

Path parameters

Parameters
parent

string

Required. The parent from where the resources should be listed. In Cloud Run, it may be one of the following:

  • {project_id_or_number}
  • namespaces/{project_id_or_number}
  • namespaces/{project_id_or_number}/services
  • projects/{project_id_or_number}/locations/{region}
  • projects/{project_id_or_number}/regions/{region} It takes the form namespaces/{namespace}.

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

  • run.services.list

Query parameters

Parameters
pageSize

integer

The maximum number of records that should be returned.

includeUninitialized

boolean

Not supported, and ignored by Cloud Run.

fieldSelector

string

Not supported, and ignored by Cloud Run.

labelSelector

string

Allows to filter resources based on a label. Supported operations are =, !=, exists, in, and notIn.

resourceVersion

string

Not supported, and ignored by Cloud Run.

watch

boolean

Not supported, and ignored by Cloud Run.

pageToken

string

Encoded string to continue paging.

Request body

The request body must be empty.

Response body

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

A list of Service resources.

JSON representation
{
  "apiVersion": string,
  "kind": string,
  "metadata": {
    object (ListMeta)
  },
  "items": [
    {
      object (Service)
    }
  ],
  "unreachable": [
    string
  ]
}
Fields
apiVersion

string

The API version for this call; returns "serving.knative.dev/v1".

kind

string

The kind of this resource; returns "ServiceList".

metadata

object (ListMeta)

Metadata associated with this Service list.

items[]

object (Service)

List of Services.

unreachable[]

string

For calls against the global endpoint, returns the list of Cloud locations that could not be reached. For regional calls, this field is not used.

Authorization Scopes

Requires the following OAuth scope:

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

For more information, see the Authentication Overview.