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)