Namespace
apiVersion: v1
import "k8s.io/api/core/v1"
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 用于描述 Namespace 的属性。
- 
finalizers ([]string)
finalizers 是一个不透明的值列表,只有此列表为空时才能从存储中永久删除对象。 更多信息: https://kubernetes.io/zh-cn/docs/tasks/administer-cluster/namespaces/
原子性:将在合并期间被替换
 
NamespaceStatus
NamespaceStatus 表示 Namespace 的当前状态信息。
- 
conditions ([]NamespaceCondition)
补丁策略:基于
type健合并Map:键
type的唯一值将在合并期间保留表示命名空间当前状态的最新可用状况。
NamespaceCondition 包含命名空间状态的详细信息。
- 
conditions.status (string),必需
状况(condition)的状态,取值为 True、False 或 Unknown 之一。
 
- conditions.type (string), 必需
 
命名空间控制器状况的类型。
 - 
 - 
phase (string)
phase 是命名空间的当前生命周期阶段。更多信息: https://kubernetes.io/zh-cn/docs/tasks/administer-cluster/namespaces/
 
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/
 
操作
get 读取指定的 Namespace
HTTP 请求
GET /api/v1/namespaces/{name}
参数
- 
name (路径参数):string,必需
Namespace 的名称
 - 
pretty (查询参数):string
 
响应
200 (Namespace):OK
401:Unauthorized
get 读取指定 Namespace 的状态
HTTP 请求
GET /api/v1/namespaces/{name}/status
参数
- 
name (路径参数):string,必需
Namespace 的名称
 
- 
pretty (查询参数):string
 
响应
200 (Namespace):OK
401:Unauthorized
list 列出或者检查类别为 Namespace 的对象
HTTP 请求
GET /api/v1/namespaces
参数
- 
allowWatchBookmarks (查询参数):boolean
 
- 
continue (查询参数):string
 
- 
fieldSelector (查询参数):string
 
- 
labelSelector (查询参数):string
 
- 
limit (查询参数):integer
 
- 
pretty (查询参数):string
 
- 
resourceVersion (查询参数):string
 
- 
resourceVersionMatch (查询参数):string
 
- 
resourceVersionMatch (查询参数): string
 
- 
timeoutSeconds (查询参数):integer
 
- 
watch (查询参数):boolean
 
响应
200 (NamespaceList):OK
401:Unauthorized
create 创建一个 Namespace
HTTP 请求
POST /api/v1/namespaces
参数
- body: Namespace,必需
 
- 
dryRun (查询参数):string
 
- 
fieldManager (查询参数):string
 
- 
fieldValidation (查询参数):string
 
- 
pretty (查询参数):string
 
响应
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
 
- 
fieldManager (查询参数):string
 
- 
fieldValidation (查询参数):string
 
- 
pretty (查询参数):string
 
响应
200 (Namespace):OK
201 (Namespace):Created
401:Unauthorized
update 替换指定 Namespace 的终结器
HTTP 请求
PUT /api/v1/namespaces/{name}/finalize
参数
- 
name (路径参数):string,必需
Namespace 的名称
 - 
body: Namespace,必需
 
- 
dryRun (查询参数):string
 
- 
fieldManager (查询参数):string
 
- 
fieldValidation (查询参数):string
 
- 
pretty (查询参数):string
 
响应
200 (Namespace):OK
201 (Namespace):Created
401:Unauthorized
update 替换指定 Namespace 的状态
HTTP 请求
PUT /api/v1/namespaces/{name}/status
参数
- 
name (路径阐述):string,必需
Namespace 的名称
 - 
body: Namespace,必需
 
- 
dryRun (查询参数):string
 
- 
fieldManager (查询参数):string
 
- 
fieldValidation (查询参数):string
 
- 
pretty (查询参数):string
 
响应
200 (Namespace):OK
201 (Namespace):Created
401: Unauthorized
patch 部分更新指定的 Namespace
HTTP 请求
PATCH /api/v1/namespaces/{name}
参数
- 
name (路径参数):string,必需
Namespace 的名称
 
- body: Patch,必需
 
- 
dryRun (查询参数):string
 
- 
fieldManager (查询参数):string
 
- 
fieldValidation (查询参数):string
 
- 
force (查询参数):boolean
 
- 
pretty (查询参数): string
 
响应
200 (Namespace):OK
201 (Namespace):Created
401: Unauthorized
patch 部分更新指定 Namespace 的状态
HTTP 请求
PATCH /api/v1/namespaces/{name}/status
参数
- 
name (路径参数):string,必需
Namespace 的名称
 
- body: Patch,必需
 
- 
dryRun (查询参数):string
 
- 
fieldManager (查询参数):string
 
- 
fieldValidation (查询参数):string
 
- 
force (查询参数): boolean
 
- 
pretty (查询参数):string
 
响应
200 (Namespace):OK
201 (Namespace):Created
401:Unauthorized
delete 删除一个 Namespace
HTTP 请求
DELETE /api/v1/namespaces/{name}
参数
- 
name (路径参数):string,必需
Namespace 的名称
 - 
body: DeleteOptions
 
- 
dryRun (查询参数):string
 
- 
gracePeriodSeconds (查询参数):integer
 
- 
ignoreStoreReadErrorWithClusterBreakingPotential (查询参数):boolean
 
- 
pretty (查询参数):string
 
- 
propagationPolicy (查询参数):string
 
响应
200 (Status):OK
202 (Status):Accepted
401:Unauthorized