# LimitRange > LimitRange 设置名字空间中每个资源类别的资源用量限制。 --- LLMS index: [llms.txt](/llms.txt) --- `apiVersion: v1` `import "k8s.io/api/core/v1"` ## LimitRange {#LimitRange} LimitRange 设置名字空间中每个资源类别的资源用量限制。

- **apiVersion**: v1 - **kind**: LimitRange - **metadata** (ObjectMeta) 标准的对象元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata - **spec** (LimitRangeSpec) `spec` 定义强制执行的限制。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status ## LimitRangeSpec {#LimitRangeSpec} LimitRangeSpec 定义与类别匹配的资源的最小/最大使用限制。

- **limits** ([]LimitRangeItem)，必需 **原子：将在合并期间被替换** `limits` 是强制执行的 LimitRangeItem 对象的列表。 **LimitRangeItem 定义与类别匹配的任意资源的最小/最大使用限制。** - **limits.type** (string)，必需此限制应用到的资源的类型。 - **limits.default** (map[string]Quantity) 资源限制被省略时按资源名称设定的默认资源要求限制值。 - **limits.defaultRequest** (map[string]Quantity) `defaultRequest` 是资源请求被省略时按资源名称设定的默认资源要求请求值。 - **limits.max** (map[string]Quantity) 按资源名称针对这种类别的最大使用约束。 - **limits.maxLimitRequestRatio** (map[string]Quantity) 如果指定 `maxLimitRequestRatio`，则所指定的资源必须设置非零的请求和限制值，且限制除以请求小于或等于这里列举的值；此属性用来表示所指定资源的最大突发用量。 - **limits.min** (map[string]Quantity) 按资源名称区分的，针对这种类别对象的最小用量约束。 ## LimitRangeList {#LimitRangeList} LimitRangeList 是 LimitRange 项的列表。

- **apiVersion**: v1 - **kind**: LimitRangeList - **metadata** (ListMeta) 标准的列表元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds - **items** ([]LimitRange)，必需 `items` 是 LimitRange 对象的列表。更多信息： https://kubernetes.io/zh-cn/docs/concepts/configuration/manage-resources-containers/ ## 操作 {#Operations}

### `get` 读取指定的 LimitRange #### HTTP 请求 GET /api/v1/namespaces/{namespace}/limitranges/{name} #### 参数 - **name** (**路径参数**): string，必需 LimitRange 的名称。 - **namespace** (**路径参数**): string，必需 namespace - **pretty** (**查询参数**): string pretty #### 响应 200 (LimitRange): OK 401: Unauthorized ### `list` 列出或监视 LimitRange 类别的对象 #### HTTP 请求 GET /api/v1/namespaces/{namespace}/limitranges #### 参数 - **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 (LimitRangeList): OK 401: Unauthorized ### `list` 列出或监视 LimitRange 类别的对象 #### HTTP 请求 GET /api/v1/limitranges #### 参数 - **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 (LimitRangeList): OK 401: Unauthorized ### `create` 创建 LimitRange #### HTTP 请求 POST /api/v1/namespaces/{namespace}/limitranges #### 参数 - **namespace** (**路径参数**): string，必需 namespace - **body**: LimitRange，必需 - **dryRun** (**查询参数**): string dryRun - **fieldManager** (**查询参数**): string fieldManager - **fieldValidation** (**查询参数**): string fieldValidation - **pretty** (**查询参数**): string pretty #### 响应 200 (LimitRange): OK 201 (LimitRange): Created 202 (LimitRange): Accepted 401: Unauthorized ### `update` 替换指定的 LimitRange #### HTTP 请求 PUT /api/v1/namespaces/{namespace}/limitranges/{name} #### 参数 - **name** (**路径参数**): string，必需 LimitRange 的名称。 - **namespace** (**路径参数**): string，必需 namespace - **body**: LimitRange，必需 - **dryRun** (**查询参数**): string dryRun - **fieldManager** (**查询参数**): string fieldManager - **fieldValidation** (**查询参数**): string fieldValidation - **pretty** (**查询参数**): string pretty #### 响应 200 (LimitRange): OK 201 (LimitRange): Created 401: Unauthorized ### `patch` 部分更新指定的 LimitRange #### HTTP 请求 PATCH /api/v1/namespaces/{namespace}/limitranges/{name} #### 参数 - **name** (**路径参数**): string，必需 LimitRange 的名称。 - **namespace** (**路径参数**): string，必需 namespace - **body**: Patch，必需 - **dryRun** (**查询参数**): string dryRun - **fieldManager** (**查询参数**): string fieldManager - **fieldValidation** (**查询参数**): string fieldValidation - **force** (**查询参数**): boolean force - **pretty** (**查询参数**): string pretty #### 响应 200 (LimitRange): OK 201 (LimitRange): Created 401: Unauthorized ### `delete` 删除 LimitRange #### HTTP 请求 DELETE /api/v1/namespaces/{namespace}/limitranges/{name} #### 参数 - **name** (**路径参数**): string，必需 LimitRange 的名称。 - **namespace** (**路径参数**): string，必需 namespace - **body**: DeleteOptions - **dryRun** (**查询参数**): string dryRun - **gracePeriodSeconds** (**查询参数**): integer gracePeriodSeconds - **ignoreStoreReadErrorWithClusterBreakingPotential** (**查询参数**): boolean ignoreStoreReadErrorWithClusterBreakingPotential - **pretty** (**查询参数**): string pretty - **propagationPolicy** (**查询参数**): string propagationPolicy #### 响应 200 (Status): OK 202 (Status): Accepted 401: Unauthorized ### `deletecollection` 删除 LimitRange 的集合 #### HTTP 请求 DELETE /api/v1/namespaces/{namespace}/limitranges #### 参数 - **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