OpenShift 文档正在迁移，不久后将仅在 docs.redhat.com（所有 Red Hat 产品文档的所在地）提供。立即体验 新的文档体验。
  1. 文档
    2. history bug_report picture_as_pdf
×

ClusterResourceQuota [quota.openshift.io/v1]

描述

ClusterResourceQuota 镜像了集群范围内的 ResourceQuota。此对象易于转换为合成的 ResourceQuota 对象，以允许配额评估的重复使用。兼容性级别 1：在主要版本中稳定至少 12 个月或 3 个次要版本（以较长者为准）。

类型

对象

必需

  • 元数据

  • spec

规范

属性 类型 描述

apiVersion

字符串

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

kind

字符串

Kind 是一个字符串值，表示此对象表示的 REST 资源。服务器可以从客户端提交请求的端点推断出这一点。不能更新。采用驼峰式大小写。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

元数据

ObjectMeta

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

spec

对象

Spec 定义了所需的配额

status

对象

Status 定义了实际强制执行的配额及其当前使用情况

.spec

描述

Spec 定义了所需的配额

类型

对象

必需

  • quota

  • selector

属性 类型 描述

quota

对象

Quota 定义了所需的配额

selector

对象

Selector 是用于匹配项目的 selector。它应该只选择数十个活跃项目（尽管它可以选择更多不活跃的项目）。这些项目将通过此资源争夺对象的创建。

.spec.quota

描述

Quota 定义了所需的配额

类型

对象

属性 类型 描述

hard

整数或字符串

hard 是每个命名资源的一组所需的硬性限制。更多信息：https://kubernetes.ac.cn/docs/concepts/policy/resource-quotas/

scopeSelector

对象

scopeSelector也是一个过滤器集合，类似于作用域，必须与配额跟踪的每个对象匹配，但使用ScopeSelectorOperator结合可能的值来表达。要使资源匹配，必须同时匹配作用域和scopeSelector（如果在spec中指定）。

scopes

数组 (字符串)

必须与配额跟踪的每个对象匹配的过滤器集合。如果未指定，则配额匹配所有对象。

.spec.quota.scopeSelector

描述

scopeSelector也是一个过滤器集合，类似于作用域，必须与配额跟踪的每个对象匹配，但使用ScopeSelectorOperator结合可能的值来表达。要使资源匹配，必须同时匹配作用域和scopeSelector（如果在spec中指定）。

类型

对象

属性 类型 描述

matchExpressions

数组

按资源的作用域列出作用域选择器要求。

matchExpressions[]

对象

作用域资源选择器要求是一个选择器，包含值、作用域名称和一个关联作用域名称和值的操作符。

.spec.quota.scopeSelector.matchExpressions

描述

按资源的作用域列出作用域选择器要求。

类型

数组

.spec.quota.scopeSelector.matchExpressions[]

描述

作用域资源选择器要求是一个选择器，包含值、作用域名称和一个关联作用域名称和值的操作符。

类型

对象

必需

  • operator

  • scopeName

属性 类型 描述

operator

字符串

表示作用域与一组值的关系。有效操作符为In、NotIn、Exists、DoesNotExist。

scopeName

字符串

选择器应用到的作用域名称。

values

数组 (字符串)

字符串值数组。如果操作符为In或NotIn，则values数组必须非空。如果操作符为Exists或DoesNotExist，则values数组必须为空。此数组在策略性合并补丁期间会被替换。

.spec.selector

描述

Selector 是用于匹配项目的 selector。它应该只选择数十个活跃项目（尽管它可以选择更多不活跃的项目）。这些项目将通过此资源争夺对象的创建。

类型

对象

属性 类型 描述

annotations

未定义 (字符串)

AnnotationSelector用于通过注释选择项目。

labels

``

LabelSelector用于通过标签选择项目。

.status

描述

Status 定义了实际强制执行的配额及其当前使用情况

类型

对象

必需

  • total

属性 类型 描述

namespaces

``

Namespaces按项目划分使用情况。这种划分允许在单个项目内快速解决删除协调，而无需在所有项目中重新计算。这可以用于提取给定项目的增量。

total

对象

Total定义了实际强制执行的配额及其在所有项目中的当前使用情况

.status.total

描述

Total定义了实际强制执行的配额及其在所有项目中的当前使用情况

类型

对象

属性 类型 描述

hard

整数或字符串

Hard是为每个命名资源设置的一组强制硬限制。更多信息：https://kubernetes.ac.cn/docs/concepts/policy/resource-quotas/

used

整数或字符串

Used是命名空间中资源当前观察到的总使用量。

API 端点

提供以下API端点

  • /apis/quota.openshift.io/v1/clusterresourcequotas

    • DELETE: 删除ClusterResourceQuota集合

    • GET: 列出ClusterResourceQuota类型的对象

    • POST: 创建一个ClusterResourceQuota

  • /apis/quota.openshift.io/v1/watch/clusterresourcequotas

    • GET: 监视ClusterResourceQuota列表的单个更改。已弃用：改为使用列表操作中的“watch”参数。

  • /apis/quota.openshift.io/v1/clusterresourcequotas/{name}

    • DELETE: 删除一个ClusterResourceQuota

    • GET: 读取指定的ClusterResourceQuota

    • PATCH: 部分更新指定的ClusterResourceQuota

    • PUT: 替换指定的ClusterResourceQuota

  • /apis/quota.openshift.io/v1/watch/clusterresourcequotas/{name}

    • GET: 监视ClusterResourceQuota类型对象的更改。已弃用：改为使用列表操作中的“watch”参数，并使用“fieldSelector”参数过滤为单个项目。

  • /apis/quota.openshift.io/v1/clusterresourcequotas/{name}/status

    • GET: 读取指定的ClusterResourceQuota的状态

    • PATCH: 部分更新指定的ClusterResourceQuota的状态

    • PUT: 替换指定的ClusterResourceQuota的状态

/apis/quota.openshift.io/v1/clusterresourcequotas

HTTP 方法

DELETE

描述

删除ClusterResourceQuota集合

表1. HTTP响应
HTTP 代码 响应体

200 - OK

Status模式

401 - Unauthorized

空
HTTP 方法

GET

描述

列出ClusterResourceQuota类型的对象

表2. HTTP响应
HTTP 代码 响应体

200 - OK

ClusterResourceQuotaList模式

401 - Unauthorized

空
HTTP 方法

POST

描述

创建一个ClusterResourceQuota

表3. 查询参数
参数 类型 描述

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的dryRun指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有dry run阶段

fieldValidation

字符串

fieldValidation指示服务器如何处理请求(POST/PUT/PATCH)中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略对象中静默删除的任何未知字段，并将忽略解码器遇到的所有重复字段中的最后一个字段。这是v1.23之前默认的行为。- Warn：对于对象中每个被删除的未知字段，以及遇到的每个重复字段，这将通过标准警告响应标头发送警告。如果没有任何其他错误，请求仍然会成功，并且只持久化任何重复字段的最后一个。这是v1.23+中的默认值- Strict：如果任何未知字段将从对象中删除，或者存在任何重复字段，这将导致请求失败并出现BadRequest错误。服务器返回的错误将包含遇到的所有未知和重复字段。
表4. 请求体参数
参数 类型 描述

body

ClusterResourceQuota模式
表5. HTTP响应
HTTP 代码 响应体

200 - OK

ClusterResourceQuota模式

201 - Created

ClusterResourceQuota模式

202 - Accepted

ClusterResourceQuota模式

401 - Unauthorized

空

/apis/quota.openshift.io/v1/watch/clusterresourcequotas

HTTP 方法

GET

描述

监视ClusterResourceQuota列表的单个更改。已弃用：改为使用列表操作中的“watch”参数。

表6. HTTP响应
HTTP 代码 响应体

200 - OK

WatchEvent模式

401 - Unauthorized

空

/apis/quota.openshift.io/v1/clusterresourcequotas/{name}

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

name

字符串

ClusterResourceQuota的名称
HTTP 方法

DELETE

描述

删除一个ClusterResourceQuota

表8. 查询参数
参数 类型 描述

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的dryRun指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有dry run阶段
表9. HTTP响应
HTTP 代码 响应体

200 - OK

Status模式

202 - Accepted

Status模式

401 - Unauthorized

空
HTTP 方法

GET

描述

读取指定的ClusterResourceQuota

表10. HTTP响应
HTTP 代码 响应体

200 - OK

ClusterResourceQuota模式

401 - Unauthorized

空
HTTP 方法

PATCH

描述

部分更新指定的ClusterResourceQuota

表11. 查询参数
参数 类型 描述

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的dryRun指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有dry run阶段

fieldValidation

字符串

fieldValidation指示服务器如何处理请求(POST/PUT/PATCH)中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略对象中静默删除的任何未知字段，并将忽略解码器遇到的所有重复字段中的最后一个字段。这是v1.23之前默认的行为。- Warn：对于对象中每个被删除的未知字段，以及遇到的每个重复字段，这将通过标准警告响应标头发送警告。如果没有任何其他错误，请求仍然会成功，并且只持久化任何重复字段的最后一个。这是v1.23+中的默认值- Strict：如果任何未知字段将从对象中删除，或者存在任何重复字段，这将导致请求失败并出现BadRequest错误。服务器返回的错误将包含遇到的所有未知和重复字段。
表12. HTTP响应
HTTP 代码 响应体

200 - OK

ClusterResourceQuota模式

401 - Unauthorized

空
HTTP 方法

PUT

描述

替换指定的ClusterResourceQuota

表13. 查询参数
参数 类型 描述

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的dryRun指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有dry run阶段

fieldValidation

字符串

fieldValidation指示服务器如何处理请求(POST/PUT/PATCH)中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略对象中静默删除的任何未知字段，并将忽略解码器遇到的所有重复字段中的最后一个字段。这是v1.23之前默认的行为。- Warn：对于对象中每个被删除的未知字段，以及遇到的每个重复字段，这将通过标准警告响应标头发送警告。如果没有任何其他错误，请求仍然会成功，并且只持久化任何重复字段的最后一个。这是v1.23+中的默认值- Strict：如果任何未知字段将从对象中删除，或者存在任何重复字段，这将导致请求失败并出现BadRequest错误。服务器返回的错误将包含遇到的所有未知和重复字段。
表14. 请求体参数
参数 类型 描述

body

ClusterResourceQuota模式
表15. HTTP响应
HTTP 代码 响应体

200 - OK

ClusterResourceQuota模式

201 - Created

ClusterResourceQuota模式

401 - Unauthorized

空

/apis/quota.openshift.io/v1/watch/clusterresourcequotas/{name}

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

name

字符串

ClusterResourceQuota的名称
HTTP 方法

GET

描述

监视ClusterResourceQuota类型对象的更改。已弃用：改为使用列表操作中的“watch”参数，并使用“fieldSelector”参数过滤为单个项目。

表17. HTTP响应
HTTP 代码 响应体

200 - OK

WatchEvent模式

401 - Unauthorized

空

/apis/quota.openshift.io/v1/clusterresourcequotas/{name}/status

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

name

字符串

ClusterResourceQuota的名称
HTTP 方法

GET

描述

读取指定的ClusterResourceQuota的状态

表19. HTTP响应
HTTP 代码 响应体

200 - OK

ClusterResourceQuota模式

401 - Unauthorized

空
HTTP 方法

PATCH

描述

部分更新指定的ClusterResourceQuota的状态

表20. 查询参数
参数 类型 描述

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的dryRun指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有dry run阶段

fieldValidation

字符串

fieldValidation指示服务器如何处理请求(POST/PUT/PATCH)中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略对象中静默删除的任何未知字段，并将忽略解码器遇到的所有重复字段中的最后一个字段。这是v1.23之前默认的行为。- Warn：对于对象中每个被删除的未知字段，以及遇到的每个重复字段，这将通过标准警告响应标头发送警告。如果没有任何其他错误，请求仍然会成功，并且只持久化任何重复字段的最后一个。这是v1.23+中的默认值- Strict：如果任何未知字段将从对象中删除，或者存在任何重复字段，这将导致请求失败并出现BadRequest错误。服务器返回的错误将包含遇到的所有未知和重复字段。
表21. HTTP响应
HTTP 代码 响应体

200 - OK

ClusterResourceQuota模式

401 - Unauthorized

空
HTTP 方法

PUT

描述

替换指定的ClusterResourceQuota的状态

表22. 查询参数
参数 类型 描述

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的dryRun指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有dry run阶段

fieldValidation

字符串

fieldValidation指示服务器如何处理请求(POST/PUT/PATCH)中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略对象中静默删除的任何未知字段，并将忽略解码器遇到的所有重复字段中的最后一个字段。这是v1.23之前默认的行为。- Warn：对于对象中每个被删除的未知字段，以及遇到的每个重复字段，这将通过标准警告响应标头发送警告。如果没有任何其他错误，请求仍然会成功，并且只持久化任何重复字段的最后一个。这是v1.23+中的默认值- Strict：如果任何未知字段将从对象中删除，或者存在任何重复字段，这将导致请求失败并出现BadRequest错误。服务器返回的错误将包含遇到的所有未知和重复字段。
表23. 请求体参数
参数 类型 描述

body

ClusterResourceQuota模式
表24. HTTP响应
HTTP 代码 响应体

200 - OK

ClusterResourceQuota模式

201 - Created

ClusterResourceQuota模式

401 - Unauthorized

空