Endpoints
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}]
},
]
Endpoints — это устаревший API, который не содержит информации обо всех функциях Service. Для получения полной информации о конечных точках Service используйте discoveryv1.EndpointSlice.
Устарело: этот API объявлен устаревшим в версии v1.33+. Используйте discoveryv1.EndpointSlice.
apiVersion: v1
import "k8s.io/api/core/v1"
Endpoints
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}]
},
]
Endpoints — это устаревший API, который не содержит информации обо всех функциях Service. Для получения полной информации о конечных точках Service используйте discoveryv1.EndpointSlice.
Устарело: этот API объявлен устаревшим в версии v1.33+. Используйте discoveryv1.EndpointSlice.
| Поле | Описание |
|---|---|
apiVersionstring |
APIVersion определяет версионированную схему этого представления объекта. Серверы должны преобразовывать распознанные схемы в последнее внутреннее значение и могут отклонять нераспознанные значения. Подробнее: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
kindstring |
Kind — строковое значение, представляющее ресурс REST, который представляет этот объект. Серверы могут определить его по конечной точке, на которую клиент отправляет запросы. Не может быть обновлено. В формате CamelCase. Подробнее: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
metadataObjectMeta |
Стандартные метаданные объекта. Подробнее: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata |
subsetsEndpointSubset array |
Множество всех конечных точек является объединением всех подмножеств. Адреса распределяются по подмножествам в соответствии с общими для них IP-адресами. Если один адрес связан с несколькими портами, часть из которых доступна, а часть нет (поскольку они относятся к разным контейнерам), этот адрес будет отображаться в разных подмножествах для соответствующих портов. В одном подмножестве адрес не может одновременно присутствовать в Addresses и NotReadyAddresses. Наборы адресов и портов, составляющие службу. |
EndpointsList
EndpointsList — это список конечных точек. Устарело: этот API объявлен устаревшим в версии v1.33+.
| Поле | Описание |
|---|---|
apiVersionstring |
APIVersion определяет версионированную схему этого представления объекта. Серверы должны преобразовывать распознанные схемы в последнее внутреннее значение и могут отклонять нераспознанные значения. Подробнее: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
items *Endpoints array |
Список конечных точек. |
kindstring |
Kind — строковое значение, представляющее ресурс REST, который представляет этот объект. Серверы могут определить его по конечной точке, на которую клиент отправляет запросы. Не может быть обновлено. В формате CamelCase. Подробнее: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
metadataListMeta |
Стандартные метаданные списка. Подробнее: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
EndpointAddress
EndpointAddress — это кортеж, описывающий один IP-адрес. Устарело: этот API объявлен устаревшим в версии v1.33+.
| Поле | Описание |
|---|---|
hostnamestring |
Имя хоста этой конечной точки |
ip *string |
IP-адрес этой конечной точки. Не может быть адресом обратной петли (127.0.0.0/8 или ::1), локальным адресом канала (169.254.0.0/16 или fe80::/10) или групповым адресом локального канала (224.0.0.0/24 или ff02::/16). |
nodeNamestring |
Необязательно: узел, на котором размещена эта конечная точка. Это можно использовать для определения конечных точек, локальных для узла. |
targetRefObjectReference |
Ссылка на объект, предоставляющий конечную точку. |
EndpointPort
EndpointPort — это кортеж, описывающий один порт. Устарело: этот API объявлен устаревшим в версии v1.33+.
| Поле | Описание |
|---|---|
appProtocolstring |
Протокол прикладного уровня для этого порта. Это поле используется как подсказка, позволяющая реализациям предоставлять расширенные возможности для поддерживаемых ими протоколов. Это поле соответствует стандартному синтаксису меток Kubernetes. Допустимые значения: * Непрефиксные имена протоколов — зарезервированы для стандартных имён служб IANA (согласно RFC-6335 и https://www.iana.org/assignments/service-names). * Имена с префиксом, определённые Kubernetes: * 'kubernetes.io/h2c' — HTTP/2 с предварительным знанием поверх незашифрованного соединения, как описано в https://www.rfc-editor.org/rfc/rfc9113.html#name-starting-http-2-with-prior- * 'kubernetes.io/ws' — WebSocket поверх незашифрованного соединения, как описано в https://www.rfc-editor.org/rfc/rfc6455 * 'kubernetes.io/wss' — WebSocket поверх TLS, как описано в https://www.rfc-editor.org/rfc/rfc6455 * Для других протоколов следует использовать имена с префиксом, определяемым реализацией, например mycompany.com/my-custom-protocol. |
namestring |
Имя этого порта. Оно должно совпадать со значением поля 'name' соответствующего ServicePort. Должно соответствовать формату DNS_LABEL. Необязательно, только если определён один порт. |
port *integer |
Номер порта конечной точки. |
protocolstring |
IP-протокол для этого порта. Должен быть UDP, TCP или SCTP. По умолчанию — TCP. Возможные значения перечисления: - `"SCTP"` — протокол SCTP. - `"TCP"` — протокол TCP. - `"UDP"` — протокол UDP. |
EndpointSubset
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 ]
Устарело: этот API объявлен устаревшим в версии v1.33+.
| Поле | Описание |
|---|---|
addressesEndpointAddress array |
IP-адреса, предоставляющие соответствующие порты и помеченные как готовые. Эти конечные точки следует считать безопасными для использования балансировщиками нагрузки и клиентами. |
notReadyAddressesEndpointAddress array |
IP-адреса, предоставляющие соответствующие порты, но в данный момент не помеченные как готовые, поскольку их запуск ещё не завершён, недавно не пройдена проверка готовности или недавно не пройдена проверка работоспособности. |
portsEndpointPort array |
Номера портов, доступных на соответствующих IP-адресах. |
© 2026 The Kubernetes Authors | Documentation Distributed under CC BY 4.0
Copyright © 2026 The Linux Foundation ®. All rights reserved.
https://kubernetes.io/docs/reference/kubernetes-api/core/endpoints-v1/