Spec-Zone.ru › AWS CLI v2

[ aws . opsworks ]

описание-настроек-автомасштабирования-по-нагрузке

Описание

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

Примечание

Вы должны указать по крайней мере один из параметров.

Требуемые разрешения : Для использования этого действия пользователь IAM должен иметь уровень разрешений «Показать», «Развернуть» или «Управлять» для стека или прикреплённый политику, которая явно предоставляет разрешения. Дополнительную информацию о разрешениях пользователей см. в разделе Управление разрешениями пользователей.

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

Синтаксис

  describe-load-based-auto-scaling
--layer-ids <value>
[--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]

Параметры

--layer-ids (список)

Массив идентификаторов слоев.

(строка)

Синтаксис:

"string" "string" ...

--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 V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, отображающего двоичный блок, 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.

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы с AWS CLI в «Руководстве пользователя AWS CLI».

Если не указано иное, все примеры используют правила цитирования для unix-подобных систем. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. Использование кавычек со строками в «Руководстве пользователя AWS CLI».

Для описания конфигурации автомасштабирования по нагрузке слоя

В следующем примере описывается конфигурация автомасштабирования по нагрузке указанного слоя. Слой идентифицируется по его идентификатору слоя, который можно найти на странице сведений о слое или выполнив describe-layers.

aws opsworks describe-load-based-auto-scaling --region us-east-1 --layer-ids 6bec29c9-c866-41a0-aba5-fa3e374ce2a1

Вывод: У примера слоя есть единственная нагрузка-базирующаяся инстанция.

{
  "LoadBasedAutoScalingConfigurations": [
    {
      "DownScaling": {
        "IgnoreMetricsTime": 10,
        "ThresholdsWaitTime": 10,
        "InstanceCount": 1,
        "CpuThreshold": 30.0
      },
      "Enable": true,
      "UpScaling": {
        "IgnoreMetricsTime": 5,
        "ThresholdsWaitTime": 5,
        "InstanceCount": 1,
        "CpuThreshold": 80.0
      },
      "LayerId": "6bec29c9-c866-41a0-aba5-fa3e374ce2a1"
    }
  ]
}

Дополнительная информация

Дополнительную информацию см. в разделе Как работает автоматическое масштабирование по нагрузке в «Руководстве пользователя AWS OpsWorks».

Вывод

LoadBasedAutoScalingConfigurations -> (список)

Массив объектов LoadBasedAutoScalingConfiguration, описывающих конфигурацию каждого слоя.

(структура)

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

LayerId -> (строка)

Идентификатор слоя.

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

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

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

Объект AutoScalingThresholds, описывающий конфигурацию увеличения масштаба, которая определяет, как и когда OpsWorks Stacks увеличивает количество экземпляров.

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

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

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

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

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

Время (в минутах) после события масштабирования, в течение которого OpsWorks Stacks должен игнорировать метрики и подавлять дополнительные события масштабирования. Например, OpsWorks Stacks добавляет новые экземпляры после события увеличения масштаба, но экземпляры не начнут снижать нагрузку до тех пор, пока они не будут загружены и настроены. Нет смысла генерировать дополнительные события масштабирования во время этой операции, которая обычно занимает несколько минут. IgnoreMetricsTime позволяет вам направить OpsWorks Stacks подавлять события масштабирования достаточно долго, чтобы новые экземпляры были запущены.

CpuThreshold -> (вещественное число)

Порог использования ЦП в процентах от доступного ЦП. Значение -1 отключает порог.

MemoryThreshold -> (вещественное число)

Порог использования памяти в процентах от доступной памяти. Значение -1 отключает порог.

LoadThreshold -> (вещественное число)

Порог нагрузки. Значение -1 отключает порог. Дополнительную информацию о том, как вычисляется нагрузка, см. в разделе Нагрузка (вычисление).

Alarms -> (список)

Настраиваемые оповещения CloudWatch для автомасштабирования, используемые в качестве порогов. Этот параметр принимает список до пяти имен оповещений, которые чувствительны к регистру и должны находиться в одном регионе со стеком.

Примечание

Для использования настраиваемых оповещений необходимо обновить роль службы, чтобы разрешить cloudwatch:DescribeAlarms . Вы можете либо позволить OpsWorks Stacks обновить роль для вас при первом использовании этой функции, либо вручную отредактировать роль. Дополнительную информацию см. в разделе Разрешение OpsWorks Stacks действовать от вашего имени.

(строка)

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

Объект AutoScalingThresholds, описывающий конфигурацию уменьшения масштаба, которая определяет, как и когда OpsWorks Stacks уменьшает количество экземпляров.

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

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

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

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

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

Время (в минутах) после события масштабирования, в течение которого OpsWorks Stacks должен игнорировать метрики и подавлять дополнительные события масштабирования. Например, OpsWorks Stacks добавляет новые экземпляры после события увеличения масштаба, но экземпляры не начнут снижать нагрузку до тех пор, пока они не будут загружены и настроены. Нет смысла генерировать дополнительные события масштабирования во время этой операции, которая обычно занимает несколько минут. IgnoreMetricsTime позволяет вам направить OpsWorks Stacks подавлять события масштабирования достаточно долго, чтобы новые экземпляры были запущены.

CpuThreshold -> (вещественное число)

Порог использования ЦП в процентах от доступного ЦП. Значение -1 отключает порог.

MemoryThreshold -> (вещественное число)

Порог использования памяти в процентах от доступной памяти. Значение -1 отключает порог.

LoadThreshold -> (вещественное число)

Порог нагрузки. Значение -1 отключает порог. Дополнительную информацию о том, как вычисляется нагрузка, см. в разделе Нагрузка (вычисление).

Alarms -> (список)

Настраиваемые оповещения CloudWatch для автомасштабирования, используемые в качестве порогов. Этот параметр принимает список до пяти имен оповещений, которые чувствительны к регистру и должны находиться в одном регионе со стеком.

Примечание

Для использования настраиваемых оповещений необходимо обновить роль службы, чтобы разрешить cloudwatch:DescribeAlarms . Вы можете либо позволить OpsWorks Stacks обновить роль для вас при первом использовании этой функции, либо вручную отредактировать роль. Дополнительную информацию см. в разделе Разрешение OpsWorks Stacks действовать от вашего имени.

(строка)

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

Spec-Zone.ru

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