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 (string)

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

  • parameters (IngressClassParametersReference)

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

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

    • parameters.kind (string), required

      kind 是所引用资源的类型。

    • parameters.name (string), required

      name 是所引用资源的名称。

    • parameters.apiGroup (string)

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

    • parameters.namespace (string)

      namespace 是所引用资源的命名空间。当 scope 设置为“Namespace”时,此字段是必需的,当 scope 设置为“Cluster”时,此字段必须为未设置状态。

    • parameters.scope (string)

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

IngressClassList

IngressClassList 是 IngressClass 的集合。


  • apiVersion: networking.k8s.io/v1

  • kind: IngressClassList

  • metadata (ListMeta)

    标准列表元数据。

  • items ([]IngressClass), required

    items 是 IngressClass 的列表。

操作


get 读取指定的 IngressClass

HTTP 请求

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

参数

  • name (在路径中): string, required

    IngressClass 的名称

  • pretty (在查询中): string

    pretty

响应

200 (IngressClass): OK

401: Unauthorized

list 列出或观察 IngressClass 类型的对象

HTTP 请求

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

参数

响应

200 (IngressClassList): OK

401: Unauthorized

create 创建 IngressClass

HTTP 请求

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

参数

响应

200 (IngressClass): OK

201 (IngressClass): Created

202 (IngressClass): Accepted

401: Unauthorized

update 替换指定的 IngressClass

HTTP 请求

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

参数

  • name (在路径中): string, required

    IngressClass 的名称

  • body: IngressClass, required

  • dryRun (在查询中): string

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • pretty (在查询中): string

    pretty

响应

200 (IngressClass): OK

201 (IngressClass): Created

401: Unauthorized

patch 部分更新指定的 IngressClass

HTTP 请求

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

参数

  • name (在路径中): string, required

    IngressClass 的名称

  • body: Patch, required

  • dryRun (在查询中): string

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • force (在查询中): boolean

    force

  • pretty (在查询中): string

    pretty

响应

200 (IngressClass): OK

201 (IngressClass): Created

401: Unauthorized

delete 删除 IngressClass

HTTP 请求

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

参数

响应

200 (Status): OK

202 (Status): Accepted

401: Unauthorized

deletecollection 删除 IngressClass 集合

HTTP 请求

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

参数

响应

200 (Status): OK

401: Unauthorized

此页面是自动生成的。

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

上次修改时间:2023 年 4 月 3 日,太平洋标准时间上午 8:22:API Ref 多页面 v1.27 (7b39e9a9ec)