15.3. Endpoints [v1]

描述: 端点是实施实际服务的端点集合。示例： Name: "mysvc", Subsets: [{"ip": "10.10.1.1"}, {"ip": "10.10.2.2"}], Ports: [{"name": "a", "port": 8675}, {"name": "b", "port": 309}] }, { address: [{"ip": "10.10.3.3"}], ports: [{"name": "a", "port": 93}, {"name": "b", "port": 76}] }, ]
类型: 对象

15.3.1. 规格
复制链接

Expand

属性	类型	描述
`apiVersion`	`字符串`	APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`kind`	`字符串`	kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`metadata`	`ObjectMeta`	标准对象元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
`子集`	`array`	所有端点的集合都是所有子集的 union。地址会根据它们共享的 IP 放入子集中。含有多个端口的单一地址，其中的一些地址已就绪，有些地址不是（因为它们来自不同容器）将导致地址显示在不同端口的不同子集中。同一子集中的 Address 和 NotReadyAddresses 中都不会显示任何地址。组成服务的地址和端口集。
`subsets[]`	`对象`	EndpointSubset 是一组带有通用端口的地址。扩展的一组端点是 Address x Portsian 的产品。例如，给定：{ Address: [{"ip": "10.10.1.1"}, {"ip": "10.10.2.2"}], Ports: [{"name": "a", "port": 8675}, {"name": "b", "port": 309}] } The生成的端点集为： [ 10.10.1.1:8675, 10.10.2.2:8675 ], b: [ 10.10.1.1:309, 10.10.2.2:309 ]

15.3.1.1. .subsets
复制链接

描述: 所有端点的集合都是所有子集的 union。地址会根据它们共享的 IP 放入子集中。含有多个端口的单一地址，其中的一些地址已就绪，有些地址不是（因为它们来自不同容器）将导致地址显示在不同端口的不同子集中。同一子集中的 Address 和 NotReadyAddresses 中都不会显示任何地址。组成服务的地址和端口集。
类型: array

15.3.1.2. .subsets[]
复制链接

描述: EndpointSubset 是一组带有通用端口的地址。扩展的一组端点是 Address x Portsian 的产品。例如，给定：{ Address: [{"ip": "10.10.1.1"}, {"ip": "10.10.2.2"}], Ports: [{"name": "a", "port": 8675}, {"name": "b", "port": 309}] } The生成的端点集为： [ 10.10.1.1:8675, 10.10.2.2:8675 ], b: [ 10.10.1.1:309, 10.10.2.2:309 ]
类型: 对象

Expand

属性	类型	描述
`addresses`	`array`	提供标记为 ready 的相关端口的 IP 地址。对于要使用的负载均衡器和客户端，这些端点应被视为安全。
`addresses[]`	`对象`	EndpointAddress 是一个描述单个 IP 地址的元组。
`notReadyAddresses`	`array`	提供相关端口但当前未标记为 ready 的 IP 地址，因为它们尚未完成、最近就绪度检查失败，或者最近已进行存活度检查失败。
`notReadyAddresses[]`	`对象`	EndpointAddress 是一个描述单个 IP 地址的元组。
`ports`	`array`	相关 IP 地址中可用端口号。
`ports[]`	`对象`	EndpointPort 是一个描述单个端口的元组。

15.3.1.3. .subsets[].addresses
复制链接

描述: 提供标记为 ready 的相关端口的 IP 地址。对于要使用的负载均衡器和客户端，这些端点应被视为安全。
类型: array

15.3.1.4. .subsets[].addresses[]
复制链接

描述

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

类型

对象

必填

ip

Expand

属性	类型	描述
`hostname`	`字符串`	此端点的主机名
`ip`	`字符串`	此端点的 IP。可能不是 loopback (127.0.0.0/8)、link-local (169.254.0.0/16)或 link-local multicast （(224.0.0.0/24)。IPv6 也被接受，但不会在所有平台上被完全支持。另外，某些 kubernetes 组件（如 kube-proxy）没有就绪。
`nodeName`	`字符串`	可选：托管此端点的节点。这可用于决定节点本地的端点。
`targetRef`	`对象`	ObjectReference 包含足够信息供您检查或修改引用的对象。

15.3.1.5. .subsets[].addresses[].targetRef
复制链接

描述: ObjectReference 包含足够信息供您检查或修改引用的对象。
类型: 对象

Expand

属性	类型	描述
`apiVersion`	`字符串`	引用的 API 版本。
`fieldPath`	`字符串`	如果引用的是对象的一部分而非整个对象，则该字符串应包含有效的 JSON/Go 字段访问声明，如 desiredState.manifest.containers[2]。例如，如果对象引用是一个 pod 中的容器，它应该还以下类似： "spec.containers{name}"（其中 "name" 是指触发事件的容器的名称）,如果不使用容器名称，则应类似于 "spec.containers[2]"（使用此 pod 中索引值为 2 的容器）。选择这个语法的原因是，为了有一些指向对象部分的正确定义方法。
`kind`	`字符串`	引用的类型。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`name`	`字符串`	引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
`namespace`	`字符串`	引用的命名空间。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/
`resourceVersion`	`字符串`	指定构成这个引用的 resourceVersion（如果存在）。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency
`uid`	`字符串`	引用的 UID。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids

15.3.1.6. .subsets[].notReadyAddresses
复制链接

描述: 提供相关端口但当前未标记为 ready 的 IP 地址，因为它们尚未完成、最近就绪度检查失败，或者最近已进行存活度检查失败。
类型: array

15.3.1.7. .subsets[].notReadyAddresses[]
复制链接

描述

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

类型

对象

必填

ip

Expand

属性	类型	描述
`hostname`	`字符串`	此端点的主机名
`ip`	`字符串`	此端点的 IP。可能不是 loopback (127.0.0.0/8)、link-local (169.254.0.0/16)或 link-local multicast （(224.0.0.0/24)。IPv6 也被接受，但不会在所有平台上被完全支持。另外，某些 kubernetes 组件（如 kube-proxy）没有就绪。
`nodeName`	`字符串`	可选：托管此端点的节点。这可用于决定节点本地的端点。
`targetRef`	`对象`	ObjectReference 包含足够信息供您检查或修改引用的对象。

15.3.1.8. .subsets[].notReadyAddresses[].targetRef
复制链接

描述: ObjectReference 包含足够信息供您检查或修改引用的对象。
类型: 对象

Expand

属性	类型	描述
`apiVersion`	`字符串`	引用的 API 版本。
`fieldPath`	`字符串`	如果引用的是对象的一部分而非整个对象，则该字符串应包含有效的 JSON/Go 字段访问声明，如 desiredState.manifest.containers[2]。例如，如果对象引用是一个 pod 中的容器，它应该还以下类似： "spec.containers{name}"（其中 "name" 是指触发事件的容器的名称）,如果不使用容器名称，则应类似于 "spec.containers[2]"（使用此 pod 中索引值为 2 的容器）。选择这个语法的原因是，为了有一些指向对象部分的正确定义方法。
`kind`	`字符串`	引用的类型。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`name`	`字符串`	引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
`namespace`	`字符串`	引用的命名空间。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/
`resourceVersion`	`字符串`	指定构成这个引用的 resourceVersion（如果存在）。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency
`uid`	`字符串`	引用的 UID。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids

15.3.1.9. .subsets[].ports
复制链接

描述: 相关 IP 地址中可用端口号。
类型: array

15.3.1.10. .subsets[].ports[]
复制链接

描述

EndpointPort 是一个描述单个端口的元组。

类型

对象

必填

port

Expand

属性	类型	描述
`appProtocol`	`字符串`	此端口的应用程序协议。此字段遵循标准 Kubernetes 标签语法。未前缀的名称是为 IANA 标准服务名称保留的（与 RFC-6335 和 http://www.iana.org/assignments/service-names一样）。非标准协议应使用前缀名称，如 mycompany.com/my-custom-protocol。
`name`	`字符串`	此端口的名称。这必须与对应的 ServicePort 中的 'name' 字段匹配。必须是 DNS_LABEL。仅在定义了端口时可选。
`port`	`整数`	端点的端口号。
`protocol`	`字符串`	此端口的 IP 协议。必须是 UDP、TCP 或 SCTP。默认为 TCP。

15.3.2. API 端点
复制链接

可用的 API 端点如下：

/api/v1/endpoints
- GET: 列出或监视 Endpoints 类型的对象
/api/v1/watch/endpoints
- GET: 观察对 Endpoints 列表的各个更改。已弃用：将 'watch' 参数与列表操作一起使用。
/api/v1/namespaces/{namespace}/endpoints
- DELETE ：删除端点的集合
- GET: 列出或监视 Endpoints 类型的对象
- POST ：创建端点
/api/v1/watch/namespaces/{namespace}/endpoints
- GET: 观察对 Endpoints 列表的各个更改。已弃用：将 'watch' 参数与列表操作一起使用。
/api/v1/namespaces/{namespace}/endpoints/{name}
- DELETE ：删除端点
- GET ：读取指定的端点
- PATCH ：部分更新指定的端点
- PUT ：替换指定的端点
/api/v1/watch/namespaces/{namespace}/endpoints/{name}
- GET: 观察对 Endpoints 类型的对象的更改。已弃用：使用带有列表操作的 'watch' 参数，而是过滤到带有 'fieldSelector' 参数的单个项目。

15.3.2.1. /api/v1/endpoints
复制链接

Expand

表 15.22. 全局查询参数
参数	类型	描述
`allowWatchBookmarks`	`布尔值`	allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签，由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回，也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视，则忽略此字段。
`继续`	`字符串`	从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须在没有 continue 字段的情况下重启其列表。否则，客户端可能会发送另一个列表请求，并带有 410 错误收到的令牌，服务器将通过从下一个密钥开始的列表进行响应，但从最新的快照（从最后一个列表结果中不一致） - 在第一个列表请求后创建、修改或删除的对象将包含在响应中，只要其密钥在"next key"后。当 watch 为 true 时，不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视，而不丢失任何修改。
`fieldSelector`	`字符串`	用于限制返回的对象列表的选择器。默认为任何内容。
`labelSelector`	`字符串`	通过标签限制返回的对象列表的选择器。默认为任何内容。
`limit`	`整数`	限制是列表调用要返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值，以检索下一个结果集。在过滤所有请求的对象时，设置限制可能会返回比请求的项目数量少（最多为零项），客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数，并将返回所有可用的结果。如果指定了限制，并且 continue 字段为空，客户端可能会假设没有更多可用的结果。如果 watch 为 true，则不支持此字段。服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象，则返回第一次列表结果时存在的对象版本。
`pretty`	`字符串`	如果 'true'，则输出被用户友善。
`resourceVersion`	`字符串`	resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置
`resourceVersionMatch`	`字符串`	resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。默认为未设置
`timeoutSeconds`	`整数`	list/watch 调用的超时。这限制了调用的时间，无论任何活动或不活跃。
`watch`	`布尔值`	观察对描述的资源的更改，并将其作为添加、更新和删除通知流返回。指定 resourceVersion。

HTTP 方法: GET
描述: 列出或监视端点类型的对象

Expand

表 15.23. HTTP 响应
HTTP 代码	响应正文
200 - OK	`EndpointsList` schema
401 - Unauthorized	空

15.3.2.2. /api/v1/watch/endpoints
复制链接

Expand

表 15.24. 全局查询参数
参数	类型	描述
`allowWatchBookmarks`	`布尔值`	allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签，由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回，也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视，则忽略此字段。
`继续`	`字符串`	从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须在没有 continue 字段的情况下重启其列表。否则，客户端可能会发送另一个列表请求，并带有 410 错误收到的令牌，服务器将通过从下一个密钥开始的列表进行响应，但从最新的快照（从最后一个列表结果中不一致） - 在第一个列表请求后创建、修改或删除的对象将包含在响应中，只要其密钥在"next key"后。当 watch 为 true 时，不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视，而不丢失任何修改。
`fieldSelector`	`字符串`	用于限制返回的对象列表的选择器。默认为任何内容。
`labelSelector`	`字符串`	通过标签限制返回的对象列表的选择器。默认为任何内容。
`limit`	`整数`	限制是列表调用要返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值，以检索下一个结果集。在过滤所有请求的对象时，设置限制可能会返回比请求的项目数量少（最多为零项），客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数，并将返回所有可用的结果。如果指定了限制，并且 continue 字段为空，客户端可能会假设没有更多可用的结果。如果 watch 为 true，则不支持此字段。服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象，则返回第一次列表结果时存在的对象版本。
`pretty`	`字符串`	如果 'true'，则输出被用户友善。
`resourceVersion`	`字符串`	resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置
`resourceVersionMatch`	`字符串`	resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。默认为未设置
`timeoutSeconds`	`整数`	list/watch 调用的超时。这限制了调用的时间，无论任何活动或不活跃。
`watch`	`布尔值`	观察对描述的资源的更改，并将其作为添加、更新和删除通知流返回。指定 resourceVersion。

HTTP 方法: GET
描述: 观察单个对 Endpoints 列表的更改。已弃用：改为使用 'watch' 参数以及 list 操作。

Expand

表 15.25. HTTP 响应
HTTP 代码	响应正文
200 - OK	`WatchEvent` 模式
401 - Unauthorized	空

15.3.2.3. /api/v1/namespaces/{namespace}/endpoints
复制链接

Expand

表 15.26. 全局路径参数
参数	类型	描述
`namespace`	`字符串`	对象名称和身份验证范围，如团队和项目

Expand

表 15.27. 全局查询参数
参数	类型	描述
`pretty`	`字符串`	如果 'true'，则输出被用户友善。

HTTP 方法: DELETE
描述: 删除端点集合

Expand

表 15.28. 查询参数
参数	类型	描述
`继续`	`字符串`	从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须在没有 continue 字段的情况下重启其列表。否则，客户端可能会发送另一个列表请求，并带有 410 错误收到的令牌，服务器将通过从下一个密钥开始的列表进行响应，但从最新的快照（从最后一个列表结果中不一致） - 在第一个列表请求后创建、修改或删除的对象将包含在响应中，只要其密钥在"next key"后。当 watch 为 true 时，不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视，而不丢失任何修改。
`dryRun`	`字符串`	出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理
`fieldSelector`	`字符串`	用于限制返回的对象列表的选择器。默认为任何内容。
`gracePeriodSeconds`	`整数`	应该删除对象前的持续时间（以秒为单位）。值必须是非负整数。值零表示立即删除。如果这个值是 nil，则使用指定类型的默认宽限期。如果没有指定，则默认为每个对象值。零表示立即删除。
`labelSelector`	`字符串`	通过标签限制返回的对象列表的选择器。默认为任何内容。
`limit`	`整数`	限制是列表调用要返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值，以检索下一个结果集。在过滤所有请求的对象时，设置限制可能会返回比请求的项目数量少（最多为零项），客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数，并将返回所有可用的结果。如果指定了限制，并且 continue 字段为空，客户端可能会假设没有更多可用的结果。如果 watch 为 true，则不支持此字段。服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象，则返回第一次列表结果时存在的对象版本。
`orphanDependents`	`布尔值`	弃用：请使用 PropagationPolicy，此字段将在 1.7 中被弃用。应该依赖的对象被孤立。如果为 true/false，"orphan"终结器将从对象的终结器列表添加到/删除。可以设置此字段或 PropagationPolicy，但不能同时设置两者。
`propagationPolicy`	`字符串`	是否以及是否执行垃圾回收。此字段或 OrphanDependents 可以设置，但不能同时设置两者。默认策略由 metadata.finalizers 和特定于资源的默认策略中设置的现有终结器决定。可接受的值为： 'Orphan' - 孤立依赖; 'Background' - 允许垃圾收集器在后台删除依赖的依赖关系； 'Foreground' - 一个删除前台所有依赖的级联策略。
`resourceVersion`	`字符串`	resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置
`resourceVersionMatch`	`字符串`	resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。默认为未设置
`timeoutSeconds`	`整数`	list/watch 调用的超时。这限制了调用的时间，无论任何活动或不活跃。

Expand

表 15.29. 主体参数
参数	类型	描述
`正文（body）`	`DeleteOptions` 模式

Expand

表 15.30. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Status` 模式
401 - Unauthorized	空

HTTP 方法: GET
描述: 列出或监视端点类型的对象

Expand

表 15.31. 查询参数
参数	类型	描述
`allowWatchBookmarks`	`布尔值`	allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签，由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回，也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视，则忽略此字段。
`继续`	`字符串`	从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须在没有 continue 字段的情况下重启其列表。否则，客户端可能会发送另一个列表请求，并带有 410 错误收到的令牌，服务器将通过从下一个密钥开始的列表进行响应，但从最新的快照（从最后一个列表结果中不一致） - 在第一个列表请求后创建、修改或删除的对象将包含在响应中，只要其密钥在"next key"后。当 watch 为 true 时，不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视，而不丢失任何修改。
`fieldSelector`	`字符串`	用于限制返回的对象列表的选择器。默认为任何内容。
`labelSelector`	`字符串`	通过标签限制返回的对象列表的选择器。默认为任何内容。
`limit`	`整数`	限制是列表调用要返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值，以检索下一个结果集。在过滤所有请求的对象时，设置限制可能会返回比请求的项目数量少（最多为零项），客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数，并将返回所有可用的结果。如果指定了限制，并且 continue 字段为空，客户端可能会假设没有更多可用的结果。如果 watch 为 true，则不支持此字段。服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象，则返回第一次列表结果时存在的对象版本。
`resourceVersion`	`字符串`	resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置
`resourceVersionMatch`	`字符串`	resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。默认为未设置
`timeoutSeconds`	`整数`	list/watch 调用的超时。这限制了调用的时间，无论任何活动或不活跃。
`watch`	`布尔值`	观察对描述的资源的更改，并将其作为添加、更新和删除通知流返回。指定 resourceVersion。

Expand

表 15.32. HTTP 响应
HTTP 代码	响应正文
200 - OK	`EndpointsList` schema
401 - Unauthorized	空

HTTP 方法: POST
描述: 创建端点

Expand

表 15.33. 查询参数
参数	类型	描述
`dryRun`	`字符串`	出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理
`fieldManager`	`字符串`	fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand

表 15.34. 主体参数
参数	类型	描述
`正文（body）`	`Endpoints` 模式

Expand

表 15.35. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Endpoints` 模式
201 - Created	`Endpoints` 模式
202 - Accepted	`Endpoints` 模式
401 - Unauthorized	空

15.3.2.4. /api/v1/watch/namespaces/{namespace}/endpoints
复制链接

Expand

表 15.36. 全局路径参数
参数	类型	描述
`namespace`	`字符串`	对象名称和身份验证范围，如团队和项目

Expand

表 15.37. 全局查询参数
参数	类型	描述
`allowWatchBookmarks`	`布尔值`	allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签，由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回，也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视，则忽略此字段。
`继续`	`字符串`	从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须在没有 continue 字段的情况下重启其列表。否则，客户端可能会发送另一个列表请求，并带有 410 错误收到的令牌，服务器将通过从下一个密钥开始的列表进行响应，但从最新的快照（从最后一个列表结果中不一致） - 在第一个列表请求后创建、修改或删除的对象将包含在响应中，只要其密钥在"next key"后。当 watch 为 true 时，不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视，而不丢失任何修改。
`fieldSelector`	`字符串`	用于限制返回的对象列表的选择器。默认为任何内容。
`labelSelector`	`字符串`	通过标签限制返回的对象列表的选择器。默认为任何内容。
`limit`	`整数`	限制是列表调用要返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值，以检索下一个结果集。在过滤所有请求的对象时，设置限制可能会返回比请求的项目数量少（最多为零项），客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数，并将返回所有可用的结果。如果指定了限制，并且 continue 字段为空，客户端可能会假设没有更多可用的结果。如果 watch 为 true，则不支持此字段。服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象，则返回第一次列表结果时存在的对象版本。
`pretty`	`字符串`	如果 'true'，则输出被用户友善。
`resourceVersion`	`字符串`	resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置
`resourceVersionMatch`	`字符串`	resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。默认为未设置
`timeoutSeconds`	`整数`	list/watch 调用的超时。这限制了调用的时间，无论任何活动或不活跃。
`watch`	`布尔值`	观察对描述的资源的更改，并将其作为添加、更新和删除通知流返回。指定 resourceVersion。

HTTP 方法: GET
描述: 观察单个对 Endpoints 列表的更改。已弃用：改为使用 'watch' 参数以及 list 操作。

Expand

表 15.38. HTTP 响应
HTTP 代码	响应正文
200 - OK	`WatchEvent` 模式
401 - Unauthorized	空

15.3.2.5. /api/v1/namespaces/{namespace}/endpoints/{name}
复制链接

Expand

表 15.39. 全局路径参数
参数	类型	描述
`name`	`字符串`	端点的名称
`namespace`	`字符串`	对象名称和身份验证范围，如团队和项目

Expand

表 15.40. 全局查询参数
参数	类型	描述
`pretty`	`字符串`	如果 'true'，则输出被用户友善。

HTTP 方法: DELETE
描述: 删除端点

Expand

表 15.41. 查询参数
参数	类型	描述
`dryRun`	`字符串`	出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理
`gracePeriodSeconds`	`整数`	应该删除对象前的持续时间（以秒为单位）。值必须是非负整数。值零表示立即删除。如果这个值是 nil，则使用指定类型的默认宽限期。如果没有指定，则默认为每个对象值。零表示立即删除。
`orphanDependents`	`布尔值`	弃用：请使用 PropagationPolicy，此字段将在 1.7 中被弃用。应该依赖的对象被孤立。如果为 true/false，"orphan"终结器将从对象的终结器列表添加到/删除。可以设置此字段或 PropagationPolicy，但不能同时设置两者。
`propagationPolicy`	`字符串`	是否以及是否执行垃圾回收。此字段或 OrphanDependents 可以设置，但不能同时设置两者。默认策略由 metadata.finalizers 和特定于资源的默认策略中设置的现有终结器决定。可接受的值为： 'Orphan' - 孤立依赖; 'Background' - 允许垃圾收集器在后台删除依赖的依赖关系； 'Foreground' - 一个删除前台所有依赖的级联策略。

Expand

表 15.42. 主体参数
参数	类型	描述
`正文（body）`	`DeleteOptions` 模式

Expand

表 15.43. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Status` 模式
202 - Accepted	`Status` 模式
401 - Unauthorized	空

HTTP 方法: GET
描述: 读取指定的端点

Expand

表 15.44. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Endpoints` 模式
401 - Unauthorized	空

HTTP 方法: PATCH
描述: 部分更新指定的端点

Expand

表 15.45. 查询参数
参数	类型	描述
`dryRun`	`字符串`	出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理
`fieldManager`	`字符串`	fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。应用请求(application/apply-patch)需要此字段，但对于非应用补丁类型(JsonPatch、MergePatch、OptMergePatch)是可选的。
`force`	`布尔值`	强制将"强制"应用请求。这意味着用户会重新清空由其他人员拥有的冲突字段。对于非应用补丁请求，必须取消设置 force 标志。

Expand

表 15.46. 主体参数
参数	类型	描述
`正文（body）`	`Patch` 模式

Expand

表 15.47. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Endpoints` 模式
201 - Created	`Endpoints` 模式
401 - Unauthorized	空

HTTP 方法: PUT
描述: 替换指定的端点

Expand

表 15.48. 查询参数
参数	类型	描述
`dryRun`	`字符串`	出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理
`fieldManager`	`字符串`	fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand

表 15.49. 主体参数
参数	类型	描述
`正文（body）`	`Endpoints` 模式

Expand

表 15.50. HTTP 响应
HTTP 代码	响应正文
200 - OK	`Endpoints` 模式
201 - Created	`Endpoints` 模式
401 - Unauthorized	空

15.3.2.6. /api/v1/watch/namespaces/{namespace}/endpoints/{name}
复制链接

Expand

表 15.51. 全局路径参数
参数	类型	描述
`name`	`字符串`	端点的名称
`namespace`	`字符串`	对象名称和身份验证范围，如团队和项目

Expand

表 15.52. 全局查询参数
参数	类型	描述
`allowWatchBookmarks`	`布尔值`	allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签，由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回，也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视，则忽略此字段。
`继续`	`字符串`	从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须在没有 continue 字段的情况下重启其列表。否则，客户端可能会发送另一个列表请求，并带有 410 错误收到的令牌，服务器将通过从下一个密钥开始的列表进行响应，但从最新的快照（从最后一个列表结果中不一致） - 在第一个列表请求后创建、修改或删除的对象将包含在响应中，只要其密钥在"next key"后。当 watch 为 true 时，不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视，而不丢失任何修改。
`fieldSelector`	`字符串`	用于限制返回的对象列表的选择器。默认为任何内容。
`labelSelector`	`字符串`	通过标签限制返回的对象列表的选择器。默认为任何内容。
`limit`	`整数`	限制是列表调用要返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值，以检索下一个结果集。在过滤所有请求的对象时，设置限制可能会返回比请求的项目数量少（最多为零项），客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数，并将返回所有可用的结果。如果指定了限制，并且 continue 字段为空，客户端可能会假设没有更多可用的结果。如果 watch 为 true，则不支持此字段。服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象，则返回第一次列表结果时存在的对象版本。
`pretty`	`字符串`	如果 'true'，则输出被用户友善。
`resourceVersion`	`字符串`	resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置
`resourceVersionMatch`	`字符串`	resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。默认为未设置
`timeoutSeconds`	`整数`	list/watch 调用的超时。这限制了调用的时间，无论任何活动或不活跃。
`watch`	`布尔值`	观察对描述的资源的更改，并将其作为添加、更新和删除通知流返回。指定 resourceVersion。

HTTP 方法: GET
描述: 观察对 Endpoints 类型的对象的更改。已弃用：使用带有列表操作的 'watch' 参数，而是过滤到带有 'fieldSelector' 参数的单个项目。

Expand

表 15.53. HTTP 响应
HTTP 代码	响应正文
200 - OK	`WatchEvent` 模式
401 - Unauthorized	空

返回顶部

15.3. Endpoints [v1]

15.3.1. 规格
复制链接

15.3.1.1. .subsets
复制链接

15.3.1.2. .subsets[]
复制链接

15.3.1.3. .subsets[].addresses
复制链接

15.3.1.4. .subsets[].addresses[]
复制链接

15.3.1.5. .subsets[].addresses[].targetRef
复制链接

15.3.1.6. .subsets[].notReadyAddresses
复制链接

15.3.1.7. .subsets[].notReadyAddresses[]
复制链接

15.3.1.8. .subsets[].notReadyAddresses[].targetRef
复制链接

15.3.1.9. .subsets[].ports
复制链接

15.3.1.10. .subsets[].ports[]
复制链接

15.3.2. API 端点
复制链接

15.3.2.1. /api/v1/endpoints
复制链接

15.3.2.2. /api/v1/watch/endpoints
复制链接

15.3.2.3. /api/v1/namespaces/{namespace}/endpoints
复制链接

15.3.2.4. /api/v1/watch/namespaces/{namespace}/endpoints
复制链接

15.3.2.5. /api/v1/namespaces/{namespace}/endpoints/{name}
复制链接

15.3.2.6. /api/v1/watch/namespaces/{namespace}/endpoints/{name}
复制链接

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

15.3. Endpoints [v1]

15.3.1. 规格复制链接链接已复制到粘贴板!

15.3.1.1. .subsets复制链接链接已复制到粘贴板!

15.3.1.2. .subsets[]复制链接链接已复制到粘贴板!

15.3.1.3. .subsets[].addresses复制链接链接已复制到粘贴板!

15.3.1.4. .subsets[].addresses[]复制链接链接已复制到粘贴板!

15.3.1.5. .subsets[].addresses[].targetRef复制链接链接已复制到粘贴板!

15.3.1.6. .subsets[].notReadyAddresses复制链接链接已复制到粘贴板!

15.3.1.7. .subsets[].notReadyAddresses[]复制链接链接已复制到粘贴板!

15.3.1.8. .subsets[].notReadyAddresses[].targetRef复制链接链接已复制到粘贴板!

15.3.1.9. .subsets[].ports复制链接链接已复制到粘贴板!

15.3.1.10. .subsets[].ports[]复制链接链接已复制到粘贴板!

15.3.2. API 端点复制链接链接已复制到粘贴板!

15.3.2.1. /api/v1/endpoints复制链接链接已复制到粘贴板!

15.3.2.2. /api/v1/watch/endpoints复制链接链接已复制到粘贴板!

15.3.2.3. /api/v1/namespaces/{namespace}/endpoints复制链接链接已复制到粘贴板!

15.3.2.4. /api/v1/watch/namespaces/{namespace}/endpoints复制链接链接已复制到粘贴板!

15.3.2.5. /api/v1/namespaces/{namespace}/endpoints/{name}复制链接链接已复制到粘贴板!

15.3.2.6. /api/v1/watch/namespaces/{namespace}/endpoints/{name}复制链接链接已复制到粘贴板!

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

15.3.1. 规格
复制链接

15.3.1.1. .subsets
复制链接

15.3.1.2. .subsets[]
复制链接

15.3.1.3. .subsets[].addresses
复制链接

15.3.1.4. .subsets[].addresses[]
复制链接

15.3.1.5. .subsets[].addresses[].targetRef
复制链接

15.3.1.6. .subsets[].notReadyAddresses
复制链接

15.3.1.7. .subsets[].notReadyAddresses[]
复制链接

15.3.1.8. .subsets[].notReadyAddresses[].targetRef
复制链接

15.3.1.9. .subsets[].ports
复制链接

15.3.1.10. .subsets[].ports[]
复制链接

15.3.2. API 端点
复制链接

15.3.2.1. /api/v1/endpoints
复制链接

15.3.2.2. /api/v1/watch/endpoints
复制链接

15.3.2.3. /api/v1/namespaces/{namespace}/endpoints
复制链接

15.3.2.4. /api/v1/watch/namespaces/{namespace}/endpoints
复制链接

15.3.2.5. /api/v1/namespaces/{namespace}/endpoints/{name}
复制链接

15.3.2.6. /api/v1/watch/namespaces/{namespace}/endpoints/{name}
复制链接