10.2. API 端点

可用的 API 端点如下：

/api/v1/namespaces
- GET: 列出或监视类型为 Namespace 的对象
- POST ：创建一个命名空间
/api/v1/watch/namespaces
- GET: 观察单个对 Namespace 列表的更改。已弃用：使用带有 list 操作的 'watch' 参数。
/api/v1/namespaces/{name}
- DELETE ：删除命名空间
- GET ：读取指定的命名空间
- PATCH: 部分更新指定的命名空间
- PUT ：替换指定的命名空间
/api/v1/watch/namespaces/{name}
- GET: 观察对类型为 Namespace 的对象的更改。已弃用：使用带有 list 操作的 'watch' 参数，而是过滤到带有 'fieldSelector' 参数的单个项目。
/api/v1/namespaces/{name}/status
- GET ：指定命名空间的读取状态
- PATCH: 部分更新指定命名空间的状态
- PUT ：替换指定命名空间的状态
/api/v1/namespaces/{name}/finalize
- PUT ：替换指定命名空间的顺序

10.2.1. /api/v1/namespaces

HTTP 方法: GET
描述: 列出或监视类型为 Namespace 的对象

表 10.1. HTTP 响应
HTTP 代码	响应正文
200 - OK	`NamespaceList` 模式
401 - Unauthorized	空

HTTP 方法: POST
描述: 创建一个命名空间

表 10.2. 查询参数
参数	类型	描述
`dryRun`	`字符串`	出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理
`fieldValidation`	`string`	fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。

表 10.3. 主体参数
参数	类型	描述
`正文（body）`	`Namespace` 模式

表 10.4. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Namespace` 模式
201 - Created	`Namespace` 模式
202 - Accepted	`Namespace` 模式
401 - Unauthorized	空

10.2.2. /api/v1/watch/namespaces

HTTP 方法: GET
描述: 观察单个对 Namespace 列表的更改。已弃用：使用带有列表操作的 'watch' 参数。

表 10.5. HTTP 响应
HTTP 代码	响应正文
200 - OK	`WatchEvent` 模式
401 - Unauthorized	空

10.2.3. /api/v1/namespaces/{name}

表 10.6. 全局路径参数
参数	类型	描述
`name`	`字符串`	命名空间的名称

HTTP 方法: DELETE
描述: 删除命名空间

表 10.7. 查询参数
参数	类型	描述
`dryRun`	`字符串`	出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理

表 10.8. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Status` 模式
202 - Accepted	`Status` 模式
401 - Unauthorized	空

HTTP 方法: GET
描述: 读取指定的命名空间

表 10.9. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Namespace` 模式
401 - Unauthorized	空

HTTP 方法: PATCH
描述: 部分更新指定的命名空间

表 10.10. 查询参数
参数	类型	描述
`dryRun`	`字符串`	出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理
`fieldValidation`	`string`	fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。

表 10.11. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Namespace` 模式
201 - Created	`Namespace` 模式
401 - Unauthorized	空

HTTP 方法: PUT
描述: 替换指定的命名空间

表 10.12. 查询参数
参数	类型	描述
`dryRun`	`字符串`	出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理
`fieldValidation`	`string`	fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。

表 10.13. 主体参数
参数	类型	描述
`正文（body）`	`Namespace` 模式

表 10.14. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Namespace` 模式
201 - Created	`Namespace` 模式
401 - Unauthorized	空

10.2.4. /api/v1/watch/namespaces/{name}

表 10.15. 全局路径参数
参数	类型	描述
`name`	`字符串`	命名空间的名称

HTTP 方法: GET
描述: 观察对类型为 Namespace 的对象的更改。已弃用：使用带有列表操作的 'watch' 参数，而是过滤为带有 'fieldSelector' 参数的单个项目。

表 10.16. HTTP 响应
HTTP 代码	响应正文
200 - OK	`WatchEvent` 模式
401 - Unauthorized	空

10.2.5. /api/v1/namespaces/{name}/status

表 10.17. 全局路径参数
参数	类型	描述
`name`	`字符串`	命名空间的名称

HTTP 方法: GET
描述: 指定命名空间的读取状态

表 10.18. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Namespace` 模式
401 - Unauthorized	空

HTTP 方法: PATCH
描述: 部分更新指定命名空间的状态

表 10.19. 查询参数
参数	类型	描述
`dryRun`	`字符串`	出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理
`fieldValidation`	`string`	fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。

表 10.20. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Namespace` 模式
201 - Created	`Namespace` 模式
401 - Unauthorized	空

HTTP 方法: PUT
描述: 替换指定命名空间的状态

表 10.21. 查询参数
参数	类型	描述
`dryRun`	`字符串`	出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理
`fieldValidation`	`string`	fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。

表 10.22. 主体参数
参数	类型	描述
`正文（body）`	`Namespace` 模式

表 10.23. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Namespace` 模式
201 - Created	`Namespace` 模式
401 - Unauthorized	空

10.2.6. /api/v1/namespaces/{name}/finalize

表 10.24. 全局路径参数
参数	类型	描述
`name`	`字符串`	命名空间的名称

表 10.25. 全局查询参数
参数	类型	描述
`dryRun`	`字符串`	出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理
`fieldValidation`	`string`	fieldValidation 指示服务器如何处理包含了未知或重复字段的请求 (POST/PUT/PATCH) 中的对象。有效值为： - Ignore ：忽略从对象中静默丢弃的未知字段，并将忽略所有除最后一个重复字段以外的所有字段。这是 v1.23 版本之前的默认行为- Warn: 这会通过标准的警告响应头为从对象丢弃的每个未知字段以及遇到的每个重复字段，发送警告。如果没有其他错误，请求仍会成功，且只保留重复字段的最后一个。这是 v1.23+ 的的默认行为 - Strict: 如果从对象中删除了任何未知字段，或者存在任何重复字段，请求将失败并带有 BadRequest 错误。从服务器返回的错误将包含遇到的，以及重复的字段。

HTTP 方法: PUT
描述: 替换指定命名空间完成

表 10.26. 主体参数
参数	类型	描述
`正文（body）`	`Namespace` 模式

表 10.27. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Namespace` 模式
201 - Created	`Namespace` 模式
401 - Unauthorized	空

10.2. API 端点

10.2.1. /api/v1/namespaces

10.2.2. /api/v1/watch/namespaces

10.2.3. /api/v1/namespaces/{name}

10.2.4. /api/v1/watch/namespaces/{name}

10.2.5. /api/v1/namespaces/{name}/status

10.2.6. /api/v1/namespaces/{name}/finalize

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Red Hat legal and privacy links

Red Hat legal and privacy links