14.2. API 端点

可用的 API 端点如下：

/api/v1/pods
- GET: 列出或监视类型为 Pod 的对象
/api/v1/watch/pods
- GET: 观察单个对 Pod 列表的更改。已弃用：改为使用 'watch' 参数及列表操作。
/api/v1/namespaces/{namespace}/pods
- DELETE: 删除 Pod 集合
- GET: 列出或监视类型为 Pod 的对象
- POST ：创建 Pod
/api/v1/watch/namespaces/{namespace}/pods
- GET: 观察单个对 Pod 列表的更改。已弃用：改为使用 'watch' 参数及列表操作。
/api/v1/namespaces/{namespace}/pods/{name}
- DELETE ：删除 Pod
- GET ：读取指定的 Pod
- PATCH: 部分更新指定的 Pod
- PUT ：替换指定的 Pod
/api/v1/namespaces/{namespace}/pods/{name}/log
- GET ：读取指定 Pod 的日志
/api/v1/watch/namespaces/{namespace}/pods/{name}
- GET: 观察对类型为 Pod 的对象的更改。已弃用：使用带有 list 操作的 'watch' 参数，而是过滤到带有 'fieldSelector' 参数的单个项目。
/api/v1/namespaces/{namespace}/pods/{name}/status
- GET ：指定 Pod 的读取状态
- PATCH: 部分更新指定 Pod 的状态
- PUT ：替换指定 Pod 的状态
/api/v1/namespaces/{namespace}/pods/{name}/ephemeralcontainers
- GET ：读取指定 Pod 的临时containers
- PATCH: 部分更新指定 Pod 的临时容器
- PUT ：替换指定 Pod 的 ephemeralcontainers

14.2.1. /api/v1/pods

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

表 14.1. HTTP 响应
HTTP 代码	响应正文
200 - OK	`PodList` 模式
401 - 未授权	空

14.2.2. /api/v1/watch/pods

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

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

14.2.3. /api/v1/namespaces/{namespace}/pods

HTTP 方法: DELETE
描述: 删除 Pod 集合

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

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

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

表 14.5. HTTP 响应
HTTP 代码	响应正文
200 - OK	`PodList` 模式
401 - 未授权	空

HTTP 方法: POST
描述: 创建 Pod

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

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

表 14.8. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Pod` 模式
201 - Created	`Pod` 模式
202 - Accepted	`Pod` 模式
401 - 未授权	空

14.2.4. /api/v1/watch/namespaces/{namespace}/pods

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

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

14.2.5. /api/v1/namespaces/{namespace}/pods/{name}

表 14.10. 全局路径参数
参数	类型	描述
`name`	`string`	Pod 的名称

HTTP 方法: DELETE
描述: 删除 Pod

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

表 14.12. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Pod` 模式
202 - Accepted	`Pod` 模式
401 - 未授权	空

HTTP 方法: GET
描述: 读取指定的 Pod

表 14.13. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Pod` 模式
401 - 未授权	空

HTTP 方法: PATCH
描述: 部分更新指定的 Pod

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

表 14.15. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Pod` 模式
201 - Created	`Pod` 模式
401 - 未授权	空

HTTP 方法: PUT
描述: 替换指定的 Pod

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

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

表 14.18. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Pod` 模式
201 - Created	`Pod` 模式
401 - 未授权	空

14.2.6. /api/v1/namespaces/{namespace}/pods/{name}/log

表 14.19. 全局路径参数
参数	类型	描述
`name`	`string`	Pod 的名称

HTTP 方法: GET
描述: 读取指定 Pod 的日志

表 14.20. HTTP 响应
HTTP 代码	响应正文
200 - OK	`string`
401 - 未授权	空

14.2.7. /api/v1/watch/namespaces/{namespace}/pods/{name}

表 14.21. 全局路径参数
参数	类型	描述
`name`	`string`	Pod 的名称

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

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

14.2.8. /api/v1/namespaces/{namespace}/pods/{name}/status

表 14.23. 全局路径参数
参数	类型	描述
`name`	`string`	Pod 的名称

HTTP 方法: GET
描述: 指定 Pod 的读取状态

表 14.24. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Pod` 模式
401 - 未授权	空

HTTP 方法: PATCH
描述: 部分更新指定 Pod 的状态

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

表 14.26. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Pod` 模式
201 - Created	`Pod` 模式
401 - 未授权	空

HTTP 方法: PUT
描述: 替换指定 Pod 的状态

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

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

表 14.29. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Pod` 模式
201 - Created	`Pod` 模式
401 - 未授权	空

14.2.9. /api/v1/namespaces/{namespace}/pods/{name}/ephemeralcontainers

表 14.30. 全局路径参数
参数	类型	描述
`name`	`string`	Pod 的名称

HTTP 方法: GET
描述: 读取指定 Pod 的 ephemeralcontainers

表 14.31. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Pod` 模式
401 - 未授权	空

HTTP 方法: PATCH
描述: 部分更新指定 Pod 的 ephemeralcontainers

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

表 14.33. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Pod` 模式
201 - Created	`Pod` 模式
401 - 未授权	空

HTTP 方法: PUT
描述: 替换指定 Pod 的 ephemeralcontainers

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

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

表 14.36. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Pod` 模式
201 - Created	`Pod` 模式
401 - 未授权	空

14.2. API 端点

14.2.1. /api/v1/pods

14.2.2. /api/v1/watch/pods

14.2.3. /api/v1/namespaces/{namespace}/pods

14.2.4. /api/v1/watch/namespaces/{namespace}/pods

14.2.5. /api/v1/namespaces/{namespace}/pods/{name}

14.2.6. /api/v1/namespaces/{namespace}/pods/{name}/log

14.2.7. /api/v1/watch/namespaces/{namespace}/pods/{name}

14.2.8. /api/v1/namespaces/{namespace}/pods/{name}/status

14.2.9. /api/v1/namespaces/{namespace}/pods/{name}/ephemeralcontainers

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Red Hat legal and privacy links

Red Hat legal and privacy links