Spec-Zone.ru › Kubernetes

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.

Поле Описание
apiVersion
string
APIVersion определяет версионированную схему этого представления объекта. Серверы должны преобразовывать распознанные схемы в последнее внутреннее значение и могут отклонять нераспознанные значения. Подробнее: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
kind
string
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
subsets
EndpointSubset array
Множество всех конечных точек является объединением всех подмножеств. Адреса распределяются по подмножествам в соответствии с общими для них IP-адресами. Если один адрес связан с несколькими портами, часть из которых доступна, а часть нет (поскольку они относятся к разным контейнерам), этот адрес будет отображаться в разных подмножествах для соответствующих портов. В одном подмножестве адрес не может одновременно присутствовать в Addresses и NotReadyAddresses. Наборы адресов и портов, составляющие службу.

EndpointsList

EndpointsList — это список конечных точек. Устарело: этот API объявлен устаревшим в версии v1.33+.

Поле Описание
apiVersion
string
APIVersion определяет версионированную схему этого представления объекта. Серверы должны преобразовывать распознанные схемы в последнее внутреннее значение и могут отклонять нераспознанные значения. Подробнее: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
items *
Endpoints array
Список конечных точек.
kind
string
Kind — строковое значение, представляющее ресурс REST, который представляет этот объект. Серверы могут определить его по конечной точке, на которую клиент отправляет запросы. Не может быть обновлено. В формате CamelCase. Подробнее: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
metadata
ListMeta
Стандартные метаданные списка. Подробнее: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

EndpointAddress

EndpointAddress — это кортеж, описывающий один IP-адрес. Устарело: этот API объявлен устаревшим в версии v1.33+.

Поле Описание
hostname
string
Имя хоста этой конечной точки
ip *
string
IP-адрес этой конечной точки. Не может быть адресом обратной петли (127.0.0.0/8 или ::1), локальным адресом канала (169.254.0.0/16 или fe80::/10) или групповым адресом локального канала (224.0.0.0/24 или ff02::/16).
nodeName
string
Необязательно: узел, на котором размещена эта конечная точка. Это можно использовать для определения конечных точек, локальных для узла.
targetRef
ObjectReference
Ссылка на объект, предоставляющий конечную точку.

EndpointPort

EndpointPort — это кортеж, описывающий один порт. Устарело: этот API объявлен устаревшим в версии v1.33+.

Поле Описание
appProtocol
string
Протокол прикладного уровня для этого порта. Это поле используется как подсказка, позволяющая реализациям предоставлять расширенные возможности для поддерживаемых ими протоколов. Это поле соответствует стандартному синтаксису меток 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.
name
string
Имя этого порта. Оно должно совпадать со значением поля 'name' соответствующего ServicePort. Должно соответствовать формату DNS_LABEL. Необязательно, только если определён один порт.
port *
integer
Номер порта конечной точки.
protocol
string
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+.

Поле Описание
addresses
EndpointAddress array
IP-адреса, предоставляющие соответствующие порты и помеченные как готовые. Эти конечные точки следует считать безопасными для использования балансировщиками нагрузки и клиентами.
notReadyAddresses
EndpointAddress array
IP-адреса, предоставляющие соответствующие порты, но в данный момент не помеченные как готовые, поскольку их запуск ещё не завершён, недавно не пройдена проверка готовности или недавно не пройдена проверка работоспособности.
ports
EndpointPort 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/

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API