端点

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)

    标准对象的元数据。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

  • subsets ([]EndpointSubset)

    所有端点的集合是所有子集的并集。地址根据它们共享的 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)

      提供标记为已准备好的相关端口的 IP 地址。这些端点应被认为对负载均衡器和客户端安全使用。

      EndpointAddress 是一个元组，描述单个 IP 地址。

      • subsets.addresses.ip (string), required

        此端点的 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 地址。

      • subsets.notReadyAddresses.ip (string), required

        此端点的 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 是一个元组，描述单个端口。

      • subsets.ports.port (int32), required

        端点的端口号。

      • subsets.ports.protocol (string)

        此端口的 IP 协议。必须是 UDP、TCP 或 SCTP。默认值为 TCP。

      • subsets.ports.name (string)

        此端口的名称。这必须与相应 ServicePort 中的“name”字段匹配。必须是 DNS_LABEL。仅当定义了一个端口时，可选。

      • subsets.ports.appProtocol (string)

        此端口的应用程序协议。这用作实现的提示，以便为它们理解的协议提供更丰富的行为。此字段遵循标准 Kubernetes 标签语法。有效值为

EndpointsList

EndpointsList 是端点的列表。

操作

get 读取指定的 Endpoints

HTTP 请求

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

参数

  • name (in path): string, required

    Endpoints 的名称

  • namespace (in path): string, required

    命名空间

  • pretty (in query): string

    pretty

响应

200 (Endpoints): OK

401: Unauthorized

list 列出或观察 Endpoints 类型的对象

HTTP 请求

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

参数

响应

200 (EndpointsList): OK

401: Unauthorized

list 列出或观察 Endpoints 类型的对象

HTTP 请求

GET /api/v1/endpoints

参数

响应

200 (EndpointsList): OK

401: Unauthorized

create 创建 Endpoints

HTTP 请求

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

参数

响应

200 (Endpoints): OK

201 (Endpoints): Created

202 (Endpoints): Accepted

401: Unauthorized

update 替换指定的 Endpoints

HTTP 请求

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

参数

响应

200 (Endpoints): OK

201 (Endpoints): Created

401: Unauthorized

patch 部分更新指定的 Endpoints

HTTP 请求

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

参数

  • name (in path): string, required

    Endpoints 的名称

  • namespace (in path): string, required

    命名空间

  • body: Patch, required

  • dryRun (in query): string

    dryRun

  • fieldManager (in query): string

    fieldManager

  • fieldValidation (in query): string

    fieldValidation

  • force (in query): boolean

    force

  • pretty (in query): string

    pretty

响应

200 (Endpoints): OK

201 (Endpoints): Created

401: Unauthorized

delete 删除 Endpoints

HTTP 请求

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

参数

响应

200 (Status): OK

202 (Status): Accepted

401: Unauthorized

deletecollection 删除 Endpoints 集合

HTTP 请求

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

参数

响应

200 (Status): OK

401: Unauthorized

此页面是自动生成的。

如果您打算报告此页面的问题，请在您的问题描述中提及该页面是自动生成的。修复可能需要在 Kubernetes 项目的其他地方进行。

上次修改时间：2023 年 7 月 26 日下午 1:45 PST：生成的內容 (1e2ed88743)