--- api_metadata: apiVersion: "v1" import: "k8s.io/api/core/v1" kind: "LimitRange" content_type: "api_reference" description: "LimitRange 设置名字空间中每个资源类别的资源用量限制。" title: "LimitRange" weight: 2 --- `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