--- api_metadata: apiVersion: "v1" import: "k8s.io/api/core/v1" kind: "ResourceQuota" content_type: "api_reference" description: "ResourceQuota 设置每个命名空间强制执行的聚合配额限制。" title: "ResourceQuota" weight: 3 --- `apiVersion: v1` `import "k8s.io/api/core/v1"` ## ResourceQuota {#ResourceQuota} ResourceQuota 设置每个命名空间强制执行的聚合配额限制。

- **apiVersion**: v1 - **kind**: ResourceQuota - **metadata** (}}">ObjectMeta) 标准的对象元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata - **spec** (}}">ResourceQuotaSpec) `spec` 定义所需的配额。 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status - **status** (}}">ResourceQuotaStatus) `status` 定义实际执行的配额及其当前使用情况。 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status ## ResourceQuotaSpec {#ResourceQuotaSpec} ResourceQuotaSpec 定义为 Quota 强制执行所需的硬限制。

- **hard** (map[string]}}">Quantity) `hard` 是每种指定资源所需的硬性限制集合。更多信息： https://kubernetes.io/docs/concepts/policy/resource-quotas/ - **scopeSelector** (ScopeSelector) `scopeSelector` 也是一组过滤器的集合，和 `scopes` 类似，必须匹配配额所跟踪的每个对象，但使用 ScopeSelectorOperator 结合可能的值来表示。对于要匹配的资源，必须同时匹配 scopes 和 `scopeSelector`（如果在 `spec` 中设置了的话）。 `scope` 选择算符表示的是由限定范围的资源选择算符进行**逻辑与**运算得出的结果。 - **scopeSelector.matchExpressions** ([]ScopedResourceSelectorRequirement) **原子：将在合并期间被替换** 按资源范围划分的范围选择算符需求列表。限定范围的资源选择算符需求是一种选择算符，包含值、范围名称和将二者关联起来的运算符。 - **scopeSelector.matchExpressions.operator** (string)，必需表示范围与一组值之间的关系。有效的运算符为 `In`、`NotIn`、`Exists`、`DoesNotExist`。可能的枚举值： - `"DoesNotExist"` - `"Exists"` - `"In"` - `"NotIn"` - **scopeSelector.matchExpressions.scopeName** (string)，必需选择器所适用的范围的名称。可能的枚举值： - `"BestEffort"` 匹配所有 BestEffort 服务质量的 Pod 对象 - `"CrossNamespacePodAffinity"` 匹配所有提到跨命名空间 Pod（反）亲和性的 Pod 对象 - `"NotBestEffort"` 匹配所有非 BestEffort 服务质量的 Pod 对象 - `"NotTerminating"` 匹配所有 `spec.activeDeadlineSeconds` 为 nil 的 Pod 对象 - `"PriorityClass"` 匹配所有指定了优先级类的 Pod 对象 - `"Terminating"` 匹配所有 `spec.activeDeadlineSeconds >=0` 的 Pod 对象 - `"VolumeAttributesClass"` 匹配所有指定了卷属性类的 PVC 对象 - **scopeSelector.matchExpressions.values** ([]string) **原子：将在合并期间被替换** 字符串值数组。如果操作符是 `In` 或 `NotIn`，`values` 数组必须是非空的。如果操作符是 `Exists` 或 `DoesNotExist`，`values` 数组必须为空。该数组将在策略性合并补丁操作期间被替换。 - **scopes** ([]string) **原子：将在合并期间被替换** 一个匹配被配额跟踪的所有对象的过滤器集合。如果没有指定，则默认匹配所有对象。 ## ResourceQuotaStatus {#ResourceQuotaStatus} ResourceQuotaStatus 定义硬性限制和观测到的用量。

- **hard** (map[string]}}">Quantity) `hard` 是每种指定资源所强制实施的硬性限制集合。更多信息： https://kubernetes.io/docs/concepts/policy/resource-quotas/ - **used** (map[string]}}">Quantity) `used` 是当前命名空间中所观察到的资源总用量。 ## ResourceQuotaList {#ResourceQuotaList} ResourceQuotaList 是 ResourceQuota 列表。

- **apiVersion**：v1 - **kind**：ResourceQuotaList - **metadata** (}}">ListMeta) 标准列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds - **items** ([]}}">ResourceQuota)，必需 `items` 是 ResourceQuota 对象的列表。更多信息： https://kubernetes.io/docs/concepts/policy/resource-quotas/ ## 操作 {#Operations}

### `get` 读取指定的 ResourceQuota #### HTTP 请求 GET /api/v1/namespaces/{namespace}/resourcequotas/{name} #### 参数 - **name** （**路径参数**）: string，必需 ResourceQuota 的名称。 - **namespace** （**路径参数**）: string，必需 }}">namespace - **pretty** （**查询参数**）: string }}">pretty #### 响应 200 (}}">ResourceQuota): OK 401: Unauthorized ### `get` 读取指定的 ResourceQuota 的状态 #### HTTP 请求 GET /api/v1/namespaces/{namespace}/resourcequotas/{name}/status #### 参数 - **name** （**路径参数**）: string，必需 ResourceQuota 的名称。 - **namespace** （**路径参数**）: string，必需 }}">namespace - **pretty** （**查询参数**）: string }}">pretty #### 响应 200 (}}">ResourceQuota): OK 401: Unauthorized ### `list` 列出或监视 ResourceQuota 类别的对象 #### HTTP 请求 GET /api/v1/namespaces/{namespace}/resourcequotas #### 参数 - **namespace**（**路径参数**）: string，必需 }}">namespace - **allowWatchBookmarks**（**查询参数**）: boolean }}">allowWatchBookmarks - **continue**（**查询参数**）: string }}">continue - **fieldSelector**（**查询参数**）: string }}">fieldSelector - **labelSelector**（**查询参数**）: string }}">labelSelector - **limit**（**查询参数**）: integer }}">limit - **pretty**（**查询参数**）: string }}">pretty - **resourceVersion**（**查询参数**）: string }}">resourceVersion - **resourceVersionMatch**（**查询参数**）: string }}">resourceVersionMatch - **sendInitialEvents**（**查询参数**）: boolean }}">sendInitialEvents - **shardSelector** (**查询参数**): string }}">shardSelector - **timeoutSeconds**（**查询参数**）: integer }}">timeoutSeconds - **watch**（**查询参数**）: boolean }}">watch #### 响应 200 (}}">ResourceQuotaList): OK 401: Unauthorized ### `list` 列出或监视 ResourceQuota 类别的对象 #### HTTP 请求 GET /api/v1/resourcequotas #### 参数 - **allowWatchBookmarks**（**查询参数**）: boolean }}">allowWatchBookmarks - **continue**（**查询参数**）: string }}">continue - **fieldSelector**（**查询参数**）: string }}">fieldSelector - **labelSelector**（**查询参数**）: string }}">labelSelector - **limit**（**查询参数**）: integer }}">limit - **pretty**（**查询参数**）: string }}">pretty - **resourceVersion**（**查询参数**）: string }}">resourceVersion - **resourceVersionMatch**（**查询参数**）: string }}">resourceVersionMatch - **sendInitialEvents**（**查询参数**）: boolean }}">sendInitialEvents - **shardSelector** (**查询参数**): string }}">shardSelector - **timeoutSeconds**（**查询参数**）: integer }}">timeoutSeconds - **watch**（**查询参数**）: boolean }}">watch #### 响应 200 (}}">ResourceQuotaList): OK 401: Unauthorized ### `create` 创建一个 ResourceQuota #### HTTP 请求 POST /api/v1/namespaces/{namespace}/resourcequotas #### 参数 - **namespace** （**路径参数**）: string，必需 }}">namespace - **body**: }}">ResourceQuota，必需 - **dryRun** （**查询参数**）: string }}">dryRun - **fieldManager** （**查询参数**）: string }}">fieldManager - **fieldValidation** （**查询参数**）: string }}">fieldValidation - **pretty** （**查询参数**）: string }}">pretty #### 响应 200 (}}">ResourceQuota): OK 201 (}}">ResourceQuota): Created 202 (}}">ResourceQuota): Accepted 401: Unauthorized ### `update` 更新指定的 ResourceQuota #### HTTP 请求 PUT /api/v1/namespaces/{namespace}/resourcequotas/{name} #### 参数 - **name** （**路径参数**）: string，必需 ResourceQuota 的名称。 - **namespace** （**路径参数**）: string，必需 }}">namespace - **body**: }}">ResourceQuota，必需 - **dryRun** （**查询参数**）: string }}">dryRun - **fieldManager** （**查询参数**）: string }}">fieldManager - **fieldValidation** （**查询参数**）: string }}">fieldValidation - **pretty** （**查询参数**）: string }}">pretty #### 响应 200 (}}">ResourceQuota): OK 201 (}}">ResourceQuota): Created 401: Unauthorized ### `update` 更新指定 ResourceQuota 的状态 #### HTTP 请求 PUT /api/v1/namespaces/{namespace}/resourcequotas/{name}/status #### 参数 - **name** （**路径参数**）: string，必需 ResourceQuota 的名称。 - **namespace** （**路径参数**）: string，必需 }}">namespace - **body**: }}">ResourceQuota，必需 - **dryRun** （**查询参数**）: string }}">dryRun - **fieldManager** （**查询参数**）: string }}">fieldManager - **fieldValidation** （**查询参数**）: string }}">fieldValidation - **pretty** （**查询参数**）: string }}">pretty #### 响应 200 (}}">ResourceQuota): OK 201 (}}">ResourceQuota): Created 401: Unauthorized ### `patch` 部分更新指定的 ResourceQuota #### HTTP 请求 PATCH /api/v1/namespaces/{namespace}/resourcequotas/{name} #### 参数 - **name** （**路径参数**）: string，必需 ResourceQuota 的名称。 - **namespace** （**路径参数**）: string，必需 }}">namespace - **body**: }}">Patch，必需 - **dryRun** （**查询参数**）: string }}">dryRun - **fieldManager** （**查询参数**）: string }}">fieldManager - **fieldValidation** （**查询参数**）: string }}">fieldValidation - **force** （**查询参数**）: boolean }}">force - **pretty** （**查询参数**）: string }}">pretty #### 响应 200 (}}">ResourceQuota): OK 201 (}}">ResourceQuota): Created 401: Unauthorized ### `patch` 部分更新指定 ResourceQuota 的状态 #### HTTP 请求 PATCH /api/v1/namespaces/{namespace}/resourcequotas/{name}/status #### 参数 - **name** （**路径参数**）: string，必需 ResourceQuota 的名称。 - **namespace** （**路径参数**）: string，必需 }}">namespace - **body**: }}">Patch，必需 - **dryRun** （**查询参数**）: string }}">dryRun - **fieldManager** （**查询参数**）: string }}">fieldManager - **fieldValidation** （**查询参数**）: string }}">fieldValidation - **force** （**查询参数**）: boolean }}">force - **pretty** （**查询参数**）: string }}">pretty #### 响应 200 (}}">ResourceQuota): OK 201 (}}">ResourceQuota): Created 401: Unauthorized ### `delete` 删除 ResourceQuota #### HTTP 请求 DELETE /api/v1/namespaces/{namespace}/resourcequotas/{name} #### 参数 - **name** （**路径参数**）: string，必需 ResourceQuota 的名称。 - **namespace** （**路径参数**）: string，必需 }}">namespace - **body**: }}">DeleteOptions - **dryRun** （**查询参数**）: string }}">dryRun - **gracePeriodSeconds** （**查询参数**）: integer }}">gracePeriodSeconds - **ignoreStoreReadErrorWithClusterBreakingPotential** （**查询参数**）: boolean }}">ignoreStoreReadErrorWithClusterBreakingPotential - **pretty** （**查询参数**）: string }}">pretty - **propagationPolicy** （**查询参数**）: string }}">propagationPolicy #### 响应 200 (}}">ResourceQuota): OK 202 (}}">ResourceQuota): Accepted 401: Unauthorized ### `deletecollection` 删除 ResourceQuota 的集合 #### HTTP 请求 DELETE /api/v1/namespaces/{namespace}/resourcequotas #### 参数 - **namespace** （**路径参数**）: string，必需 }}">namespace - **body**: }}">DeleteOptions - **continue** （**查询参数**）: string }}">continue - **dryRun** （**查询参数**）: string }}">dryRun - **fieldSelector** （**查询参数**）: string }}">fieldSelector - **gracePeriodSeconds** （**查询参数**）: integer }}">gracePeriodSeconds - **ignoreStoreReadErrorWithClusterBreakingPotential** （**查询参数**）: boolean }}">ignoreStoreReadErrorWithClusterBreakingPotential - **labelSelector** （**查询参数**）: string }}">labelSelector - **limit** （**查询参数**）: integer }}">limit - **pretty** （**查询参数**）: string }}">pretty - **propagationPolicy** （**查询参数**）: string }}">propagationPolicy - **resourceVersion** （**查询参数**）: string }}">resourceVersion - **resourceVersionMatch** （**查询参数**）: string }}">resourceVersionMatch - **sendInitialEvents** (**查询参数**): boolean }}">sendInitialEvents - **shardSelector** (**查询参数**): string }}">shardSelector - **timeoutSeconds** （**查询参数**）: integer }}">timeoutSeconds #### 响应 200 (}}">Status): OK 401: Unauthorized