# Namespace

NamespaceNamespace provides a scope for Names.apiVersion: v1import "k8s.io/api/core/v1"NamespaceNamespace provides a scope for Names. Use of multiple namespaces is optional.apiVersion: v1kind: Namespacemetadata (ObjectMeta)Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadataspec (NamespaceSpec)Spec defines the behavior of the Namespace. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-statusstatus (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-statusNamespaceSpecNamespaceSpec describes the attributes on a Namespace.finalizers ([]string)Atomic: will be replaced during a mergeFinalizers 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/NamespaceStatusNamespaceStatus is information about the current status of a Namespace.conditions ([]NamespaceCondition)Patch strategy: merge on key typeMap: unique values on key type will be kept during a mergeRepresents the latest available observations of a namespace's current state.NamespaceCondition contains details about state of namespace.conditions.status (string), requiredStatus of the condition, one of True, False, Unknown.conditions.type (string), requiredType 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/NamespaceListNamespaceList is a list of Namespaces.apiVersion: v1kind: NamespaceListmetadata (ListMeta)Standard list metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kindsitems ([]Namespace), requiredItems is the list of Namespace objects in the list. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/Operationsget read the specified NamespaceHTTP RequestGET /api/v1/namespaces/{name}Parametersname (in path): string, requiredname of the Namespacepretty (in query): stringprettyResponse200 (Namespace): OK401: Unauthorizedget read status of the specified NamespaceHTTP RequestGET /api/v1/namespaces/{name}/statusParametersname (in path): string, requiredname of the Namespacepretty (in query): stringprettyResponse200 (Namespace): OK401: Unauthorizedlist list or watch objects of kind NamespaceHTTP RequestGET /api/v1/namespacesParametersallowWatchBookmarks (in query): booleanallowWatchBookmarkscontinue (in query): stringcontinuefieldSelector (in query): stringfieldSelectorlabelSelector (in query): stringlabelSelectorlimit (in query): integerlimitpretty (in query): stringprettyresourceVersion (in query): stringresourceVersionresourceVersionMatch (in query): stringresourceVersionMatchsendInitialEvents (in query): booleansendInitialEventstimeoutSeconds (in query): integertimeoutSecondswatch (in query): booleanwatchResponse200 (NamespaceList): OK401: Unauthorizedcreate create a NamespaceHTTP RequestPOST /api/v1/namespacesParametersbody: Namespace, requireddryRun (in query): stringdryRunfieldManager (in query): stringfieldManagerfieldValidation (in query): stringfieldValidationpretty (in query): stringprettyResponse200 (Namespace): OK201 (Namespace): Created202 (Namespace): Accepted401: Unauthorizedupdate replace the specified NamespaceHTTP RequestPUT /api/v1/namespaces/{name}Parametersname (in path): string, requiredname of the Namespacebody: Namespace, requireddryRun (in query): stringdryRunfieldManager (in query): stringfieldManagerfieldValidation (in query): stringfieldValidationpretty (in query): stringprettyResponse200 (Namespace): OK201 (Namespace): Created401: Unauthorizedupdate replace finalize of the specified NamespaceHTTP RequestPUT /api/v1/namespaces/{name}/finalizeParametersname (in path): string, requiredname of the Namespacebody: Namespace, requireddryRun (in query): stringdryRunfieldManager (in query): stringfieldManagerfieldValidation (in query): stringfieldValidationpretty (in query): stringprettyResponse200 (Namespace): OK201 (Namespace): Created401: Unauthorizedupdate replace status of the specified NamespaceHTTP RequestPUT /api/v1/namespaces/{name}/statusParametersname (in path): string, requiredname of the Namespacebody: Namespace, requireddryRun (in query): stringdryRunfieldManager (in query): stringfieldManagerfieldValidation (in query): stringfieldValidationpretty (in query): stringprettyResponse200 (Namespace): OK201 (Namespace): Created401: Unauthorizedpatch partially update the specified NamespaceHTTP RequestPATCH /api/v1/namespaces/{name}Parametersname (in path): string, requiredname of the Namespacebody: Patch, requireddryRun (in query): stringdryRunfieldManager (in query): stringfieldManagerfieldValidation (in query): stringfieldValidationforce (in query): booleanforcepretty (in query): stringprettyResponse200 (Namespace): OK201 (Namespace): Created401: Unauthorizedpatch partially update status of the specified NamespaceHTTP RequestPATCH /api/v1/namespaces/{name}/statusParametersname (in path): string, requiredname of the Namespacebody: Patch, requireddryRun (in query): stringdryRunfieldManager (in query): stringfieldManagerfieldValidation (in query): stringfieldValidationforce (in query): booleanforcepretty (in query): stringprettyResponse200 (Namespace): OK201 (Namespace): Created401: Unauthorizeddelete delete a NamespaceHTTP RequestDELETE /api/v1/namespaces/{name}Parametersname (in path): string, requiredname of the Namespacebody: DeleteOptionsdryRun (in query): stringdryRungracePeriodSeconds (in query): integergracePeriodSecondsignoreStoreReadErrorWithClusterBreakingPotential (in query): booleanignoreStoreReadErrorWithClusterBreakingPotentialpretty (in query): stringprettypropagationPolicy (in query): stringpropagationPolicyResponse200 (Status): OK202 (Status): Accepted401: UnauthorizedThis 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.