Console
    Contact Us Start free

    Method: namespaces.services.list

    Lists services for the given project and region. Results are sorted by creation time, descending.

    HTTP request

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

    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
    limit

    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.
    continue

    string

    Encoded string to continue paging.

    Request body

    The request body must be empty.

    Response body

    A list of Service resources.

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

    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 .
    Design a Mobile Site
    View Site in Mobile | Classic
    Share by: