7.5. Scale [autoscaling/v1]


描述
scale 代表资源的扩展请求。
类型
对象

7.5.1. 规格

Expand
属性类型描述

apiVersion

字符串

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值,并可拒绝未识别的值。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

字符串

kind 是一个字符串值,代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ObjectMeta

标准对象元数据;更多信息 :https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata。

spec

对象

ScaleSpec 描述了 scale 子资源的属性。

status

对象

ScaleStatus 代表 scale 子资源的当前状态。

7.5.1.1. .spec

描述
ScaleSpec 描述了 scale 子资源的属性。
类型
对象
Expand
属性类型描述

replicas

整数

扩展对象所需的实例数量。

7.5.1.2. .status

描述
ScaleStatus 代表 scale 子资源的当前状态。
类型
对象
必填
  • replicas
Expand
属性类型描述

replicas

整数

扩展对象的实际观察实例数量。

selector

字符串

对应当与副本数匹配的 pod 的标签查询。这与标签选择器相同,但采用字符串格式以避免由客户端内省。字符串的格式与 query-param 语法相同。有关标签选择器的更多信息: http://kubernetes.io/docs/user-guide/labels#label-selectors

7.5.2. API 端点

可用的 API 端点如下:

  • /apis/apps/v1/namespaces/{namespace}/deployments/{name}/scale

    • GET :指定 Deployment 的读取扩展
    • PATCH :部分更新指定部署扩展
    • PUT :替换指定部署的规模
  • /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 的缩放
Expand
表 7.107. 全局路径参数
参数类型描述

name

字符串

Scale 的名称

namespace

字符串

对象名称和身份验证范围,如团队和项目

Expand
表 7.108. 全局查询参数
参数类型描述

pretty

字符串

如果 'true',则输出被用户友善。

HTTP 方法
GET
描述
指定部署的读取扩展
Expand
表 7.109. HTTP 响应
HTTP 代码响应正文

200 - OK

扩展模式

401 - Unauthorized

HTTP 方法
PATCH
描述
指定部署的部分更新扩展
Expand
表 7.110. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。应用请求(application/apply-patch)需要此字段,但对于非应用补丁类型(JsonPatch、MergePatch、OptMergePatch)是可选的。

force

布尔值

强制将"强制"应用请求。这意味着用户会重新清空由其他人员拥有的冲突字段。对于非应用补丁请求,必须取消设置 force 标志。

Expand
表 7.111. 主体参数
参数类型描述

正文(body)

Patch 模式

 
Expand
表 7.112. HTTP 响应
HTTP 代码响应正文

200 - OK

扩展模式

201 - Created

扩展模式

401 - Unauthorized

HTTP 方法
PUT
描述
替换指定部署的扩展
Expand
表 7.113. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand
表 7.114. 主体参数
参数类型描述

正文(body)

扩展模式

 
Expand
表 7.115. HTTP 响应
HTTP 代码响应正文

200 - OK

扩展模式

201 - Created

扩展模式

401 - Unauthorized

Expand
表 7.116. 全局路径参数
参数类型描述

name

字符串

Scale 的名称

namespace

字符串

对象名称和身份验证范围,如团队和项目

Expand
表 7.117. 全局查询参数
参数类型描述

pretty

字符串

如果 'true',则输出被用户友善。

HTTP 方法
GET
描述
指定 ReplicaSet 的读取扩展
Expand
表 7.118. HTTP 响应
HTTP 代码响应正文

200 - OK

扩展模式

401 - Unauthorized

HTTP 方法
PATCH
描述
指定 ReplicaSet 的部分更新扩展
Expand
表 7.119. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。应用请求(application/apply-patch)需要此字段,但对于非应用补丁类型(JsonPatch、MergePatch、OptMergePatch)是可选的。

force

布尔值

强制将"强制"应用请求。这意味着用户会重新清空由其他人员拥有的冲突字段。对于非应用补丁请求,必须取消设置 force 标志。

Expand
表 7.120. 主体参数
参数类型描述

正文(body)

Patch 模式

 
Expand
表 7.121. HTTP 响应
HTTP 代码响应正文

200 - OK

扩展模式

201 - Created

扩展模式

401 - Unauthorized

HTTP 方法
PUT
描述
替换指定 ReplicaSet 的扩展
Expand
表 7.122. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand
表 7.123. 主体参数
参数类型描述

正文(body)

扩展模式

 
Expand
表 7.124. HTTP 响应
HTTP 代码响应正文

200 - OK

扩展模式

201 - Created

扩展模式

401 - Unauthorized

Expand
表 7.125. 全局路径参数
参数类型描述

name

字符串

Scale 的名称

namespace

字符串

对象名称和身份验证范围,如团队和项目

Expand
表 7.126. 全局查询参数
参数类型描述

pretty

字符串

如果 'true',则输出被用户友善。

HTTP 方法
GET
描述
指定 StatefulSet 的读取扩展
Expand
表 7.127. HTTP 响应
HTTP 代码响应正文

200 - OK

扩展模式

401 - Unauthorized

HTTP 方法
PATCH
描述
指定 StatefulSet 的部分更新扩展
Expand
表 7.128. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。应用请求(application/apply-patch)需要此字段,但对于非应用补丁类型(JsonPatch、MergePatch、OptMergePatch)是可选的。

force

布尔值

强制将"强制"应用请求。这意味着用户会重新清空由其他人员拥有的冲突字段。对于非应用补丁请求,必须取消设置 force 标志。

Expand
表 7.129. 主体参数
参数类型描述

正文(body)

Patch 模式

 
Expand
表 7.130. HTTP 响应
HTTP 代码响应正文

200 - OK

扩展模式

201 - Created

扩展模式

401 - Unauthorized

HTTP 方法
PUT
描述
替换指定 StatefulSet 的 scale
Expand
表 7.131. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand
表 7.132. 主体参数
参数类型描述

正文(body)

扩展模式

 
Expand
表 7.133. HTTP 响应
HTTP 代码响应正文

200 - OK

扩展模式

201 - Created

扩展模式

401 - Unauthorized

Expand
表 7.134. 全局路径参数
参数类型描述

name

字符串

Scale 的名称

namespace

字符串

对象名称和身份验证范围,如团队和项目

Expand
表 7.135. 全局查询参数
参数类型描述

pretty

字符串

如果 'true',则输出被用户友善。

HTTP 方法
GET
描述
指定 ReplicationController 的读取扩展
Expand
表 7.136. HTTP 响应
HTTP 代码响应正文

200 - OK

扩展模式

401 - Unauthorized

HTTP 方法
PATCH
描述
指定 ReplicationController 的部分更新扩展
Expand
表 7.137. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。应用请求(application/apply-patch)需要此字段,但对于非应用补丁类型(JsonPatch、MergePatch、OptMergePatch)是可选的。

force

布尔值

强制将"强制"应用请求。这意味着用户会重新清空由其他人员拥有的冲突字段。对于非应用补丁请求,必须取消设置 force 标志。

Expand
表 7.138. 主体参数
参数类型描述

正文(body)

Patch 模式

 
Expand
表 7.139. HTTP 响应
HTTP 代码响应正文

200 - OK

扩展模式

201 - Created

扩展模式

401 - Unauthorized

HTTP 方法
PUT
描述
替换指定 ReplicationController 的扩展
Expand
表 7.140. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand
表 7.141. 主体参数
参数类型描述

正文(body)

扩展模式

 
Expand
表 7.142. HTTP 响应
HTTP 代码响应正文

200 - OK

扩展模式

201 - Created

扩展模式

401 - Unauthorized

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat