diff --git a/content/zh-cn/docs/reference/kubernetes-api/policy-resources/limit-range-v1.md b/content/zh-cn/docs/reference/kubernetes-api/policy-resources/limit-range-v1.md new file mode 100644 index 0000000000..1ee5af68a3 --- /dev/null +++ b/content/zh-cn/docs/reference/kubernetes-api/policy-resources/limit-range-v1.md @@ -0,0 +1,658 @@ +--- +api_metadata: + apiVersion: "v1" + import: "k8s.io/api/core/v1" + kind: "LimitRange" +content_type: "api_reference" +description: "LimitRange 设置名字空间中每个资源类别的资源用量限制。" +title: "LimitRange" +weight: 1 +--- + + +`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 + +- **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 + +- **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 + +- **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 + +- **labelSelector** (**查询参数**): string + + }}">labelSelector + +- **limit** (**查询参数**): integer + + }}">limit + +- **pretty** (**查询参数**): string + + }}">pretty + +- **propagationPolicy** (**查询参数**): string + + }}">propagationPolicy + +- **resourceVersion** (**查询参数**): string + + }}">resourceVersion + +- **resourceVersionMatch** (**查询参数**): string + + }}">resourceVersionMatch + +- **timeoutSeconds** (**查询参数**): integer + + }}">timeoutSeconds + + +#### 响应 +200 (}}">Status): OK + +401: Unauthorized