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 是所引用资源的命名空间。当 scope 设置为“Namespace”时，此字段是必需的，当 scope 设置为“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 (在路径中): string，必填

    IngressClass 的名称

  • pretty (在查询中): string

    pretty

响应

200 (IngressClass): OK

401: 未授权

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

HTTP 请求

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

参数

响应

200 (IngressClassList): OK

401: 未授权

create 创建 IngressClass

HTTP 请求

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

参数

响应

200 (IngressClass): OK

201 (IngressClass): 已创建

202 (IngressClass): 已接受

401: 未授权

update 替换指定的 IngressClass

HTTP 请求

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

参数

  • name (在路径中): string，必填

    IngressClass 的名称

  • body: IngressClass，必需

  • dryRun (在查询中): string

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • pretty (在查询中): string

    pretty

响应

200 (IngressClass): OK

201 (IngressClass): 已创建

401: 未授权

patch 部分更新指定的 IngressClass

HTTP 请求

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

参数

  • name (在路径中): string，必填

    IngressClass 的名称

  • body: Patch，必需

  • dryRun (在查询中): string

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • force (在查询中): boolean

    force

  • pretty (在查询中): string

    pretty

响应

200 (IngressClass): OK

201 (IngressClass): 已创建

401: 未授权

delete 删除 IngressClass

HTTP 请求

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

参数

响应

200 (Status): OK

202 (Status): 已接受

401: 未授权

deletecollection 删除 IngressClass 集合

HTTP 请求

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

参数

响应

200 (Status): OK

401: 未授权

本页面是自动生成的。

如果你打算报告此页面存在的问题，请在问题描述中提及此页面是自动生成的。修复可能需要在 Kubernetes 项目的其他地方进行。

上次修改时间：2025 年 4 月 9 日太平洋标准时间下午 6:36：更新 v1.32 的 API 参考文档 (a3b579d035)