端點

Endpoints 是實作實際服務的端點集合。

apiVersion: v1

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

端點

Endpoints 是實作實際服務的端點集合。範例

Name: "mysvc", Subsets: [ { Addresses: [{"ip": "10.10.1.1"}, {"ip": "10.10.2.2"}], Ports: [{"name": "a", "port": 8675}, {"name": "b", "port": 309}] }, { Addresses: [{"ip": "10.10.3.3"}], Ports: [{"name": "a", "port": 93}, {"name": "b", "port": 76}] }, ]

  • apiVersion: v1

  • kind: Endpoints

  • metadata (ObjectMeta)

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

  • subsets ([]EndpointSubset)

    Atomic：將在合併期間被取代

    所有端點的集合是所有子集的聯集。位址根據它們共用的 IP 放置在子集中。具有多個連接埠的單一位址，其中一些連接埠已就緒，而另一些連接埠尚未就緒 (因為它們來自不同的容器)，將導致該位址針對不同的連接埠顯示在不同的子集中。在同一個子集中，沒有位址會同時出現在 Addresses 和 NotReadyAddresses 中。組成服務的位址和連接埠集合。

    *EndpointSubset 是一組具有通用連接埠集合的位址群組。擴展的端點集合是 Addresses x Ports 的笛卡爾積。例如，給定

    { Addresses: [{"ip": "10.10.1.1"}, {"ip": "10.10.2.2"}], Ports: [{"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 ]*

    • subsets.addresses ([]EndpointAddress)

      Atomic：將在合併期間被取代

      提供標記為就緒的相關連接埠的 IP 位址。這些端點應被視為對負載平衡器和用戶端來說是安全的。

      EndpointAddress 是一個描述單一 IP 位址的元組。

      • 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 (字串)

        選填：託管此端點的節點。這可以用於判斷節點本機的端點。

      • subsets.addresses.targetRef (ObjectReference)

        提供端點的物件參考。

    • subsets.notReadyAddresses ([]EndpointAddress)

      Atomic：將在合併期間被取代

      提供相關埠號的 IP 位址，但目前未標記為就緒，因為它們尚未完成啟動、最近未通過就緒探測，或最近未通過存活探測。

      EndpointAddress 是一個描述單一 IP 位址的元組。

      • subsets.notReadyAddresses.ip (字串), 必填

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

      • subsets.notReadyAddresses.hostname (字串)

        這個端點的主機名稱

      • subsets.notReadyAddresses.nodeName (字串)

        選填：託管此端點的節點。這可以用於判斷節點本機的端點。

      • subsets.notReadyAddresses.targetRef (ObjectReference)

        提供端點的物件參考。

    • subsets.ports ([]EndpointPort)

      Atomic：將在合併期間被取代

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

      EndpointPort 是一個描述單一埠號的元組。

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

        端點的埠號。

      • subsets.ports.protocol (字串)

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

      • subsets.ports.name (字串)

        此埠號的名稱。這必須與對應 ServicePort 中的 'name' 欄位一致。必須為 DNS_LABEL。僅當定義一個埠號時為選填。

      • subsets.ports.appProtocol (字串)

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

EndpointsList

EndpointsList 是端點的列表。

操作

get 讀取指定的 Endpoints

HTTP 請求

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

參數

  • name (在路徑中): 字串, 必填

    Endpoints 的名稱

  • namespace (在路徑中): 字串, 必填

    命名空間

  • pretty (在查詢中): 字串

    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}

參數

回應

200 (Endpoints): 成功

201 (Endpoints): 已建立

401: 未經授權

patch 部分更新指定的 Endpoints

HTTP 請求

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

參數

  • name (在路徑中): 字串, 必填

    Endpoints 的名稱

  • namespace (在路徑中): 字串, 必填

    命名空間

  • body: Patch, 必填

  • dryRun (在查詢中): 字串

    dryRun

  • fieldManager (在查詢中): 字串

    fieldManager

  • fieldValidation (在查詢中): 字串

    fieldValidation

  • force (在查詢中): 布林值

    force

  • pretty (在查詢中): 字串

    pretty

回應

200 (Endpoints): 成功

201 (Endpoints): 已建立

401: 未經授權

delete 刪除 Endpoints

HTTP 請求

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

參數

回應

200 (Status): 成功

202 (Status): 已接受

401: 未經授權

deletecollection 刪除 Endpoints 的集合

HTTP 請求

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

參數

回應

200 (Status): 成功

401: 未經授權

此頁面為自動產生。

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

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