APIService

APIService представляет сервер для определённой GroupVersion. Имя должно иметь формат "version.group".

apiVersion: apiregistration.k8s.io/v1

import "k8s.io/kube-aggregator/pkg/apis/apiregistration/v1"

APIService

APIService представляет сервер для определённой GroupVersion. Имя должно иметь формат "version.group".

Поле	Описание
`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
`spec` APIServiceSpec	Spec содержит информацию, необходимую для поиска сервера и взаимодействия с ним
`status` APIServiceStatus	Status содержит производную информацию о сервере API

APIServiceSpec

APIServiceSpec содержит информацию, необходимую для поиска сервера и взаимодействия с ним. Поддерживается только https, однако проверку сертификата можно отключить.

Поле	Описание
`caBundle` string	CABundle — это закодированный в формате PEM пакет центров сертификации, который будет использоваться для проверки сертификата сервера API. Если значение не указано, используются системные корневые сертификаты доверия на apiserver.
`group` string	Group — имя группы API, которую обслуживает этот сервер
`groupPriorityMinimum` * integer	GroupPriorityMinimum — минимальный приоритет, который должна иметь эта группа. Чем выше приоритет, тем предпочтительнее группа для клиентов по сравнению с группами с более низким приоритетом. Обратите внимание, что для других версий этой группы могут быть указаны ещё более высокие значения GroupPriorityMinimum, благодаря чему вся группа получит более высокий приоритет. Первичная сортировка выполняется по GroupPriorityMinimum в порядке убывания (20 перед 10). Вторичная сортировка выполняется в алфавитном порядке по имени объекта (v1.bar перед v1.foo). Рекомендуется использовать значение около 18000 для *.k8s.io (кроме extensions), а для PaaS-систем (OpenShift, Deis) — значения в диапазоне 2000.
`insecureSkipTLSVerify` boolean	InsecureSkipTLSVerify отключает проверку сертификата TLS при взаимодействии с этим сервером. Настоятельно не рекомендуется использовать этот параметр. Вместо него следует использовать CABundle.
`service` ServiceReference	Service — ссылка на сервис этого сервера API. Он должен принимать соединения на порту 443. Если Service равен nil, это означает, что обработка данной группы и версии API выполняется локально на этом сервере. Запрос будет просто передан обычной цепочке обработчиков для выполнения.
`version` string	Version — версия API, которую обслуживает этот сервер. Например, "v1"
`versionPriority` * integer	VersionPriority определяет порядок этой версии API внутри её группы. Значение должно быть больше нуля. Первичная сортировка выполняется по VersionPriority в порядке убывания (20 перед 10). Поскольку сортировка выполняется внутри группы, значение может быть небольшим, вероятно, в диапазоне десятков. Если приоритеты версий совпадают, для определения порядка внутри группы используется строка версии. Если строка версии соответствует формату "kube-like", она будет располагаться выше строк версий, не соответствующих этому формату; последние сортируются лексикографически. Версии формата "kube-like" начинаются с "v", за которым следует число (основная версия), а затем, при наличии, строка "alpha" или "beta" и ещё одно число (дополнительная версия). Сначала они сортируются по уровню стабильности: GA > beta > alpha (где GA — версия без суффикса, например beta или alpha), а затем сравниваются основная и дополнительная версии. Пример отсортированного списка версий: v10, v2, v1, v11beta2, v10beta3, v3beta1, v12alpha1, v11alpha2, foo1, foo10.

APIServiceStatus

APIServiceStatus содержит производную информацию о сервере API

Поле	Описание
`conditions` APIServiceCondition array стратегия исправления: слияние по ключу `type`	Текущее состояние сервиса apiService.

APIServiceList

APIServiceList — это список объектов APIService.

Поле	Описание
`apiVersion` string	APIVersion определяет версионированную схему этого представления объекта. Серверы должны преобразовывать распознанные схемы в последнее внутреннее значение и могут отклонять нераспознанные значения. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`items` * APIService array	Items — список объектов APIService
`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#metadata

APIServiceCondition

APIServiceCondition описывает состояние APIService в определённый момент времени

Поле	Описание
`lastTransitionTime` Time	Время последнего перехода условия из одного состояния в другое.
`message` string	Понятное человеку сообщение с подробностями о последнем переходе.
`reason` string	Уникальная причина последнего перехода условия, состоящая из одного слова в CamelCase.
`status` * string	Status — состояние условия. Возможные значения: True, False, Unknown.
`type` * string	Type — тип условия.

ServiceReference

ServiceReference содержит ссылку на Service.legacy.k8s.io

Поле	Описание
`name` string	Name — имя сервиса
`namespace` string	Namespace — пространство имён сервиса
`port` integer	Если указано, порт сервиса, на котором размещён webhook. Для обратной совместимости по умолчанию используется 443. `port` должен быть допустимым номером порта (от 1 до 65535 включительно).

© 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/apiregistration/api-service-v1/