Namespace

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 ()

  Standard object’s metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

• spec ()

  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 ()

  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.

  • 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/

NamespaceList is a list of Namespaces.

• apiVersion: v1

• kind: NamespaceList

• metadata (ListMeta)

  Standard list metadata. More info:

• items ([]Namespace), required

  Items is the list of Namespace objects in the list. More info:

HTTP Request

GET /api/v1/namespaces/{name}

Parameters

• name (in path): string, required

  name of the Namespace

• pretty (in query): string

  pretty

Response

200 (Namespace): OK

401: Unauthorized

read status of the specified Namespace

HTTP Request

GET /api/v1/namespaces/{name}/status

Parameters

• name (in path): string, required

  name of the Namespace

• pretty (in query): string

  pretty

Response

200 (Namespace): OK

401: Unauthorized

list list or watch objects of kind Namespace

HTTP Request

GET /api/v1/namespaces

Parameters

• allowWatchBookmarks (in query): boolean

  allowWatchBookmarks

• continue (in query): string

• fieldSelector (in query): string

  fieldSelector

• labelSelector (in query): string

• limit

• pretty (in query): string

• resourceVersion (in query): string

  resourceVersion

• resourceVersionMatch (in query): string

• timeoutSeconds (in query): integer

  timeoutSeconds

• watch (in query): boolean

Response

200 (): OK

401: Unauthorized

HTTP Request

POST /api/v1/namespaces

Parameters

• body: , required

• dryRun (in query): string

  dryRun

• fieldManager (in query): string

• pretty (in query): string

  pretty

Response

200 (Namespace): OK

201 (): Created

202 (Namespace): Accepted

401: Unauthorized

update replace the specified Namespace

HTTP Request

PUT /api/v1/namespaces/{name}

Parameters

• name (in path): string, required

  name of the Namespace

• body: Namespace, required

• dryRun (in query): string

• fieldManager (in query): string

  fieldManager

• fieldValidation (in query): string

• pretty (in query): string

  pretty

Response

200 (Namespace): OK

201 (): Created

401: Unauthorized

update replace finalize of the specified Namespace

HTTP Request

PUT /api/v1/namespaces/{name}/finalize

Parameters

• name (in path): string, required

  name of the Namespace

• body: , required

• dryRun (in query): string

  dryRun

• fieldManager (in query): string

• fieldValidation (in query): string

  fieldValidation

• pretty (in query): string

Response

200 (): OK

201 (Namespace): Created

401: Unauthorized

HTTP Request

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

Parameters

• name (in path): string, required

• body: Namespace, required

• dryRun (in query): string

• fieldManager (in query): string

  fieldManager

• fieldValidation (in query): string

• pretty (in query): string

  pretty

Response

200 (Namespace): OK

201 (): Created

401: Unauthorized

patch partially update the specified Namespace

HTTP Request

PATCH /api/v1/namespaces/{name}

Parameters

• name (in path): string, required

  name of the Namespace

• body: , required

• dryRun (in query): string

  dryRun

• fieldManager (in query): string

• fieldValidation (in query): string

  fieldValidation

• force (in query): boolean

• pretty (in query): string

  pretty

Response

200 (Namespace): OK

201 (): Created

401: Unauthorized

partially update status of the specified Namespace

HTTP Request

PATCH /api/v1/namespaces/{name}/status

Parameters

• name (in path): string, required

  name of the Namespace

• body: , required

• dryRun (in query): string

  dryRun

• fieldManager (in query): string

• fieldValidation (in query): string

  fieldValidation

• force (in query): boolean

• pretty (in query): string

  pretty

Response

200 (Namespace): OK

201 (): Created

401: Unauthorized

HTTP Request

DELETE /api/v1/namespaces/{name}

Parameters

• name (in path): string, required

  name of the Namespace

• body:

• dryRun (in query): string

  dryRun

• gracePeriodSeconds (in query): integer

• pretty (in query): string

  pretty

• propagationPolicy (in query): string

Response

200 (): OK

401: Unauthorized