5.2. API 端点

可用的 API 端点如下：

/apis/apps/v1/namespaces/{namespace}/deployments/{name}/scale
- GET ：指定 Deployment 的读取扩展
- PATCH: 部分更新指定部署的扩展
- PUT ：替换指定 Deployment 的扩展
/apis/apps/v1/namespaces/{namespace}/replicasets/{name}/scale
- GET ：指定 ReplicaSet 的读取规模
- PATCH: 部分更新指定 ReplicaSet 的扩展
- PUT ：替换指定 ReplicaSet 的扩展
/apis/apps/v1/namespaces/{namespace}/statefulsets/{name}/scale
- GET ：指定 StatefulSet 的读取扩展
- PATCH: 部分更新指定 StatefulSet 的扩展
- PUT ：替换指定 StatefulSet 的扩展
/api/v1/namespaces/{namespace}/replicationcontrollers/{name}/scale
- GET ：指定 ReplicationController 的读取规模
- PATCH: 部分更新指定 ReplicationController 的扩展
- PUT ：替换指定 ReplicationController 的扩展

5.2.1. /apis/apps/v1/namespaces/{namespace}/deployments/{name}/scale

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

HTTP 方法: GET
描述: 指定部署的读取规模

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

HTTP 方法: PATCH
描述: 部分更新指定部署扩展

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

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

HTTP 方法: PUT
描述: 替换指定 Deployment 的扩展

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

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

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

5.2.2. /apis/apps/v1/namespaces/{namespace}/replicasets/{name}/scale

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

HTTP 方法: GET
描述: 指定 ReplicaSet 的读取规模

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

HTTP 方法: PATCH
描述: 部分更新指定 ReplicaSet 扩展

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

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

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

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

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

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

5.2.3. /apis/apps/v1/namespaces/{namespace}/statefulsets/{name}/scale

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

HTTP 方法: GET
描述: 指定 StatefulSet 的读取扩展

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

HTTP 方法: PATCH
描述: 部分更新指定 StatefulSet 的扩展

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

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

HTTP 方法: PUT
描述: 替换指定 StatefulSet 的扩展

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

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

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

5.2.4. /api/v1/namespaces/{namespace}/replicationcontrollers/{name}/scale

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

HTTP 方法: GET
描述: 指定 ReplicationController 的读取扩展

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

HTTP 方法: PATCH
描述: 部分更新指定 ReplicationController 的扩展

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

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

HTTP 方法: PUT
描述: 替换指定 ReplicationController 的扩展

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

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

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

5.2. API 端点

5.2.1. /apis/apps/v1/namespaces/{namespace}/deployments/{name}/scale

5.2.2. /apis/apps/v1/namespaces/{namespace}/replicasets/{name}/scale

5.2.3. /apis/apps/v1/namespaces/{namespace}/statefulsets/{name}/scale

5.2.4. /api/v1/namespaces/{namespace}/replicationcontrollers/{name}/scale

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Red Hat legal and privacy links

Red Hat legal and privacy links