• Cloud Container Engine

cce
  1. Help Center
  2. Cloud Container Engine
  3. API Reference 2.0
  4. Kubernetes API
  5. Deployment
  6. Listing oDeployments Under a Specified Namespace

Listing oDeployments Under a Specified Namespace

Function

This API is used to list all Deployment resource objects under a specified Namespace.

URI

GET /apis/apps/v1/namespaces/{namespace}/deployments

GET /apis/extensions/v1beta1/namespaces/{namespace}/deployments

Table 1 describes the parameters of this API.

Table 1 Parameter description

Parameters

Mandatory

Description

namespace

Yes

object name and auth scope, such as for teams and projects

fieldSelector

No

A selector to restrict the list of returned objects by their fields. Defaults to everything.

includeUninitialized

No

If true, partially initialized resources are included in the response.

labelSelector

No

A selector to restrict the list of returned objects by their labels. Defaults to everything.

pretty

No

If 'true', then the output is pretty printed.

resourceVersion

No

When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it's 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.

timeoutSeconds

No

Timeout for the list/watch call.

watch

No

Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.

Request

N/A

Response

Response parameters:

For the description about response parameters, see Table 2

Example response:

{
    "kind": "DeploymentList",
    "apiVersion": "apps/v1beta1",
    "metadata": {
        "selfLink": "/apis/apps/v1beta1/namespaces/ns-12130306-s/deployments",
        "resourceVersion": "418745"
    },
    "items": []
}

Status Code

Table 2 describes the status code of this API.

Table 2 Status code

Status Code

Description

200

This operation succeeds, and a Deployment resource object is returned.

For the description about status codes, see Status Codes.