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), 必填

      kind 是所參照資源的類型。

    • parameters.name (string), 必填

      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), 必填

    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): 成功

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 (在 query 中): 字串

    dryRun

  • fieldManager (在 query 中): 字串

    fieldManager

  • fieldValidation (在 query 中): 字串

    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 (在 query 中): 字串

    dryRun

  • fieldManager (在 query 中): 字串

    fieldManager

  • fieldValidation (在 query 中): 字串

    fieldValidation

  • force (在 query 中): 布林值

    force

  • pretty (在查詢中): string

    pretty

回應

200 (IngressClass): OK

201 (IngressClass): 已建立

401: 未經授權

delete 刪除 IngressClass

HTTP 請求

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

參數

回應

200 (Status): 成功

202 (Status): 已接受

401: 未經授權

deletecollection 刪除 IngressClass 的集合

HTTP 請求

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

參數

回應

200 (Status): 成功

401: 未經授權

此頁面為自動產生。

如果您計劃回報關於此頁面的問題,請在您的問題描述中提及此頁面為自動產生。此修正可能需要在 Kubernetes 專案的其他地方進行。

上次修改時間:2024 年 8 月 28 日下午 6:01 PST:Update generated API reference for v1.31 (8ba98c79c1)