-
Language:
English
-
Language:
English
Chapter 3. Kubernetes v1 REST API
3.1. Overview
The Kubernetes API allows you to run containerized applications, bind persistent storage, link those applications through service discovery, and manage the cluster infrastructure.
3.1.1. Version information
Version: v1
3.1.2. URI scheme
Host: 127.0.0.1:8443
BasePath: /
Schemes: HTTPS
3.2. Paths
3.2.1. create a Binding
POST /api/v1/bindings
3.2.1.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true |
3.2.1.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.1.3. Consumes
- /
3.2.1.4. Produces
- application/json
3.2.1.5. Tags
- apiv1
3.2.2. list objects of kind ComponentStatus
GET /api/v1/componentstatuses
3.2.2.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string |
3.2.2.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.2.3. Consumes
- /
3.2.2.4. Produces
- application/json
3.2.2.5. Tags
- apiv1
3.2.3. list or watch objects of kind Endpoints
GET /api/v1/endpoints
3.2.3.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string |
3.2.3.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.3.3. Consumes
- /
3.2.3.4. Produces
- application/json
3.2.3.5. Tags
- apiv1
3.2.4. create a Endpoints
POST /api/v1/endpoints
3.2.4.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true |
3.2.4.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.4.3. Consumes
- /
3.2.4.4. Produces
- application/json
3.2.4.5. Tags
- apiv1
3.2.5. list or watch objects of kind Event
GET /api/v1/events
3.2.5.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string |
3.2.5.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.5.3. Consumes
- /
3.2.5.4. Produces
- application/json
3.2.5.5. Tags
- apiv1
3.2.6. create a Event
POST /api/v1/events
3.2.6.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true |
3.2.6.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.6.3. Consumes
- /
3.2.6.4. Produces
- application/json
3.2.6.5. Tags
- apiv1
3.2.7. list or watch objects of kind LimitRange
GET /api/v1/limitranges
3.2.7.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string |
3.2.7.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.7.3. Consumes
- /
3.2.7.4. Produces
- application/json
3.2.7.5. Tags
- apiv1
3.2.8. create a LimitRange
POST /api/v1/limitranges
3.2.8.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true |
3.2.8.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.8.3. Consumes
- /
3.2.8.4. Produces
- application/json
3.2.8.5. Tags
- apiv1
3.2.9. list or watch objects of kind Namespace
GET /api/v1/namespaces
3.2.9.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string |
3.2.9.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.9.3. Consumes
- /
3.2.9.4. Produces
- application/json
3.2.9.5. Tags
- apiv1
3.2.10. create a Namespace
POST /api/v1/namespaces
3.2.10.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true |
3.2.10.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.10.3. Consumes
- /
3.2.10.4. Produces
- application/json
3.2.10.5. Tags
- apiv1
3.2.11. create a Binding
POST /api/v1/namespaces/{namespace}/bindings3.2.11.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.11.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.11.3. Consumes
- /
3.2.11.4. Produces
- application/json
3.2.11.5. Tags
- apiv1
3.2.12. list objects of kind ComponentStatus
GET /api/v1/namespaces/{namespace}/componentstatuses3.2.12.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.12.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.12.3. Consumes
- /
3.2.12.4. Produces
- application/json
3.2.12.5. Tags
- apiv1
3.2.13. read the specified ComponentStatus
GET /api/v1/namespaces/{namespace}/componentstatuses/{name}3.2.13.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the ComponentStatus | true | string |
3.2.13.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.13.3. Consumes
- /
3.2.13.4. Produces
- application/json
3.2.13.5. Tags
- apiv1
3.2.14. list or watch objects of kind Endpoints
GET /api/v1/namespaces/{namespace}/endpoints3.2.14.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.14.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.14.3. Consumes
- /
3.2.14.4. Produces
- application/json
3.2.14.5. Tags
- apiv1
3.2.15. create a Endpoints
POST /api/v1/namespaces/{namespace}/endpoints3.2.15.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.15.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.15.3. Consumes
- /
3.2.15.4. Produces
- application/json
3.2.15.5. Tags
- apiv1
3.2.16. read the specified Endpoints
GET /api/v1/namespaces/{namespace}/endpoints/{name}3.2.16.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Endpoints | true | string |
3.2.16.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.16.3. Consumes
- /
3.2.16.4. Produces
- application/json
3.2.16.5. Tags
- apiv1
3.2.17. replace the specified Endpoints
PUT /api/v1/namespaces/{namespace}/endpoints/{name}3.2.17.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Endpoints | true | string |
3.2.17.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.17.3. Consumes
- /
3.2.17.4. Produces
- application/json
3.2.17.5. Tags
- apiv1
3.2.18. delete a Endpoints
DELETE /api/v1/namespaces/{namespace}/endpoints/{name}3.2.18.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Endpoints | true | string |
3.2.18.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.18.3. Consumes
- /
3.2.18.4. Produces
- application/json
3.2.18.5. Tags
- apiv1
3.2.19. partially update the specified Endpoints
PATCH /api/v1/namespaces/{namespace}/endpoints/{name}3.2.19.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Endpoints | true | string |
3.2.19.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.19.3. Consumes
- application/json-patch+json
- application/merge-patch+json
- application/strategic-merge-patch+json
3.2.19.4. Produces
- application/json
3.2.19.5. Tags
- apiv1
3.2.20. list or watch objects of kind Event
GET /api/v1/namespaces/{namespace}/events3.2.20.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.20.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.20.3. Consumes
- /
3.2.20.4. Produces
- application/json
3.2.20.5. Tags
- apiv1
3.2.21. create a Event
POST /api/v1/namespaces/{namespace}/events3.2.21.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.21.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.21.3. Consumes
- /
3.2.21.4. Produces
- application/json
3.2.21.5. Tags
- apiv1
3.2.22. read the specified Event
GET /api/v1/namespaces/{namespace}/events/{name}3.2.22.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Event | true | string |
3.2.22.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.22.3. Consumes
- /
3.2.22.4. Produces
- application/json
3.2.22.5. Tags
- apiv1
3.2.23. replace the specified Event
PUT /api/v1/namespaces/{namespace}/events/{name}3.2.23.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Event | true | string |
3.2.23.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.23.3. Consumes
- /
3.2.23.4. Produces
- application/json
3.2.23.5. Tags
- apiv1
3.2.24. delete a Event
DELETE /api/v1/namespaces/{namespace}/events/{name}3.2.24.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Event | true | string |
3.2.24.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.24.3. Consumes
- /
3.2.24.4. Produces
- application/json
3.2.24.5. Tags
- apiv1
3.2.25. partially update the specified Event
PATCH /api/v1/namespaces/{namespace}/events/{name}3.2.25.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Event | true | string |
3.2.25.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.25.3. Consumes
- application/json-patch+json
- application/merge-patch+json
- application/strategic-merge-patch+json
3.2.25.4. Produces
- application/json
3.2.25.5. Tags
- apiv1
3.2.26. list or watch objects of kind LimitRange
GET /api/v1/namespaces/{namespace}/limitranges3.2.26.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.26.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.26.3. Consumes
- /
3.2.26.4. Produces
- application/json
3.2.26.5. Tags
- apiv1
3.2.27. create a LimitRange
POST /api/v1/namespaces/{namespace}/limitranges3.2.27.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.27.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.27.3. Consumes
- /
3.2.27.4. Produces
- application/json
3.2.27.5. Tags
- apiv1
3.2.28. read the specified LimitRange
GET /api/v1/namespaces/{namespace}/limitranges/{name}3.2.28.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the LimitRange | true | string |
3.2.28.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.28.3. Consumes
- /
3.2.28.4. Produces
- application/json
3.2.28.5. Tags
- apiv1
3.2.29. replace the specified LimitRange
PUT /api/v1/namespaces/{namespace}/limitranges/{name}3.2.29.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the LimitRange | true | string |
3.2.29.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.29.3. Consumes
- /
3.2.29.4. Produces
- application/json
3.2.29.5. Tags
- apiv1
3.2.30. delete a LimitRange
DELETE /api/v1/namespaces/{namespace}/limitranges/{name}3.2.30.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the LimitRange | true | string |
3.2.30.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.30.3. Consumes
- /
3.2.30.4. Produces
- application/json
3.2.30.5. Tags
- apiv1
3.2.31. partially update the specified LimitRange
PATCH /api/v1/namespaces/{namespace}/limitranges/{name}3.2.31.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the LimitRange | true | string |
3.2.31.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.31.3. Consumes
- application/json-patch+json
- application/merge-patch+json
- application/strategic-merge-patch+json
3.2.31.4. Produces
- application/json
3.2.31.5. Tags
- apiv1
3.2.32. list or watch objects of kind PersistentVolumeClaim
GET /api/v1/namespaces/{namespace}/persistentvolumeclaims3.2.32.1. Description
Persistent Volume Claims (PVC) represent a request to use a persistent volume (PV) with a pod. When creating a pod definition (or replication controller or deployment config) a developer may specify the amount of storage they need via a persistent volume reference. If an administrator has enabled and configured persistent volumes for use, they will be allocated on demand to pods that have similar requirements. Since volumes are created lazily, some pods may be scheduled to a node before their volume is assigned. The node will detect this situation and wait to start the pod until the volume is bound. Events will be generated (visible by using the describe command on the pod) that indicate the pod is waiting for volumes.
3.2.32.2. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.32.3. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.32.4. Consumes
- /
3.2.32.5. Produces
- application/json
3.2.32.6. Tags
- apiv1
3.2.33. create a PersistentVolumeClaim
POST /api/v1/namespaces/{namespace}/persistentvolumeclaims3.2.33.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.33.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.33.3. Consumes
- /
3.2.33.4. Produces
- application/json
3.2.33.5. Tags
- apiv1
3.2.34. read the specified PersistentVolumeClaim
GET /api/v1/namespaces/{namespace}/persistentvolumeclaims/{name}3.2.34.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the PersistentVolumeClaim | true | string |
3.2.34.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.34.3. Consumes
- /
3.2.34.4. Produces
- application/json
3.2.34.5. Tags
- apiv1
3.2.35. replace the specified PersistentVolumeClaim
PUT /api/v1/namespaces/{namespace}/persistentvolumeclaims/{name}3.2.35.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the PersistentVolumeClaim | true | string |
3.2.35.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.35.3. Consumes
- /
3.2.35.4. Produces
- application/json
3.2.35.5. Tags
- apiv1
3.2.36. delete a PersistentVolumeClaim
DELETE /api/v1/namespaces/{namespace}/persistentvolumeclaims/{name}3.2.36.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the PersistentVolumeClaim | true | string |
3.2.36.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.36.3. Consumes
- /
3.2.36.4. Produces
- application/json
3.2.36.5. Tags
- apiv1
3.2.37. partially update the specified PersistentVolumeClaim
PATCH /api/v1/namespaces/{namespace}/persistentvolumeclaims/{name}3.2.37.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the PersistentVolumeClaim | true | string |
3.2.37.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.37.3. Consumes
- application/json-patch+json
- application/merge-patch+json
- application/strategic-merge-patch+json
3.2.37.4. Produces
- application/json
3.2.37.5. Tags
- apiv1
3.2.38. replace status of the specified PersistentVolumeClaim
PUT /api/v1/namespaces/{namespace}/persistentvolumeclaims/{name}/status3.2.38.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the PersistentVolumeClaim | true | string |
3.2.38.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.38.3. Consumes
- /
3.2.38.4. Produces
- application/json
3.2.38.5. Tags
- apiv1
3.2.39. list or watch objects of kind Pod
GET /api/v1/namespaces/{namespace}/pods3.2.39.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.39.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.39.3. Consumes
- /
3.2.39.4. Produces
- application/json
3.2.39.5. Tags
- apiv1
3.2.40. create a Pod
POST /api/v1/namespaces/{namespace}/pods3.2.40.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.40.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.40.3. Consumes
- /
3.2.40.4. Produces
- application/json
3.2.40.5. Tags
- apiv1
3.2.41. read the specified Pod
GET /api/v1/namespaces/{namespace}/pods/{name}3.2.41.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Pod | true | string |
3.2.41.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.41.3. Consumes
- /
3.2.41.4. Produces
- application/json
3.2.41.5. Tags
- apiv1
3.2.42. replace the specified Pod
PUT /api/v1/namespaces/{namespace}/pods/{name}3.2.42.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Pod | true | string |
3.2.42.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.42.3. Consumes
- /
3.2.42.4. Produces
- application/json
3.2.42.5. Tags
- apiv1
3.2.43. delete a Pod
DELETE /api/v1/namespaces/{namespace}/pods/{name}3.2.43.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Pod | true | string |
3.2.43.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.43.3. Consumes
- /
3.2.43.4. Produces
- application/json
3.2.43.5. Tags
- apiv1
3.2.44. partially update the specified Pod
PATCH /api/v1/namespaces/{namespace}/pods/{name}3.2.44.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Pod | true | string |
3.2.44.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.44.3. Consumes
- application/json-patch+json
- application/merge-patch+json
- application/strategic-merge-patch+json
3.2.44.4. Produces
- application/json
3.2.44.5. Tags
- apiv1
3.2.45. connect GET requests to attach of Pod
GET /api/v1/namespaces/{namespace}/pods/{name}/attach3.2.45.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | stdin | redirect the standard input stream of the pod for this call; defaults to false | false | boolean | |
| QueryParameter | stdout | redirect the standard output stream of the pod for this call; defaults to true | false | boolean | |
| QueryParameter | stderr | redirect the standard error stream of the pod for this call; defaults to true | false | boolean | |
| QueryParameter | tty | allocate a terminal for this attach call; defaults to false | false | boolean | |
| QueryParameter | container | the container in which to execute the command. Defaults to only container if there is only one container in the pod. | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Pod | true | string |
3.2.45.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.45.3. Consumes
- /
3.2.45.4. Produces
- /
3.2.45.5. Tags
- apiv1
3.2.46. connect POST requests to attach of Pod
POST /api/v1/namespaces/{namespace}/pods/{name}/attach3.2.46.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | stdin | redirect the standard input stream of the pod for this call; defaults to false | false | boolean | |
| QueryParameter | stdout | redirect the standard output stream of the pod for this call; defaults to true | false | boolean | |
| QueryParameter | stderr | redirect the standard error stream of the pod for this call; defaults to true | false | boolean | |
| QueryParameter | tty | allocate a terminal for this attach call; defaults to false | false | boolean | |
| QueryParameter | container | the container in which to execute the command. Defaults to only container if there is only one container in the pod. | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Pod | true | string |
3.2.46.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.46.3. Consumes
- /
3.2.46.4. Produces
- /
3.2.46.5. Tags
- apiv1
3.2.47. create binding of a Binding
POST /api/v1/namespaces/{namespace}/pods/{name}/binding3.2.47.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Binding | true | string |
3.2.47.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.47.3. Consumes
- /
3.2.47.4. Produces
- application/json
3.2.47.5. Tags
- apiv1
3.2.48. connect GET requests to exec of Pod
GET /api/v1/namespaces/{namespace}/pods/{name}/exec3.2.48.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | stdin | redirect the standard input stream of the pod for this call; defaults to false | false | boolean | |
| QueryParameter | stdout | redirect the standard output stream of the pod for this call; defaults to true | false | boolean | |
| QueryParameter | stderr | redirect the standard error stream of the pod for this call; defaults to true | false | boolean | |
| QueryParameter | tty | allocate a terminal for this exec call; defaults to false | false | boolean | |
| QueryParameter | container | the container in which to execute the command. Defaults to only container if there is only one container in the pod. | false | string | |
| QueryParameter | command | the command to execute; argv array; not executed within a shell | false | ref | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Pod | true | string |
3.2.48.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.48.3. Consumes
- /
3.2.48.4. Produces
- /
3.2.48.5. Tags
- apiv1
3.2.49. connect POST requests to exec of Pod
POST /api/v1/namespaces/{namespace}/pods/{name}/exec3.2.49.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | stdin | redirect the standard input stream of the pod for this call; defaults to false | false | boolean | |
| QueryParameter | stdout | redirect the standard output stream of the pod for this call; defaults to true | false | boolean | |
| QueryParameter | stderr | redirect the standard error stream of the pod for this call; defaults to true | false | boolean | |
| QueryParameter | tty | allocate a terminal for this exec call; defaults to false | false | boolean | |
| QueryParameter | container | the container in which to execute the command. Defaults to only container if there is only one container in the pod. | false | string | |
| QueryParameter | command | the command to execute; argv array; not executed within a shell | false | ref | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Pod | true | string |
3.2.49.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.49.3. Consumes
- /
3.2.49.4. Produces
- /
3.2.49.5. Tags
- apiv1
3.2.50. read log of the specified Pod
GET /api/v1/namespaces/{namespace}/pods/{name}/log3.2.50.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | container | the container for which to stream logs; defaults to only container if there is one container in the pod | false | string | |
| QueryParameter | follow | follow the log stream of the pod; defaults to false | false | boolean | |
| QueryParameter | previous | return previous terminated container logs; defaults to false | false | boolean | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Pod | true | string |
3.2.50.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.50.3. Consumes
- /
3.2.50.4. Produces
- application/json
3.2.50.5. Tags
- apiv1
3.2.51. connect GET requests to portforward of Pod
GET /api/v1/namespaces/{namespace}/pods/{name}/portforward3.2.51.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Pod | true | string |
3.2.51.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.51.3. Consumes
- /
3.2.51.4. Produces
- /
3.2.51.5. Tags
- apiv1
3.2.52. connect POST requests to portforward of Pod
POST /api/v1/namespaces/{namespace}/pods/{name}/portforward3.2.52.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Pod | true | string |
3.2.52.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.52.3. Consumes
- /
3.2.52.4. Produces
- /
3.2.52.5. Tags
- apiv1
3.2.53. connect GET requests to proxy of Pod
GET /api/v1/namespaces/{namespace}/pods/{name}/proxy3.2.53.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | path | URL path to use in proxy request to pod | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Pod | true | string |
3.2.53.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.53.3. Consumes
- /
3.2.53.4. Produces
- /
3.2.53.5. Tags
- apiv1
3.2.54. connect PUT requests to proxy of Pod
PUT /api/v1/namespaces/{namespace}/pods/{name}/proxy3.2.54.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | path | URL path to use in proxy request to pod | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Pod | true | string |
3.2.54.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.54.3. Consumes
- /
3.2.54.4. Produces
- /
3.2.54.5. Tags
- apiv1
3.2.55. connect DELETE requests to proxy of Pod
DELETE /api/v1/namespaces/{namespace}/pods/{name}/proxy3.2.55.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | path | URL path to use in proxy request to pod | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Pod | true | string |
3.2.55.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.55.3. Consumes
- /
3.2.55.4. Produces
- /
3.2.55.5. Tags
- apiv1
3.2.56. connect POST requests to proxy of Pod
POST /api/v1/namespaces/{namespace}/pods/{name}/proxy3.2.56.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | path | URL path to use in proxy request to pod | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Pod | true | string |
3.2.56.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.56.3. Consumes
- /
3.2.56.4. Produces
- /
3.2.56.5. Tags
- apiv1
3.2.57. connect GET requests to proxy of Pod
GET /api/v1/namespaces/{namespace}/pods/{name}/proxy/{path:*}3.2.57.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | path | URL path to use in proxy request to pod | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Pod | true | string | |
| PathParameter | path:* | path to the resource | true | string |
3.2.57.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.57.3. Consumes
- /
3.2.57.4. Produces
- /
3.2.57.5. Tags
- apiv1
3.2.58. connect PUT requests to proxy of Pod
PUT /api/v1/namespaces/{namespace}/pods/{name}/proxy/{path:*}3.2.58.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | path | URL path to use in proxy request to pod | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Pod | true | string | |
| PathParameter | path:* | path to the resource | true | string |
3.2.58.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.58.3. Consumes
- /
3.2.58.4. Produces
- /
3.2.58.5. Tags
- apiv1
3.2.59. connect DELETE requests to proxy of Pod
DELETE /api/v1/namespaces/{namespace}/pods/{name}/proxy/{path:*}3.2.59.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | path | URL path to use in proxy request to pod | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Pod | true | string | |
| PathParameter | path:* | path to the resource | true | string |
3.2.59.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.59.3. Consumes
- /
3.2.59.4. Produces
- /
3.2.59.5. Tags
- apiv1
3.2.60. connect POST requests to proxy of Pod
POST /api/v1/namespaces/{namespace}/pods/{name}/proxy/{path:*}3.2.60.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | path | URL path to use in proxy request to pod | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Pod | true | string | |
| PathParameter | path:* | path to the resource | true | string |
3.2.60.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.60.3. Consumes
- /
3.2.60.4. Produces
- /
3.2.60.5. Tags
- apiv1
3.2.61. replace status of the specified Pod
PUT /api/v1/namespaces/{namespace}/pods/{name}/status3.2.61.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Pod | true | string |
3.2.61.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.61.3. Consumes
- /
3.2.61.4. Produces
- application/json
3.2.61.5. Tags
- apiv1
3.2.62. list or watch objects of kind PodTemplate
GET /api/v1/namespaces/{namespace}/podtemplates3.2.62.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.62.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.62.3. Consumes
- /
3.2.62.4. Produces
- application/json
3.2.62.5. Tags
- apiv1
3.2.63. create a PodTemplate
POST /api/v1/namespaces/{namespace}/podtemplates3.2.63.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.63.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.63.3. Consumes
- /
3.2.63.4. Produces
- application/json
3.2.63.5. Tags
- apiv1
3.2.64. read the specified PodTemplate
GET /api/v1/namespaces/{namespace}/podtemplates/{name}3.2.64.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the PodTemplate | true | string |
3.2.64.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.64.3. Consumes
- /
3.2.64.4. Produces
- application/json
3.2.64.5. Tags
- apiv1
3.2.65. replace the specified PodTemplate
PUT /api/v1/namespaces/{namespace}/podtemplates/{name}3.2.65.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the PodTemplate | true | string |
3.2.65.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.65.3. Consumes
- /
3.2.65.4. Produces
- application/json
3.2.65.5. Tags
- apiv1
3.2.66. delete a PodTemplate
DELETE /api/v1/namespaces/{namespace}/podtemplates/{name}3.2.66.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the PodTemplate | true | string |
3.2.66.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.66.3. Consumes
- /
3.2.66.4. Produces
- application/json
3.2.66.5. Tags
- apiv1
3.2.67. partially update the specified PodTemplate
PATCH /api/v1/namespaces/{namespace}/podtemplates/{name}3.2.67.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the PodTemplate | true | string |
3.2.67.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.67.3. Consumes
- application/json-patch+json
- application/merge-patch+json
- application/strategic-merge-patch+json
3.2.67.4. Produces
- application/json
3.2.67.5. Tags
- apiv1
3.2.68. list or watch objects of kind ReplicationController
GET /api/v1/namespaces/{namespace}/replicationcontrollers3.2.68.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.68.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.68.3. Consumes
- /
3.2.68.4. Produces
- application/json
3.2.68.5. Tags
- apiv1
3.2.69. create a ReplicationController
POST /api/v1/namespaces/{namespace}/replicationcontrollers3.2.69.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.69.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.69.3. Consumes
- /
3.2.69.4. Produces
- application/json
3.2.69.5. Tags
- apiv1
3.2.70. read the specified ReplicationController
GET /api/v1/namespaces/{namespace}/replicationcontrollers/{name}3.2.70.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the ReplicationController | true | string |
3.2.70.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.70.3. Consumes
- /
3.2.70.4. Produces
- application/json
3.2.70.5. Tags
- apiv1
3.2.71. replace the specified ReplicationController
PUT /api/v1/namespaces/{namespace}/replicationcontrollers/{name}3.2.71.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the ReplicationController | true | string |
3.2.71.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.71.3. Consumes
- /
3.2.71.4. Produces
- application/json
3.2.71.5. Tags
- apiv1
3.2.72. delete a ReplicationController
DELETE /api/v1/namespaces/{namespace}/replicationcontrollers/{name}3.2.72.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the ReplicationController | true | string |
3.2.72.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.72.3. Consumes
- /
3.2.72.4. Produces
- application/json
3.2.72.5. Tags
- apiv1
3.2.73. partially update the specified ReplicationController
PATCH /api/v1/namespaces/{namespace}/replicationcontrollers/{name}3.2.73.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the ReplicationController | true | string |
3.2.73.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.73.3. Consumes
- application/json-patch+json
- application/merge-patch+json
- application/strategic-merge-patch+json
3.2.73.4. Produces
- application/json
3.2.73.5. Tags
- apiv1
3.2.74. list or watch objects of kind ResourceQuota
GET /api/v1/namespaces/{namespace}/resourcequotas3.2.74.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.74.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.74.3. Consumes
- /
3.2.74.4. Produces
- application/json
3.2.74.5. Tags
- apiv1
3.2.75. create a ResourceQuota
POST /api/v1/namespaces/{namespace}/resourcequotas3.2.75.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.75.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.75.3. Consumes
- /
3.2.75.4. Produces
- application/json
3.2.75.5. Tags
- apiv1
3.2.76. read the specified ResourceQuota
GET /api/v1/namespaces/{namespace}/resourcequotas/{name}3.2.76.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the ResourceQuota | true | string |
3.2.76.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.76.3. Consumes
- /
3.2.76.4. Produces
- application/json
3.2.76.5. Tags
- apiv1
3.2.77. replace the specified ResourceQuota
PUT /api/v1/namespaces/{namespace}/resourcequotas/{name}3.2.77.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the ResourceQuota | true | string |
3.2.77.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.77.3. Consumes
- /
3.2.77.4. Produces
- application/json
3.2.77.5. Tags
- apiv1
3.2.78. delete a ResourceQuota
DELETE /api/v1/namespaces/{namespace}/resourcequotas/{name}3.2.78.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the ResourceQuota | true | string |
3.2.78.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.78.3. Consumes
- /
3.2.78.4. Produces
- application/json
3.2.78.5. Tags
- apiv1
3.2.79. partially update the specified ResourceQuota
PATCH /api/v1/namespaces/{namespace}/resourcequotas/{name}3.2.79.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the ResourceQuota | true | string |
3.2.79.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.79.3. Consumes
- application/json-patch+json
- application/merge-patch+json
- application/strategic-merge-patch+json
3.2.79.4. Produces
- application/json
3.2.79.5. Tags
- apiv1
3.2.80. replace status of the specified ResourceQuota
PUT /api/v1/namespaces/{namespace}/resourcequotas/{name}/status3.2.80.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the ResourceQuota | true | string |
3.2.80.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.80.3. Consumes
- /
3.2.80.4. Produces
- application/json
3.2.80.5. Tags
- apiv1
3.2.81. list or watch objects of kind Secret
GET /api/v1/namespaces/{namespace}/secrets3.2.81.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.81.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.81.3. Consumes
- /
3.2.81.4. Produces
- application/json
3.2.81.5. Tags
- apiv1
3.2.82. create a Secret
POST /api/v1/namespaces/{namespace}/secrets3.2.82.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.82.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.82.3. Consumes
- /
3.2.82.4. Produces
- application/json
3.2.82.5. Tags
- apiv1
3.2.83. read the specified Secret
GET /api/v1/namespaces/{namespace}/secrets/{name}3.2.83.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Secret | true | string |
3.2.83.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.83.3. Consumes
- /
3.2.83.4. Produces
- application/json
3.2.83.5. Tags
- apiv1
3.2.84. replace the specified Secret
PUT /api/v1/namespaces/{namespace}/secrets/{name}3.2.84.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Secret | true | string |
3.2.84.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.84.3. Consumes
- /
3.2.84.4. Produces
- application/json
3.2.84.5. Tags
- apiv1
3.2.85. delete a Secret
DELETE /api/v1/namespaces/{namespace}/secrets/{name}3.2.85.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Secret | true | string |
3.2.85.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.85.3. Consumes
- /
3.2.85.4. Produces
- application/json
3.2.85.5. Tags
- apiv1
3.2.86. partially update the specified Secret
PATCH /api/v1/namespaces/{namespace}/secrets/{name}3.2.86.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Secret | true | string |
3.2.86.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.86.3. Consumes
- application/json-patch+json
- application/merge-patch+json
- application/strategic-merge-patch+json
3.2.86.4. Produces
- application/json
3.2.86.5. Tags
- apiv1
3.2.87. list or watch objects of kind ServiceAccount
GET /api/v1/namespaces/{namespace}/serviceaccounts3.2.87.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.87.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.87.3. Consumes
- /
3.2.87.4. Produces
- application/json
3.2.87.5. Tags
- apiv1
3.2.88. create a ServiceAccount
POST /api/v1/namespaces/{namespace}/serviceaccounts3.2.88.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.88.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.88.3. Consumes
- /
3.2.88.4. Produces
- application/json
3.2.88.5. Tags
- apiv1
3.2.89. read the specified ServiceAccount
GET /api/v1/namespaces/{namespace}/serviceaccounts/{name}3.2.89.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the ServiceAccount | true | string |
3.2.89.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.89.3. Consumes
- /
3.2.89.4. Produces
- application/json
3.2.89.5. Tags
- apiv1
3.2.90. replace the specified ServiceAccount
PUT /api/v1/namespaces/{namespace}/serviceaccounts/{name}3.2.90.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the ServiceAccount | true | string |
3.2.90.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.90.3. Consumes
- /
3.2.90.4. Produces
- application/json
3.2.90.5. Tags
- apiv1
3.2.91. delete a ServiceAccount
DELETE /api/v1/namespaces/{namespace}/serviceaccounts/{name}3.2.91.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the ServiceAccount | true | string |
3.2.91.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.91.3. Consumes
- /
3.2.91.4. Produces
- application/json
3.2.91.5. Tags
- apiv1
3.2.92. partially update the specified ServiceAccount
PATCH /api/v1/namespaces/{namespace}/serviceaccounts/{name}3.2.92.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the ServiceAccount | true | string |
3.2.92.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.92.3. Consumes
- application/json-patch+json
- application/merge-patch+json
- application/strategic-merge-patch+json
3.2.92.4. Produces
- application/json
3.2.92.5. Tags
- apiv1
3.2.93. list or watch objects of kind Service
GET /api/v1/namespaces/{namespace}/services3.2.93.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.93.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.93.3. Consumes
- /
3.2.93.4. Produces
- application/json
3.2.93.5. Tags
- apiv1
3.2.94. create a Service
POST /api/v1/namespaces/{namespace}/services3.2.94.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.94.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.94.3. Consumes
- /
3.2.94.4. Produces
- application/json
3.2.94.5. Tags
- apiv1
3.2.95. read the specified Service
GET /api/v1/namespaces/{namespace}/services/{name}3.2.95.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Service | true | string |
3.2.95.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.95.3. Consumes
- /
3.2.95.4. Produces
- application/json
3.2.95.5. Tags
- apiv1
3.2.96. replace the specified Service
PUT /api/v1/namespaces/{namespace}/services/{name}3.2.96.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Service | true | string |
3.2.96.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.96.3. Consumes
- /
3.2.96.4. Produces
- application/json
3.2.96.5. Tags
- apiv1
3.2.97. delete a Service
DELETE /api/v1/namespaces/{namespace}/services/{name}3.2.97.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Service | true | string |
3.2.97.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.97.3. Consumes
- /
3.2.97.4. Produces
- application/json
3.2.97.5. Tags
- apiv1
3.2.98. partially update the specified Service
PATCH /api/v1/namespaces/{namespace}/services/{name}3.2.98.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Service | true | string |
3.2.98.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.98.3. Consumes
- application/json-patch+json
- application/merge-patch+json
- application/strategic-merge-patch+json
3.2.98.4. Produces
- application/json
3.2.98.5. Tags
- apiv1
3.2.99. read the specified Namespace
GET /api/v1/namespaces/{name}3.2.99.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| PathParameter | name | name of the Namespace | true | string |
3.2.99.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.99.3. Consumes
- /
3.2.99.4. Produces
- application/json
3.2.99.5. Tags
- apiv1
3.2.100. replace the specified Namespace
PUT /api/v1/namespaces/{name}3.2.100.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | name | name of the Namespace | true | string |
3.2.100.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.100.3. Consumes
- /
3.2.100.4. Produces
- application/json
3.2.100.5. Tags
- apiv1
3.2.101. delete a Namespace
DELETE /api/v1/namespaces/{name}3.2.101.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | name | name of the Namespace | true | string |
3.2.101.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.101.3. Consumes
- /
3.2.101.4. Produces
- application/json
3.2.101.5. Tags
- apiv1
3.2.102. partially update the specified Namespace
PATCH /api/v1/namespaces/{name}3.2.102.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | name | name of the Namespace | true | string |
3.2.102.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.102.3. Consumes
- application/json-patch+json
- application/merge-patch+json
- application/strategic-merge-patch+json
3.2.102.4. Produces
- application/json
3.2.102.5. Tags
- apiv1
3.2.103. replace finalize of the specified Namespace
PUT /api/v1/namespaces/{name}/finalize3.2.103.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | name | name of the Namespace | true | string |
3.2.103.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.103.3. Consumes
- /
3.2.103.4. Produces
- application/json
3.2.103.5. Tags
- apiv1
3.2.104. replace status of the specified Namespace
PUT /api/v1/namespaces/{name}/status3.2.104.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | name | name of the Namespace | true | string |
3.2.104.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.104.3. Consumes
- /
3.2.104.4. Produces
- application/json
3.2.104.5. Tags
- apiv1
3.2.105. list or watch objects of kind Node
GET /api/v1/nodes
3.2.105.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string |
3.2.105.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.105.3. Consumes
- /
3.2.105.4. Produces
- application/json
3.2.105.5. Tags
- apiv1
3.2.106. create a Node
POST /api/v1/nodes
3.2.106.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true |
3.2.106.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.106.3. Consumes
- /
3.2.106.4. Produces
- application/json
3.2.106.5. Tags
- apiv1
3.2.107. read the specified Node
GET /api/v1/nodes/{name}3.2.107.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| PathParameter | name | name of the Node | true | string |
3.2.107.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.107.3. Consumes
- /
3.2.107.4. Produces
- application/json
3.2.107.5. Tags
- apiv1
3.2.108. replace the specified Node
PUT /api/v1/nodes/{name}3.2.108.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | name | name of the Node | true | string |
3.2.108.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.108.3. Consumes
- /
3.2.108.4. Produces
- application/json
3.2.108.5. Tags
- apiv1
3.2.109. delete a Node
DELETE /api/v1/nodes/{name}3.2.109.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | name | name of the Node | true | string |
3.2.109.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.109.3. Consumes
- /
3.2.109.4. Produces
- application/json
3.2.109.5. Tags
- apiv1
3.2.110. partially update the specified Node
PATCH /api/v1/nodes/{name}3.2.110.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | name | name of the Node | true | string |
3.2.110.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.110.3. Consumes
- application/json-patch+json
- application/merge-patch+json
- application/strategic-merge-patch+json
3.2.110.4. Produces
- application/json
3.2.110.5. Tags
- apiv1
3.2.111. replace status of the specified Node
PUT /api/v1/nodes/{name}/status3.2.111.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | name | name of the Node | true | string |
3.2.111.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.111.3. Consumes
- /
3.2.111.4. Produces
- application/json
3.2.111.5. Tags
- apiv1
3.2.112. list or watch objects of kind PersistentVolumeClaim
GET /api/v1/persistentvolumeclaims
3.2.112.1. Description
Persistent Volume Claims (PVC) represent a request to use a persistent volume (PV) with a pod. When creating a pod definition (or replication controller or deployment config) a developer may specify the amount of storage they need via a persistent volume reference. If an administrator has enabled and configured persistent volumes for use, they will be allocated on demand to pods that have similar requirements. Since volumes are created lazily, some pods may be scheduled to a node before their volume is assigned. The node will detect this situation and wait to start the pod until the volume is bound. Events will be generated (visible by using the describe command on the pod) that indicate the pod is waiting for volumes.
3.2.112.2. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string |
3.2.112.3. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.112.4. Consumes
- /
3.2.112.5. Produces
- application/json
3.2.112.6. Tags
- apiv1
3.2.113. create a PersistentVolumeClaim
POST /api/v1/persistentvolumeclaims
3.2.113.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true |
3.2.113.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.113.3. Consumes
- /
3.2.113.4. Produces
- application/json
3.2.113.5. Tags
- apiv1
3.2.114. list or watch objects of kind PersistentVolume
GET /api/v1/persistentvolumes
3.2.114.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string |
3.2.114.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.114.3. Consumes
- /
3.2.114.4. Produces
- application/json
3.2.114.5. Tags
- apiv1
3.2.115. create a PersistentVolume
POST /api/v1/persistentvolumes
3.2.115.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true |
3.2.115.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.115.3. Consumes
- /
3.2.115.4. Produces
- application/json
3.2.115.5. Tags
- apiv1
3.2.116. read the specified PersistentVolume
GET /api/v1/persistentvolumes/{name}3.2.116.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| PathParameter | name | name of the PersistentVolume | true | string |
3.2.116.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.116.3. Consumes
- /
3.2.116.4. Produces
- application/json
3.2.116.5. Tags
- apiv1
3.2.117. replace the specified PersistentVolume
PUT /api/v1/persistentvolumes/{name}3.2.117.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | name | name of the PersistentVolume | true | string |
3.2.117.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.117.3. Consumes
- /
3.2.117.4. Produces
- application/json
3.2.117.5. Tags
- apiv1
3.2.118. delete a PersistentVolume
DELETE /api/v1/persistentvolumes/{name}3.2.118.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | name | name of the PersistentVolume | true | string |
3.2.118.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.118.3. Consumes
- /
3.2.118.4. Produces
- application/json
3.2.118.5. Tags
- apiv1
3.2.119. partially update the specified PersistentVolume
PATCH /api/v1/persistentvolumes/{name}3.2.119.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | name | name of the PersistentVolume | true | string |
3.2.119.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.119.3. Consumes
- application/json-patch+json
- application/merge-patch+json
- application/strategic-merge-patch+json
3.2.119.4. Produces
- application/json
3.2.119.5. Tags
- apiv1
3.2.120. replace status of the specified PersistentVolume
PUT /api/v1/persistentvolumes/{name}/status3.2.120.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | name | name of the PersistentVolume | true | string |
3.2.120.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.120.3. Consumes
- /
3.2.120.4. Produces
- application/json
3.2.120.5. Tags
- apiv1
3.2.121. list or watch objects of kind Pod
GET /api/v1/pods
3.2.121.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string |
3.2.121.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.121.3. Consumes
- /
3.2.121.4. Produces
- application/json
3.2.121.5. Tags
- apiv1
3.2.122. create a Pod
POST /api/v1/pods
3.2.122.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true |
3.2.122.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.122.3. Consumes
- /
3.2.122.4. Produces
- application/json
3.2.122.5. Tags
- apiv1
3.2.123. list or watch objects of kind PodTemplate
GET /api/v1/podtemplates
3.2.123.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string |
3.2.123.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.123.3. Consumes
- /
3.2.123.4. Produces
- application/json
3.2.123.5. Tags
- apiv1
3.2.124. create a PodTemplate
POST /api/v1/podtemplates
3.2.124.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true |
3.2.124.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.124.3. Consumes
- /
3.2.124.4. Produces
- application/json
3.2.124.5. Tags
- apiv1
3.2.125. proxy GET requests to Pod
GET /api/v1/proxy/namespaces/{namespace}/pods/{name}3.2.125.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Pod | true | string |
3.2.125.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.125.3. Consumes
- /
3.2.125.4. Produces
- /
3.2.125.5. Tags
- apiv1
3.2.126. proxy PUT requests to Pod
PUT /api/v1/proxy/namespaces/{namespace}/pods/{name}3.2.126.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Pod | true | string |
3.2.126.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.126.3. Consumes
- /
3.2.126.4. Produces
- /
3.2.126.5. Tags
- apiv1
3.2.127. proxy DELETE requests to Pod
DELETE /api/v1/proxy/namespaces/{namespace}/pods/{name}3.2.127.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Pod | true | string |
3.2.127.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.127.3. Consumes
- /
3.2.127.4. Produces
- /
3.2.127.5. Tags
- apiv1
3.2.128. proxy POST requests to Pod
POST /api/v1/proxy/namespaces/{namespace}/pods/{name}3.2.128.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Pod | true | string |
3.2.128.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.128.3. Consumes
- /
3.2.128.4. Produces
- /
3.2.128.5. Tags
- apiv1
3.2.129. proxy GET requests to Pod
GET /api/v1/proxy/namespaces/{namespace}/pods/{name}/{path:*}3.2.129.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Pod | true | string | |
| PathParameter | path:* | path to the resource | true | string |
3.2.129.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.129.3. Consumes
- /
3.2.129.4. Produces
- /
3.2.129.5. Tags
- apiv1
3.2.130. proxy PUT requests to Pod
PUT /api/v1/proxy/namespaces/{namespace}/pods/{name}/{path:*}3.2.130.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Pod | true | string | |
| PathParameter | path:* | path to the resource | true | string |
3.2.130.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.130.3. Consumes
- /
3.2.130.4. Produces
- /
3.2.130.5. Tags
- apiv1
3.2.131. proxy DELETE requests to Pod
DELETE /api/v1/proxy/namespaces/{namespace}/pods/{name}/{path:*}3.2.131.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Pod | true | string | |
| PathParameter | path:* | path to the resource | true | string |
3.2.131.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.131.3. Consumes
- /
3.2.131.4. Produces
- /
3.2.131.5. Tags
- apiv1
3.2.132. proxy POST requests to Pod
POST /api/v1/proxy/namespaces/{namespace}/pods/{name}/{path:*}3.2.132.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Pod | true | string | |
| PathParameter | path:* | path to the resource | true | string |
3.2.132.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.132.3. Consumes
- /
3.2.132.4. Produces
- /
3.2.132.5. Tags
- apiv1
3.2.133. proxy GET requests to Service
GET /api/v1/proxy/namespaces/{namespace}/services/{name}3.2.133.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Service | true | string |
3.2.133.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.133.3. Consumes
- /
3.2.133.4. Produces
- /
3.2.133.5. Tags
- apiv1
3.2.134. proxy PUT requests to Service
PUT /api/v1/proxy/namespaces/{namespace}/services/{name}3.2.134.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Service | true | string |
3.2.134.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.134.3. Consumes
- /
3.2.134.4. Produces
- /
3.2.134.5. Tags
- apiv1
3.2.135. proxy DELETE requests to Service
DELETE /api/v1/proxy/namespaces/{namespace}/services/{name}3.2.135.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Service | true | string |
3.2.135.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.135.3. Consumes
- /
3.2.135.4. Produces
- /
3.2.135.5. Tags
- apiv1
3.2.136. proxy POST requests to Service
POST /api/v1/proxy/namespaces/{namespace}/services/{name}3.2.136.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Service | true | string |
3.2.136.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.136.3. Consumes
- /
3.2.136.4. Produces
- /
3.2.136.5. Tags
- apiv1
3.2.137. proxy GET requests to Service
GET /api/v1/proxy/namespaces/{namespace}/services/{name}/{path:*}3.2.137.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Service | true | string | |
| PathParameter | path:* | path to the resource | true | string |
3.2.137.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.137.3. Consumes
- /
3.2.137.4. Produces
- /
3.2.137.5. Tags
- apiv1
3.2.138. proxy PUT requests to Service
PUT /api/v1/proxy/namespaces/{namespace}/services/{name}/{path:*}3.2.138.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Service | true | string | |
| PathParameter | path:* | path to the resource | true | string |
3.2.138.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.138.3. Consumes
- /
3.2.138.4. Produces
- /
3.2.138.5. Tags
- apiv1
3.2.139. proxy DELETE requests to Service
DELETE /api/v1/proxy/namespaces/{namespace}/services/{name}/{path:*}3.2.139.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Service | true | string | |
| PathParameter | path:* | path to the resource | true | string |
3.2.139.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.139.3. Consumes
- /
3.2.139.4. Produces
- /
3.2.139.5. Tags
- apiv1
3.2.140. proxy POST requests to Service
POST /api/v1/proxy/namespaces/{namespace}/services/{name}/{path:*}3.2.140.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Service | true | string | |
| PathParameter | path:* | path to the resource | true | string |
3.2.140.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.140.3. Consumes
- /
3.2.140.4. Produces
- /
3.2.140.5. Tags
- apiv1
3.2.141. proxy GET requests to Node
GET /api/v1/proxy/nodes/{name}3.2.141.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| PathParameter | name | name of the Node | true | string |
3.2.141.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.141.3. Consumes
- /
3.2.141.4. Produces
- /
3.2.141.5. Tags
- apiv1
3.2.142. proxy PUT requests to Node
PUT /api/v1/proxy/nodes/{name}3.2.142.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| PathParameter | name | name of the Node | true | string |
3.2.142.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.142.3. Consumes
- /
3.2.142.4. Produces
- /
3.2.142.5. Tags
- apiv1
3.2.143. proxy DELETE requests to Node
DELETE /api/v1/proxy/nodes/{name}3.2.143.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| PathParameter | name | name of the Node | true | string |
3.2.143.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.143.3. Consumes
- /
3.2.143.4. Produces
- /
3.2.143.5. Tags
- apiv1
3.2.144. proxy POST requests to Node
POST /api/v1/proxy/nodes/{name}3.2.144.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| PathParameter | name | name of the Node | true | string |
3.2.144.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.144.3. Consumes
- /
3.2.144.4. Produces
- /
3.2.144.5. Tags
- apiv1
3.2.145. proxy GET requests to Node
GET /api/v1/proxy/nodes/{name}/{path:*}3.2.145.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| PathParameter | name | name of the Node | true | string | |
| PathParameter | path:* | path to the resource | true | string |
3.2.145.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.145.3. Consumes
- /
3.2.145.4. Produces
- /
3.2.145.5. Tags
- apiv1
3.2.146. proxy PUT requests to Node
PUT /api/v1/proxy/nodes/{name}/{path:*}3.2.146.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| PathParameter | name | name of the Node | true | string | |
| PathParameter | path:* | path to the resource | true | string |
3.2.146.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.146.3. Consumes
- /
3.2.146.4. Produces
- /
3.2.146.5. Tags
- apiv1
3.2.147. proxy DELETE requests to Node
DELETE /api/v1/proxy/nodes/{name}/{path:*}3.2.147.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| PathParameter | name | name of the Node | true | string | |
| PathParameter | path:* | path to the resource | true | string |
3.2.147.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.147.3. Consumes
- /
3.2.147.4. Produces
- /
3.2.147.5. Tags
- apiv1
3.2.148. proxy POST requests to Node
POST /api/v1/proxy/nodes/{name}/{path:*}3.2.148.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| PathParameter | name | name of the Node | true | string | |
| PathParameter | path:* | path to the resource | true | string |
3.2.148.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| default | success | string |
3.2.148.3. Consumes
- /
3.2.148.4. Produces
- /
3.2.148.5. Tags
- apiv1
3.2.149. list or watch objects of kind ReplicationController
GET /api/v1/replicationcontrollers
3.2.149.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string |
3.2.149.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.149.3. Consumes
- /
3.2.149.4. Produces
- application/json
3.2.149.5. Tags
- apiv1
3.2.150. create a ReplicationController
POST /api/v1/replicationcontrollers
3.2.150.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true |
3.2.150.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.150.3. Consumes
- /
3.2.150.4. Produces
- application/json
3.2.150.5. Tags
- apiv1
3.2.151. list or watch objects of kind ResourceQuota
GET /api/v1/resourcequotas
3.2.151.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string |
3.2.151.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.151.3. Consumes
- /
3.2.151.4. Produces
- application/json
3.2.151.5. Tags
- apiv1
3.2.152. create a ResourceQuota
POST /api/v1/resourcequotas
3.2.152.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true |
3.2.152.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.152.3. Consumes
- /
3.2.152.4. Produces
- application/json
3.2.152.5. Tags
- apiv1
3.2.153. list or watch objects of kind Secret
GET /api/v1/secrets
3.2.153.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string |
3.2.153.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.153.3. Consumes
- /
3.2.153.4. Produces
- application/json
3.2.153.5. Tags
- apiv1
3.2.154. create a Secret
POST /api/v1/secrets
3.2.154.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true |
3.2.154.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.154.3. Consumes
- /
3.2.154.4. Produces
- application/json
3.2.154.5. Tags
- apiv1
3.2.155. list or watch objects of kind SecurityContextConstraints
GET /api/v1/securitycontextconstraints
3.2.155.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string |
3.2.155.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.155.3. Consumes
- /
3.2.155.4. Produces
- application/json
3.2.155.5. Tags
- apiv1
3.2.156. create a SecurityContextConstraints
POST /api/v1/securitycontextconstraints
3.2.156.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true |
3.2.156.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.156.3. Consumes
- /
3.2.156.4. Produces
- application/json
3.2.156.5. Tags
- apiv1
3.2.157. read the specified SecurityContextConstraints
GET /api/v1/securitycontextconstraints/{name}3.2.157.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| PathParameter | name | name of the SecurityContextConstraints | true | string |
3.2.157.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.157.3. Consumes
- /
3.2.157.4. Produces
- application/json
3.2.157.5. Tags
- apiv1
3.2.158. replace the specified SecurityContextConstraints
PUT /api/v1/securitycontextconstraints/{name}3.2.158.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | name | name of the SecurityContextConstraints | true | string |
3.2.158.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.158.3. Consumes
- /
3.2.158.4. Produces
- application/json
3.2.158.5. Tags
- apiv1
3.2.159. delete a SecurityContextConstraints
DELETE /api/v1/securitycontextconstraints/{name}3.2.159.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | name | name of the SecurityContextConstraints | true | string |
3.2.159.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.159.3. Consumes
- /
3.2.159.4. Produces
- application/json
3.2.159.5. Tags
- apiv1
3.2.160. partially update the specified SecurityContextConstraints
PATCH /api/v1/securitycontextconstraints/{name}3.2.160.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true | |||
| PathParameter | name | name of the SecurityContextConstraints | true | string |
3.2.160.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.160.3. Consumes
- application/json-patch+json
- application/merge-patch+json
- application/strategic-merge-patch+json
3.2.160.4. Produces
- application/json
3.2.160.5. Tags
- apiv1
3.2.161. list or watch objects of kind ServiceAccount
GET /api/v1/serviceaccounts
3.2.161.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string |
3.2.161.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.161.3. Consumes
- /
3.2.161.4. Produces
- application/json
3.2.161.5. Tags
- apiv1
3.2.162. create a ServiceAccount
POST /api/v1/serviceaccounts
3.2.162.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true |
3.2.162.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.162.3. Consumes
- /
3.2.162.4. Produces
- application/json
3.2.162.5. Tags
- apiv1
3.2.163. list or watch objects of kind Service
GET /api/v1/services
3.2.163.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string |
3.2.163.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.163.3. Consumes
- /
3.2.163.4. Produces
- application/json
3.2.163.5. Tags
- apiv1
3.2.164. create a Service
POST /api/v1/services
3.2.164.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| BodyParameter | body | true |
3.2.164.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.164.3. Consumes
- /
3.2.164.4. Produces
- application/json
3.2.164.5. Tags
- apiv1
3.2.165. watch individual changes to a list of Endpoints
GET /api/v1/watch/endpoints
3.2.165.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string |
3.2.165.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.165.3. Consumes
- /
3.2.165.4. Produces
- application/json
3.2.165.5. Tags
- apiv1
3.2.166. watch individual changes to a list of Event
GET /api/v1/watch/events
3.2.166.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string |
3.2.166.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.166.3. Consumes
- /
3.2.166.4. Produces
- application/json
3.2.166.5. Tags
- apiv1
3.2.167. watch individual changes to a list of LimitRange
GET /api/v1/watch/limitranges
3.2.167.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string |
3.2.167.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.167.3. Consumes
- /
3.2.167.4. Produces
- application/json
3.2.167.5. Tags
- apiv1
3.2.168. watch individual changes to a list of Namespace
GET /api/v1/watch/namespaces
3.2.168.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string |
3.2.168.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.168.3. Consumes
- /
3.2.168.4. Produces
- application/json
3.2.168.5. Tags
- apiv1
3.2.169. watch individual changes to a list of Endpoints
GET /api/v1/watch/namespaces/{namespace}/endpoints3.2.169.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.169.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.169.3. Consumes
- /
3.2.169.4. Produces
- application/json
3.2.169.5. Tags
- apiv1
3.2.170. watch changes to an object of kind Endpoints
GET /api/v1/watch/namespaces/{namespace}/endpoints/{name}3.2.170.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Endpoints | true | string |
3.2.170.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.170.3. Consumes
- /
3.2.170.4. Produces
- application/json
3.2.170.5. Tags
- apiv1
3.2.171. watch individual changes to a list of Event
GET /api/v1/watch/namespaces/{namespace}/events3.2.171.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.171.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.171.3. Consumes
- /
3.2.171.4. Produces
- application/json
3.2.171.5. Tags
- apiv1
3.2.172. watch changes to an object of kind Event
GET /api/v1/watch/namespaces/{namespace}/events/{name}3.2.172.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Event | true | string |
3.2.172.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.172.3. Consumes
- /
3.2.172.4. Produces
- application/json
3.2.172.5. Tags
- apiv1
3.2.173. watch individual changes to a list of LimitRange
GET /api/v1/watch/namespaces/{namespace}/limitranges3.2.173.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.173.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.173.3. Consumes
- /
3.2.173.4. Produces
- application/json
3.2.173.5. Tags
- apiv1
3.2.174. watch changes to an object of kind LimitRange
GET /api/v1/watch/namespaces/{namespace}/limitranges/{name}3.2.174.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the LimitRange | true | string |
3.2.174.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.174.3. Consumes
- /
3.2.174.4. Produces
- application/json
3.2.174.5. Tags
- apiv1
3.2.175. watch individual changes to a list of PersistentVolumeClaim
GET /api/v1/watch/namespaces/{namespace}/persistentvolumeclaims3.2.175.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.175.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.175.3. Consumes
- /
3.2.175.4. Produces
- application/json
3.2.175.5. Tags
- apiv1
3.2.176. watch changes to an object of kind PersistentVolumeClaim
GET /api/v1/watch/namespaces/{namespace}/persistentvolumeclaims/{name}3.2.176.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the PersistentVolumeClaim | true | string |
3.2.176.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.176.3. Consumes
- /
3.2.176.4. Produces
- application/json
3.2.176.5. Tags
- apiv1
3.2.177. watch individual changes to a list of Pod
GET /api/v1/watch/namespaces/{namespace}/pods3.2.177.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.177.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.177.3. Consumes
- /
3.2.177.4. Produces
- application/json
3.2.177.5. Tags
- apiv1
3.2.178. watch changes to an object of kind Pod
GET /api/v1/watch/namespaces/{namespace}/pods/{name}3.2.178.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Pod | true | string |
3.2.178.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.178.3. Consumes
- /
3.2.178.4. Produces
- application/json
3.2.178.5. Tags
- apiv1
3.2.179. watch individual changes to a list of PodTemplate
GET /api/v1/watch/namespaces/{namespace}/podtemplates3.2.179.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.179.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.179.3. Consumes
- /
3.2.179.4. Produces
- application/json
3.2.179.5. Tags
- apiv1
3.2.180. watch changes to an object of kind PodTemplate
GET /api/v1/watch/namespaces/{namespace}/podtemplates/{name}3.2.180.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the PodTemplate | true | string |
3.2.180.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.180.3. Consumes
- /
3.2.180.4. Produces
- application/json
3.2.180.5. Tags
- apiv1
3.2.181. watch individual changes to a list of ReplicationController
GET /api/v1/watch/namespaces/{namespace}/replicationcontrollers3.2.181.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.181.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.181.3. Consumes
- /
3.2.181.4. Produces
- application/json
3.2.181.5. Tags
- apiv1
3.2.182. watch changes to an object of kind ReplicationController
GET /api/v1/watch/namespaces/{namespace}/replicationcontrollers/{name}3.2.182.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the ReplicationController | true | string |
3.2.182.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.182.3. Consumes
- /
3.2.182.4. Produces
- application/json
3.2.182.5. Tags
- apiv1
3.2.183. watch individual changes to a list of ResourceQuota
GET /api/v1/watch/namespaces/{namespace}/resourcequotas3.2.183.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.183.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.183.3. Consumes
- /
3.2.183.4. Produces
- application/json
3.2.183.5. Tags
- apiv1
3.2.184. watch changes to an object of kind ResourceQuota
GET /api/v1/watch/namespaces/{namespace}/resourcequotas/{name}3.2.184.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the ResourceQuota | true | string |
3.2.184.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.184.3. Consumes
- /
3.2.184.4. Produces
- application/json
3.2.184.5. Tags
- apiv1
3.2.185. watch individual changes to a list of Secret
GET /api/v1/watch/namespaces/{namespace}/secrets3.2.185.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.185.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.185.3. Consumes
- /
3.2.185.4. Produces
- application/json
3.2.185.5. Tags
- apiv1
3.2.186. watch changes to an object of kind Secret
GET /api/v1/watch/namespaces/{namespace}/secrets/{name}3.2.186.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Secret | true | string |
3.2.186.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.186.3. Consumes
- /
3.2.186.4. Produces
- application/json
3.2.186.5. Tags
- apiv1
3.2.187. watch individual changes to a list of ServiceAccount
GET /api/v1/watch/namespaces/{namespace}/serviceaccounts3.2.187.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.187.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.187.3. Consumes
- /
3.2.187.4. Produces
- application/json
3.2.187.5. Tags
- apiv1
3.2.188. watch changes to an object of kind ServiceAccount
GET /api/v1/watch/namespaces/{namespace}/serviceaccounts/{name}3.2.188.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the ServiceAccount | true | string |
3.2.188.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.188.3. Consumes
- /
3.2.188.4. Produces
- application/json
3.2.188.5. Tags
- apiv1
3.2.189. watch individual changes to a list of Service
GET /api/v1/watch/namespaces/{namespace}/services3.2.189.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string |
3.2.189.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.189.3. Consumes
- /
3.2.189.4. Produces
- application/json
3.2.189.5. Tags
- apiv1
3.2.190. watch changes to an object of kind Service
GET /api/v1/watch/namespaces/{namespace}/services/{name}3.2.190.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | namespace | object name and auth scope, such as for teams and projects | true | string | |
| PathParameter | name | name of the Service | true | string |
3.2.190.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.190.3. Consumes
- /
3.2.190.4. Produces
- application/json
3.2.190.5. Tags
- apiv1
3.2.191. watch changes to an object of kind Namespace
GET /api/v1/watch/namespaces/{name}3.2.191.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | name | name of the Namespace | true | string |
3.2.191.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.191.3. Consumes
- /
3.2.191.4. Produces
- application/json
3.2.191.5. Tags
- apiv1
3.2.192. watch individual changes to a list of Node
GET /api/v1/watch/nodes
3.2.192.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string |
3.2.192.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.192.3. Consumes
- /
3.2.192.4. Produces
- application/json
3.2.192.5. Tags
- apiv1
3.2.193. watch changes to an object of kind Node
GET /api/v1/watch/nodes/{name}3.2.193.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | name | name of the Node | true | string |
3.2.193.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.193.3. Consumes
- /
3.2.193.4. Produces
- application/json
3.2.193.5. Tags
- apiv1
3.2.194. watch individual changes to a list of PersistentVolumeClaim
GET /api/v1/watch/persistentvolumeclaims
3.2.194.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string |
3.2.194.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.194.3. Consumes
- /
3.2.194.4. Produces
- application/json
3.2.194.5. Tags
- apiv1
3.2.195. watch individual changes to a list of PersistentVolume
GET /api/v1/watch/persistentvolumes
3.2.195.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string |
3.2.195.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.195.3. Consumes
- /
3.2.195.4. Produces
- application/json
3.2.195.5. Tags
- apiv1
3.2.196. watch changes to an object of kind PersistentVolume
GET /api/v1/watch/persistentvolumes/{name}3.2.196.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | name | name of the PersistentVolume | true | string |
3.2.196.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.196.3. Consumes
- /
3.2.196.4. Produces
- application/json
3.2.196.5. Tags
- apiv1
3.2.197. watch individual changes to a list of Pod
GET /api/v1/watch/pods
3.2.197.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string |
3.2.197.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.197.3. Consumes
- /
3.2.197.4. Produces
- application/json
3.2.197.5. Tags
- apiv1
3.2.198. watch individual changes to a list of PodTemplate
GET /api/v1/watch/podtemplates
3.2.198.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string |
3.2.198.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.198.3. Consumes
- /
3.2.198.4. Produces
- application/json
3.2.198.5. Tags
- apiv1
3.2.199. watch individual changes to a list of ReplicationController
GET /api/v1/watch/replicationcontrollers
3.2.199.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string |
3.2.199.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.199.3. Consumes
- /
3.2.199.4. Produces
- application/json
3.2.199.5. Tags
- apiv1
3.2.200. watch individual changes to a list of ResourceQuota
GET /api/v1/watch/resourcequotas
3.2.200.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string |
3.2.200.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.200.3. Consumes
- /
3.2.200.4. Produces
- application/json
3.2.200.5. Tags
- apiv1
3.2.201. watch individual changes to a list of Secret
GET /api/v1/watch/secrets
3.2.201.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string |
3.2.201.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.201.3. Consumes
- /
3.2.201.4. Produces
- application/json
3.2.201.5. Tags
- apiv1
3.2.202. watch individual changes to a list of SecurityContextConstraints
GET /api/v1/watch/securitycontextconstraints
3.2.202.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string |
3.2.202.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.202.3. Consumes
- /
3.2.202.4. Produces
- application/json
3.2.202.5. Tags
- apiv1
3.2.203. watch changes to an object of kind SecurityContextConstraints
GET /api/v1/watch/securitycontextconstraints/{name}3.2.203.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string | |
| PathParameter | name | name of the SecurityContextConstraints | true | string |
3.2.203.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.203.3. Consumes
- /
3.2.203.4. Produces
- application/json
3.2.203.5. Tags
- apiv1
3.2.204. watch individual changes to a list of ServiceAccount
GET /api/v1/watch/serviceaccounts
3.2.204.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string |
3.2.204.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.204.3. Consumes
- /
3.2.204.4. Produces
- application/json
3.2.204.5. Tags
- apiv1
3.2.205. watch individual changes to a list of Service
GET /api/v1/watch/services
3.2.205.1. Parameters
| Type | Name | Description | Required | Schema | Default |
|---|---|---|---|---|---|
| QueryParameter | pretty | If 'true', then the output is pretty printed. | false | string | |
| QueryParameter | labelSelector | a selector to restrict the list of returned objects by their labels; defaults to everything | false | string | |
| QueryParameter | fieldSelector | a selector to restrict the list of returned objects by their fields; defaults to everything | false | string | |
| QueryParameter | watch | watch for changes to the described resources and return them as a stream of add, update, and remove notifications; specify resourceVersion | false | boolean | |
| QueryParameter | resourceVersion | 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 | false | string |
3.2.205.2. Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | success |
3.2.205.3. Consumes
- /
3.2.205.4. Produces
- application/json
3.2.205.5. Tags
- apiv1
3.3. Definitions
3.3.1. v1.PersistentVolume
A Persistent Volume (PV) is a storage device that is made available for use by applications by an administrator. When a user requests persistent storage be allocated for a pod, they create a persistent volume claim with the size and type of storage they need. The system will look for persistent volumes that match that claim and, if one is available, it will assign that persistent volume to the claim. Information about the volume (type, location, secrets necessary to use it) will be available to the claim and the claim may then be used from a pod as a volume source.
Deleting a persistent volume removes the cluster’s record of the volume, and may result in automated processes destroying the underlying network store.
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard object metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | false | ||
| spec | specification of a persistent volume as provisioned by an administrator; see http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#persistent-volumes | false | ||
| status | current status of a persistent volume; populated by the system, read-only; see http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#persistent-volumes | false |
3.3.2. v1.MetadataVolumeSource
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| items | list of metadata files | false |
3.3.3. v1.TCPSocketAction
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| port | number or name of the port to access on the container; number must be in the range 1 to 65535; name must be an IANA_SVC_NAME | true | string |
3.3.4. v1.ResourceQuotaStatus
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| hard | hard is the set of enforced hard limits for each named resource; see http://releases.k8s.io/HEAD/docs/design/admission_control_resource_quota.md#admissioncontrol-plugin-resourcequota | false | ||
| used | used is the current observed total usage of the resource in the namespace | false |
3.3.5. v1.ContainerStateTerminated
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| exitCode | exit status from the last termination of the container | true | integer (int32) | |
| signal | signal from the last termination of the container | false | integer (int32) | |
| reason | (brief) reason from the last termination of the container | false | string | |
| message | message regarding the last termination of the container | false | string | |
| startedAt | time at which previous execution of the container started | false | string (date-time) | |
| finishedAt | time at which the container last terminated | false | string (date-time) | |
| containerID | container’s ID in the format 'docker://<container_id>' | false | string |
3.3.6. v1.ReplicationControllerList
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard list metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | false | ||
| items | list of replication controllers; see http://releases.k8s.io/HEAD/docs/user-guide/replication-controller.md | true |
3.3.7. v1.Capability
3.3.8. v1.Pod
A pod corresponds to a group of containers running together on the same machine. All containers in a pod share an IP address, and may have access to shared volumes and local filesystem. Like individual application containers, pods are considered to be relatively ephemeral rather than durable entities. Pods are scheduled to nodes and remain there until termination (according to restart policy) or deletion. When a node dies, the pods scheduled to that node are deleted. Specific pods are never rescheduled to new nodes; instead, they must be replaced by a component like the replication controller.
See the Kubernetes pod documentation for more information.
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard object metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | false | ||
| spec | specification of the desired behavior of the pod; http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status | false | ||
| status | most recently observed status of the pod; populated by the system, read-only; http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status | false |
3.3.9. v1.Event
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard object metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | true | ||
| involvedObject | object this event is about | true | ||
| reason | short, machine understandable string that gives the reason for the transition into the object’s current status | false | string | |
| message | human-readable description of the status of this operation | false | string | |
| source | component reporting this event | false | ||
| firstTimestamp | the time at which the event was first recorded | false | string (date-time) | |
| lastTimestamp | the time at which the most recent occurrence of this event was recorded | false | string (date-time) | |
| count | the number of times this event has occurred | false | integer (int32) |
3.3.10. v1.HostPathVolumeSource
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| path | path of the directory on the host; see http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#hostpath | true | string |
3.3.11. v1.Volume
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| name | volume name; must be a DNS_LABEL and unique within the pod; see http://releases.k8s.io/HEAD/docs/user-guide/identifiers.md#names | true | string | |
| hostPath | pre-existing host file or directory; generally for privileged system daemons or other agents tied to the host; see http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#hostpath | false | ||
| emptyDir | temporary directory that shares a pod’s lifetime; see http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#emptydir | false | ||
| gcePersistentDisk | GCE disk resource attached to the host machine on demand; see http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#gcepersistentdisk | false | ||
| awsElasticBlockStore | AWS disk resource attached to the host machine on demand; see http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#awselasticblockstore | false | ||
| gitRepo | git repository at a particular revision | false | ||
| secret | secret to populate volume; see http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#secrets | false | ||
| nfs | NFS volume that will be mounted in the host machine; see http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#nfs | false | ||
| iscsi | iSCSI disk attached to host machine on demand; see http://releases.k8s.io/HEAD/examples/iscsi/README.md | false | ||
| glusterfs | Glusterfs volume that will be mounted on the host machine; see http://releases.k8s.io/HEAD/examples/glusterfs/README.md | false | ||
| persistentVolumeClaim | a reference to a PersistentVolumeClaim in the same namespace; see http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#persistentvolumeclaims | false | ||
| rbd | rados block volume that will be mounted on the host machine; see http://releases.k8s.io/HEAD/examples/rbd/README.md | false | ||
| cephfs | Ceph filesystem that will be mounted on the host machine | false | ||
| metadata | Metadata volume containing information about the pod | false |
3.3.12. v1.ContainerStateRunning
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| startedAt | time at which the container was last (re-)started | false | string (date-time) |
3.3.13. v1.DeleteOptions
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| gracePeriodSeconds | the duration in seconds to wait before deleting this object; defaults to a per object value if not specified; zero means delete immediately | true | integer (int64) |
3.3.14. v1.ListMeta
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| selfLink | URL for the object; populated by the system, read-only | false | string | |
| resourceVersion | string that identifies the internal version of this object that can be used by clients to determine when objects have changed; populated by the system, read-only; value must be treated as opaque by clients and passed unmodified back to the server: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#concurrency-control-and-consistency | false | string |
3.3.15. v1.PodTemplateSpec
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| metadata | standard object metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | false | ||
| spec | specification of the desired behavior of the pod; http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status | false |
3.3.16. v1.SecretList
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard list metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | false | ||
| items | items is a list of secret objects; see http://releases.k8s.io/HEAD/docs/user-guide/secrets.md | true |
3.3.17. v1.NFSVolumeSource
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| server | the hostname or IP address of the NFS server; see http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#nfs | true | string | |
| path | the path that is exported by the NFS server; see http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#nfs | true | string | |
| readOnly | forces the NFS export to be mounted with read-only permissions; see http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#nfs | false | boolean | false |
3.3.18. v1.CephFSVolumeSource
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| monitors | a collection of Ceph monitors | true | string array | |
| user | rados user name; default is admin; optional | false | string | |
| secretFile | path to secret for rados user; default is /etc/ceph/user.secret; optional | false | string | |
| secretRef | name of a secret to authenticate the user; if provided overrides keyring; optional | false | ||
| readOnly | Ceph fs to be mounted with read-only permissions | false | boolean | false |
3.3.19. v1.Capabilities
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| add | added capabilities | false | ||
| drop | dropped capabilities | false |
3.3.20. v1.ComponentCondition
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| type | type of component condition, currently only Healthy | true | string | |
| status | current status of this component condition, one of True, False, Unknown | true | string | |
| message | health check message received from the component | false | string | |
| error | error code from health check attempt (if any) | false | string |
3.3.21. v1.ServiceStatus
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| loadBalancer | status of load-balancer | false |
3.3.22. v1.SecretVolumeSource
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| secretName | secretName is the name of a secret in the pod’s namespace; see http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#secrets | true | string |
3.3.23. v1.ResourceRequirements
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| limits | Maximum amount of compute resources allowed; see http://releases.k8s.io/HEAD/docs/design/resources.md#resource-specifications | false | ||
| requests | Minimum amount of resources requested; if Requests is omitted for a container, it defaults to Limits if that is explicitly specified, otherwise to an implementation-defined value; see http://releases.k8s.io/HEAD/docs/design/resources.md#resource-specifications | false |
3.3.24. v1.PersistentVolumeClaim
Persistent Volume Claims (PVC) represent a request to use a persistent volume (PV) with a pod. When creating a pod definition (or replication controller or deployment config) a developer may specify the amount of storage they need via a persistent volume reference. If an administrator has enabled and configured persistent volumes for use, they will be allocated on demand to pods that have similar requirements. Since volumes are created lazily, some pods may be scheduled to a node before their volume is assigned. The node will detect this situation and wait to start the pod until the volume is bound. Events will be generated (visible by using the describe command on the pod) that indicate the pod is waiting for volumes.
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard object metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | false | ||
| spec | the desired characteristics of a volume; see http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#persistentvolumeclaims | false | ||
| status | the current status of a persistent volume claim; read-only; see http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#persistentvolumeclaims | false |
3.3.25. v1.SecurityContextConstraintsList
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | false | |||
| items | true |
3.3.26. v1.NamespaceStatus
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| phase | phase is the current lifecycle phase of the namespace; see http://releases.k8s.io/HEAD/docs/design/namespaces.md#phases | false | string |
3.3.27. v1.PersistentVolumeAccessMode
3.3.28. v1.ResourceQuotaSpec
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| hard | hard is the set of desired hard limits for each named resource; see http://releases.k8s.io/HEAD/docs/design/admission_control_resource_quota.md#admissioncontrol-plugin-resourcequota | false |
3.3.29. v1.RunAsUserStrategyOptions
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| type | strategy used to generate RunAsUser | false | string | |
| uid | the uid to always run as; required for MustRunAs | false | integer (int64) | |
| uidRangeMin | min value for range based allocators | false | integer (int64) | |
| uidRangeMax | max value for range based allocators | false | integer (int64) |
3.3.30. v1.PersistentVolumeSpec
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| capacity | a description of the persistent volume’s resources and capacity; see http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#capacity | false | ||
| gcePersistentDisk | GCE disk resource provisioned by an admin; see http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#gcepersistentdisk | false | ||
| awsElasticBlockStore | AWS disk resource provisioned by an admin; see http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#awselasticblockstore | false | ||
| hostPath | a HostPath provisioned by a developer or tester; for development use only; see http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#hostpath | false | ||
| glusterfs | Glusterfs volume resource provisioned by an admin; see http://releases.k8s.io/HEAD/examples/glusterfs/README.md | false | ||
| nfs | NFS volume resource provisioned by an admin; see http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#nfs | false | ||
| rbd | rados block volume that will be mounted on the host machine; see http://releases.k8s.io/HEAD/examples/rbd/README.md | false | ||
| iscsi | an iSCSI disk resource provisioned by an admin | false | ||
| cephfs | Ceph filesystem that will be mounted on the host machine | false | ||
| accessModes | all ways the volume can be mounted; see http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#access-modes | false | ||
| claimRef | when bound, a reference to the bound claim; see http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#binding | false | ||
| persistentVolumeReclaimPolicy | what happens to a volume when released from its claim; Valid options are Retain (default) and Recycle. Recyling must be supported by the volume plugin underlying this persistent volume. See http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#recycling-policy | false | string |
3.3.31. v1.ExecAction
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| command | command line to execute inside the container; working directory for the command is root ('/') in the container’s file system; the command is exec’d, not run inside a shell; exit status of 0 is treated as live/healthy and non-zero is unhealthy | false | string array |
3.3.32. v1.PersistentVolumeClaimVolumeSource
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| claimName | the name of the claim in the same namespace to be mounted as a volume; see http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#persistentvolumeclaims | true | string | |
| readOnly | mount volume as read-only when true; default false | false | boolean | false |
3.3.33. v1.ServiceSpec
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| ports | ports exposed by the service; see http://releases.k8s.io/HEAD/docs/user-guide/services.md#virtual-ips-and-service-proxies | true | ||
| selector | label keys and values that must match in order to receive traffic for this service; if empty, all pods are selected, if not specified, endpoints must be manually specified; see http://releases.k8s.io/HEAD/docs/user-guide/services.md#overview | false | ||
| portalIP | deprecated, use clusterIP instead | false | string | |
| clusterIP | IP address of the service; usually assigned by the system; if specified, it will be allocated to the service if unused or else creation of the service will fail; cannot be updated; 'None' can be specified for a headless service when proxying is not required; see http://releases.k8s.io/HEAD/docs/user-guide/services.md#virtual-ips-and-service-proxies | false | string | |
| type | type of this service; must be ClusterIP, NodePort, or LoadBalancer; defaults to ClusterIP; see http://releases.k8s.io/HEAD/docs/user-guide/services.md#external-services | false | string | |
| deprecatedPublicIPs | deprecated. externally visible IPs (e.g. load balancers) that should be proxied to this service | false | string array | |
| sessionAffinity | enable client IP based session affinity; must be ClientIP or None; defaults to None; see http://releases.k8s.io/HEAD/docs/user-guide/services.md#virtual-ips-and-service-proxies | false | string |
3.3.34. v1.ServiceList
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard list metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | false | ||
| items | list of services | true |
3.3.35. v1.PersistentVolumeList
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard list metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | ||
| items | list of persistent volumes; see http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md | false |
3.3.36. v1.ContainerStatus
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| name | name of the container; must be a DNS_LABEL and unique within the pod; cannot be updated | true | string | |
| state | details about the container’s current condition | false | ||
| lastState | details about the container’s last termination condition | false | ||
| ready | specifies whether the container has passed its readiness probe | true | boolean | false |
| restartCount | the number of times the container has been restarted, currently based on the number of dead containers that have not yet been removed | true | integer (int32) | |
| image | image of the container; see http://releases.k8s.io/HEAD/docs/user-guide/images.md | true | string | |
| imageID | ID of the container’s image | true | string | |
| containerID | container’s ID in the format 'docker://<container_id>'; see http://releases.k8s.io/HEAD/docs/user-guide/container-environment.md#container-information | false | string |
3.3.37. v1.Handler
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| exec | exec-based handler | false | ||
| httpGet | HTTP-based handler | false | ||
| tcpSocket | TCP-based handler; TCP hooks not yet supported | false |
3.3.38. v1.NodeAddress
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| type | node address type, one of Hostname, ExternalIP or InternalIP | true | string | |
| address | the node address | true | string |
3.3.39. v1.EndpointPort
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| name | name of this port | false | string | |
| port | port number of the endpoint | true | integer (int32) | |
| protocol | protocol for this port; must be UDP or TCP; TCP if unspecified | false | string |
3.3.40. v1.EndpointSubset
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| addresses | IP addresses which offer the related ports | false | ||
| ports | port numbers available on the related IP addresses | false |
3.3.41. v1.LimitRangeList
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard list metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | false | ||
| items | items is a list of LimitRange objects; see http://releases.k8s.io/HEAD/docs/design/admission_control_limit_range.md | true |
3.3.42. v1.Container
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| name | name of the container; must be a DNS_LABEL and unique within the pod; cannot be updated | true | string | |
| image | Docker image name; see http://releases.k8s.io/HEAD/docs/user-guide/images.md | false | string | |
| command | entrypoint array; not executed within a shell; the Docker image’s entrypoint is used if this is not provided; cannot be updated; variable references $(VAR_NAME) are expanded using the container’s environment variables; if a variable cannot be resolved, the reference in the input string will be unchanged; the $(VAR_NAME) syntax can be escaped with a double , ie: (VAR_NAME) ; escaped references will never be expanded, regardless of whether the variable exists or not; see http://releases.k8s.io/HEAD/docs/user-guide/containers.md#containers-and-commands | false | string array | |
| args | command array; the Docker image’s cmd is used if this is not provided; arguments to the entrypoint; cannot be updated; variable references $(VAR_NAME) are expanded using the container’s environment variables; if a variable cannot be resolved, the reference in the input string will be unchanged; the $(VAR_NAME) syntax can be escaped with a double , ie: (VAR_NAME) ; escaped references will never be expanded, regardless of whether the variable exists or not; see http://releases.k8s.io/HEAD/docs/user-guide/containers.md#containers-and-commands | false | string array | |
| workingDir | container’s working directory; defaults to image’s default; cannot be updated | false | string | |
| ports | list of ports to expose from the container; cannot be updated | false | ||
| env | list of environment variables to set in the container; cannot be updated | false | ||
| resources | Compute Resources required by this container; cannot be updated; see http://releases.k8s.io/HEAD/docs/user-guide/compute-resources.md | false | ||
| volumeMounts | pod volumes to mount into the container’s filesystem; cannot be updated | false | ||
| livenessProbe | periodic probe of container liveness; container will be restarted if the probe fails; cannot be updated; see http://releases.k8s.io/HEAD/docs/user-guide/pod-states.md#container-probes | false | ||
| readinessProbe | periodic probe of container service readiness; container will be removed from service endpoints if the probe fails; cannot be updated; see http://releases.k8s.io/HEAD/docs/user-guide/pod-states.md#container-probes | false | ||
| lifecycle | actions that the management system should take in response to container lifecycle events; cannot be updated | false | ||
| terminationMessagePath | path at which the file to which the container’s termination message will be written is mounted into the container’s filesystem; message written is intended to be brief final status, such as an assertion failure message; defaults to /dev/termination-log; cannot be updated | false | string | |
| imagePullPolicy | image pull policy; one of Always, Never, IfNotPresent; defaults to Always if :latest tag is specified, or IfNotPresent otherwise; cannot be updated; see http://releases.k8s.io/HEAD/docs/user-guide/images.md#updating-images | false | string | |
| securityContext | security options the pod should run with; see http://releases.k8s.io/HEAD/docs/design/security_context.md | false | ||
| stdin | Whether this container should allocate a buffer for stdin in the container runtime; default is false | false | boolean | false |
| tty | Whether this container should allocate a TTY for itself, also requires 'stdin' to be true; default is false | false | boolean | false |
3.3.43. v1.MetadataFile
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| name | the name of the file to be created | true | string | |
| fieldRef | selects a field of the pod. Supported fields: metadata.annotations, metadata.labels, metadata.name, metadata.namespace | true |
3.3.44. v1.PodSpec
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| volumes | list of volumes that can be mounted by containers belonging to the pod; see http://releases.k8s.io/HEAD/docs/user-guide/volumes.md | false | ||
| containers | list of containers belonging to the pod; cannot be updated; containers cannot currently be added or removed; there must be at least one container in a Pod; see http://releases.k8s.io/HEAD/docs/user-guide/containers.md | true | ||
| restartPolicy | restart policy for all containers within the pod; one of Always, OnFailure, Never; defaults to Always; see http://releases.k8s.io/HEAD/docs/user-guide/pod-states.md#restartpolicy | false | string | |
| terminationGracePeriodSeconds | optional duration in seconds the pod needs to terminate gracefully; may be decreased in delete request; value must be non-negative integer; the value zero indicates delete immediately; if this value is not set, the default grace period will be used instead; the grace period is the duration in seconds after the processes running in the pod are sent a termination signal and the time when the processes are forcibly halted with a kill signal; set this value longer than the expected cleanup time for your process | false | integer (int64) | |
| activeDeadlineSeconds | false | integer (int64) | ||
| dnsPolicy | DNS policy for containers within the pod; one of 'ClusterFirst' or 'Default' | false | string | |
| nodeSelector | selector which must match a node’s labels for the pod to be scheduled on that node; see http://releases.k8s.io/HEAD/docs/user-guide/node-selection/README.md | false | ||
| host | deprecated, use nodeName instead | false | string | |
| serviceAccountName | name of the ServiceAccount to use to run this pod; see http://releases.k8s.io/HEAD/docs/design/service_accounts.md | false | string | |
| serviceAccount | deprecated; use serviceAccountName instead | false | string | |
| nodeName | node requested for this pod | false | string | |
| hostNetwork | host networking requested for this pod | false | boolean | false |
| imagePullSecrets | list of references to secrets in the same namespace available for pulling the container images; see http://releases.k8s.io/HEAD/docs/user-guide/images.md#specifying-imagepullsecrets-on-a-pod | false |
3.3.45. v1.PersistentVolumeStatus
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| phase | the current phase of a persistent volume; see http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#phase | false | string | |
| message | human-readable message indicating details about why the volume is in this state | false | string | |
| reason | (brief) reason the volume is not is not available | false | string |
3.3.46. v1.RBDVolumeSource
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| monitors | a collection of Ceph monitors; see http://releases.k8s.io/HEAD/examples/rbd/README.md#how-to-use-it | true | string array | |
| image | rados image name; see http://releases.k8s.io/HEAD/examples/rbd/README.md#how-to-use-it | true | string | |
| fsType | file system type to mount, such as ext4, xfs, ntfs; see http://releases.k8s.io/HEAD/examples/rbd/README.md#how-to-use-it | false | string | |
| pool | rados pool name; default is rbd; optional; see http://releases.k8s.io/HEAD/examples/rbd/README.md#how-to-use-it | true | string | |
| user | rados user name; default is admin; optional; see http://releases.k8s.io/HEAD/examples/rbd/README.md#how-to-use-it | true | string | |
| keyring | keyring is the path to key ring for rados user; default is /etc/ceph/keyring; optional; see http://releases.k8s.io/HEAD/examples/rbd/README.md#how-to-use-it | true | string | |
| secretRef | name of a secret to authenticate the RBD user; if provided overrides keyring; optional; see http://releases.k8s.io/HEAD/examples/rbd/README.md#how-to-use-it | true | ||
| readOnly | rbd volume to be mounted with read-only permissions; see http://releases.k8s.io/HEAD/examples/rbd/README.md#how-to-use-it | false | boolean | false |
3.3.47. v1.LoadBalancerIngress
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| ip | IP address of ingress point | false | string | |
| hostname | hostname of ingress point | false | string |
3.3.48. v1.SecurityContext
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| capabilities | the Linux capabilites that should be added or removed; see http://releases.k8s.io/HEAD/docs/design/security_context.md#security-context | false | ||
| privileged | run the container in privileged mode; see http://releases.k8s.io/HEAD/docs/design/security_context.md#security-context | false | boolean | false |
| seLinuxOptions | options that control the SELinux labels applied; see http://releases.k8s.io/HEAD/docs/design/security_context.md#security-context | false | ||
| runAsUser | the user id that runs the first process in the container; see http://releases.k8s.io/HEAD/docs/design/security_context.md#security-context | false | integer (int64) | |
| runAsNonRoot | indicates the container must be run as a non-root user either by specifying the runAsUser or in the image specification | false | boolean | false |
3.3.49. v1.ServicePort
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| name | the name of this port; optional if only one port is defined | false | string | |
| protocol | the protocol used by this port; must be UDP or TCP; TCP if unspecified | false | string | |
| port | the port number that is exposed | true | integer (int32) | |
| targetPort | number or name of the port to access on the pods targeted by the service; defaults to the service port; number must be in the range 1 to 65535; name must be an IANA_SVC_NAME; see http://releases.k8s.io/HEAD/docs/user-guide/services.md#defining-a-service | false | string | |
| nodePort | the port on each node on which this service is exposed when type=NodePort or LoadBalancer; usually assigned by the system; if specified, it will be allocated to the service if unused or else creation of the service will fail; see http://releases.k8s.io/HEAD/docs/user-guide/services.md#type—nodeport | true | integer (int32) |
3.3.50. v1.StatusCause
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| reason | machine-readable description of the cause of the error; if this value is empty there is no information available | false | string | |
| message | human-readable description of the cause of the error; this field may be presented as-is to a reader | false | string | |
| field | field of the resource that has caused this error, as named by its JSON serialization; may include dot and postfix notation for nested attributes; arrays are zero-indexed; fields may appear more than once in an array of causes due to fields having multiple errors | false | string |
3.3.51. v1.Namespace
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard object metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | false | ||
| spec | spec defines the behavior of the Namespace; http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status | false | ||
| status | status describes the current status of a Namespace; http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status | false |
3.3.52. v1.GCEPersistentDiskVolumeSource
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| pdName | unique name of the PD resource in GCE; see http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#gcepersistentdisk | true | string | |
| fsType | file system type to mount, such as ext4, xfs, ntfs; see http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#gcepersistentdisk | true | string | |
| partition | partition on the disk to mount (e.g., '1' for /dev/sda1); if omitted the plain device name (e.g., /dev/sda) will be mounted; see http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#gcepersistentdisk | false | integer (int32) | |
| readOnly | read-only if true, read-write otherwise (false or unspecified); see http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#gcepersistentdisk | false | boolean | false |
3.3.53. v1.EndpointsList
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard list metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | false | ||
| items | list of endpoints | true |
3.3.54. v1.NodeList
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard list metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | false | ||
| items | list of nodes | true |
3.3.55. v1.EventSource
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| component | component that generated the event | false | string | |
| host | name of the host where the event is generated | false | string |
3.3.56. v1.EnvVarSource
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| fieldRef | selects a field of the pod; only name and namespace are supported | true |
3.3.57. v1.LimitRangeSpec
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| limits | limits is the list of LimitRangeItem objects that are enforced | true |
3.3.58. v1.PersistentVolumeClaimSpec
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| accessModes | the desired access modes the volume should have; see http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#access-modes-1 | false | ||
| resources | the desired resources the volume should have; see http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#resources | false | ||
| volumeName | the binding reference to the persistent volume backing this claim | false | string |
3.3.59. v1.ReplicationController
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard object metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | false | ||
| spec | specification of the desired behavior of the replication controller; http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status | false | ||
| status | most recently observed status of the replication controller; populated by the system, read-only; http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status | false |
3.3.60. v1.NamespaceList
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard list metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | false | ||
| items | items is the list of Namespace objects in the list; see http://releases.k8s.io/HEAD/docs/user-guide/namespaces.md | true |
3.3.61. v1.SecurityContextConstraints
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | false | |||
| allowPrivilegedContainer | allow containers to run as privileged | true | boolean | false |
| allowedCapabilities | capabilities that are allowed to be added | true | ||
| allowHostDirVolumePlugin | allow the use of the host dir volume plugin | true | boolean | false |
| allowHostNetwork | allow the use of the hostNetwork in the pod spec | true | boolean | false |
| allowHostPorts | allow the use of the host ports in the containers | true | boolean | false |
| seLinuxContext | strategy used to generate SELinuxOptions | false | ||
| runAsUser | strategy used to generate RunAsUser | false | ||
| users | users allowed to use this SecurityContextConstraints | false | string array | |
| groups | groups allowed to use this SecurityContextConstraints | false | string array |
3.3.62. v1.VolumeMount
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| name | name of the volume to mount | true | string | |
| readOnly | mounted read-only if true, read-write otherwise (false or unspecified) | false | boolean | false |
| mountPath | path within the container at which the volume should be mounted | true | string |
3.3.63. v1.NodeStatus
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| capacity | compute resource capacity of the node; see http://releases.k8s.io/HEAD/docs/user-guide/compute-resources.md | false | ||
| phase | most recently observed lifecycle phase of the node; see http://releases.k8s.io/HEAD/docs/admin/node.md#node-phase | false | string | |
| conditions | list of node conditions observed; see http://releases.k8s.io/HEAD/docs/admin/node.md#node-condition | false | ||
| addresses | list of addresses reachable to the node; see http://releases.k8s.io/HEAD/docs/admin/node.md#node-addresses | false | ||
| nodeInfo | set of ids/uuids to uniquely identify the node; see http://releases.k8s.io/HEAD/docs/admin/node.md#node-info | false |
3.3.64. v1.ReplicationControllerStatus
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| replicas | most recently observed number of replicas; see http://releases.k8s.io/HEAD/docs/user-guide/replication-controller.md#what-is-a-replication-controller | true | integer (int32) | |
| observedGeneration | reflects the generation of the most recently observed replication controller | false | integer (int64) |
3.3.65. v1.PodCondition
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| type | kind of the condition, currently only Ready; see http://releases.k8s.io/HEAD/docs/user-guide/pod-states.md#pod-conditions | true | string | |
| status | status of the condition, one of True, False, Unknown; see http://releases.k8s.io/HEAD/docs/user-guide/pod-states.md#pod-conditions | true | string |
3.3.66. v1.NodeCondition
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| type | type of node condition, currently only Ready | true | string | |
| status | status of the condition, one of True, False, Unknown | true | string | |
| lastHeartbeatTime | last time we got an update on a given condition | false | string (date-time) | |
| lastTransitionTime | last time the condition transit from one status to another | false | string (date-time) | |
| reason | (brief) reason for the condition’s last transition | false | string | |
| message | human readable message indicating details about last transition | false | string |
3.3.67. v1.ServiceAccount
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard object metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | false | ||
| secrets | list of secrets that can be used by pods running as this service account; see http://releases.k8s.io/HEAD/docs/user-guide/secrets.md | false | ||
| imagePullSecrets | list of references to secrets in the same namespace available for pulling container images; see http://releases.k8s.io/HEAD/docs/user-guide/secrets.md#manually-specifying-an-imagepullsecret | false |
3.3.68. v1.PodTemplate
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard object metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | false | ||
| template | the template of the desired behavior of the pod; http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status | false |
3.3.69. v1.PodList
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard list metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | ||
| items | list of pods; see http://releases.k8s.io/HEAD/docs/user-guide/pods.md | true | Section 3.3.8, “v1.Pod” array |
3.3.70. v1.EmptyDirVolumeSource
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| medium | type of storage used to back the volume; must be an empty string (default) or Memory; see http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#emptydir | false | string |
3.3.71. v1.NodeSpec
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| podCIDR | pod IP range assigned to the node | false | string | |
| externalID | deprecated. External ID assigned to the node by some machine database (e.g. a cloud provider). Defaults to node name when empty. | false | string | |
| providerID | ID of the node assigned by the cloud provider in the format: <ProviderName>://<ProviderSpecificNodeID> | false | string | |
| unschedulable | disable pod scheduling on the node; see http://releases.k8s.io/HEAD/docs/admin/node.md#manual-node-administration | false | boolean | false |
3.3.72. api.Patch
3.3.73. v1.HTTPGetAction
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| path | path to access on the HTTP server | false | string | |
| port | number or name of the port to access on the container; number must be in the range 1 to 65535; name must be an IANA_SVC_NAME | true | string | |
| host | hostname to connect to; defaults to pod IP | false | string | |
| scheme | scheme to connect with, must be HTTP or HTTPS, defaults to HTTP | false | string |
3.3.74. v1.ResourceQuotaList
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard list metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | false | ||
| items | items is a list of ResourceQuota objects; see http://releases.k8s.io/HEAD/docs/design/admission_control_resource_quota.md#admissioncontrol-plugin-resourcequota | true |
3.3.75. v1.ServiceAccountList
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard list metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | false | ||
| items | list of ServiceAccounts; see http://releases.k8s.io/HEAD/docs/design/service_accounts.md#service-accounts | true |
3.3.76. v1.Probe
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| exec | exec-based handler | false | ||
| httpGet | HTTP-based handler | false | ||
| tcpSocket | TCP-based handler; TCP hooks not yet supported | false | ||
| initialDelaySeconds | number of seconds after the container has started before liveness probes are initiated; see http://releases.k8s.io/HEAD/docs/user-guide/pod-states.md#container-probes | false | integer (int64) | |
| timeoutSeconds | number of seconds after which liveness probes timeout; defaults to 1 second; see http://releases.k8s.io/HEAD/docs/user-guide/pod-states.md#container-probes | false | integer (int64) |
3.3.77. v1.NamespaceSpec
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| finalizers | an opaque list of values that must be empty to permanently remove object from storage; see http://releases.k8s.io/HEAD/docs/design/namespaces.md#finalizers | false |
3.3.78. v1.ISCSIVolumeSource
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| targetPortal | iSCSI target portal | true | string | |
| iqn | iSCSI Qualified Name | true | string | |
| lun | iscsi target lun number | true | integer (int32) | |
| fsType | file system type to mount, such as ext4, xfs, ntfs | true | string | |
| readOnly | read-only if true, read-write otherwise (false or unspecified) | false | boolean | false |
3.3.79. v1.EventList
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard list metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | false | ||
| items | list of events | true |
3.3.80. v1.LoadBalancerStatus
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| ingress | load-balancer ingress points | false |
3.3.81. v1.PersistentVolumeClaimList
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard list metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | ||
| items | a list of persistent volume claims; see http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#persistentvolumeclaims | false |
3.3.82. v1.ComponentStatus
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard object metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | false | ||
| conditions | list of component conditions observed | false |
3.3.83. v1.GitRepoVolumeSource
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| repository | repository URL | true | string | |
| revision | commit hash for the specified revision | true | string |
3.3.84. v1.ObjectMeta
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| name | string that identifies an object. Must be unique within a namespace; cannot be updated; see http://releases.k8s.io/HEAD/docs/user-guide/identifiers.md#names | false | string | |
| generateName | an optional prefix to use to generate a unique name; has the same validation rules as name; optional, and is applied only name if is not specified; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#idempotency | false | string | |
| namespace | namespace of the object; must be a DNS_LABEL; cannot be updated; see http://releases.k8s.io/HEAD/docs/user-guide/namespaces.md | false | string | |
| selfLink | URL for the object; populated by the system, read-only | false | string | |
| uid | unique UUID across space and time; populated by the system; read-only; see http://releases.k8s.io/HEAD/docs/user-guide/identifiers.md#uids | false | string | |
| resourceVersion | string that identifies the internal version of this object that can be used by clients to determine when objects have changed; populated by the system, read-only; value must be treated as opaque by clients and passed unmodified back to the server: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#concurrency-control-and-consistency | false | string | |
| generation | a sequence number representing a specific generation of the desired state; populated by the system; read-only | false | integer (int64) | |
| creationTimestamp | RFC 3339 date and time at which the object was created; populated by the system, read-only; null for lists; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | false | string (date-time) | |
| deletionTimestamp | RFC 3339 date and time at which the object will be deleted; populated by the system when a graceful deletion is requested, read-only; if not set, graceful deletion of the object has not been requested; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | false | string (date-time) | |
| labels | map of string keys and values that can be used to organize and categorize objects; may match selectors of replication controllers and services; see http://releases.k8s.io/HEAD/docs/user-guide/labels.md | false | ||
| annotations | map of string keys and values that can be used by external tooling to store and retrieve arbitrary metadata about objects; see http://releases.k8s.io/HEAD/docs/user-guide/annotations.md | false |
3.3.85. v1.LocalObjectReference
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| name | name of the referent; see http://releases.k8s.io/HEAD/docs/user-guide/identifiers.md#names | false | string |
3.3.86. v1.ContainerPort
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| name | name for the port that can be referred to by services; must be an IANA_SVC_NAME and unique within the pod | false | string | |
| hostPort | number of port to expose on the host; most containers do not need this | false | integer (int32) | |
| containerPort | number of port to expose on the pod’s IP address | true | integer (int32) | |
| protocol | protocol for port; must be UDP or TCP; TCP if unspecified | false | string | |
| hostIP | host IP to bind the port to | false | string |
3.3.87. v1.Secret
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard object metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | false | ||
| data | data contains the secret data. Each key must be a valid DNS_SUBDOMAIN or leading dot followed by valid DNS_SUBDOMAIN. Each value must be a base64 encoded string as described in https://tools.ietf.org/html/rfc4648#section-4 | false | ||
| type | type facilitates programmatic handling of secret data | false | string |
3.3.88. v1.ContainerState
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| waiting | details about a waiting container | false | ||
| running | details about a running container | false | ||
| terminated | details about a terminated container | false |
3.3.89. v1.Endpoints
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard object metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | false | ||
| subsets | sets of addresses and ports that comprise a service | true |
3.3.90. v1.SELinuxContextStrategyOptions
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| type | strategy used to generate the SELinux context | false | string | |
| seLinuxOptions | seLinuxOptions required to run as; required for MustRunAs | false |
3.3.91. v1.PodStatus
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| phase | current condition of the pod; see http://releases.k8s.io/HEAD/docs/user-guide/pod-states.md#pod-phase | false | string | |
| conditions | current service state of pod; see http://releases.k8s.io/HEAD/docs/user-guide/pod-states.md#pod-conditions | false | ||
| message | human readable message indicating details about why the pod is in this condition | false | string | |
| reason | (brief-CamelCase) reason indicating details about why the pod is in this condition | false | string | |
| hostIP | IP address of the host to which the pod is assigned; empty if not yet scheduled | false | string | |
| podIP | IP address allocated to the pod; routable at least within the cluster; empty if not yet allocated | false | string | |
| startTime | RFC 3339 date and time at which the object was acknowledged by the Kubelet. This is before the Kubelet pulled the container image(s) for the pod. | false | string (date-time) | |
| containerStatuses | list of container statuses; see http://releases.k8s.io/HEAD/docs/user-guide/pod-states.md#container-statuses | false |
3.3.92. v1.SELinuxOptions
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| user | the user label to apply to the container; see http://releases.k8s.io/HEAD/docs/user-guide/labels.md | false | string | |
| role | the role label to apply to the container; see http://releases.k8s.io/HEAD/docs/user-guide/labels.md | false | string | |
| type | the type label to apply to the container; see http://releases.k8s.io/HEAD/docs/user-guide/labels.md | false | string | |
| level | the level label to apply to the container; see http://releases.k8s.io/HEAD/docs/user-guide/labels.md | false | string |
3.3.93. v1.Service
A Service is an abstraction which defines a logical set of Pods and a policy by which to access them - sometimes called a micro-service. The set of Pods targeted by a Service is (usually) determined by a Label selector. Services broadly fall into two types - those that load balance a set of Pods and hide which Pod a client talks to (clusterIP set to an IP address), and those where clients want to talk to the individual member pods directly (clusterIP set to 'None', also known as 'headless' services). The cluster IP of a service is exposed as an environment variable in each pod in the same namespace.
Services may be exposed only inside the cluster (type ClusterIP), inside the cluster and on a high port on each node (type NodePort), or exposed to a load balancer via the hosting cloud infrastructure (type LoadBalancer). Services with a ClusterIP may choose to map the ports available on the ClusterIP to different ports on the pods. Each service has a DNS entry of the form <name>.<namespace>.svc.cluster.local that will be valid from other pods in the cluster.
If the selector for pods is not specified, the service endpoints may be managed by the client directly. Update the endpoint resource to program the service - this can be used to inject external network services into a namsepace.
See the Kubernetes service documentation for more information.
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard object metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | false | ||
| spec | specification of the desired behavior of the service; http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status | false | ||
| status | most recently observed status of the service; populated by the system, read-only; http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status | false |
3.3.94. v1.ObjectReference
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of the referent; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| namespace | namespace of the referent; see http://releases.k8s.io/HEAD/docs/user-guide/namespaces.md | false | string | |
| name | name of the referent; see http://releases.k8s.io/HEAD/docs/user-guide/identifiers.md#names | false | string | |
| uid | uid of the referent; see http://releases.k8s.io/HEAD/docs/user-guide/identifiers.md#uids | false | string | |
| apiVersion | API version of the referent | false | string | |
| resourceVersion | specific resourceVersion to which this reference is made, if any: http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#concurrency-control-and-consistency | false | string | |
| fieldPath | if referring to a piece of an object instead of an entire object, this string should contain a valid JSON/Go field access statement, such as desiredState.manifest.containers[2] | false | string |
3.3.95. v1.ObjectFieldSelector
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| apiVersion | version of the schema that fieldPath is written in terms of; defaults to v1 | false | string | |
| fieldPath | path of the field to select in the specified API version | true | string |
3.3.96. v1.ComponentStatusList
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard list metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | false | ||
| items | list of component status objects | true |
3.3.97. v1.Lifecycle
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| postStart | called immediately after a container is started; if the handler fails, the container is terminated and restarted according to its restart policy; other management of the container blocks until the hook completes; see http://releases.k8s.io/HEAD/docs/user-guide/container-environment.md#hook-details | false | ||
| preStop | called before a container is terminated; the container is terminated after the handler completes; other management of the container blocks until the hook completes; see http://releases.k8s.io/HEAD/docs/user-guide/container-environment.md#hook-details | false |
3.3.98. v1.Status
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard list metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | false | ||
| status | status of the operation; either Success, or Failure; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status | false | string | |
| message | human-readable description of the status of this operation | false | string | |
| reason | machine-readable description of why this operation is in the 'Failure' status; if this value is empty there is no information available; a reason clarifies an HTTP status code but does not override it | false | string | |
| details | extended data associated with the reason; each reason may define its own extended details; this field is optional and the data returned is not guaranteed to conform to any schema except that defined by the reason type | false | ||
| code | suggested HTTP return code for this status; 0 if not set | false | integer (int32) |
3.3.99. v1.NodeSystemInfo
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| machineID | machine-id reported by the node | true | string | |
| systemUUID | system-uuid reported by the node | true | string | |
| bootID | boot id is the boot-id reported by the node | true | string | |
| kernelVersion | Kernel version reported by the node from 'uname -r' (e.g. 3.16.0-0.bpo.4-amd64) | true | string | |
| osImage | OS image used reported by the node from /etc/os-release (e.g. Debian GNU/Linux 7 (wheezy)) | true | string | |
| containerRuntimeVersion | Container runtime version reported by the node through runtime remote API (e.g. docker://1.5.0) | true | string | |
| kubeletVersion | Kubelet version reported by the node | true | string | |
| kubeProxyVersion | Kube-proxy version reported by the node | true | string |
3.3.100. json.WatchEvent
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| type | the type of watch event; may be ADDED, MODIFIED, DELETED, or ERROR | false | string | |
| object | the object being watched; will match the type of the resource endpoint or be a Status object if the type is ERROR | false | string |
3.3.101. v1.EndpointAddress
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| ip | IP address of the endpoint | true | string | |
| targetRef | reference to object providing the endpoint | false |
3.3.102. v1.AWSElasticBlockStoreVolumeSource
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| volumeID | unique id of the PD resource in AWS; see http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#awselasticblockstore | true | string | |
| fsType | file system type to mount, such as ext4, xfs, ntfs; see http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#awselasticblockstore | true | string | |
| partition | partition on the disk to mount (e.g., '1' for /dev/sda1); if omitted the plain device name (e.g., /dev/sda) will be mounted; see http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#awselasticblockstore | false | integer (int32) | |
| readOnly | read-only if true, read-write otherwise (false or unspecified); see http://releases.k8s.io/HEAD/docs/user-guide/volumes.md#awselasticblockstore | false | boolean | false |
3.3.103. v1.Binding
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard object metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | false | ||
| target | an object to bind to | true |
3.3.104. v1.Node
Nodes represent the machines that run the pods and containers in the cluster. A node resource is typically created and modified by the software running on the node - reporting information about capacity and the current health of the node. The labels of the node can be used by pods to specify a subset of the cluster to be scheduled on. The scheduler will only assign pods to nodes that have the schedulable condition set and also ready.
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard object metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | false | ||
| spec | specification of a node; http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status | false | ||
| status | most recently observed status of the node; populated by the system, read-only; http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status | false |
3.3.105. v1.StatusDetails
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| name | the name attribute of the resource associated with the status StatusReason (when there is a single name which can be described) | false | string | |
| kind | the kind attribute of the resource associated with the status StatusReason; on some operations may differ from the requested resource Kind; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| causes | the Causes array includes more details associated with the StatusReason failure; not all StatusReasons may provide detailed causes | false | ||
| retryAfterSeconds | the number of seconds before the client should attempt to retry this operation | false | integer (int32) |
3.3.106. v1.ResourceQuota
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard object metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | false | ||
| spec | spec defines the desired quota; http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status | false | ||
| status | status defines the actual enforced quota and current usage; http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status | false |
3.3.107. v1.EnvVar
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| name | name of the environment variable; must be a C_IDENTIFIER | true | string | |
| value | value of the environment variable; defaults to empty string; variable references $(VAR_NAME) are expanded using the previously defined environment variables in the container and any service environment variables; if a variable cannot be resolved, the reference in the input string will be unchanged; the $(VAR_NAME) syntax can be escaped with a double , ie: (VAR_NAME) ; escaped references will never be expanded, regardless of whether the variable exists or not | false | string | |
| valueFrom | source for the environment variable’s value; cannot be used if value is not empty | false |
3.3.108. v1.ReplicationControllerSpec
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| replicas | number of replicas desired; defaults to 1; see http://releases.k8s.io/HEAD/docs/user-guide/replication-controller.md#what-is-a-replication-controller | false | integer (int32) | |
| selector | label keys and values that must match in order to be controlled by this replication controller, if empty defaulted to labels on Pod template; see http://releases.k8s.io/HEAD/docs/user-guide/labels.md#label-selectors | false | ||
| template | object that describes the pod that will be created if insufficient replicas are detected; takes precedence over templateRef; see http://releases.k8s.io/HEAD/docs/user-guide/replication-controller.md#pod-template | false |
3.3.109. v1.ContainerStateWaiting
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| reason | (brief) reason the container is not yet running, such as pulling its image | false | string |
3.3.110. v1.PodTemplateList
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard list metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | false | ||
| items | list of pod templates | true |
3.3.111. v1.LimitRangeItem
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| type | type of resource that this limit applies to | false | string | |
| max | max usage constraints on this kind by resource name | false | ||
| min | min usage constraints on this kind by resource name | false | ||
| default | default values on this kind by resource name if omitted | false |
3.3.112. v1.FinalizerName
3.3.113. v1.LimitRange
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| kind | kind of object, in CamelCase; cannot be updated; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#types-kinds | false | string | |
| apiVersion | version of the schema the object should have; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#resources | false | string | |
| metadata | standard object metadata; see http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#metadata | false | ||
| spec | spec defines the limits enforced; http://releases.k8s.io/HEAD/docs/devel/api-conventions.md#spec-and-status | false |
3.3.114. v1.GlusterfsVolumeSource
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| endpoints | gluster hosts endpoints name; see http://releases.k8s.io/HEAD/examples/glusterfs/README.md#create-a-pod | true | string | |
| path | path to gluster volume; see http://releases.k8s.io/HEAD/examples/glusterfs/README.md#create-a-pod | true | string | |
| readOnly | glusterfs volume to be mounted with read-only permissions; see http://releases.k8s.io/HEAD/examples/glusterfs/README.md#create-a-pod | false | boolean | false |
3.3.115. v1.PersistentVolumeClaimStatus
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
| phase | the current phase of the claim | false | string | |
| accessModes | the actual access modes the volume has; see http://releases.k8s.io/HEAD/docs/user-guide/persistent-volumes.md#access-modes-1 | false | ||
| capacity | the actual resources the volume has | false |
3.3.116. any
Represents an untyped JSON map - see the description of the field for more info about the structure of this object.