Chapter 3. Kubernetes v1 REST API

3.2.1. get available resources

GET /api/v1

3.2.1.1. Consumes

application/json
application/yaml

3.2.1.2. Produces

application/json
application/yaml

3.2.1.3. Tags

apiv1

3.2.2. create a Binding

POST /api/v1/bindings

3.2.2.1. Parameters

Type	Name	Description	Required	Schema	Default
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.10, “v1.Binding”

3.2.2.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.10, “v1.Binding”

3.2.2.3. Consumes

/

3.2.2.4. Produces

application/json
application/yaml

3.2.2.5. Tags

apiv1

3.2.3. list objects of kind ComponentStatus

GET /api/v1/componentstatuses

3.2.3.1. Parameters

Type	Name	Description	Required	Schema
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
QueryParameter	timeoutSeconds	Timeout for the list/watch call.	false	integer

3.2.3.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.17, “v1.ComponentStatusList”

3.2.3.3. Consumes

/

3.2.3.4. Produces

application/json
application/yaml

3.2.3.5. Tags

apiv1

3.2.4. read the specified ComponentStatus

GET /api/v1/componentstatuses/{name}

3.2.4.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 ComponentStatus	true	string

3.2.4.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.16, “v1.ComponentStatus”

3.2.4.3. Consumes

/

3.2.4.4. Produces

application/json
application/yaml

3.2.4.5. Tags

apiv1

3.2.5. create a ConfigMap

POST /api/v1/configmaps

3.2.5.1. Parameters

Type	Name	Description	Required	Schema	Default
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.18, “v1.ConfigMap”

3.2.5.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.18, “v1.ConfigMap”

3.2.5.3. Consumes

/

3.2.5.4. Produces

application/json
application/yaml

3.2.5.5. Tags

apiv1

3.2.6. list or watch objects of kind ConfigMap

GET /api/v1/configmaps

3.2.6.1. Parameters

Type	Name	Description	Required	Schema
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
QueryParameter	timeoutSeconds	Timeout for the list/watch call.	false	integer

3.2.6.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.20, “v1.ConfigMapList”

3.2.6.3. Consumes

/

3.2.6.4. Produces

application/json
application/yaml

3.2.6.5. Tags

apiv1

3.2.7. create a Endpoints

POST /api/v1/endpoints

3.2.7.1. Parameters

Type	Name	Description	Required	Schema	Default
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.38, “v1.Endpoints”

3.2.7.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.38, “v1.Endpoints”

3.2.7.3. Consumes

/

3.2.7.4. Produces

application/json
application/yaml

3.2.7.5. Tags

apiv1

3.2.8. list or watch objects of kind Endpoints

GET /api/v1/endpoints

3.2.8.1. Parameters

Type	Name	Description	Required	Schema
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
QueryParameter	timeoutSeconds	Timeout for the list/watch call.	false	integer

3.2.8.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.39, “v1.EndpointsList”

3.2.8.3. Consumes

/

3.2.8.4. Produces

application/json
application/yaml

3.2.8.5. Tags

apiv1

3.2.9. create a Event

POST /api/v1/events

3.2.9.1. Parameters

Type	Name	Description	Required	Schema	Default
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.42, “v1.Event”

3.2.9.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.42, “v1.Event”

3.2.9.3. Consumes

/

3.2.9.4. Produces

application/json
application/yaml

3.2.9.5. Tags

apiv1

3.2.10. list or watch objects of kind Event

GET /api/v1/events

3.2.10.1. Parameters

Type	Name	Description	Required	Schema
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
QueryParameter	timeoutSeconds	Timeout for the list/watch call.	false	integer

3.2.10.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.43, “v1.EventList”

3.2.10.3. Consumes

/

3.2.10.4. Produces

application/json
application/yaml

3.2.10.5. Tags

apiv1

3.2.11. create a LimitRange

POST /api/v1/limitranges

3.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	Section 3.3.62, “v1.LimitRange”

3.2.11.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.62, “v1.LimitRange”

3.2.11.3. Consumes

/

3.2.11.4. Produces

application/json
application/yaml

3.2.11.5. Tags

apiv1

3.2.12. list or watch objects of kind LimitRange

GET /api/v1/limitranges

3.2.12.1. Parameters

Type	Name	Description	Required	Schema
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
QueryParameter	timeoutSeconds	Timeout for the list/watch call.	false	integer

3.2.12.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.64, “v1.LimitRangeList”

3.2.12.3. Consumes

/

3.2.12.4. Produces

application/json
application/yaml

3.2.12.5. Tags

apiv1

3.2.13. create a Namespace

POST /api/v1/namespaces

3.2.13.1. Parameters

Type	Name	Description	Required	Schema	Default
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.72, “v1.Namespace”

3.2.13.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.72, “v1.Namespace”

3.2.13.3. Consumes

/

3.2.13.4. Produces

application/json
application/yaml

3.2.13.5. Tags

apiv1

3.2.14. delete collection of Namespace

DELETE /api/v1/namespaces

3.2.14.1. Parameters

Type	Name	Description	Required	Schema
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
QueryParameter	timeoutSeconds	Timeout for the list/watch call.	false	integer

3.2.14.2. Responses

HTTP Code	Description	Schema
200	success	Section 2.3.7, “unversioned.Status”

3.2.14.3. Consumes

/

3.2.14.4. Produces

application/json
application/yaml

3.2.14.5. Tags

apiv1

3.2.15. list or watch objects of kind Namespace

GET /api/v1/namespaces

3.2.15.1. Parameters

Type	Name	Description	Required	Schema
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
QueryParameter	timeoutSeconds	Timeout for the list/watch call.	false	integer

3.2.15.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.73, “v1.NamespaceList”

3.2.15.3. Consumes

/

3.2.15.4. Produces

application/json
application/yaml

3.2.15.5. Tags

apiv1

3.2.16. create a Binding

POST /api/v1/namespaces/{namespace}/bindings

3.2.16.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.10, “v1.Binding”
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string

3.2.16.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.10, “v1.Binding”

3.2.16.3. Consumes

/

3.2.16.4. Produces

application/json
application/yaml

3.2.16.5. Tags

apiv1

3.2.17. create a ConfigMap

POST /api/v1/namespaces/{namespace}/configmaps

3.2.17.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.18, “v1.ConfigMap”
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string

3.2.17.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.18, “v1.ConfigMap”

3.2.17.3. Consumes

/

3.2.17.4. Produces

application/json
application/yaml

3.2.17.5. Tags

apiv1

3.2.18. delete collection of ConfigMap

DELETE /api/v1/namespaces/{namespace}/configmaps

3.2.18.1. Parameters

Type	Name	Description	Required	Schema
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
QueryParameter	timeoutSeconds	Timeout for the list/watch call.	false	integer
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string

3.2.18.2. Responses

HTTP Code	Description	Schema
200	success	Section 2.3.7, “unversioned.Status”

3.2.18.3. Consumes

/

3.2.18.4. Produces

application/json
application/yaml

3.2.18.5. Tags

apiv1

3.2.19. list or watch objects of kind ConfigMap

GET /api/v1/namespaces/{namespace}/configmaps

3.2.19.1. Parameters

Type	Name	Description	Required	Schema
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
QueryParameter	timeoutSeconds	Timeout for the list/watch call.	false	integer
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string

3.2.19.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.20, “v1.ConfigMapList”

3.2.19.3. Consumes

/

3.2.19.4. Produces

application/json
application/yaml

3.2.19.5. Tags

apiv1

3.2.20. replace the specified ConfigMap

PUT /api/v1/namespaces/{namespace}/configmaps/{name}

3.2.20.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.18, “v1.ConfigMap”
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string
PathParameter	name	name of the ConfigMap	true	string

3.2.20.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.18, “v1.ConfigMap”

3.2.20.3. Consumes

/

3.2.20.4. Produces

application/json
application/yaml

3.2.20.5. Tags

apiv1

3.2.21. delete a ConfigMap

DELETE /api/v1/namespaces/{namespace}/configmaps/{name}

3.2.21.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 2.3.48, “v1.DeleteOptions”
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string
PathParameter	name	name of the ConfigMap	true	string

3.2.21.2. Responses

HTTP Code	Description	Schema
200	success	Section 2.3.7, “unversioned.Status”

3.2.21.3. Consumes

/

3.2.21.4. Produces

application/json
application/yaml

3.2.21.5. Tags

apiv1

3.2.22. partially update the specified ConfigMap

PATCH /api/v1/namespaces/{namespace}/configmaps/{name}

3.2.22.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 2.3.6, “unversioned.Patch”
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string
PathParameter	name	name of the ConfigMap	true	string

3.2.22.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.18, “v1.ConfigMap”

3.2.22.3. Consumes

application/json-patch+json
application/merge-patch+json
application/strategic-merge-patch+json

3.2.22.4. Produces

application/json
application/yaml

3.2.22.5. Tags

apiv1

3.2.23. read the specified ConfigMap

GET /api/v1/namespaces/{namespace}/configmaps/{name}

3.2.23.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
QueryParameter	export	Should this value be exported. Export strips fields that a user can not specify.	false	boolean
QueryParameter	exact	Should the export be exact. Exact export maintains cluster-specific fields like 'Namespace'	false	boolean
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string
PathParameter	name	name of the ConfigMap	true	string

3.2.23.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.18, “v1.ConfigMap”

3.2.23.3. Consumes

/

3.2.23.4. Produces

application/json
application/yaml

3.2.23.5. Tags

apiv1

3.2.24. create a Endpoints

POST /api/v1/namespaces/{namespace}/endpoints

3.2.24.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.38, “v1.Endpoints”
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string

3.2.24.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.38, “v1.Endpoints”

3.2.24.3. Consumes

/

3.2.24.4. Produces

application/json
application/yaml

3.2.24.5. Tags

apiv1

3.2.25. delete collection of Endpoints

DELETE /api/v1/namespaces/{namespace}/endpoints

3.2.25.1. Parameters

Type	Name	Description	Required	Schema
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
QueryParameter	timeoutSeconds	Timeout for the list/watch call.	false	integer
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string

3.2.25.2. Responses

HTTP Code	Description	Schema
200	success	Section 2.3.7, “unversioned.Status”

3.2.25.3. Consumes

/

3.2.25.4. Produces

application/json
application/yaml

3.2.25.5. Tags

apiv1

3.2.26. list or watch objects of kind Endpoints

GET /api/v1/namespaces/{namespace}/endpoints

3.2.26.1. Parameters

Type	Name	Description	Required	Schema
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
QueryParameter	timeoutSeconds	Timeout for the list/watch call.	false	integer
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	Section 3.3.39, “v1.EndpointsList”

3.2.26.3. Consumes

/

3.2.26.4. Produces

application/json
application/yaml

3.2.26.5. Tags

apiv1

3.2.27. replace the specified Endpoints

PUT /api/v1/namespaces/{namespace}/endpoints/{name}

3.2.27.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.38, “v1.Endpoints”
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.27.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.38, “v1.Endpoints”

3.2.27.3. Consumes

/

3.2.27.4. Produces

application/json
application/yaml

3.2.27.5. Tags

apiv1

3.2.28. delete a Endpoints

DELETE /api/v1/namespaces/{namespace}/endpoints/{name}

3.2.28.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 2.3.48, “v1.DeleteOptions”
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.28.2. Responses

HTTP Code	Description	Schema
200	success	Section 2.3.7, “unversioned.Status”

3.2.28.3. Consumes

/

3.2.28.4. Produces

application/json
application/yaml

3.2.28.5. Tags

apiv1

3.2.29. partially update the specified Endpoints

PATCH /api/v1/namespaces/{namespace}/endpoints/{name}

3.2.29.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 2.3.6, “unversioned.Patch”
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.29.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.38, “v1.Endpoints”

3.2.29.3. Consumes

application/json-patch+json
application/merge-patch+json
application/strategic-merge-patch+json

3.2.29.4. Produces

application/json
application/yaml

3.2.29.5. Tags

apiv1

3.2.30. read the specified Endpoints

GET /api/v1/namespaces/{namespace}/endpoints/{name}

3.2.30.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
QueryParameter	export	Should this value be exported. Export strips fields that a user can not specify.	false	boolean
QueryParameter	exact	Should the export be exact. Exact export maintains cluster-specific fields like 'Namespace'	false	boolean
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.30.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.38, “v1.Endpoints”

3.2.30.3. Consumes

/

3.2.30.4. Produces

application/json
application/yaml

3.2.30.5. Tags

apiv1

3.2.31. create a Event

POST /api/v1/namespaces/{namespace}/events

3.2.31.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.42, “v1.Event”
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string

3.2.31.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.42, “v1.Event”

3.2.31.3. Consumes

/

3.2.31.4. Produces

application/json
application/yaml

3.2.31.5. Tags

apiv1

3.2.32. delete collection of Event

DELETE /api/v1/namespaces/{namespace}/events

3.2.32.1. Parameters

Type	Name	Description	Required	Schema
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
QueryParameter	timeoutSeconds	Timeout for the list/watch call.	false	integer
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string

3.2.32.2. Responses

HTTP Code	Description	Schema
200	success	Section 2.3.7, “unversioned.Status”

3.2.32.3. Consumes

/

3.2.32.4. Produces

application/json
application/yaml

3.2.32.5. Tags

apiv1

3.2.33. list or watch objects of kind Event

GET /api/v1/namespaces/{namespace}/events

3.2.33.1. Parameters

Type	Name	Description	Required	Schema
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
QueryParameter	timeoutSeconds	Timeout for the list/watch call.	false	integer
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	Section 3.3.43, “v1.EventList”

3.2.33.3. Consumes

/

3.2.33.4. Produces

application/json
application/yaml

3.2.33.5. Tags

apiv1

3.2.34. replace the specified Event

PUT /api/v1/namespaces/{namespace}/events/{name}

3.2.34.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.42, “v1.Event”
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.34.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.42, “v1.Event”

3.2.34.3. Consumes

/

3.2.34.4. Produces

application/json
application/yaml

3.2.34.5. Tags

apiv1

3.2.35. delete a Event

DELETE /api/v1/namespaces/{namespace}/events/{name}

3.2.35.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 2.3.48, “v1.DeleteOptions”
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.35.2. Responses

HTTP Code	Description	Schema
200	success	Section 2.3.7, “unversioned.Status”

3.2.35.3. Consumes

/

3.2.35.4. Produces

application/json
application/yaml

3.2.35.5. Tags

apiv1

3.2.36. partially update the specified Event

PATCH /api/v1/namespaces/{namespace}/events/{name}

3.2.36.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 2.3.6, “unversioned.Patch”
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.36.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.42, “v1.Event”

3.2.36.3. Consumes

application/json-patch+json
application/merge-patch+json
application/strategic-merge-patch+json

3.2.36.4. Produces

application/json
application/yaml

3.2.36.5. Tags

apiv1

3.2.37. read the specified Event

GET /api/v1/namespaces/{namespace}/events/{name}

3.2.37.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
QueryParameter	export	Should this value be exported. Export strips fields that a user can not specify.	false	boolean
QueryParameter	exact	Should the export be exact. Exact export maintains cluster-specific fields like 'Namespace'	false	boolean
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.37.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.42, “v1.Event”

3.2.37.3. Consumes

/

3.2.37.4. Produces

application/json
application/yaml

3.2.37.5. Tags

apiv1

3.2.38. create a LimitRange

POST /api/v1/namespaces/{namespace}/limitranges

3.2.38.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.62, “v1.LimitRange”
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string

3.2.38.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.62, “v1.LimitRange”

3.2.38.3. Consumes

/

3.2.38.4. Produces

application/json
application/yaml

3.2.38.5. Tags

apiv1

3.2.39. delete collection of LimitRange

DELETE /api/v1/namespaces/{namespace}/limitranges

3.2.39.1. Parameters

Type	Name	Description	Required	Schema
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
QueryParameter	timeoutSeconds	Timeout for the list/watch call.	false	integer
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	Section 2.3.7, “unversioned.Status”

3.2.39.3. Consumes

/

3.2.39.4. Produces

application/json
application/yaml

3.2.39.5. Tags

apiv1

3.2.40. list or watch objects of kind LimitRange

GET /api/v1/namespaces/{namespace}/limitranges

3.2.40.1. Parameters

Type	Name	Description	Required	Schema
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
QueryParameter	timeoutSeconds	Timeout for the list/watch call.	false	integer
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	Section 3.3.64, “v1.LimitRangeList”

3.2.40.3. Consumes

/

3.2.40.4. Produces

application/json
application/yaml

3.2.40.5. Tags

apiv1

3.2.41. replace the specified LimitRange

PUT /api/v1/namespaces/{namespace}/limitranges/{name}

3.2.41.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.62, “v1.LimitRange”
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.41.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.62, “v1.LimitRange”

3.2.41.3. Consumes

/

3.2.41.4. Produces

application/json
application/yaml

3.2.41.5. Tags

apiv1

3.2.42. delete a LimitRange

DELETE /api/v1/namespaces/{namespace}/limitranges/{name}

3.2.42.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 2.3.48, “v1.DeleteOptions”
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.42.2. Responses

HTTP Code	Description	Schema
200	success	Section 2.3.7, “unversioned.Status”

3.2.42.3. Consumes

/

3.2.42.4. Produces

application/json
application/yaml

3.2.42.5. Tags

apiv1

3.2.43. partially update the specified LimitRange

PATCH /api/v1/namespaces/{namespace}/limitranges/{name}

3.2.43.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 2.3.6, “unversioned.Patch”
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.43.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.62, “v1.LimitRange”

3.2.43.3. Consumes

application/json-patch+json
application/merge-patch+json
application/strategic-merge-patch+json

3.2.43.4. Produces

application/json
application/yaml

3.2.43.5. Tags

apiv1

3.2.44. read the specified LimitRange

GET /api/v1/namespaces/{namespace}/limitranges/{name}

3.2.44.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
QueryParameter	export	Should this value be exported. Export strips fields that a user can not specify.	false	boolean
QueryParameter	exact	Should the export be exact. Exact export maintains cluster-specific fields like 'Namespace'	false	boolean
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.44.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.62, “v1.LimitRange”

3.2.44.3. Consumes

/

3.2.44.4. Produces

application/json
application/yaml

3.2.44.5. Tags

apiv1

3.2.45. create a PersistentVolumeClaim

POST /api/v1/namespaces/{namespace}/persistentvolumeclaims

3.2.45.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.89, “v1.PersistentVolumeClaim”
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string

3.2.45.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.89, “v1.PersistentVolumeClaim”

3.2.45.3. Consumes

/

3.2.45.4. Produces

application/json
application/yaml

3.2.45.5. Tags

apiv1

3.2.46. delete collection of PersistentVolumeClaim

DELETE /api/v1/namespaces/{namespace}/persistentvolumeclaims

3.2.46.1. Parameters

Type	Name	Description	Required	Schema
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
QueryParameter	timeoutSeconds	Timeout for the list/watch call.	false	integer
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string

3.2.46.2. Responses

HTTP Code	Description	Schema
200	success	Section 2.3.7, “unversioned.Status”

3.2.46.3. Consumes

/

3.2.46.4. Produces

application/json
application/yaml

3.2.46.5. Tags

apiv1

3.2.47. list or watch objects of kind PersistentVolumeClaim

GET /api/v1/namespaces/{namespace}/persistentvolumeclaims

3.2.47.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.47.2. Parameters

Type	Name	Description	Required	Schema
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
QueryParameter	timeoutSeconds	Timeout for the list/watch call.	false	integer
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string

3.2.47.3. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.90, “v1.PersistentVolumeClaimList”

3.2.47.4. Consumes

/

3.2.47.5. Produces

application/json
application/yaml

3.2.47.6. Tags

apiv1

3.2.48. replace the specified PersistentVolumeClaim

PUT /api/v1/namespaces/{namespace}/persistentvolumeclaims/{name}

3.2.48.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.89, “v1.PersistentVolumeClaim”
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.48.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.89, “v1.PersistentVolumeClaim”

3.2.48.3. Consumes

/

3.2.48.4. Produces

application/json
application/yaml

3.2.48.5. Tags

apiv1

3.2.49. delete a PersistentVolumeClaim

DELETE /api/v1/namespaces/{namespace}/persistentvolumeclaims/{name}

3.2.49.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 2.3.48, “v1.DeleteOptions”
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.49.2. Responses

HTTP Code	Description	Schema
200	success	Section 2.3.7, “unversioned.Status”

3.2.49.3. Consumes

/

3.2.49.4. Produces

application/json
application/yaml

3.2.49.5. Tags

apiv1

3.2.50. partially update the specified PersistentVolumeClaim

PATCH /api/v1/namespaces/{namespace}/persistentvolumeclaims/{name}

3.2.50.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 2.3.6, “unversioned.Patch”
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.50.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.89, “v1.PersistentVolumeClaim”

3.2.50.3. Consumes

application/json-patch+json
application/merge-patch+json
application/strategic-merge-patch+json

3.2.50.4. Produces

application/json
application/yaml

3.2.50.5. Tags

apiv1

3.2.51. read the specified PersistentVolumeClaim

GET /api/v1/namespaces/{namespace}/persistentvolumeclaims/{name}

3.2.51.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
QueryParameter	export	Should this value be exported. Export strips fields that a user can not specify.	false	boolean
QueryParameter	exact	Should the export be exact. Exact export maintains cluster-specific fields like 'Namespace'	false	boolean
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.51.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.89, “v1.PersistentVolumeClaim”

3.2.51.3. Consumes

/

3.2.51.4. Produces

application/json
application/yaml

3.2.51.5. Tags

apiv1

3.2.52. replace status of the specified PersistentVolumeClaim

PUT /api/v1/namespaces/{namespace}/persistentvolumeclaims/{name}/status

3.2.52.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.89, “v1.PersistentVolumeClaim”
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.52.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.89, “v1.PersistentVolumeClaim”

3.2.52.3. Consumes

/

3.2.52.4. Produces

application/json
application/yaml

3.2.52.5. Tags

apiv1

3.2.53. create a Pod

POST /api/v1/namespaces/{namespace}/pods

3.2.53.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.97, “v1.Pod”
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string

3.2.53.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.97, “v1.Pod”

3.2.53.3. Consumes

/

3.2.53.4. Produces

application/json
application/yaml

3.2.53.5. Tags

apiv1

3.2.54. delete collection of Pod

DELETE /api/v1/namespaces/{namespace}/pods

3.2.54.1. Parameters

Type	Name	Description	Required	Schema
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
QueryParameter	timeoutSeconds	Timeout for the list/watch call.	false	integer
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string

3.2.54.2. Responses

HTTP Code	Description	Schema
200	success	Section 2.3.7, “unversioned.Status”

3.2.54.3. Consumes

/

3.2.54.4. Produces

application/json
application/yaml

3.2.54.5. Tags

apiv1

3.2.55. list or watch objects of kind Pod

GET /api/v1/namespaces/{namespace}/pods

3.2.55.1. Parameters

Type	Name	Description	Required	Schema
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
QueryParameter	timeoutSeconds	Timeout for the list/watch call.	false	integer
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string

3.2.55.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.99, “v1.PodList”

3.2.55.3. Consumes

/

3.2.55.4. Produces

application/json
application/yaml

3.2.55.5. Tags

apiv1

3.2.56. replace the specified Pod

PUT /api/v1/namespaces/{namespace}/pods/{name}

3.2.56.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.97, “v1.Pod”
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
200	success	Section 3.3.97, “v1.Pod”

3.2.56.3. Consumes

/

3.2.56.4. Produces

application/json
application/yaml

3.2.56.5. Tags

apiv1

3.2.57. delete a Pod

DELETE /api/v1/namespaces/{namespace}/pods/{name}

3.2.57.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 2.3.48, “v1.DeleteOptions”
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.57.2. Responses

HTTP Code	Description	Schema
200	success	Section 2.3.7, “unversioned.Status”

3.2.57.3. Consumes

/

3.2.57.4. Produces

application/json
application/yaml

3.2.57.5. Tags

apiv1

3.2.58. partially update the specified Pod

PATCH /api/v1/namespaces/{namespace}/pods/{name}

3.2.58.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 2.3.6, “unversioned.Patch”
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.58.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.97, “v1.Pod”

3.2.58.3. Consumes

application/json-patch+json
application/merge-patch+json
application/strategic-merge-patch+json

3.2.58.4. Produces

application/json
application/yaml

3.2.58.5. Tags

apiv1

3.2.59. read the specified Pod

GET /api/v1/namespaces/{namespace}/pods/{name}

3.2.59.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
QueryParameter	export	Should this value be exported. Export strips fields that a user can not specify.	false	boolean
QueryParameter	exact	Should the export be exact. Exact export maintains cluster-specific fields like 'Namespace'	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.59.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.97, “v1.Pod”

3.2.59.3. Consumes

/

3.2.59.4. Produces

application/json
application/yaml

3.2.59.5. Tags

apiv1

3.2.60. connect POST requests to attach of Pod

POST /api/v1/namespaces/{namespace}/pods/{name}/attach

3.2.60.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	stdin	Stdin if true, redirects the standard input stream of the pod for this call. Defaults to false.	false	boolean
QueryParameter	stdout	Stdout if true indicates that stdout is to be redirected for the attach call. Defaults to true.	false	boolean
QueryParameter	stderr	Stderr if true indicates that stderr is to be redirected for the attach call. Defaults to true.	false	boolean
QueryParameter	tty	TTY if true indicates that a tty will be allocated for the attach call. This is passed through the container runtime so the tty is allocated on the worker node by the container runtime. 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.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. connect GET requests to attach of Pod

GET /api/v1/namespaces/{namespace}/pods/{name}/attach

3.2.61.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	stdin	Stdin if true, redirects the standard input stream of the pod for this call. Defaults to false.	false	boolean
QueryParameter	stdout	Stdout if true indicates that stdout is to be redirected for the attach call. Defaults to true.	false	boolean
QueryParameter	stderr	Stderr if true indicates that stderr is to be redirected for the attach call. Defaults to true.	false	boolean
QueryParameter	tty	TTY if true indicates that a tty will be allocated for the attach call. This is passed through the container runtime so the tty is allocated on the worker node by the container runtime. 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.61.2. Responses

HTTP Code	Description	Schema
default	success	string

3.2.61.3. Consumes

/

3.2.61.4. Produces

/

3.2.61.5. Tags

apiv1

3.2.62. create binding of a Binding

POST /api/v1/namespaces/{namespace}/pods/{name}/binding

3.2.62.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.10, “v1.Binding”
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.62.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.10, “v1.Binding”

3.2.62.3. Consumes

/

3.2.62.4. Produces

application/json
application/yaml

3.2.62.5. Tags

apiv1

3.2.63. connect POST requests to exec of Pod

POST /api/v1/namespaces/{namespace}/pods/{name}/exec

3.2.63.1. Parameters

Type	Name	Description	Required	Schema
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	TTY if true indicates that a tty will be allocated for the exec call. Defaults to false.	false	boolean
QueryParameter	container	Container in which to execute the command. Defaults to only container if there is only one container in the pod.	false	string
QueryParameter	command	Command is the remote command to execute. argv array. Not executed within a shell.	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.63.2. Responses

HTTP Code	Description	Schema
default	success	string

3.2.63.3. Consumes

/

3.2.63.4. Produces

/

3.2.63.5. Tags

apiv1

3.2.64. connect GET requests to exec of Pod

GET /api/v1/namespaces/{namespace}/pods/{name}/exec

3.2.64.1. Parameters

Type	Name	Description	Required	Schema
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	TTY if true indicates that a tty will be allocated for the exec call. Defaults to false.	false	boolean
QueryParameter	container	Container in which to execute the command. Defaults to only container if there is only one container in the pod.	false	string
QueryParameter	command	Command is the remote command to execute. argv array. Not executed within a shell.	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.64.2. Responses

HTTP Code	Description	Schema
default	success	string

3.2.64.3. Consumes

/

3.2.64.4. Produces

/

3.2.64.5. Tags

apiv1

3.2.65. read log of the specified Pod

GET /api/v1/namespaces/{namespace}/pods/{name}/log

3.2.65.1. Parameters

Type	Name	Description	Required	Schema
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
QueryParameter	sinceSeconds	A relative time in seconds before the current time from which to show logs. If this value precedes the time a pod was started, only logs since the pod start will be returned. If this value is in the future, no logs will be returned. Only one of sinceSeconds or sinceTime may be specified.	false	integer
QueryParameter	sinceTime	An RFC3339 timestamp from which to show logs. If this value precedes the time a pod was started, only logs since the pod start will be returned. If this value is in the future, no logs will be returned. Only one of sinceSeconds or sinceTime may be specified.	false	string
QueryParameter	timestamps	If true, add an RFC3339 or RFC3339Nano timestamp at the beginning of every line of log output. Defaults to false.	false	boolean
QueryParameter	tailLines	If set, the number of lines from the end of the logs to show. If not specified, logs are shown from the creation of the container or sinceSeconds or sinceTime	false	integer
QueryParameter	limitBytes	If set, the number of bytes to read from the server before terminating the log output. This may not display a complete final line of logging, and may return slightly more or slightly less than the specified limit.	false	integer
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.65.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.97, “v1.Pod”

3.2.65.3. Consumes

/

3.2.65.4. Produces

application/json
application/yaml

3.2.65.5. Tags

apiv1

3.2.66. connect POST requests to portforward of Pod

POST /api/v1/namespaces/{namespace}/pods/{name}/portforward

3.2.66.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.66.2. Responses

HTTP Code	Description	Schema
default	success	string

3.2.66.3. Consumes

/

3.2.66.4. Produces

/

3.2.66.5. Tags

apiv1

3.2.67. connect GET requests to portforward of Pod

GET /api/v1/namespaces/{namespace}/pods/{name}/portforward

3.2.67.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.67.2. Responses

HTTP Code	Description	Schema
default	success	string

3.2.67.3. Consumes

/

3.2.67.4. Produces

/

3.2.67.5. Tags

apiv1

3.2.68. connect PUT requests to proxy of Pod

PUT /api/v1/namespaces/{namespace}/pods/{name}/proxy

3.2.68.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	path	Path is the URL path to use for the current 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.68.2. Responses

HTTP Code	Description	Schema
default	success	string

3.2.68.3. Consumes

/

3.2.68.4. Produces

/

3.2.68.5. Tags

apiv1

3.2.69. connect POST requests to proxy of Pod

POST /api/v1/namespaces/{namespace}/pods/{name}/proxy

3.2.69.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	path	Path is the URL path to use for the current 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.69.2. Responses

HTTP Code	Description	Schema
default	success	string

3.2.69.3. Consumes

/

3.2.69.4. Produces

/

3.2.69.5. Tags

apiv1

3.2.70. connect DELETE requests to proxy of Pod

DELETE /api/v1/namespaces/{namespace}/pods/{name}/proxy

3.2.70.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	path	Path is the URL path to use for the current 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.70.2. Responses

HTTP Code	Description	Schema
default	success	string

3.2.70.3. Consumes

/

3.2.70.4. Produces

/

3.2.70.5. Tags

apiv1

3.2.71. connect OPTIONS requests to proxy of Pod

OPTIONS /api/v1/namespaces/{namespace}/pods/{name}/proxy

3.2.71.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	path	Path is the URL path to use for the current 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.71.2. Responses

HTTP Code	Description	Schema
default	success	string

3.2.71.3. Consumes

/

3.2.71.4. Produces

/

3.2.71.5. Tags

apiv1

3.2.72. connect HEAD requests to proxy of Pod

HEAD /api/v1/namespaces/{namespace}/pods/{name}/proxy

3.2.72.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	path	Path is the URL path to use for the current 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.72.2. Responses

HTTP Code	Description	Schema
default	success	string

3.2.72.3. Consumes

/

3.2.72.4. Produces

/

3.2.72.5. Tags

apiv1

3.2.73. connect GET requests to proxy of Pod

GET /api/v1/namespaces/{namespace}/pods/{name}/proxy

3.2.73.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	path	Path is the URL path to use for the current 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.73.2. Responses

HTTP Code	Description	Schema
default	success	string

3.2.73.3. Consumes

/

3.2.73.4. Produces

/

3.2.73.5. Tags

apiv1

3.2.74. connect PUT requests to proxy of Pod

PUT /api/v1/namespaces/{namespace}/pods/{name}/proxy/{path}

3.2.74.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	path	Path is the URL path to use for the current 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.74.2. Responses

HTTP Code	Description	Schema
default	success	string

3.2.74.3. Consumes

/

3.2.74.4. Produces

/

3.2.74.5. Tags

apiv1

3.2.75. connect POST requests to proxy of Pod

POST /api/v1/namespaces/{namespace}/pods/{name}/proxy/{path}

3.2.75.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	path	Path is the URL path to use for the current 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.75.2. Responses

HTTP Code	Description	Schema
default	success	string

3.2.75.3. Consumes

/

3.2.75.4. Produces

/

3.2.75.5. Tags

apiv1

3.2.76. connect DELETE requests to proxy of Pod

DELETE /api/v1/namespaces/{namespace}/pods/{name}/proxy/{path}

3.2.76.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	path	Path is the URL path to use for the current 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.76.2. Responses

HTTP Code	Description	Schema
default	success	string

3.2.76.3. Consumes

/

3.2.76.4. Produces

/

3.2.76.5. Tags

apiv1

3.2.77. connect OPTIONS requests to proxy of Pod

OPTIONS /api/v1/namespaces/{namespace}/pods/{name}/proxy/{path}

3.2.77.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	path	Path is the URL path to use for the current 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.77.2. Responses

HTTP Code	Description	Schema
default	success	string

3.2.77.3. Consumes

/

3.2.77.4. Produces

/

3.2.77.5. Tags

apiv1

3.2.78. connect HEAD requests to proxy of Pod

HEAD /api/v1/namespaces/{namespace}/pods/{name}/proxy/{path}

3.2.78.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	path	Path is the URL path to use for the current 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.78.2. Responses

HTTP Code	Description	Schema
default	success	string

3.2.78.3. Consumes

/

3.2.78.4. Produces

/

3.2.78.5. Tags

apiv1

3.2.79. connect GET requests to proxy of Pod

GET /api/v1/namespaces/{namespace}/pods/{name}/proxy/{path}

3.2.79.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	path	Path is the URL path to use for the current 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.79.2. Responses

HTTP Code	Description	Schema
default	success	string

3.2.79.3. Consumes

/

3.2.79.4. Produces

/

3.2.79.5. Tags

apiv1

3.2.80. replace status of the specified Pod

PUT /api/v1/namespaces/{namespace}/pods/{name}/status

3.2.80.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.97, “v1.Pod”
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.80.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.97, “v1.Pod”

3.2.80.3. Consumes

/

3.2.80.4. Produces

application/json
application/yaml

3.2.80.5. Tags

apiv1

3.2.81. create a PodTemplate

POST /api/v1/namespaces/{namespace}/podtemplates

3.2.81.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.103, “v1.PodTemplate”
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	Section 3.3.103, “v1.PodTemplate”

3.2.81.3. Consumes

/

3.2.81.4. Produces

application/json
application/yaml

3.2.81.5. Tags

apiv1

3.2.82. delete collection of PodTemplate

DELETE /api/v1/namespaces/{namespace}/podtemplates

3.2.82.1. Parameters

Type	Name	Description	Required	Schema
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
QueryParameter	timeoutSeconds	Timeout for the list/watch call.	false	integer
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	Section 2.3.7, “unversioned.Status”

3.2.82.3. Consumes

/

3.2.82.4. Produces

application/json
application/yaml

3.2.82.5. Tags

apiv1

3.2.83. list or watch objects of kind PodTemplate

GET /api/v1/namespaces/{namespace}/podtemplates

3.2.83.1. Parameters

Type	Name	Description	Required	Schema
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
QueryParameter	timeoutSeconds	Timeout for the list/watch call.	false	integer
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string

3.2.83.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.104, “v1.PodTemplateList”

3.2.83.3. Consumes

/

3.2.83.4. Produces

application/json
application/yaml

3.2.83.5. Tags

apiv1

3.2.84. replace the specified PodTemplate

PUT /api/v1/namespaces/{namespace}/podtemplates/{name}

3.2.84.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.103, “v1.PodTemplate”
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.84.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.103, “v1.PodTemplate”

3.2.84.3. Consumes

/

3.2.84.4. Produces

application/json
application/yaml

3.2.84.5. Tags

apiv1

3.2.85. delete a PodTemplate

DELETE /api/v1/namespaces/{namespace}/podtemplates/{name}

3.2.85.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 2.3.48, “v1.DeleteOptions”
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.85.2. Responses

HTTP Code	Description	Schema
200	success	Section 2.3.7, “unversioned.Status”

3.2.85.3. Consumes

/

3.2.85.4. Produces

application/json
application/yaml

3.2.85.5. Tags

apiv1

3.2.86. partially update the specified PodTemplate

PATCH /api/v1/namespaces/{namespace}/podtemplates/{name}

3.2.86.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 2.3.6, “unversioned.Patch”
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.86.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.103, “v1.PodTemplate”

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
application/yaml

3.2.86.5. Tags

apiv1

3.2.87. read the specified PodTemplate

GET /api/v1/namespaces/{namespace}/podtemplates/{name}

3.2.87.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
QueryParameter	export	Should this value be exported. Export strips fields that a user can not specify.	false	boolean
QueryParameter	exact	Should the export be exact. Exact export maintains cluster-specific fields like 'Namespace'	false	boolean
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.87.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.103, “v1.PodTemplate”

3.2.87.3. Consumes

/

3.2.87.4. Produces

application/json
application/yaml

3.2.87.5. Tags

apiv1

3.2.88. create a ReplicationController

POST /api/v1/namespaces/{namespace}/replicationcontrollers

3.2.88.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.108, “v1.ReplicationController”
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	Section 3.3.108, “v1.ReplicationController”

3.2.88.3. Consumes

/

3.2.88.4. Produces

application/json
application/yaml

3.2.88.5. Tags

apiv1

3.2.89. delete collection of ReplicationController

DELETE /api/v1/namespaces/{namespace}/replicationcontrollers

3.2.89.1. Parameters

Type	Name	Description	Required	Schema
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
QueryParameter	timeoutSeconds	Timeout for the list/watch call.	false	integer
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string

3.2.89.2. Responses

HTTP Code	Description	Schema
200	success	Section 2.3.7, “unversioned.Status”

3.2.89.3. Consumes

/

3.2.89.4. Produces

application/json
application/yaml

3.2.89.5. Tags

apiv1

3.2.90. list or watch objects of kind ReplicationController

GET /api/v1/namespaces/{namespace}/replicationcontrollers

3.2.90.1. Parameters

Type	Name	Description	Required	Schema
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
QueryParameter	timeoutSeconds	Timeout for the list/watch call.	false	integer
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string

3.2.90.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.109, “v1.ReplicationControllerList”

3.2.90.3. Consumes

/

3.2.90.4. Produces

application/json
application/yaml

3.2.90.5. Tags

apiv1

3.2.91. replace the specified ReplicationController

PUT /api/v1/namespaces/{namespace}/replicationcontrollers/{name}

3.2.91.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.108, “v1.ReplicationController”
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.91.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.108, “v1.ReplicationController”

3.2.91.3. Consumes

/

3.2.91.4. Produces

application/json
application/yaml

3.2.91.5. Tags

apiv1

3.2.92. delete a ReplicationController

DELETE /api/v1/namespaces/{namespace}/replicationcontrollers/{name}

3.2.92.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 2.3.48, “v1.DeleteOptions”
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.92.2. Responses

HTTP Code	Description	Schema
200	success	Section 2.3.7, “unversioned.Status”

3.2.92.3. Consumes

/

3.2.92.4. Produces

application/json
application/yaml

3.2.92.5. Tags

apiv1

3.2.93. partially update the specified ReplicationController

PATCH /api/v1/namespaces/{namespace}/replicationcontrollers/{name}

3.2.93.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 2.3.6, “unversioned.Patch”
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.93.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.108, “v1.ReplicationController”

3.2.93.3. Consumes

application/json-patch+json
application/merge-patch+json
application/strategic-merge-patch+json

3.2.93.4. Produces

application/json
application/yaml

3.2.93.5. Tags

apiv1

3.2.94. read the specified ReplicationController

GET /api/v1/namespaces/{namespace}/replicationcontrollers/{name}

3.2.94.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
QueryParameter	export	Should this value be exported. Export strips fields that a user can not specify.	false	boolean
QueryParameter	exact	Should the export be exact. Exact export maintains cluster-specific fields like 'Namespace'	false	boolean
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.94.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.108, “v1.ReplicationController”

3.2.94.3. Consumes

/

3.2.94.4. Produces

application/json
application/yaml

3.2.94.5. Tags

apiv1

3.2.95. replace scale of the specified Scale

PUT /api/v1/namespaces/{namespace}/replicationcontrollers/{name}/scale

3.2.95.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.121, “v1.Scale”
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string
PathParameter	name	name of the Scale	true	string

3.2.95.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.121, “v1.Scale”

3.2.95.3. Consumes

/

3.2.95.4. Produces

application/json
application/yaml

3.2.95.5. Tags

apiv1

3.2.96. partially update scale of the specified Scale

PATCH /api/v1/namespaces/{namespace}/replicationcontrollers/{name}/scale

3.2.96.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 2.3.6, “unversioned.Patch”
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string
PathParameter	name	name of the Scale	true	string

3.2.96.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.121, “v1.Scale”

3.2.96.3. Consumes

application/json-patch+json
application/merge-patch+json
application/strategic-merge-patch+json

3.2.96.4. Produces

application/json
application/yaml

3.2.96.5. Tags

apiv1

3.2.97. read scale of the specified Scale

GET /api/v1/namespaces/{namespace}/replicationcontrollers/{name}/scale

3.2.97.1. Parameters

Type	Name	Description	Required	Schema
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 Scale	true	string

3.2.97.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.121, “v1.Scale”

3.2.97.3. Consumes

/

3.2.97.4. Produces

application/json
application/yaml

3.2.97.5. Tags

apiv1

3.2.98. replace status of the specified ReplicationController

PUT /api/v1/namespaces/{namespace}/replicationcontrollers/{name}/status

3.2.98.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.108, “v1.ReplicationController”
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.98.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.108, “v1.ReplicationController”

3.2.98.3. Consumes

/

3.2.98.4. Produces

application/json
application/yaml

3.2.98.5. Tags

apiv1

3.2.99. create a ResourceQuota

POST /api/v1/namespaces/{namespace}/resourcequotas

3.2.99.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.112, “v1.ResourceQuota”
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string

3.2.99.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.112, “v1.ResourceQuota”

3.2.99.3. Consumes

/

3.2.99.4. Produces

application/json
application/yaml

3.2.99.5. Tags

apiv1

3.2.100. delete collection of ResourceQuota

DELETE /api/v1/namespaces/{namespace}/resourcequotas

3.2.100.1. Parameters

Type	Name	Description	Required	Schema
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
QueryParameter	timeoutSeconds	Timeout for the list/watch call.	false	integer
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string

3.2.100.2. Responses

HTTP Code	Description	Schema
200	success	Section 2.3.7, “unversioned.Status”

3.2.100.3. Consumes

/

3.2.100.4. Produces

application/json
application/yaml

3.2.100.5. Tags

apiv1

3.2.101. list or watch objects of kind ResourceQuota

GET /api/v1/namespaces/{namespace}/resourcequotas

3.2.101.1. Parameters

Type	Name	Description	Required	Schema
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
QueryParameter	timeoutSeconds	Timeout for the list/watch call.	false	integer
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string

3.2.101.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.113, “v1.ResourceQuotaList”

3.2.101.3. Consumes

/

3.2.101.4. Produces

application/json
application/yaml

3.2.101.5. Tags

apiv1

3.2.102. replace the specified ResourceQuota

PUT /api/v1/namespaces/{namespace}/resourcequotas/{name}

3.2.102.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.112, “v1.ResourceQuota”
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.102.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.112, “v1.ResourceQuota”

3.2.102.3. Consumes

/

3.2.102.4. Produces

application/json
application/yaml

3.2.102.5. Tags

apiv1

3.2.103. delete a ResourceQuota

DELETE /api/v1/namespaces/{namespace}/resourcequotas/{name}

3.2.103.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 2.3.48, “v1.DeleteOptions”
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.103.2. Responses

HTTP Code	Description	Schema
200	success	Section 2.3.7, “unversioned.Status”

3.2.103.3. Consumes

/

3.2.103.4. Produces

application/json
application/yaml

3.2.103.5. Tags

apiv1

3.2.104. partially update the specified ResourceQuota

PATCH /api/v1/namespaces/{namespace}/resourcequotas/{name}

3.2.104.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 2.3.6, “unversioned.Patch”
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.104.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.112, “v1.ResourceQuota”

3.2.104.3. Consumes

application/json-patch+json
application/merge-patch+json
application/strategic-merge-patch+json

3.2.104.4. Produces

application/json
application/yaml

3.2.104.5. Tags

apiv1

3.2.105. read the specified ResourceQuota

GET /api/v1/namespaces/{namespace}/resourcequotas/{name}

3.2.105.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
QueryParameter	export	Should this value be exported. Export strips fields that a user can not specify.	false	boolean
QueryParameter	exact	Should the export be exact. Exact export maintains cluster-specific fields like 'Namespace'	false	boolean
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.105.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.112, “v1.ResourceQuota”

3.2.105.3. Consumes

/

3.2.105.4. Produces

application/json
application/yaml

3.2.105.5. Tags

apiv1

3.2.106. replace status of the specified ResourceQuota

PUT /api/v1/namespaces/{namespace}/resourcequotas/{name}/status

3.2.106.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.112, “v1.ResourceQuota”
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.106.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.112, “v1.ResourceQuota”

3.2.106.3. Consumes

/

3.2.106.4. Produces

application/json
application/yaml

3.2.106.5. Tags

apiv1

3.2.107. create a Secret

POST /api/v1/namespaces/{namespace}/secrets

3.2.107.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 2.3.171, “v1.Secret”
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string

3.2.107.2. Responses

HTTP Code	Description	Schema
200	success	Section 2.3.171, “v1.Secret”

3.2.107.3. Consumes

/

3.2.107.4. Produces

application/json
application/yaml

3.2.107.5. Tags

apiv1

3.2.108. delete collection of Secret

DELETE /api/v1/namespaces/{namespace}/secrets

3.2.108.1. Parameters

Type	Name	Description	Required	Schema
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
QueryParameter	timeoutSeconds	Timeout for the list/watch call.	false	integer
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string

3.2.108.2. Responses

HTTP Code	Description	Schema
200	success	Section 2.3.7, “unversioned.Status”

3.2.108.3. Consumes

/

3.2.108.4. Produces

application/json
application/yaml

3.2.108.5. Tags

apiv1

3.2.109. list or watch objects of kind Secret

GET /api/v1/namespaces/{namespace}/secrets

3.2.109.1. Parameters

Type	Name	Description	Required	Schema
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
QueryParameter	timeoutSeconds	Timeout for the list/watch call.	false	integer
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string

3.2.109.2. Responses

HTTP Code	Description	Schema
200	success	Section 2.3.174, “v1.SecretList”

3.2.109.3. Consumes

/

3.2.109.4. Produces

application/json
application/yaml

3.2.109.5. Tags

apiv1

3.2.110. replace the specified Secret

PUT /api/v1/namespaces/{namespace}/secrets/{name}

3.2.110.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 2.3.171, “v1.Secret”
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.110.2. Responses

HTTP Code	Description	Schema
200	success	Section 2.3.171, “v1.Secret”

3.2.110.3. Consumes

/

3.2.110.4. Produces

application/json
application/yaml

3.2.110.5. Tags

apiv1

3.2.111. delete a Secret

DELETE /api/v1/namespaces/{namespace}/secrets/{name}

3.2.111.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 2.3.48, “v1.DeleteOptions”
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.111.2. Responses

HTTP Code	Description	Schema
200	success	Section 2.3.7, “unversioned.Status”

3.2.111.3. Consumes

/

3.2.111.4. Produces

application/json
application/yaml

3.2.111.5. Tags

apiv1

3.2.112. partially update the specified Secret

PATCH /api/v1/namespaces/{namespace}/secrets/{name}

3.2.112.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 2.3.6, “unversioned.Patch”
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.112.2. Responses

HTTP Code	Description	Schema
200	success	Section 2.3.171, “v1.Secret”

3.2.112.3. Consumes

application/json-patch+json
application/merge-patch+json
application/strategic-merge-patch+json

3.2.112.4. Produces

application/json
application/yaml

3.2.112.5. Tags

apiv1

3.2.113. read the specified Secret

GET /api/v1/namespaces/{namespace}/secrets/{name}

3.2.113.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
QueryParameter	export	Should this value be exported. Export strips fields that a user can not specify.	false	boolean
QueryParameter	exact	Should the export be exact. Exact export maintains cluster-specific fields like 'Namespace'	false	boolean
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.113.2. Responses

HTTP Code	Description	Schema
200	success	Section 2.3.171, “v1.Secret”

3.2.113.3. Consumes

/

3.2.113.4. Produces

application/json
application/yaml

3.2.113.5. Tags

apiv1

3.2.114. create a ServiceAccount

POST /api/v1/namespaces/{namespace}/serviceaccounts

3.2.114.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.132, “v1.ServiceAccount”
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string

3.2.114.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.132, “v1.ServiceAccount”

3.2.114.3. Consumes

/

3.2.114.4. Produces

application/json
application/yaml

3.2.114.5. Tags

apiv1

3.2.115. delete collection of ServiceAccount

DELETE /api/v1/namespaces/{namespace}/serviceaccounts

3.2.115.1. Parameters

Type	Name	Description	Required	Schema
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
QueryParameter	timeoutSeconds	Timeout for the list/watch call.	false	integer
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string

3.2.115.2. Responses

HTTP Code	Description	Schema
200	success	Section 2.3.7, “unversioned.Status”

3.2.115.3. Consumes

/

3.2.115.4. Produces

application/json
application/yaml

3.2.115.5. Tags

apiv1

3.2.116. list or watch objects of kind ServiceAccount

GET /api/v1/namespaces/{namespace}/serviceaccounts

3.2.116.1. Parameters

Type	Name	Description	Required	Schema
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
QueryParameter	timeoutSeconds	Timeout for the list/watch call.	false	integer
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string

3.2.116.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.133, “v1.ServiceAccountList”

3.2.116.3. Consumes

/

3.2.116.4. Produces

application/json
application/yaml

3.2.116.5. Tags

apiv1

3.2.117. replace the specified ServiceAccount

PUT /api/v1/namespaces/{namespace}/serviceaccounts/{name}

3.2.117.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.132, “v1.ServiceAccount”
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.117.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.132, “v1.ServiceAccount”

3.2.117.3. Consumes

/

3.2.117.4. Produces

application/json
application/yaml

3.2.117.5. Tags

apiv1

3.2.118. delete a ServiceAccount

DELETE /api/v1/namespaces/{namespace}/serviceaccounts/{name}

3.2.118.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 2.3.48, “v1.DeleteOptions”
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.118.2. Responses

HTTP Code	Description	Schema
200	success	Section 2.3.7, “unversioned.Status”

3.2.118.3. Consumes

/

3.2.118.4. Produces

application/json
application/yaml

3.2.118.5. Tags

apiv1

3.2.119. partially update the specified ServiceAccount

PATCH /api/v1/namespaces/{namespace}/serviceaccounts/{name}

3.2.119.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 2.3.6, “unversioned.Patch”
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.119.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.132, “v1.ServiceAccount”

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
application/yaml

3.2.119.5. Tags

apiv1

3.2.120. read the specified ServiceAccount

GET /api/v1/namespaces/{namespace}/serviceaccounts/{name}

3.2.120.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
QueryParameter	export	Should this value be exported. Export strips fields that a user can not specify.	false	boolean
QueryParameter	exact	Should the export be exact. Exact export maintains cluster-specific fields like 'Namespace'	false	boolean
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.120.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.132, “v1.ServiceAccount”

3.2.120.3. Consumes

/

3.2.120.4. Produces

application/json
application/yaml

3.2.120.5. Tags

apiv1

3.2.121. create a Service

POST /api/v1/namespaces/{namespace}/services

3.2.121.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.131, “v1.Service”
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string

3.2.121.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.131, “v1.Service”

3.2.121.3. Consumes

/

3.2.121.4. Produces

application/json
application/yaml

3.2.121.5. Tags

apiv1

3.2.122. list or watch objects of kind Service

GET /api/v1/namespaces/{namespace}/services

3.2.122.1. Parameters

Type	Name	Description	Required	Schema
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
QueryParameter	timeoutSeconds	Timeout for the list/watch call.	false	integer
PathParameter	namespace	object name and auth scope, such as for teams and projects	true	string

3.2.122.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.134, “v1.ServiceList”

3.2.122.3. Consumes

/

3.2.122.4. Produces

application/json
application/yaml

3.2.122.5. Tags

apiv1

3.2.123. replace the specified Service

PUT /api/v1/namespaces/{namespace}/services/{name}

3.2.123.1. Parameters

Type	Name	Description	Required	Schema
QueryParameter	pretty	If 'true', then the output is pretty printed.	false	string
BodyParameter	body		true	Section 3.3.131, “v1.Service”
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.123.2. Responses

HTTP Code	Description	Schema
200	success	Section 3.3.131, “v1.Service”

3.2.123.3. Consumes

/

3.2.123.4. Produces

application/json
application/yaml

3.2.123.5. Tags

apiv1

3.2.124. delete a Service

DELETE /api/v1/namespaces/{namespace}/services/{name}

3.2.124.1. Parameters

Type	Name	Description	Required	Schema
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.124.2. Responses

HTTP Code	Description	Schema
200	success	Section 2.3.7, “unversioned.Status”

3.2.124.3. Consumes

/

3.1. Overview

3.1.1. Version information

3.1.2. URI scheme

3.2. Paths