APIService

APIService 代表特定 GroupVersion 的伺服器。

apiVersion: apiregistration.k8s.io/v1

import "k8s.io/kube-aggregator/pkg/apis/apiregistration/v1"

APIService

APIService 代表特定 GroupVersion 的伺服器。名稱必須為 "version.group"。

APIServiceSpec

APIServiceSpec 包含用於定位伺服器和與伺服器通訊的資訊。 僅支援 https，但您可以停用憑證驗證。

  • groupPriorityMinimum (int32)，必要

    GroupPriorityMinimum 是此群組應至少擁有的優先順序。 較高的優先順序表示用戶端優先選擇此群組，而不是優先順序較低的群組。 請注意，此群組的其他版本可能會指定更高的 GroupPriorityMinimum 值，以便整個群組獲得更高的優先順序。 主要排序依據是 GroupPriorityMinimum，從最高數字到最低數字排序（20 在 10 之前）。 次要排序依據是物件名稱的字母順序比較。（v1.bar 在 v1.foo 之前） 我們建議類似如下的設定：*.k8s.io（extensions 除外）設定為 18000，PaaS（OpenShift、Deis）建議設定在 2000 範圍內

  • versionPriority (int32)，必要

    VersionPriority 控制此 API 版本在其群組內的排序。 必須大於零。 主要排序依據是 VersionPriority，從最高到最低排序（20 在 10 之前）。 由於它在群組內部，因此數字可以很小，可能在 10 幾左右。 如果版本優先順序相等，版本字串將用於計算群組內的順序。 如果版本字串是 "kube-like"，它將排序在非 "kube-like" 版本字串之上，這些字串按詞彙順序排序。 "Kube-like" 版本以 "v" 開頭，然後是數字（主要版本），然後是可選字串 "alpha" 或 "beta" 和另一個數字（次要版本）。 這些版本首先按 GA > beta > alpha 排序（其中 GA 是沒有後綴的版本，例如 beta 或 alpha），然後比較主要版本，然後是次要版本。 版本排序列表範例：v10、v2、v1、v11beta2、v10beta3、v3beta1、v12alpha1、v11alpha2、foo1、foo10。

  • caBundle ([]byte)

    原子操作：將在合併期間被取代

    CABundle 是 PEM 編碼的 CA 捆綁包，將用於驗證 API 伺服器的服務憑證。 如果未指定，則使用 apiserver 上的系統信任根。

  • group (string)

    Group 是此伺服器託管的 API 群組名稱

  • insecureSkipTLSVerify (boolean)

    InsecureSkipTLSVerify 停用與此伺服器通訊時的 TLS 憑證驗證。 強烈建議不要這樣做。 您應該改用 CABundle。

  • service (ServiceReference)

    Service 是對此 API 伺服器的服務的參考。 它必須在連接埠 443 上通訊。 如果 Service 為 nil，則表示 API 群組版本的處理在本伺服器上本機處理。 呼叫將簡單地委派給正常的處理常式鏈來完成。

    ServiceReference 保有對 Service.legacy.k8s.io 的參考

    • service.name (string)

      Name 是服務的名稱

    • service.namespace (string)

      Namespace 是服務的命名空間

    • service.port (int32)

      如果指定，則為託管 webhook 的服務上的連接埠。 預設值為 443 以實現向後相容性。 port 應該是有效的連接埠號碼（1-65535，包含在內）。

  • version (string)

    Version 是此伺服器託管的 API 版本。 例如，"v1"

APIServiceStatus

APIServiceStatus 包含關於 API 伺服器的衍生資訊

  • conditions ([]APIServiceCondition)

    Patch 策略：在鍵 type 上合併

    Map：在合併期間，鍵類型上的唯一值將被保留

    apiService 的目前服務狀態。

    APIServiceCondition 描述特定時間點 APIService 的狀態

    • conditions.status (string)，必要

      Status 是條件的狀態。 可以是 True、False、Unknown。

    • conditions.type (string)，必要

      Type 是條件的類型。

    • conditions.lastTransitionTime (Time)

      條件上次從一個狀態轉換到另一個狀態的時間。

      Time 是 time.Time 的包裝函式，它支援正確地封送處理為 YAML 和 JSON。 為 time 套件提供的許多工廠方法提供了包裝函式。

    • conditions.message (string)

      人類可讀的訊息，指示關於上次轉換的詳細資訊。

    • conditions.reason (string)

      條件上次轉換的唯一、單字、CamelCase 原因。

APIServiceList

APIServiceList 是 APIService 物件的列表。

操作

get 讀取指定的 APIService

HTTP 請求

GET /apis/apiregistration.k8s.io/v1/apiservices/{name}

參數

  • name (在路徑中)：string，必要

    APIService 的名稱

  • pretty (查詢參數): 字串

    pretty (美觀顯示)

回應

200 (APIService): 成功

401: 未經授權

get 讀取指定 APIService 的狀態

HTTP 請求

GET /apis/apiregistration.k8s.io/v1/apiservices/{name}/status

參數

  • name (在路徑中)：string，必要

    APIService 的名稱

  • pretty (查詢參數): 字串

    pretty (美觀顯示)

回應

200 (APIService): 成功

401: 未經授權

list 列出或監看 APIService 類型的物件

HTTP 請求

GET /apis/apiregistration.k8s.io/v1/apiservices

參數

回應

200 (APIServiceList): 成功

401: 未經授權

create 建立 APIService

HTTP 請求

POST /apis/apiregistration.k8s.io/v1/apiservices

參數

回應

200 (APIService): 成功

201 (APIService): 已建立

202 (APIService): 已接受

401: 未經授權

update 取代指定的 APIService

HTTP 請求

PUT /apis/apiregistration.k8s.io/v1/apiservices/{name}

參數

回應

200 (APIService): 成功

201 (APIService): 已建立

401: 未經授權

update 取代指定 APIService 的狀態

HTTP 請求

PUT /apis/apiregistration.k8s.io/v1/apiservices/{name}/status

參數

回應

200 (APIService): 成功

201 (APIService): 已建立

401: 未經授權

patch 部分更新指定的 APIService

HTTP 請求

PATCH /apis/apiregistration.k8s.io/v1/apiservices/{name}

參數

回應

200 (APIService): 成功

201 (APIService): 已建立

401: 未經授權

patch 部分更新指定 APIService 的狀態

HTTP 請求

PATCH /apis/apiregistration.k8s.io/v1/apiservices/{name}/status

參數

回應

200 (APIService): 成功

201 (APIService): 已建立

401: 未經授權

delete 刪除 APIService

HTTP 請求

DELETE /apis/apiregistration.k8s.io/v1/apiservices/{name}

參數

回應

200 (Status): 成功

202 (Status): 已接受

401: 未經授權

deletecollection 刪除 APIService 集合

HTTP 請求

DELETE /apis/apiregistration.k8s.io/v1/apiservices

參數

回應

200 (Status): 成功

401: 未經授權

此頁面為自動產生。

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

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