IngressClass

    apiVersion: networking.k8s.io/v1

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

    IngressClass 代表 Ingress 的类,被 Ingress 的规约引用。 ingressclass.kubernetes.io/is-default-class 注解可以用来标明一个 IngressClass 应该被视为默认的 Ingress 类。 当某个 IngressClass 资源将此注解设置为 true 时, 没有指定类的新 Ingress 资源将被分配到此默认类。


    IngressClassSpec 提供有关 Ingress 类的信息。


    • controller (string)

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

    • parameters (IngressClassParametersReference)

      parameters 是指向控制器中包含额外配置的自定义资源的链接。 如果控制器不需要额外的属性,这是可选的。

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

      • parameters.kind (string),必需

        kind 是被引用资源的类型。

      • parameters.name (string),必需

        name 是被引用资源的名称。

      • parameters.apiGroup (string)

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

      • parameters.namespace (string)

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

      • parameters.scope (string)

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

    IngressClassList 是 IngressClasses 的集合。


    • apiVersion: networking.k8s.io/v1

    • kind: IngressClassList

    • metadata ()

      标准的列表元数据。

    • items ([]IngressClass),必需

      items 是 IngressClasses 的列表。


    HTTP 请求

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

    参数

    • name路径参数):string,必需

      IngressClass 的名称

    • pretty查询参数):string

    响应

    200 (): OK

    401: Unauthorized

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

    HTTP 请求

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

    参数

    • allowWatchBookmarks查询参数):boolean

    • continue查询参数):string

      continue

    • fieldSelector查询参数):string

    • labelSelector查询参数):string

      labelSelector

    • limit查询参数):integer

    • pretty查询参数):string

    • resourceVersion查询参数):string

      resourceVersion

    • resourceVersionMatch查询参数):string

    • timeoutSeconds查询参数):integer

      timeoutSeconds

    • watch查询参数):boolean

    响应

    200 (): OK

    401: Unauthorized

    HTTP 请求

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

    参数

    • body: ,必需

    • dryRun查询参数):string

      dryRun

    • fieldManager查询参数):string

    • pretty查询参数):string

      pretty

    响应

    200 (IngressClass): OK

    201 (): Created

    202 (IngressClass): Accepted

    401: Unauthorized

    update 替换指定的 IngressClass

    HTTP 请求

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

    参数

    • name路径参数):string,必需

      IngressClass 的名称

    • body: IngressClass,必需

    • dryRun查询参数):string

    • fieldManager查询参数):string

      fieldManager

    • fieldValidation查询参数):string

    • pretty查询参数):string

      pretty

    响应

    200 (IngressClass): OK

    201 (): Created

    401: Unauthorized

    HTTP 请求

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

    参数

    • name路径参数):string,必需

      IngressClass 的名称

    • body: ,必需

    • dryRun查询参数):string

      dryRun

    • fieldManager查询参数):string

    • fieldValidation

    • force查询参数):boolean

    • pretty查询参数):string

      pretty

    响应

    200 (IngressClass): OK

    201 (): Created

    401: Unauthorized

    删除一个 IngressClass

    HTTP 请求

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

    参数

    • name路径参数):string,必需

      IngressClass 的名称

    • body:

    • dryRun查询参数):string

      dryRun

    • gracePeriodSeconds查询字符串):integer

    • pretty查询参数):string

      pretty

    • propagationPolicy查询参数):string

    响应

    200 (): OK

    202 (Status): Accepted

    401: Unauthorized

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

    参数

    • body:

    • continue查询参数):string

      continue

    • dryRun查询参数):string

    • fieldSelector查询参数):string

      fieldSelector

    • gracePeriodSeconds查询字符串):integer

    • labelSelector查询参数):string

      labelSelector

    • limit查询参数):integer

    • pretty查询参数):string

      pretty

    • propagationPolicy查询参数):string

    • resourceVersion查询参数):string

      resourceVersion

    • timeoutSeconds查询参数):integer

    响应

    200 (): OK

    401: Unauthorized