Общие параметры
allowWatchBookmarks
allowWatchBookmarks запрашивает события наблюдения с типом "BOOKMARK". Серверы, не реализующие закладки, могут игнорировать этот флаг, а закладки отправляются по усмотрению сервера. Клиенты не должны предполагать, что закладки возвращаются через какой-либо определённый интервал, а также не должны предполагать, что сервер отправит событие BOOKMARK в течение сессии. Если это не наблюдение, это поле игнорируется.
continue
Параметр continue должен быть установлен при получении дополнительных результатов с сервера. Поскольку это значение определяется сервером, клиенты могут использовать только значение continue из предыдущего результата запроса с идентичными параметрами запроса (за исключением значения continue), и сервер может отклонить значение continue, которое он не распознаёт. Если указанное значение continue больше недействительно, будь то из-за истечения срока действия (обычно от пяти до пятнадцати минут) или изменения конфигурации на сервере, сервер ответит ошибкой 410 ResourceExpired вместе с токеном continue. Если клиенту нужен согласованный список, он должен перезапустить свой список без поля continue. В противном случае клиент может отправить ещё один запрос списка с полученным токеном ошибки 410, сервер ответит списком, начиная со следующего ключа, но с последней фиксацией, что не согласуется с предыдущими результатами списка — объекты, созданные, изменённые или удалённые после первого запроса списка, будут включены в ответ, при условии, что их ключи находятся после "следующего ключа".
Это поле не поддерживается, когда watch равно true. Клиенты могут начать наблюдение с последнего значения resourceVersion, возвращённого сервером, и не пропустить никаких изменений.
dryRun
При наличии указывает, что изменения не должны сохраняться. Неверная или нераспознанная директива dryRun приведёт к ошибочному ответу и дальнейшему необработке запроса. Допустимые значения: - All: будут обработаны все стадии сухого запуска
fieldManager
fieldManager — это имя, связанное с исполнителем или объектом, производящим эти изменения. Значение должно быть меньше или равно 128 символам и содержать только печатаемые символы, как определено в https://golang.org/pkg/unicode/#IsPrint.
fieldSelector
Селектор для ограничения списка возвращаемых объектов по их полям. По умолчанию всё.
fieldValidation
fieldValidation инструктирует сервер, как обрабатывать объекты в запросе (POST/PUT/PATCH), содержащие неизвестные или дублирующиеся поля, при условии, что ServerSideFieldValidation функция включена. Допустимые значения: - Ignore: Это игнорирует все неизвестные поля, которые бесшумно удаляются из объекта, и игнорирует все, кроме последнего дублирующегося поля, которое встречает декодер. Это поведение по умолчанию до версии v1.23 и поведение по умолчанию, когда ServerSideFieldValidation функция отключена. - Warn: Это отправляет предупреждение через стандартный заголовок ответа о предупреждении для каждого неизвестного поля, которое удаляется из объекта, и для каждого встреченного дублирующегося поля. Запрос всё ещё будет успешным, если нет других ошибок, и сохранит только последнее из дублирующихся полей. Это значение по умолчанию, когда включена ServerSideFieldValidation функция. - Strict: Это приведёт к отказу запроса с ошибкой BadRequest, если какие-либо неизвестные поля будут удалены из объекта или если присутствуют дублирующие поля. Возвращаемая от сервера ошибка будет содержать все встреченные неизвестные и дублирующие поля.
force
Force позволит «принудительно» применять запросы Apply. Это означает, что пользователь повторно получит конфликтующие поля, принадлежащие другим людям. Флаг force должен быть сброшен для запросов исправления патчей, не являющихся apply.
gracePeriodSeconds
Длительность в секундах перед удалением объекта. Значение должно быть неотрицательным целым числом. Значение ноль указывает на немедленное удаление. Если это значение равно null, будет использоваться значение grace period по умолчанию для указанного типа. По умолчанию используется значение по умолчанию для объекта, если не указано иное. Ноль означает немедленное удаление.
labelSelector
Селектор для ограничения списка возвращаемых объектов по их меткам. По умолчанию всё.
limit
limit — это максимальное количество ответов, возвращаемых для вызова списка. Если существует больше элементов, сервер установит поле continue в метаданных списка в значение, которое может быть использовано с тем же начальным запросом для получения следующего набора результатов. Установка ограничения может вернуть меньше, чем запрошенное количество элементов (вплоть до нуля элементов) в случае, если все запрошенные объекты отфильтрованы, и клиенты должны использовать только наличие поля continue, чтобы определить, доступны ли ещё результаты. Серверы могут выбрать не поддерживать аргумент limit и вернуть все доступные результаты. Если limit указан, а поле continue пустое, клиенты могут предположить, что больше результатов недоступны. Это поле не поддерживается, если watch равно true.
Сервер гарантирует, что объекты, возвращённые при использовании continue, будут идентичны выполнению одного вызова списка без ограничения — то есть, никакие объекты, созданные, изменённые или удалённые после выполнения первого запроса, не будут включены в последующие запросы с продолжением. Это иногда называется согласованной фиксацией и гарантирует, что клиент, использующий limit для получения меньших фрагментов очень большого результата, может гарантировать, что он увидит все возможные объекты. Если объекты обновляются во время поблочного списка, возвращается версия объекта, которая была в наличии на момент расчёта первого результата списка.
namespace
Имя объекта и область видимости аутентификации, например, для команд и проектов
pretty
Если 'true', то вывод форматируется.
propagationPolicy
Определяет, будет ли и как выполняться сборка мусора. Может быть установлено либо это поле, либо OrphanDependents, но не оба. Политика по умолчанию определяется текущим набором finalizers в metadata.finalizers и политикой по умолчанию для конкретного ресурса. Допустимые значения: 'Orphan' — сирота зависимых объектов; 'Background' — разрешить сборщику мусора удалять зависимые объекты в фоновом режиме; 'Foreground' — каскадная политика, которая удаляет всех зависимых объектов в фоновом режиме.
resourceVersion
resourceVersion устанавливает ограничение на то, из каких версий ресурсов может быть получен запрос. Подробнее см. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions.
По умолчанию не задано
resourceVersionMatch
resourceVersionMatch определяет, как resourceVersion применяется к вызовам списка. Настоятельно рекомендуется устанавливать resourceVersionMatch для вызовов списка, где resourceVersion установлен. Подробнее см. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions.
По умолчанию не задано
timeoutSeconds
Таймаут для вызова list/watch. Это ограничивает продолжительность вызова независимо от любой активности или бездействия.
watch
Наблюдение за изменениями описанных ресурсов и возвращение их в виде потока уведомлений об добавлении, обновлении и удалении. Укажите resourceVersion.
© 2022 The Kubernetes Authors | Documentation Distributed under CC BY 4.0
Copyright © 2022 The Linux Foundation ®. All rights reserved.
https://v1-24.docs.kubernetes.io/docs/reference/kubernetes-api/common-parameters/common-parameters/