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)
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
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.
Possible enum values:
"NamespaceContentRemaining" contains information about resources remaining in a namespace."NamespaceDeletionContentFailure" contains information about namespace deleter errors during deletion of resources."NamespaceDeletionDiscoveryFailure" contains information about namespace deleter errors during resource discovery."NamespaceDeletionGroupVersionParsingFailure" contains information about namespace deleter errors parsing GV for legacy types."NamespaceFinalizersRemaining" contains information about which finalizers are on resources remaining in a namespace.conditions.lastTransitionTime (Time)
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)
conditions.reason (string)
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
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
pretty (in query): string
propagationPolicy (in query): string
200 (Status): OK
202 (Status): Accepted
401: Unauthorized
© 2022 The Kubernetes Authors
Documentation Distributed under CC BY 4.0.
https://kubernetes.io/docs/reference/kubernetes-api/cluster-resources/namespace-v1/