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 是 IngressClasses 的集合。

  • apiVersion: networking.k8s.io/v1

  • kind: IngressClassList

  • metadata (ListMeta)

    标准列表元数据。

  • items ([]IngressClass), required

    items 是 IngressClasses 的列表。

操作

get 读取指定的 IngressClass

HTTP 请求

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

参数

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

    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, required

    IngressClass 的名称

  • body: IngressClass, required

  • 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, 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): 已创建

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 项目的其他地方进行。

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