ObjectMeta

ObjectMeta — это метаданные, которые должны присутствовать у всех сохраняемых ресурсов, включая все объекты, создаваемые пользователями.

apiVersion: meta/v1

import "k8s.io/apimachinery/pkg/apis/meta/v1"

ObjectMeta

Поле	Описание
`annotations` object	Annotations — это неструктурированная карта пар «ключ — значение», хранящаяся вместе с ресурсом. Внешние инструменты могут задавать её для хранения и получения произвольных метаданных. По ней нельзя выполнять запросы, и её следует сохранять при изменении объектов. Дополнительная информация: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations
`creationTimestamp` Time	CreationTimestamp — временная метка, обозначающая время на сервере, когда был создан этот объект. Не гарантируется, что она будет установлена в порядке «произошло до» для отдельных операций. Клиенты не могут задавать это значение. Оно представлено в формате RFC3339 и указано в часовом поясе UTC. Заполняется системой. Только для чтения. Для списков имеет значение null. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
`deletionGracePeriodSeconds` integer	Количество секунд, в течение которых объекту разрешено завершаться корректно, прежде чем он будет удалён из системы. Устанавливается только при наличии значения deletionTimestamp. Это значение можно только уменьшить. Только для чтения.
`deletionTimestamp` Time	DeletionTimestamp — дата и время в формате RFC 3339, когда этот ресурс будет удалён. Это поле задаётся сервером при запросе пользователя на корректное удаление и не может быть задано клиентом напрямую. Предполагается, что ресурс будет удалён (перестанет отображаться в списках ресурсов и станет недоступен по имени) по истечении указанного здесь времени, если список finalizers пуст. Пока список finalizers содержит элементы, удаление заблокировано. После установки deletionTimestamp это значение нельзя сбросить или перенести на более позднее время, однако его можно сократить или удалить ресурс до наступления указанного времени. Например, пользователь может запросить удаление pod через 30 секунд. Kubelet отправит контейнерам в pod сигнал корректного завершения. Через 30 секунд Kubelet отправит контейнеру сигнал принудительного завершения (SIGKILL) и после очистки удалит pod из API. При сетевых разделениях этот объект может продолжать существовать и после указанной временной метки, пока администратор или автоматизированный процесс не установит, что ресурс полностью завершён. Если значение не задано, запрос на корректное удаление объекта не поступал. Заполняется системой при запросе на корректное удаление. Только для чтения. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
`finalizers` string array стратегия исправления: merge	Перед удалением объекта из реестра список должен быть пуст. Каждый элемент — это идентификатор компонента, ответственного за удаление элемента из списка. Если deletionTimestamp объекта не равен nil, элементы этого списка можно только удалять. Finalizers можно обрабатывать и удалять в любом порядке. Порядок НЕ фиксирован, поскольку его фиксация создаёт значительный риск застревания finalizers. Поле finalizers является общим; любой субъект с соответствующими правами может изменить порядок его элементов. Если список finalizers обрабатывается по порядку, может возникнуть ситуация, когда компонент, отвечающий за первый finalizer в списке, ожидает сигнал (значение поля, данные внешней системы или другой сигнал), который должен поступить от компонента, отвечающего за finalizer ниже в списке. Это приведёт к взаимной блокировке. При отсутствии фиксированного порядка компоненты могут самостоятельно упорядочивать finalizers и не зависят от изменений порядка в списке.
`generateName` string	GenerateName — необязательный префикс, который сервер использует для создания уникального имени, ТОЛЬКО ЕСЛИ поле Name не задано. Если используется это поле, имя, возвращённое клиенту, будет отличаться от переданного имени. К этому значению также добавляется уникальный суффикс. Указанное значение должно соответствовать тем же правилам проверки, что и поле Name; оно может быть усечено с учётом длины суффикса, необходимого для обеспечения уникальности на сервере. Если это поле задано, а сгенерированное имя уже существует, сервер вернёт ошибку 409. Применяется только в том случае, если поле Name не задано. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency
`generation` integer	Порядковый номер, обозначающий конкретное поколение желаемого состояния. Заполняется системой. Только для чтения.
`labels` object	Карта строковых ключей и значений, которую можно использовать для организации и категоризации (определения области действия и выбора) объектов. Может соответствовать селекторам контроллеров репликации и сервисов. Дополнительная информация: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels
`managedFields` ManagedFieldsEntry array	ManagedFields сопоставляет идентификатор рабочего процесса и версию с набором полей, которыми управляет этот рабочий процесс. Это поле предназначено главным образом для внутренних служебных нужд, и пользователям обычно не нужно задавать или понимать его. Рабочим процессом может быть имя пользователя, имя контроллера или имя определённого пути apply, например "ci-cd". Набор полей всегда представлен в версии, которую рабочий процесс использовал при изменении объекта.
`name` string	Имя должно быть уникальным в пределах пространства имён. Оно обязательно при создании ресурсов, хотя некоторые ресурсы могут позволять клиенту запросить автоматическую генерацию подходящего имени. Имя предназначено главным образом для идемпотентного создания и определения конфигурации. Его нельзя обновить. Дополнительная информация: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names
`namespace` string	Namespace определяет пространство, в пределах которого каждое имя должно быть уникальным. Пустое пространство имён эквивалентно пространству имён "default", однако "default" является каноническим представлением. Не все объекты должны относиться к пространству имён — для таких объектов значение этого поля будет пустым. Должно соответствовать формату DNS_LABEL. Его нельзя обновить. Дополнительная информация: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces
`ownerReferences` OwnerReference array стратегия исправления: merge по ключу `uid`	Список объектов, от которых зависит этот объект. Если все объекты в списке удалены, этот объект будет удалён сборщиком мусора. Если объект управляется контроллером, в списке будет запись, указывающая на этот контроллер, а для поля controller будет задано значение true. Не может быть более одного управляющего контроллера.
`resourceVersion` string	Непрозрачное значение, представляющее внутреннюю версию этого объекта. Клиенты могут использовать его, чтобы определять, изменились ли объекты. Может применяться для оптимистичной блокировки, обнаружения изменений и операции watch для одного или нескольких ресурсов. Клиенты должны считать эти значения непрозрачными и передавать их серверу без изменений. Они могут быть действительны только для определённого ресурса или набора ресурсов. Заполняется системой. Только для чтения. Клиенты должны считать это значение непрозрачным. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency
`selfLink` string	Устарело: selfLink — это устаревшее поле, доступное только для чтения, которое больше не заполняется системой.
`uid` string	UID — это уникальное значение этого объекта во времени и пространстве. Обычно оно генерируется сервером при успешном создании ресурса и не может изменяться при операциях PUT. Заполняется системой. Только для чтения. Дополнительная информация: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids

Обратная связь

Была ли эта страница полезной?

Спасибо за отзыв. Если у вас есть конкретный вопрос о том, как использовать Kubernetes, на который можно дать ответ, задайте его на Stack Overflow. Создайте задачу в репозитории GitHub, если хотите сообщить о проблеме или предложить улучшение.

Последнее изменение: 13 мая 2026 г. в 18:59 PST: переключение содержимого kubernetes-api на серверную часть gen-apidocs markdown (7dffa41ae2)

© 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/definitions/object-meta-v1-meta/