Endpoints

Endpoints 是一個端點集合，它實現了實際的服務。

apiVersion: v1

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

Endpoints

Endpoints 是一個實現了實際服務的端點集合。例如：

名稱: "mysvc", 子集: [ { 地址: [{"ip": "10.10.1.1"}, {"ip": "10.10.2.2"}], 埠: [{"name": "a", "port": 8675}, {"name": "b", "port": 309}] }, { 地址: [{"ip": "10.10.3.3"}], 埠: [{"name": "a", "port": 93}, {"name": "b", "port": 76}] }, ]

Endpoints 是一箇舊版 API，不包含所有服務功能的資訊。請使用 discoveryv1.EndpointSlice 獲取有關服務端點的完整資訊。

已棄用：此 API 在 v1.33+ 中已棄用。請使用 discoveryv1.EndpointSlice。

  • apiVersion: v1

  • kind：Endpoints

  • metadata (ObjectMeta)

    標準物件的元資料。更多資訊：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

  • subsets ([]EndpointSubset)

    原子性：在合併期間將被替換

    所有端點的集合是所有子集的並集。地址根據它們共享的 IP 被放入子集。一個具有多個埠的單個地址，其中一些是就緒的，而另一些不是就緒的（因為它們來自不同的容器），將導致該地址在不同的埠中顯示在不同的子集中。在同一個子集中，任何地址都不會同時出現在 Addresses 和 NotReadyAddresses 中。包含服務的一組地址和埠。

    *EndpointSubset 是一個具有一組通用埠的地址組。擴充套件的端點集是 Addresses x Ports 的笛卡爾積。例如，給定

    { 地址: [{"ip": "10.10.1.1"}, {"ip": "10.10.2.2"}], 埠: [{"name": "a", "port": 8675}, {"name": "b", "port": 309}] }

    生成的端點集可以看作是

    a: [ 10.10.1.1:8675, 10.10.2.2:8675 ], b: [ 10.10.1.1:309, 10.10.2.2:309 ]

    已棄用：此 API 在 v1.33+ 中已棄用。*

    • subsets.addresses ([]EndpointAddress)

      原子性：在合併期間將被替換

      提供相關埠並標記為就緒的 IP 地址。這些端點應被負載均衡器和客戶端視為可安全利用。

      *EndpointAddress 是描述單個 IP 地址的元組。已棄用：此 API 在 v1.33+ 中已棄用。*

      • subsets.addresses.ip (string), 必需

        此端點的 IP。不得為迴環地址 (127.0.0.0/8 或 ::1)、鏈路本地地址 (169.254.0.0/16 或 fe80::/10) 或鏈路本地多播地址 (224.0.0.0/24 或 ff02::/16)。

      • subsets.addresses.hostname (string)

        此端點的主機名。

      • subsets.addresses.nodeName (string)

        可選：託管此端點的節點。這可用於確定節點本地的端點。

      • subsets.addresses.targetRef (ObjectReference)

        引用提供端點的物件。

    • subsets.notReadyAddresses ([]EndpointAddress)

      原子性：在合併期間將被替換

      提供相關埠但當前未標記為就緒的 IP 地址，因為它們尚未完成啟動、最近未透過就緒檢查或最近未透過活躍度檢查。

      *EndpointAddress 是描述單個 IP 地址的元組。已棄用：此 API 在 v1.33+ 中已棄用。*

      • subsets.notReadyAddresses.ip (string), 必需

        此端點的 IP。不得為迴環地址 (127.0.0.0/8 或 ::1)、鏈路本地地址 (169.254.0.0/16 或 fe80::/10) 或鏈路本地多播地址 (224.0.0.0/24 或 ff02::/16)。

      • subsets.notReadyAddresses.hostname (string)

        此端點的主機名。

      • subsets.notReadyAddresses.nodeName (string)

        可選：託管此端點的節點。這可用於確定節點本地的端點。

      • subsets.notReadyAddresses.targetRef (ObjectReference)

        引用提供端點的物件。

    • subsets.ports ([]EndpointPort)

      原子性：在合併期間將被替換

      相關 IP 地址上可用的埠號。

      *EndpointPort 是描述單個埠的元組。已棄用：此 API 在 v1.33+ 中已棄用。*

      • subsets.ports.port (int32), 必需

        端點的埠號。

      • subsets.ports.protocol (string)

        此埠的 IP 協議。必須是 UDP、TCP 或 SCTP。預設為 TCP。

      • subsets.ports.name (string)

        此埠的名稱。此名稱必須與相應 ServicePort 中的“name”欄位匹配。必須是 DNS_LABEL。僅在定義了一個埠時可選。

      • subsets.ports.appProtocol (string)

        此埠的應用協議。這用作實現的提示，以便為它們理解的協議提供更豐富的行為。此欄位遵循標準 Kubernetes 標籤語法。有效值可以是

EndpointsList

EndpointsList 是端點列表。已棄用：此 API 在 v1.33+ 中已棄用。

操作

get 讀取指定的 Endpoints

HTTP 請求

GET /api/v1/namespaces/{namespace}/endpoints/{name}

引數

  • name (在路徑中): string，必填

    Endpoints 的名稱

  • namespace (在路徑中): string，必填

    名稱空間

  • pretty (在查詢中): string

    pretty

響應

200 (Endpoints): 成功

401: 未授權

list 列出或監視 Endpoints 型別的物件

HTTP 請求

GET /api/v1/namespaces/{namespace}/endpoints

引數

響應

200 (EndpointsList): 成功

401: 未授權

list 列出或監視 Endpoints 型別的物件

HTTP 請求

GET /api/v1/endpoints

引數

響應

200 (EndpointsList): 成功

401: 未授權

create 建立 Endpoints

HTTP 請求

POST /api/v1/namespaces/{namespace}/endpoints

引數

響應

200 (Endpoints): 成功

201 (Endpoints): 已建立

202 (Endpoints): 已接受

401: 未授權

update 替換指定的 Endpoints

HTTP 請求

PUT /api/v1/namespaces/{namespace}/endpoints/{name}

引數

  • name (在路徑中): string，必填

    Endpoints 的名稱

  • namespace (在路徑中): string，必填

    名稱空間

  • body: Endpoints, 必需

  • dryRun (在查詢中): string

    dryRun

  • fieldManager (在查詢中): string

    fieldManager

  • fieldValidation (在查詢中): string

    fieldValidation

  • pretty (在查詢中): string

    pretty

響應

200 (Endpoints): 成功

201 (Endpoints): 已建立

401: 未授權

patch 部分更新指定的 Endpoints

HTTP 請求

PATCH /api/v1/namespaces/{namespace}/endpoints/{name}

引數

  • name (在路徑中): string，必填

    Endpoints 的名稱

  • namespace (在路徑中): string，必填

    名稱空間

  • body: Patch，必需

  • dryRun (在查詢中): string

    dryRun

  • fieldManager (在查詢中): string

    fieldManager

  • fieldValidation (在查詢中): string

    fieldValidation

  • force (在查詢中): boolean

    force

  • pretty (在查詢中): string

    pretty

響應

200 (Endpoints): 成功

201 (Endpoints): 已建立

401: 未授權

delete 刪除 Endpoints

HTTP 請求

DELETE /api/v1/namespaces/{namespace}/endpoints/{name}

引數

響應

200 (Status): OK

202 (Status): 已接受

401: 未授權

deletecollection 刪除 Endpoints 集合

HTTP 請求

DELETE /api/v1/namespaces/{namespace}/endpoints

引數

響應

200 (Status): OK

401: 未授權

本頁面是自動生成的。

如果你打算報告此頁面存在的問題，請在問題描述中提及此頁面是自動生成的。修復可能需要在 Kubernetes 專案的其他地方進行。

最後修改時間：2025 年 4 月 24 日上午 9:14 PST：v1.33 的 Markdown API 參考 (b84ec30bbb)