apiVersion: v1
import "k8s.io/api/core/v1"
Namespace provides a scope for Names. Use of multiple namespaces is optional.
apiVersion: v1
kind: Namespace
metadata (ObjectMeta)
Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
spec (NamespaceSpec)
Spec defines the behavior of the Namespace. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
status (NamespaceStatus)
Status describes the current status of a Namespace. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
NamespaceSpec describes the attributes on a Namespace.
finalizers ([]string)
Atomic: will be replaced during a merge
Finalizers is an opaque list of values that must be empty to permanently remove object from storage. More info: https://kubernetes.io/docs/tasks/administer-cluster/namespaces/
NamespaceStatus is information about the current status of a Namespace.
conditions ([]NamespaceCondition)
Patch strategy: merge on key type
Map: unique values on key type will be kept during a merge
Represents the latest available observations of a namespace's current state.
NamespaceCondition contains details about state of namespace.
conditions.status (string), required
Status of the condition, one of True, False, Unknown.
conditions.type (string), required
Type of namespace controller condition.
conditions.lastTransitionTime (Time)
Last time the condition transitioned from one status to another.
Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.
conditions.message (string)
Human-readable message indicating details about last transition.
conditions.reason (string)
Unique, one-word, CamelCase reason for the condition's last transition.
phase (string)
Phase is the current lifecycle phase of the namespace. More info: https://kubernetes.io/docs/tasks/administer-cluster/namespaces/
Possible enum values:
"Active" means the namespace is available for use in the system"Terminating" means the namespace is undergoing graceful terminationNamespaceList is a list of Namespaces.
apiVersion: v1
kind: NamespaceList
metadata (ListMeta)
Standard list metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
items ([]Namespace), required
Items is the list of Namespace objects in the list. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/
get read the specified NamespaceGET /api/v1/namespaces/{name}
name (in path): string, required
name of the Namespace
pretty (in query): string
200 (Namespace): OK
401: Unauthorized
get read status of the specified NamespaceGET /api/v1/namespaces/{name}/status
name (in path): string, required
name of the Namespace
pretty (in query): string
200 (Namespace): OK
401: Unauthorized
list list or watch objects of kind NamespaceGET /api/v1/namespaces
allowWatchBookmarks (in query): boolean
continue (in query): string
fieldSelector (in query): string
labelSelector (in query): string
limit (in query): integer
pretty (in query): string
resourceVersion (in query): string
resourceVersionMatch (in query): string
sendInitialEvents (in query): boolean
timeoutSeconds (in query): integer
watch (in query): boolean
200 (NamespaceList): OK
401: Unauthorized
create create a NamespacePOST /api/v1/namespaces
body: Namespace, required
dryRun (in query): string
fieldManager (in query): string
fieldValidation (in query): string
pretty (in query): string
200 (Namespace): OK
201 (Namespace): Created
202 (Namespace): Accepted
401: Unauthorized
update replace the specified NamespacePUT /api/v1/namespaces/{name}
name (in path): string, required
name of the Namespace
body: Namespace, required
dryRun (in query): string
fieldManager (in query): string
fieldValidation (in query): string
pretty (in query): string
200 (Namespace): OK
201 (Namespace): Created
401: Unauthorized
update replace finalize of the specified NamespacePUT /api/v1/namespaces/{name}/finalize
name (in path): string, required
name of the Namespace
body: Namespace, required
dryRun (in query): string
fieldManager (in query): string
fieldValidation (in query): string
pretty (in query): string
200 (Namespace): OK
201 (Namespace): Created
401: Unauthorized
update replace status of the specified NamespacePUT /api/v1/namespaces/{name}/status
name (in path): string, required
name of the Namespace
body: Namespace, required
dryRun (in query): string
fieldManager (in query): string
fieldValidation (in query): string
pretty (in query): string
200 (Namespace): OK
201 (Namespace): Created
401: Unauthorized
patch partially update the specified NamespacePATCH /api/v1/namespaces/{name}
name (in path): string, required
name of the Namespace
body: Patch, required
dryRun (in query): string
fieldManager (in query): string
fieldValidation (in query): string
force (in query): boolean
pretty (in query): string
200 (Namespace): OK
201 (Namespace): Created
401: Unauthorized
patch partially update status of the specified NamespacePATCH /api/v1/namespaces/{name}/status
name (in path): string, required
name of the Namespace
body: Patch, required
dryRun (in query): string
fieldManager (in query): string
fieldValidation (in query): string
force (in query): boolean
pretty (in query): string
200 (Namespace): OK
201 (Namespace): Created
401: Unauthorized
delete delete a NamespaceDELETE /api/v1/namespaces/{name}
name (in path): string, required
name of the Namespace
body: DeleteOptions
dryRun (in query): string
gracePeriodSeconds (in query): integer
ignoreStoreReadErrorWithClusterBreakingPotential (in query): boolean
pretty (in query): string
propagationPolicy (in query): string
200 (Status): OK
202 (Status): Accepted
401: Unauthorized
This page is automatically generated.
If you plan to report an issue with this page, mention that the page is auto-generated in your issue description. The fix may need to happen elsewhere in the Kubernetes project.