--- api_metadata: apiVersion: "v1" import: "k8s.io/api/core/v1" kind: "Namespace" content_type: "api_reference" description: "Namespace 为名字提供作用域。" title: "Namespace" weight: 7 --- `apiVersion: v1` `import "k8s.io/api/core/v1"` ## Namespace {#Namespace} Namespace 为名字提供作用域。使用多个命名空间是可选的。

- **apiVersion**: v1 - **kind**: Namespace - **metadata** (}}">ObjectMeta) 标准的对象元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata - **spec** (}}">NamespaceSpec) `spec` 定义了 Namespace 的行为。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status - **status** (}}">NamespaceStatus) `status` 描述了当前 Namespace 的状态。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status ## NamespaceSpec {#NamespaceSpec} NamespaceSpec 用于描述 Namespace 的属性。

- **finalizers** ([]string) `finalizers` 是一个不透明的值列表，只有此列表为空时才能从存储中永久删除对象。更多信息： https://kubernetes.io/zh-cn/docs/tasks/administer-cluster/namespaces/ **原子性：将在合并期间被替换** ## NamespaceStatus {#NamespaceStatus} NamespaceStatus 表示 Namespace 的当前状态信息。

- **conditions** ([]NamespaceCondition) **补丁策略：基于 `type` 健合并** **Map：键 `type` 的唯一值将在合并期间保留** 表示命名空间当前状态的最新可用状况。 **NamespaceCondition 包含命名空间状态的详细信息。** - **conditions.status** (string)，必需状况（condition）的状态，取值为 `True`、`False` 或 `Unknown` 之一。 - **conditions.type** (string), 必需命名空间控制器状况的类型。 - **conditions.lastTransitionTime** (Time) 最后一次状况状态转换的时间。 **`Time` 是对 `time.Time` 的封装。`Time` 支持对 YAML 和 JSON 进行正确封包。为 `time` 包的许多函数方法提供了封装器。** - **conditions.message** (string) 人类可读的消息，指示上次转换的详细信息。 - **conditions.reason** (string) 唯一、一个单词、驼峰命名的 Condition 转换原因。 - **phase** (string) `phase` 是命名空间的当前生命周期阶段。更多信息： https://kubernetes.io/zh-cn/docs/tasks/administer-cluster/namespaces/ ## NamespaceList {#NamespaceList} NamespaceList 是一个命名空间列表。

- **apiVersion**: v1 - **kind**: NamespaceList - **metadata** (}}">ListMeta) 标准的列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds - **items** ([]}}">Namespace)，必需 `items` 是列表中的 Namespace 对象列表。更多信息： https://kubernetes.io/zh-cn/docs/concepts/overview/working-with-objects/namespaces/ ## 操作 {#Operations}

### `get` 读取指定的 Namespace #### HTTP 请求 GET /api/v1/namespaces/{name} #### 参数 - **name** (**路径参数**)：string，必需 Namespace 的名称。 - **pretty** (**查询参数**)：string }}">pretty #### 响应 200 (}}">Namespace)：OK 401：Unauthorized ### `get` 读取指定 Namespace 的状态 #### HTTP 请求 GET /api/v1/namespaces/{name}/status #### 参数 - **name** (**路径参数**)：string，必需 Namespace 的名称。 - **pretty** (**查询参数**)：string }}">pretty #### 响应 200 (}}">Namespace)：OK 401：Unauthorized ### `list` 列出或者检查类别为 Namespace 的对象 #### HTTP 请求 GET /api/v1/namespaces #### 参数 - **allowWatchBookmarks** (**查询参数**)：boolean }}">allowWatchBookmarks - **continue** (**查询参数**)：string }}">continue - **fieldSelector** (**查询参数**)：string }}">fieldSelector - **labelSelector** (**查询参数**)：string }}">labelSelector - **limit** (**查询参数**)：integer }}">limit - **pretty** (**查询参数**)：string }}">pretty - **resourceVersion** (**查询参数**)：string }}">resourceVersion - **resourceVersionMatch** (**查询参数**)：string }}">resourceVersionMatch - **resourceVersionMatch** (**查询参数**)：string }}">resourceVersionMatch - **shardSelector** (**查询参数**): string }}">shardSelector - **timeoutSeconds** (**查询参数**)：integer }}">timeoutSeconds - **watch** (**查询参数**)：boolean }}">watch #### 响应 200 (}}">NamespaceList)：OK 401：Unauthorized ### `create` 创建一个 Namespace #### HTTP 请求 POST /api/v1/namespaces #### 参数 - **body**: }}">Namespace，必需 - **dryRun** (**查询参数**)：string }}">dryRun - **fieldManager** (**查询参数**)：string }}">fieldManager - **fieldValidation** (**查询参数**)：string }}">fieldValidation - **pretty** (**查询参数**)：string }}">pretty #### 响应 200 (}}">Namespace)：OK 201 (}}">Namespace)：Created 202 (}}">Namespace)：Accepted 401：Unauthorized ### `update` 替换指定的 Namespace #### HTTP 请求 PUT /api/v1/namespaces/{name} #### 参数 - **name** (**路径参数**)：string，必需 Namespace 的名称。 - **body**: }}">Namespace，必需 - **dryRun** (**查询参数**)：string }}">dryRun - **fieldManager** (**查询参数**)：string }}">fieldManager - **fieldValidation** (**查询参数**)：string }}">fieldValidation - **pretty** (**查询参数**)：string }}">pretty #### 响应 200 (}}">Namespace)：OK 201 (}}">Namespace)：Created 401：Unauthorized ### `update` 替换指定 Namespace 的终结器 #### HTTP 请求 PUT /api/v1/namespaces/{name}/finalize #### 参数 - **name** (**路径参数**)：string，必需 Namespace 的名称。 - **body**: }}">Namespace，必需 - **dryRun** (**查询参数**)：string }}">dryRun - **fieldManager** (**查询参数**)：string }}">fieldManager - **fieldValidation** (**查询参数**)：string }}">fieldValidation - **pretty** (**查询参数**)：string }}">pretty #### 响应 200 (}}">Namespace)：OK 201 (}}">Namespace)：Created 401：Unauthorized ### `update` 替换指定 Namespace 的状态 #### HTTP 请求 PUT /api/v1/namespaces/{name}/status #### 参数 - **name** (**路径阐述**)：string，必需 Namespace 的名称。 - **body**: }}">Namespace，必需 - **dryRun** (**查询参数**)：string }}">dryRun - **fieldManager** (**查询参数**)：string }}">fieldManager - **fieldValidation** (**查询参数**)：string }}">fieldValidation - **pretty** (**查询参数**)：string }}">pretty #### 响应 200 (}}">Namespace)：OK 201 (}}">Namespace)：Created 401: Unauthorized ### `patch` 部分更新指定的 Namespace #### HTTP 请求 PATCH /api/v1/namespaces/{name} #### 参数 - **name** (**路径参数**)：string，必需 Namespace 的名称。 - **body**: }}">Patch，必需 - **dryRun** (**查询参数**)：string }}">dryRun - **fieldManager** (**查询参数**)：string }}">fieldManager - **fieldValidation** (**查询参数**)：string }}">fieldValidation - **force** (**查询参数**)：boolean }}">force - **pretty** (**查询参数**): string }}">pretty #### 响应 200 (}}">Namespace)：OK 201 (}}">Namespace)：Created 401: Unauthorized ### `patch` 部分更新指定 Namespace 的状态 #### HTTP 请求 PATCH /api/v1/namespaces/{name}/status #### 参数 - **name** (**路径参数**)：string，必需 Namespace 的名称。 - **body**: }}">Patch，必需 - **dryRun** (**查询参数**)：string }}">dryRun - **fieldManager** (**查询参数**)：string }}">fieldManager - **fieldValidation** (**查询参数**)：string }}">fieldValidation - **force** (**查询参数**): boolean }}">force - **pretty** (**查询参数**)：string }}">pretty #### 响应 200 (}}">Namespace)：OK 201 (}}">Namespace)：Created 401：Unauthorized ### `delete` 删除一个 Namespace #### HTTP 请求 DELETE /api/v1/namespaces/{name} #### 参数 - **name** (**路径参数**)：string，必需 Namespace 的名称。 - **body**: }}">DeleteOptions - **dryRun** (**查询参数**)：string }}">dryRun - **gracePeriodSeconds** (*查询参数*)：integer }}">gracePeriodSeconds - **ignoreStoreReadErrorWithClusterBreakingPotential** (*查询参数*)：boolean }}">ignoreStoreReadErrorWithClusterBreakingPotential - **pretty** (**查询参数**)：string }}">pretty - **propagationPolicy** (**查询参数**)：string }}">propagationPolicy #### 响应 200 (}}">Status)：OK 202 (}}">Status)：Accepted 401：Unauthorized