Method: namespaces.routes.list

List routes. Results are sorted by creation time, descending.

HTTP request

GET https://run.googleapis.com/apis/serving.knative.dev/v1/{parent}/routes

Path parameters

Parameters
parent

string

The namespace from which the routes should be listed. For Cloud Run (fully managed), replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID It takes the form namespaces/{namespace}.

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

  • run.routes.list

Query parameters

Parameters
limit

integer

Optional. The maximum number of records that should be returned.

includeUninitialized

boolean

Not currently used by Cloud Run.

fieldSelector

string

Allows to filter resources based on a specific value for a field name. Send this in a query string format. i.e. 'metadata.name%3Dlorem'. Not currently used by Cloud Run.

labelSelector

string

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

resourceVersion

string

The baseline resource version from which the list or watch operation should start. Not currently used by Cloud Run.

watch

boolean

Flag that indicates that the client expects to watch this resource as well. Not currently used by Cloud Run.

continue

string

Optional. Encoded string to continue paging.

Request body

The request body must be empty.

Response body

ListRoutesResponse is a list of Route resources.

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

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

string

The API version for this call such as "serving.knative.dev/v1".

kind

string

The kind of this resource, in this case always "RouteList".

metadata

object (ListMeta)

Metadata associated with this Route list.

items[]

object (Route)

List of Routes.

unreachable[]

string

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.