Spec-Zone.ru › AWS CLI v2

[ aws . opensearch ]

describe-dry-run-progress

Описание

Описывает прогресс анализа предварительного выполнения операции без изменения данных для домена Amazon OpenSearch Service. Дополнительная информация: Определение того, вызовет ли изменение развертывание сине-зелёного типа.

См. также: Документацию API AWS

Синтаксис

  describe-dry-run-progress
--domain-name <value>
[--dry-run-id <value>]
[--load-dry-run-config | --no-load-dry-run-config]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--domain-name (строка)

Имя домена.

--dry-run-id (строка)

Уникальный идентификатор предварительного выполнения операции без изменения данных.

--load-dry-run-config | --no-load-dry-run-config (логическое значение)

Включать ли в ответ конфигурацию предварительного выполнения операции без изменения данных. Конфигурация определяет изменения, которые планируется внести в домен.

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON-строки. JSON-строка следует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределят значения, предоставленные JSON. Невозможно передавать произвольные двоичные значения с помощью значения JSON, поскольку строка будет взята буквально. Это не может быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод, не отправляя запрос API. Если указано без значения или со значением input, выводит пример JSON-ввода, который может использоваться в качестве аргумента для --cli-input-json. Аналогично, если указано yaml-input, выведет пример YAML-ввода, который можно использовать с --cli-input-yaml. Если указано значение output, валидирует входные данные команды и возвращает пример JSON-вывода для этой команды. Сгенерированный JSON-скелет не стабилен между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

Глобальные параметры

--debug (логическое значение)

Включить отладку.

--endpoint-url (строка)

Переопределить URL по умолчанию команды указанным URL.

--no-verify-ssl (логическое значение)

По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.

--no-paginate (логическое значение)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования вывода команды.

  • json
  • текст
  • таблица
  • yaml
  • yaml-поток

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использовать определенный профиль из файла учетных данных.

--region (строка)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (строка)

Показать версию этого инструмента.

--color (строка)

Включить/выключить цветной вывод.

  • включено
  • выключено
  • автоматически

--no-sign-request (логическое значение)

Не подписывать запросы. Учетные данные не будут загружаться, если этот аргумент указан.

--ca-bundle (строка)

Файл сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет выполняться без блокировки и без таймаута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет выполняться без блокировки и без таймаута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как закодированная строка base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI версии 1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, сопоставленного с двоичным блоком, fileb:// всегда будет обрабатываться как двоичное и будет использовать содержимое файла непосредственно независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенного cli-binary-format.

  • base64
  • raw-in-base64-out

--no-cli-pager (логическое значение)

Отключить вывод страниц CLI.

--cli-auto-prompt (логическое значение)

Автоматически запросить параметры ввода CLI.

--no-cli-auto-prompt (логическое значение)

Отключить автоматическое запрошение параметров ввода CLI.

Вывод

DryRunProgressStatus -> (структура)

Текущий статус пробного запуска, включая любые ошибки проверки.

DryRunId -> (строка)

Уникальный идентификатор пробного запуска.

DryRunStatus -> (строка)

Текущий статус пробного запуска.

CreationDate -> (строка)

Отметка времени начала пробного запуска.

UpdateDate -> (строка)

Отметка времени последнего обновления пробного запуска.

ValidationFailures -> (список)

Любые ошибки проверки, возникшие в результате пробного запуска.

(структура)

Ошибка проверки, возникшая в результате предварительной проверки на обновление (подробный пробный запуск) домена.

Code -> (строка)

Код ошибки.

Message -> (строка)

Соответствующее сообщение об ошибке.

DryRunConfig -> (структура)

Подробная информация о планируемых изменениях в домене.

DomainId -> (строка)

Уникальный идентификатор домена.

DomainName -> (строка)

Имя домена. Имена доменов уникальны для всех доменов, принадлежащих одному аккаунту в регионе Amazon Web Services.

ARN -> (строка)

Amazon Resource Name (ARN) домена. Для получения дополнительной информации см. идентификаторы IAM в руководстве AWS Identity and Access Management User Guide.

Created -> (булево)

Статус создания домена OpenSearch Service. True, если создание домена завершено. False, если создание домена еще в процессе.

Deleted -> (булево)

Статус удаления домена OpenSearch Service. True, если удаление домена завершено. False, если удаление домена еще в процессе. После завершения удаления статус домена больше не возвращается.

Endpoint -> (строка)

Уникальный для домена конечный пункт, используемый для отправки запросов индексации, поиска и загрузки данных в домен.

EndpointV2 -> (строка)

Если IPAddressType необходимо установить на значение dualstack, предоставляется конечный пункт домена версии 2. Этот конечный пункт работает как обычный конечный пункт, за исключением того, что он работает как с адресами IPv4, так и с адресами IPv6. Обычные конечные пункты работают только с адресами IPv4.

Endpoints -> (карта)

Пара ключ-значение, если домен OpenSearch Service использует VPC-конечные точки. Например:

  • IP-адреса IPv4 - 'vpc','vpc-endpoint-h2dsd34efgyghrtguk5gt6j2foh4.us-east-1.es.amazonaws.com'
  • Адреса с двойной стековой технологией - 'vpcv2':'vpc-endpoint-h2dsd34efgyghrtguk5gt6j2foh4.aos.us-east-1.on.aws'

key -> (строка)

value -> (строка)

Конечный пункт домена, в который отправляются запросы индексации и поиска. Например, search-imdb-movies-oopcnjfn6ugo.eu-west-1.es.amazonaws.com или doc-imdb-movies-oopcnjfn6u.eu-west-1.es.amazonaws.com.

DomainEndpointV2HostedZoneId -> (строка)

Идентификатор размещенной зоны с двойной стековой технологией для домена.

Processing -> (булево)

Статус конфигурации домена. True, если OpenSearch Service обрабатывает изменения конфигурации. False, если конфигурация активна.

UpgradeProcessing -> (булево)

Статус обновления версии домена до новой версии OpenSearch или Elasticsearch. True, если OpenSearch Service находится в процессе обновления версии. False, если конфигурация активна.

EngineVersion -> (строка)

Версия OpenSearch или Elasticsearch, используемая домена в формате Elasticsearch_X.Y или OpenSearch_X.Y.

ClusterConfig -> (структура)

Контейнер для конфигурации кластера домена.

InstanceType -> (строка)

Тип экземпляра узлов данных в кластере.

InstanceCount -> (целое число)

Количество узлов данных в кластере. Это число должно быть больше 1, в противном случае будет возвращено исключение проверки.

DedicatedMasterEnabled -> (булево)

Указывает, включены ли выделенные узлы-мастера для кластера. ``True``, если кластер будет использовать выделенный узел-мастер. ``False``, если кластер не будет.

ZoneAwarenessEnabled -> (булево)

Указывает, включены ли несколько зон доступности. Дополнительная информация: Настройка домена с несколькими зонами доступности в Amazon OpenSearch Service.

ZoneAwarenessConfig -> (структура)

Контейнер для параметров конфигурации с учетом зон доступности. Требуется только если ZoneAwarenessEnabled равно true.

AvailabilityZoneCount -> (целое число)

Если включены несколько зон доступности, это значение — количество зон, которые должен использовать домен. Допустимые значения — 2 и 3. Если ваш домен развернут в VPC, это значение равно количеству подсетей.

DedicatedMasterType -> (строка)

Тип экземпляра OpenSearch Service выделенных узлов-мастеров в кластере.

DedicatedMasterCount -> (целое число)

Количество выделенных узлов-мастеров в кластере. Это число должно быть больше 2 и не равно 4, в противном случае будет возвращено исключение проверки.

WarmEnabled -> (булево)

Включить или выключить кэш-хранилище для кластера.

WarmType -> (строка)

Тип экземпляра узлов-кэша в кластере.

WarmCount -> (целое число)

Количество узлов-кэша в кластере.

ColdStorageOptions -> (структура)

Контейнер для параметров конфигурации холодного хранения.

Enabled -> (булево)

Включить или выключить холодное хранилище в домене. Для включения холодного хранилища необходимо включить хранилище UltraWarm.

MultiAZWithStandbyEnabled -> (булево)

Булево значение, указывающее, включен ли домен Multi-AZ со вспомогательной зоной. Дополнительная информация: Настройка домена с несколькими зонами доступности в Amazon OpenSearch Service.

NodeOptions -> (список)

Список параметров узлов для домена.

(структура)

Настройки конфигурации для определения типа узла в кластере.

NodeType -> (строка)

Определяет тип узла, например, координационные узлы.

NodeConfig -> (структура)

Параметры конфигурации для определения настроек любого типа узла.

Enabled -> (булево)

Булево значение, указывающее, активен или неактивен определенный тип узла.

Type -> (строка)

Тип экземпляра определенного узла в кластере.

Count -> (целое число)

Количество узлов определенного типа в кластере.

EBSOptions -> (структура)

Контейнер для настроек хранения на основе EBS для домена.

EBSEnabled -> (булево)

Указывает, подключены ли тома EBS к узлам данных в домене OpenSearch Service.

VolumeType -> (строка)

Указывает тип томов EBS, подключенных к узлам данных.

VolumeSize -> (целое число)

Указывает размер (в GiB) томов EBS, подключенных к узлам данных.

Iops -> (целое число)

Указывает базовые показатели ввода/вывода (I/O) томов EBS, подключенных к узлам данных. Применимо только для gp3 и типов томов EBS с предоставленными IOPS.

Throughput -> (целое число)

Указывает пропускную способность (в MiB/с) томов EBS, подключенных к узлам данных. Применимо только для gp3 типа тома.

AccessPolicies -> (строка)

Документ политики Identity and Access Management (IAM), определяющий политики доступа к домену.

IPAddressType -> (строка)

Тип IP-адресов, поддерживаемых конечным пунктом для домена.

SnapshotOptions -> (структура)

УСТАРЕЛО. Контейнер для параметров, необходимых для настройки автоматических снимков индексов домена.

AutomatedSnapshotStartHour -> (целое число)

Время в формате UTC, когда OpenSearch Service выполняет ежедневный автоматический снимок указанного домена. По умолчанию — 0 часов.

VPCOptions -> (структура)

Конфигурация VPC для домена.

VPCId -> (строка)

Идентификатор вашей VPC. Amazon VPC генерирует это значение при создании VPC.

SubnetIds -> (список)

Список идентификаторов подсетей, связанных с VPC-конечными точками для домена.

(строка)

AvailabilityZones -> (список)

Список зон доступности, связанных с VPC-подсетями.

(строка)

SecurityGroupIds -> (список)

Список идентификаторов групп безопасности, связанных с VPC-конечными точками для домена.

(строка)

CognitoOptions -> (структура)

Пара ключ-значение для настройки аутентификации Amazon Cognito для OpenSearch Dashboards.

Enabled -> (булево)

Включить или выключить аутентификацию Amazon Cognito для OpenSearch Dashboards.

UserPoolId -> (строка)

Идентификатор пользовательского пула Amazon Cognito, который OpenSearch Service должен использовать для аутентификации в OpenSearch Dashboards.

IdentityPoolId -> (строка)

Идентификатор пула идентификаторов Amazon Cognito, который OpenSearch Service должен использовать для аутентификации в OpenSearch Dashboards.

RoleArn -> (строка)

AmazonOpenSearchServiceCognitoAccess роль, позволяющая OpenSearch Service настроить ваш пул пользователей и пул идентификаторов.

EncryptionAtRestOptions -> (структура)

Настройки шифрования в состоянии покоя для домена.

Enabled -> (булево)

True для включения шифрования в состоянии покоя.

KmsKeyId -> (строка)

Идентификатор ключа KMS. Принимает вид 1a2a3a4-1a2a-3a4a-5a6a-1a2a3a4a5a6a.

NodeToNodeEncryptionOptions -> (структура)

Включено или выключено шифрование между узлами.

Enabled -> (булево)

True для включения шифрования между узлами.

AdvancedOptions -> (карта)

Пара ключ-значение, определяющие параметры расширенной конфигурации.

key -> (строка)

value -> (строка)

LogPublishingOptions -> (карта)

Параметры публикации логов для домена.

key -> (строка)

Тип файла журнала. Может быть одним из следующих:

  • INDEX_SLOW_LOGS - Журналы медленных запросов индекса содержат запросы вставки, которые заняли больше времени, чем заданный порог времени выполнения запроса журнала индекса.
  • SEARCH_SLOW_LOGS - Журналы медленных запросов поиска содержат запросы поиска, которые заняли больше времени, чем заданный порог времени выполнения запроса журнала поиска.
  • ES_APPLICATION_LOGS - Логи приложения OpenSearch содержат информацию об ошибках и предупреждениях, возникающих во время работы сервиса, и могут быть полезны для устранения неполадок.
  • AUDIT_LOGS - Журналы аудита содержат записи о запросах пользователей для доступа к домену.

value -> (структура)

Указывает, публикует ли Amazon OpenSearch Service в Amazon CloudWatch журналы приложения OpenSearch и медленные запросы. Дополнительная информация: Мониторинг логов OpenSearch с помощью Amazon CloudWatch Logs.

Примечание

После включения публикации логов вам все равно нужно включить сбор медленных логов с помощью OpenSearch REST API.

CloudWatchLogsLogGroupArn -> (строка)

Amazon Resource Name (ARN) группы CloudWatch Logs, в которую должны публиковаться логи.

Enabled -> (булево)

Нужно ли публиковать логи.

ServiceSoftwareOptions -> (структура)

Текущий статус программного обеспечения службы домена.

CurrentVersion -> (string)

Текущая версия программного обеспечения службы, установленная на домене.

NewVersion -> (string)

Новая версия программного обеспечения службы, если она доступна.

UpdateAvailable -> (boolean)

Истина, если можно обновить версию программного обеспечения службы. Ложь, если обновление программного обеспечения службы невозможно.

Cancellable -> (boolean)

Истина, если можно отменить обновление версии программного обеспечения службы. Ложь, если отмена обновления невозможна.

UpdateStatus -> (string)

Статус обновления программного обеспечения службы.

Description -> (string)

Описание статуса обновления программного обеспечения службы.

AutomatedUpdateDate -> (timestamp)

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

OptionalDeployment -> (boolean)

Истина, если программное обеспечение службы никогда не обновляется автоматически. Ложь, если программное обеспечение службы обновляется автоматически после даты автоматического обновления.

DomainEndpointOptions -> (structure)

Дополнительные параметры для конечной точки домена, такие как требование HTTPS для всего трафика.

EnforceHTTPS -> (boolean)

Истина, если требуется, чтобы весь трафик домена поступал по HTTPS.

TLSSecurityPolicy -> (string)

Укажите политику безопасности TLS для применения к HTTPS-конечной точке домена. Политика может принимать одно из следующих значений:

  • Policy-Min-TLS-1-0-2019-07: Политика безопасности TLS, поддерживающая версии TLS от 1.0 до 1.2
  • Policy-Min-TLS-1-2-2019-07: Политика безопасности TLS, поддерживающая только версию TLS 1.2
  • Policy-Min-TLS-1-2-PFS-2023-10: Политика безопасности TLS, поддерживающая версии TLS от 1.2 до 1.3 с шифрами с совершенной прямой секретностью

CustomEndpointEnabled -> (boolean)

Включить пользовательскую конечную точку для домена.

CustomEndpoint -> (string)

Полный URL пользовательской конечной точки.

CustomEndpointCertificateArn -> (string)

ARN сертификата безопасности, управляемого в Amazon Web Services Certificate Manager (ACM).

AdvancedSecurityOptions -> (structure)

Настройки для точного управления доступом.

Enabled -> (boolean)

Истина, если точное управление доступом включено.

InternalUserDatabaseEnabled -> (boolean)

Истина, если база данных внутренних пользователей включена.

SAMLOptions -> (structure)

Контейнер для информации о конфигурации SAML для OpenSearch Dashboards.

Enabled -> (boolean)

Истина, если SAML включен.

Idp -> (structure)

Описание информации поставщика идентификации SAML.

MetadataContent -> (string)

Метаданные приложения SAML в формате XML.

EntityId -> (string)

Уникальный идентификатор сущности приложения в поставщике идентификации SAML.

SubjectKey -> (string)

Ключ, используемый для сопоставления атрибута субъекта SAML.

RolesKey -> (string)

Ключ, используемый для сопоставления атрибута ролей SAML.

SessionTimeoutMinutes -> (integer)

Продолжительность, в минутах, после которой сессия пользователя становится неактивной.

JWTOptions -> (structure)

Контейнер для информации о конфигурации JWT Amazon OpenSearch Service.

Enabled -> (boolean)

Истина, если использование JWT включено.

SubjectKey -> (string)

Ключ, используемый для сопоставления атрибута субъекта JWT.

RolesKey -> (string)

Ключ, используемый для сопоставления атрибута ролей JWT.

PublicKey -> (string)

Ключ, используемый для проверки подписи входящих запросов JWT.

AnonymousAuthDisableDate -> (timestamp)

Дата и время отключения периода миграции. Необходимо только при включении точного управления доступом в существующий домен.

AnonymousAuthEnabled -> (boolean)

Истина, если период миграции 30 дней включен, в течение которого администраторы могут создавать сопоставления ролей. Необходимо только при включении точного управления доступом в существующий домен.

IdentityCenterOptions -> (structure)

Параметры конфигурации для управления интеграцией IAM Identity Center в домен.

EnabledAPIAccess -> (boolean)

Указывает, включен ли IAM Identity Center для приложения.

IdentityCenterInstanceARN -> (string)

Amazon Resource Name (ARN) экземпляра IAM Identity Center.

SubjectKey -> (string)

Указывает атрибут, содержащий идентификатор субъекта (например, имя пользователя, идентификатор пользователя или электронная почта) в IAM Identity Center.

RolesKey -> (string)

Указывает атрибут, содержащий идентификатор роли бэкенда (например, имя группы или идентификатор группы) в IAM Identity Center.

IdentityCenterApplicationARN -> (string)

ARN приложения IAM Identity Center, интегрированного с Amazon OpenSearch Service.

IdentityStoreId -> (string)

Идентификатор хранилища идентификации IAM.

AutoTuneOptions -> (structure)

Настройки автоматической настройки для домена.

State -> (string)

Текущее состояние автоматической настройки в домене.

ErrorMessage -> (string)

Возникшие ошибки при включении или выключении автоматической настройки.

UseOffPeakWindow -> (boolean)

Использовать ли окно вне пиковой нагрузки домена для развертывания изменений Auto-Tune, а не расписание технического обслуживания.

ChangeProgressDetails -> (structure)

Информация о текущем изменении конфигурации домена.

ChangeId -> (string)

Идентификатор изменения конфигурации.

Message -> (string)

Сообщение, соответствующее статусу изменения конфигурации.

ConfigChangeStatus -> (string)

Текущий статус изменения конфигурации.

InitiatedBy -> (string)

IAM-принципал, который инициировал изменение конфигурации.

StartTime -> (timestamp)

Время инициирования изменения конфигурации в формате UTC.

LastUpdatedTime -> (timestamp)

Последнее время обновления изменения конфигурации.

OffPeakWindowOptions -> (structure)

Параметры, которые задают пользовательское 10-часовое окно, в течение которого OpenSearch Service может выполнять изменения конфигурации в домене.

Enabled -> (boolean)

Включить ли окно вне пиковой нагрузки.

Этот параметр доступен только при изменении домена, созданного до 16 февраля 2023 г., а не при создании нового домена. Для всех доменов, созданных после этой даты, окно вне пиковой нагрузки включено по умолчанию. Вы не можете отключить окно вне пиковой нагрузки после его включения для домена.

OffPeakWindow -> (structure)

Настройки окна вне пиковой нагрузки для домена.

WindowStartTime -> (structure)

Пользовательское начальное время окна вне пиковой нагрузки в формате UTC. Длительность окна всегда составляет 10 часов, поэтому вы не можете указать конечное время. Например, если вы укажете 23:00 UTC как начальное время, конечное время будет автоматически установлено на 9:00.

Hours -> (long)

Начальный час окна в формате UTC, используя 24-часовой формат времени. Например, 17 означает 17:00 UTC.

Minutes -> (long)

Начальная минута окна в UTC.

SoftwareUpdateOptions -> (structure)

Параметры обновления программного обеспечения службы для домена.

AutoSoftwareUpdateEnabled -> (boolean)

Включены ли автоматические обновления программного обеспечения службы для домена.

DomainProcessingStatus -> (string)

Статус любых изменений, которые в настоящее время выполняются для домена.

ModifyingProperties -> (list)

Информация о свойствах домена, которые в настоящее время изменяются.

(structure)

Информация о свойствах домена, которые в настоящее время изменяются.

Name -> (string)

Имя свойства, которое в настоящее время изменяется.

ActiveValue -> (string)

Текущее значение свойства домена, которое изменяется.

PendingValue -> (string)

Значение, которое свойство, которое в настоящее время изменяется, получит в конечном итоге.

ValueType -> (string)

Тип значения, который в настоящее время изменяется. Свойства могут иметь два типа:

  • PLAIN_TEXT : Содержат прямые значения, такие как «1», «True» или «c5.large.search».
  • STRINGIFIED_JSON : Содержат содержимое в формате JSON, например {“Enabled”:”True”}”.

AIMLOptions -> (structure)

Контейнер для параметров, необходимых для включения всех функций машинного обучения.

NaturalLanguageQueryGenerationOptions -> (structure)

Контейнер для параметров, необходимых для генерации запросов на естественном языке для указанного домена.

DesiredState -> (string)

Желаемое состояние функции генерации запросов на естественном языке. Допустимые значения — ENABLED и DISABLED.

CurrentState -> (string)

Текущее состояние функции генерации запросов на естественном языке, указывающее на завершение, выполнение или ошибку.

DryRunResults -> (structure)

Результаты моделирования.

DeploymentType -> (string)

Указывает способ применения OpenSearch Service обновления. Возможные значения:

  • Blue/Green - Обновление требует развертывания blue/green.
  • DynamicUpdate - Развертывание blue/green не требуется
  • Undetermined - Домен находится в процессе обновления и не может определить тип развертывания. Повторите попытку после завершения обновления.
  • None - Запрос не содержит никаких изменений конфигурации.

Message -> (string)

Сообщение, соответствующее типу развертывания.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

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