25.2. AppliedClusterResourceQuota [quota.openshift.io/v1]
- 描述
- AppliedClusterResourceQuota 在项目范围内镜像 ClusterResourceQuota,以便投射到项目中。它允许 project-admin 知道将哪些 ClusterResourceQuotas 应用到其项目及其关联的用法。
- 类型
-
对象
- 必填
-
metadata
-
spec
-
25.2.1. 规格 复制链接链接已复制到粘贴板!
属性 | 类型 | 描述 |
---|---|---|
|
| APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值,并可拒绝未识别的值。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind 是一个字符串值,代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| ||
|
| ClusterResourceQuotaSpec 定义所需的配额限制 |
|
| ClusterResourceQuotaStatus 定义实际强制的配额及其当前用法 |
25.2.1.1. .spec 复制链接链接已复制到粘贴板!
- 描述
- ClusterResourceQuotaSpec 定义所需的配额限制
- 类型
-
对象
- 必填
-
selector
-
quota
-
属性 | 类型 | 描述 |
---|---|---|
| 配额定义所需的配额 | |
|
| ClusterResourceQuotaSelector 用于选择项目。必须至少存在 LabelSelector 或 AnnotationSelector 之一。如果只有一个条件,则代表它是唯一选择条件。如果两者都指定,则项目必须与这两个限制匹配。 |
25.2.1.2. .spec.selector 复制链接链接已复制到粘贴板!
- 描述
- ClusterResourceQuotaSelector 用于选择项目。必须至少存在 LabelSelector 或 AnnotationSelector 之一。如果只有一个条件,则代表它是唯一选择条件。如果两者都指定,则项目必须与这两个限制匹配。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| AnnotationSelector 用于根据注解选择项目。 |
| labelSelector 用于按标签选择项目。 |
25.2.1.3. .status 复制链接链接已复制到粘贴板!
- 描述
- ClusterResourceQuotaStatus 定义实际强制的配额及其当前用法
- 类型
-
对象
- 必填
-
total
-
属性 | 类型 | 描述 |
---|---|---|
|
| 命名空间(namespace)根据项目划分使用情况。这种部门允许在单个项目内快速解析删除协调,而无需在所有项目中重新计算。这可用于拉取给定项目的 deltas。 |
|
| ResourceQuotaStatusByNamespace 为特定项目提供状态 |
| Total 定义所有项目的实际强制配额及其当前使用量 |
25.2.1.4. .status.namespaces 复制链接链接已复制到粘贴板!
- 描述
- 命名空间(namespace)根据项目划分使用情况。这种部门允许在单个项目内快速解析删除协调,而无需在所有项目中重新计算。这可用于拉取给定项目的 deltas。
- 类型
-
array
25.2.1.5. .status.namespaces[] 复制链接链接已复制到粘贴板!
- 描述
- ResourceQuotaStatusByNamespace 为特定项目提供状态
- 类型
-
对象
- 必填
-
namespace
-
status
-
属性 | 类型 | 描述 |
---|---|---|
|
| 此状态应用到的项目的命名空间 |
| status 表示此项目消耗的资源数量 |
25.2.2. API 端点 复制链接链接已复制到粘贴板!
可用的 API 端点如下:
/apis/quota.openshift.io/v1/appliedclusterresourcequotas
-
GET
: 列出 AppliedClusterResourceQuota 类型的对象
-
/apis/quota.openshift.io/v1/namespaces/{namespace}/appliedclusterresourcequotas
-
GET
: 列出 AppliedClusterResourceQuota 类型的对象
-
/apis/quota.openshift.io/v1/namespaces/{namespace}/appliedclusterresourcequotas/{name}
-
GET
:读取指定的 AppliedClusterResourceQuota
-
参数 | 类型 | 描述 |
---|---|---|
|
| allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签,由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回,也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视,则忽略此字段。如果 apiserver 中没有启用功能门 WatchBookmarks,则忽略此字段。 |
|
| 从服务器检索更多结果时,应设置 continue 选项。由于这个值是定义的服务器,因此客户端只能使用之前查询结果中的 continue 值,并带有相同的查询参数(除 continue 值除外),因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效,无论是因为过期时间(通常为 5 到十五分钟)还是服务器上的配置更改,服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表,它必须在没有 continue 字段的情况下重启其列表。否则,客户端可能会发送另一个列表请求,并带有 410 错误收到的令牌,服务器将通过从下一个密钥开始的列表进行响应,但从最新的快照(从最后一个列表结果中不一致) - 在第一个列表请求后创建、修改或删除的对象将包含在响应中,只要其密钥在"next key"后。 当 watch 为 true 时,不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视,而不丢失任何修改。 |
|
| 用于限制返回的对象列表的选择器。默认为任何内容。 |
|
| 通过标签限制返回的对象列表的选择器。默认为任何内容。 |
|
| 限制是列表调用要返回的最大响应数。如果存在更多项目,服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值,以检索下一个结果集。在过滤所有请求的对象时,设置限制可能会返回比请求的项目数量少(最多为零项),客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数,并将返回所有可用的结果。如果指定了限制,并且 continue 字段为空,客户端可能会假设没有更多可用的结果。如果 watch 为 true,则不支持此字段。 服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说,在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照,并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象,则返回第一次列表结果时存在的对象版本。 |
|
| 如果 'true',则输出被用户友善。 |
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
|
| resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。 默认为未设置 |
|
| list/watch 调用的超时。这限制了调用的时间,无论任何活动或不活跃。 |
|
| 观察对描述的资源的更改,并将其作为添加、更新和删除通知流返回。指定 resourceVersion。 |
- HTTP 方法
-
GET
- 描述
- 列出 AppliedClusterResourceQuota 类型的对象
HTTP 代码 | 响应正文 |
---|---|
200 - OK | |
401 - Unauthorized | 空 |
参数 | 类型 | 描述 |
---|---|---|
|
| 对象名称和身份验证范围,如团队和项目 |
参数 | 类型 | 描述 |
---|---|---|
|
| allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签,由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回,也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视,则忽略此字段。如果 apiserver 中没有启用功能门 WatchBookmarks,则忽略此字段。 |
|
| 从服务器检索更多结果时,应设置 continue 选项。由于这个值是定义的服务器,因此客户端只能使用之前查询结果中的 continue 值,并带有相同的查询参数(除 continue 值除外),因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效,无论是因为过期时间(通常为 5 到十五分钟)还是服务器上的配置更改,服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表,它必须在没有 continue 字段的情况下重启其列表。否则,客户端可能会发送另一个列表请求,并带有 410 错误收到的令牌,服务器将通过从下一个密钥开始的列表进行响应,但从最新的快照(从最后一个列表结果中不一致) - 在第一个列表请求后创建、修改或删除的对象将包含在响应中,只要其密钥在"next key"后。 当 watch 为 true 时,不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视,而不丢失任何修改。 |
|
| 用于限制返回的对象列表的选择器。默认为任何内容。 |
|
| 通过标签限制返回的对象列表的选择器。默认为任何内容。 |
|
| 限制是列表调用要返回的最大响应数。如果存在更多项目,服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值,以检索下一个结果集。在过滤所有请求的对象时,设置限制可能会返回比请求的项目数量少(最多为零项),客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数,并将返回所有可用的结果。如果指定了限制,并且 continue 字段为空,客户端可能会假设没有更多可用的结果。如果 watch 为 true,则不支持此字段。 服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说,在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照,并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象,则返回第一次列表结果时存在的对象版本。 |
|
| 如果 'true',则输出被用户友善。 |
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
|
| resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。 默认为未设置 |
|
| list/watch 调用的超时。这限制了调用的时间,无论任何活动或不活跃。 |
|
| 观察对描述的资源的更改,并将其作为添加、更新和删除通知流返回。指定 resourceVersion。 |
- HTTP 方法
-
GET
- 描述
- 列出 AppliedClusterResourceQuota 类型的对象
HTTP 代码 | 响应正文 |
---|---|
200 - OK | |
401 - Unauthorized | 空 |
参数 | 类型 | 描述 |
---|---|---|
|
| AppliedClusterResourceQuota 的名称 |
|
| 对象名称和身份验证范围,如团队和项目 |
参数 | 类型 | 描述 |
---|---|---|
|
| 如果 'true',则输出被用户友善。 |
- HTTP 方法
-
GET
- 描述
- 读取指定的 AppliedClusterResourceQuota
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
401 - Unauthorized | 空 |