› › ›

API получения емкости автомасштабирования

Эта функция предназначена для косвенного использования службой Elasticsearch Service, Elastic Cloud Enterprise и Elastic Cloud на Kubernetes. Прямое использование не поддерживается.

Получить емкость автоматического масштабирования.

Запрос

resp = client.autoscaling.get_autoscaling_capacity()
print(resp)

const response = await client.autoscaling.getAutoscalingCapacity();
console.log(response);

GET /_autoscaling/capacity/

Предварительные условия

Если функции безопасности Elasticsearch включены, у вас должны быть manage_autoscaling права доступа к кластеру. Дополнительную информацию см. в разделе Права доступа к безопасности.

Описание

Этот API получает текущую емкость автоматического масштабирования на основе настроенной политики автоматического масштабирования. Этот API вернёт информацию для соответствующего масштабирования кластера текущей рабочей нагрузке.

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

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

Ответ содержит информацию, специфичную для решателя, которую можно использовать для диагностики того, как и почему автоматическое масштабирование определило, что требуется определённая емкость. Эта информация предоставляется только для диагностики. Не используйте эту информацию для принятия решений по автоматическому масштабированию.

Параметры запроса

master_timeout: (Необязательно, единицы измерения времени) Время ожидания для узла мастера. Если узел мастера недоступен до истечения срока ожидания, запрос завершается сбоем и возвращает ошибку. По умолчанию значение равно 30s. Также может быть установлено значение -1, чтобы указать, что запрос никогда не должен превышать срок ожидания.

Тело ответа

policies

(объект) Содержит карту имени политики к результату емкости

Свойства policies

<policy_name>

(объект) Содержит информацию о емкости для политики

Свойства <policy_name>

required_capacity

(объект) Содержит требуемую емкость для политики.

Свойства required_capacity

node

(объект) Содержит минимальный размер узлов, необходимый для каждого узла, гарантируя, что отдельные фрагменты или задачи ML могут поместиться на один узел.

Свойства node

storage: (целое число) Объём памяти, необходимый для каждого узла.
memory: (целое число) Объем памяти, необходимый для каждого узла.
processors: (вещественное число) Количество процессоров (вCPUs) на узел.

total

(объект) Содержит общий размер, необходимый для политики.

Свойства total

storage: (целое число) Общий объём памяти, необходимый для политики.
memory: (целое число) Общий объём памяти, необходимый для политики.
processors: (вещественное число) Общее количество процессоров (vCPUs), необходимых для политики.

current_capacity

(объект) Содержит текущую емкость узлов, управляемых политикой, то есть узлов, на основе которых Elasticsearch производит свой расчет.

Свойства current_capacity

node

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

Свойства node

storage: (целое число) Максимальный объём памяти узла.
memory: (целое число) Максимальный объём памяти узла.
processors: (вещественное число) Максимальное количество процессоров (vCPUs) узла.

total

(объект) Содержит текущий общий объём памяти и памяти для узлов, управляемых политикой.

Свойства total

storage: (целое число) Текущий объём памяти, доступный для политики.
memory: (целое число) Текущий объём памяти, доступный для политики.
processors: Текущее количество процессоров (vCPUs), доступных для политики.

current_nodes

(массив объектов) Список узлов, используемых для расчета емкости.

Свойства элементов в current_nodes

name: (строка) Имя узла.

deciders

(объект) Результаты емкости от отдельных решателей, позволяющие получить представление о том, как был рассчитан внешний уровень required_capacity.

Свойства deciders

<decider_name>

(объект) Результат емкости для определенного решателя, включенного в политику.

Свойства <decider_name>

required_capacity

(объект) Требуемая емкость, определенная решателем.

Свойства required_capacity

node

(объект) Содержит минимальный размер узлов, необходимый для каждого узла, гарантируя, что отдельные фрагменты или задачи машинного обучения могут поместиться на один узел.

Свойства node

storage: (целое число) Объём памяти, необходимый для каждого узла.
memory: (целое число) Объём памяти, необходимый для каждого узла.
processors: (вещественное число) Количество процессоров (vCPUs) на узел.

total

(объект) Содержит общий размер, необходимый для политики.

Свойства total

storage: (целое число) Общий объём памяти, необходимый для политики.
memory: (целое число) Общий объём памяти, необходимый для политики.
processors: (вещественное число) Общее количество процессоров (vCPUs), необходимых для политики.

reason_summary

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

reason_details

(объект) Структура по решателю, содержащая подробную информацию об обосновании результата решателей. Содержание не должно использоваться для целей приложения и не подлежит гарантиям обратной совместимости.

Примеры

Этот пример извлекает текущую ёмкость автоматического масштабирования.

resp = client.autoscaling.get_autoscaling_capacity()
print(resp)

const response = await client.autoscaling.getAutoscalingCapacity();
console.log(response);

GET /_autoscaling/capacity

API возвращает следующий результат:

{
  policies: {}
}

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/8.17/autoscaling-get-autoscaling-capacity.html