IngressClass

IngressClass 表示 Ingress 的类,由 Ingress Spec 引用。

apiVersion: networking.k8s.io/v1

import "k8s.io/api/networking/v1"

IngressClass

IngressClass 表示 Ingress 的类,由 Ingress Spec 引用。ingressclass.kubernetes.io/is-default-class 注释可用于指示应将 IngressClass 视为默认值。当单个 IngressClass 资源将此注释设置为 true 时,未指定类的新的 Ingress 资源将被分配此默认类。


IngressClassSpec

IngressClassSpec 提供有关 Ingress 类的信息。


  • controller (字符串)

    controller 指的是应处理此类的控制器的名称。这允许由同一控制器控制的不同“风格”。例如,对于同一个实现控制器,您可能有不同的参数。这应指定为长度不超过 250 个字符的域前缀路径,例如“acme.io/ingress-controller”。此字段是不可变的。

  • parameters (IngressClassParametersReference)

    parameters 是指向包含控制器其他配置的自定义资源的链接。如果控制器不需要额外的参数,则这是可选的。

    IngressClassParametersReference 标识一个 API 对象。这可以用于指定集群或命名空间范围的资源。

    • parameters.kind (字符串),必需

      kind 是被引用资源的类型。

    • parameters.name (字符串),必需

      name 是被引用资源的名称。

    • parameters.apiGroup (字符串)

      apiGroup 是被引用资源的组。如果未指定 APIGroup,则指定的 Kind 必须位于核心 API 组中。对于任何其他第三方类型,APIGroup 是必需的。

    • parameters.namespace (字符串)

      namespace 是被引用资源的命名空间。当范围设置为“Namespace”时,此字段是必需的,当范围设置为“Cluster”时,必须取消设置。

    • parameters.scope (字符串)

      scope 表示这是否指的是集群或命名空间范围的资源。这可以设置为“Cluster”(默认)或“Namespace”。

IngressClassList

IngressClassList 是 IngressClass 的集合。


  • apiVersion: networking.k8s.io/v1

  • kind: IngressClassList

  • metadata (ListMeta)

    标准列表元数据。

  • items ([]IngressClass),必需

    items 是 IngressClass 的列表。

操作


get 读取指定的 IngressClass

HTTP 请求

GET /apis/networking.k8s.io/v1/ingressclasses/{name}

参数

  • name (路径中):字符串,必需

    IngressClass 的名称

  • pretty (查询中):字符串

    pretty

响应

200 (IngressClass): 确定

401: 未经授权

list 列出或监视 IngressClass 类型的对象

HTTP 请求

GET /apis/networking.k8s.io/v1/ingressclasses

参数

响应

200 (IngressClassList): 确定

401: 未经授权

create 创建一个 IngressClass

HTTP 请求

POST /apis/networking.k8s.io/v1/ingressclasses

参数

响应

200 (IngressClass): 确定

201 (IngressClass): 已创建

202 (IngressClass): 已接受

401: 未经授权

update 替换指定的 IngressClass

HTTP 请求

PUT /apis/networking.k8s.io/v1/ingressclasses/{name}

参数

  • name (路径中):字符串,必需

    IngressClass 的名称

  • body: IngressClass,必需

  • dryRun (查询中):字符串

    dryRun

  • fieldManager (查询中):字符串

    fieldManager

  • fieldValidation (查询中):字符串

    fieldValidation

  • pretty (查询中):字符串

    pretty

响应

200 (IngressClass): 确定

201 (IngressClass): 已创建

401: 未经授权

patch 部分更新指定的 IngressClass

HTTP 请求

PATCH /apis/networking.k8s.io/v1/ingressclasses/{name}

参数

  • name (路径中):字符串,必需

    IngressClass 的名称

  • body: Patch,必需

  • dryRun (查询中):字符串

    dryRun

  • fieldManager (查询中):字符串

    fieldManager

  • fieldValidation (查询中):字符串

    fieldValidation

  • force (查询中):布尔值

    force

  • pretty (查询中):字符串

    pretty

响应

200 (IngressClass): 确定

201 (IngressClass): 已创建

401: 未经授权

delete 删除一个 IngressClass

HTTP 请求

DELETE /apis/networking.k8s.io/v1/ingressclasses/{name}

参数

响应

200 (Status): 确定

202 (Status): 已接受

401: 未经授权

deletecollection 删除 IngressClass 的集合

HTTP 请求

DELETE /apis/networking.k8s.io/v1/ingressclasses

参数

响应

200 (Status): 确定

401: 未经授权

此页面是自动生成的。

如果您计划报告此页面上的问题,请在您的问题描述中说明该页面是自动生成的。修复可能需要在 Kubernetes 项目的其他地方进行。

上次修改时间为太平洋标准时间 2024 年 8 月 28 日下午 6:01:更新 v1.31 的自动生成的 API 参考 (8ba98c79c1)