23.2. API 端点

可用的 API 端点如下：

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

23.2.1. /api/v1/services

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

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

23.2.2. /api/v1/watch/services

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

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

23.2.3. /api/v1/namespaces/{namespace}/services

HTTP 方法: DELETE
描述: 删除服务集合

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

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

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

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

HTTP 方法: POST
描述: 创建服务

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

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

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

23.2.4. /api/v1/watch/namespaces/{namespace}/services

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

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

23.2.5. /api/v1/namespaces/{namespace}/services/{name}

表 23.10. 全局路径参数
参数	类型	描述
`name`	`字符串`	Service 的名称

HTTP 方法: DELETE
描述: 删除服务

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

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

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

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

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

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

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

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

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

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

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

23.2.6. /api/v1/watch/namespaces/{namespace}/services/{name}

表 23.19. 全局路径参数
参数	类型	描述
`name`	`字符串`	Service 的名称

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

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

23.2.7. /api/v1/namespaces/{namespace}/services/{name}/status

表 23.21. 全局路径参数
参数	类型	描述
`name`	`字符串`	Service 的名称

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

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

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

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

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

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

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

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

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

23.2. API 端点

23.2.1. /api/v1/services

23.2.2. /api/v1/watch/services

23.2.3. /api/v1/namespaces/{namespace}/services

23.2.4. /api/v1/watch/namespaces/{namespace}/services

23.2.5. /api/v1/namespaces/{namespace}/services/{name}

23.2.6. /api/v1/watch/namespaces/{namespace}/services/{name}

23.2.7. /api/v1/namespaces/{namespace}/services/{name}/status

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Red Hat legal and privacy links

Red Hat legal and privacy links