обновить-план-масштабирования

Описание

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

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

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

Синтаксис

  update-scaling-plan
--scaling-plan-name <value>
--scaling-plan-version <value>
[--application-source <value>]
[--scaling-instructions <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]

Параметры

--scaling-plan-name (строка)

Имя плана масштабирования.

--scaling-plan-version (целое число)

Номер версии плана масштабирования. Единственное допустимое значение — 1. В настоящее время у вас не может быть нескольких версий планов масштабирования.

--application-source (структура)

Стек CloudFormation или набор тегов.

Дополнительную информацию см. в ApplicationSource в Справочнике по API AWS Auto Scaling.

CloudFormationStackARN -> (строка)

Amazon Resource Name (ARN) стека AWS CloudFormation.

TagFilters -> (список)

Набор тегов (до 50).

(структура)

Представляет тег.

Key -> (строка)

Ключ тега.

Values -> (список)

Значения тегов (от 0 до 20).

(строка)

Синтаксис JSON:

{
  "CloudFormationStackARN": "string",
  "TagFilters": [
    {
      "Key": "string",
      "Values": ["string", ...]
    }
    ...
  ]
}

--scaling-instructions (список)

Инструкции по масштабированию.

Дополнительную информацию см. в ScalingInstruction в Справочнике по API AWS Auto Scaling .

(структура)

Описывает инструкцию по масштабированию для масштабируемого ресурса в плане масштабирования. Каждая инструкция по масштабированию применяется к одному ресурсу.

AWS Auto Scaling создает политики масштабирования по отслеживанию целевых значений на основе инструкций по масштабированию. Политики масштабирования по отслеживанию целевых значений изменяют емкость вашего масштабируемого ресурса по мере необходимости, чтобы поддерживать использование ресурсов на заданном вами целевом значении.

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

Предупреждение

Рекомендуется подождать не менее 24 часов после создания группы Auto Scaling, чтобы настроить предсказательное масштабирование. Для генерации прогноза необходимо как минимум 24 часа исторических данных. Дополнительную информацию см. в разделе «Рекомендации по AWS Auto Scaling» в Руководстве пользователя AWS Auto Scaling.

ServiceNamespace -> (строка)

Пространство имен AWS-сервиса.

ResourceId -> (строка)

Идентификатор ресурса. Эта строка состоит из типа ресурса и уникального идентификатора.

Группа Auto Scaling - Тип ресурса - autoScalingGroup, а уникальный идентификатор - имя группы Auto Scaling. Пример: autoScalingGroup/my-asg.
Сервис ECS - Тип ресурса - service, а уникальный идентификатор - имя кластера и имя сервиса. Пример: service/default/sample-webapp.
Запрос Spot Fleet - Тип ресурса - spot-fleet-request, а уникальный идентификатор - идентификатор запроса Spot Fleet. Пример: spot-fleet-request/sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE.
Таблица DynamoDB - Тип ресурса - table, а уникальный идентификатор - идентификатор ресурса. Пример: table/my-table.
Глобальный вторичный индекс DynamoDB - Тип ресурса - index, а уникальный идентификатор - идентификатор ресурса. Пример: table/my-table/index/my-table-index.
Кластер Aurora DB - Тип ресурса - cluster, а уникальный идентификатор - имя кластера. Пример: cluster:my-db-cluster.

ScalableDimension -> (строка)

Масштабируемая размерность, связанная с ресурсом.

autoscaling:autoScalingGroup:DesiredCapacity - Желаемая емкость группы Auto Scaling.
ecs:service:DesiredCount - Желаемое количество задач сервиса ECS.
ec2:spot-fleet-request:TargetCapacity - Целевая емкость запроса Spot Fleet.
dynamodb:table:ReadCapacityUnits - Предоставленная емкость чтения для таблицы DynamoDB.
dynamodb:table:WriteCapacityUnits - Предоставленная емкость записи для таблицы DynamoDB.
dynamodb:index:ReadCapacityUnits - Предоставленная емкость чтения для глобального вторичного индекса DynamoDB.
dynamodb:index:WriteCapacityUnits - Предоставленная емкость записи для глобального вторичного индекса DynamoDB.
rds:cluster:ReadReplicaCount - Количество реплик Aurora в кластере Aurora DB. Доступно для Aurora MySQL-совместимого и Aurora PostgreSQL-совместимого изданий.

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

Минимальная емкость ресурса.

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

Максимальная емкость ресурса. Исключение из этого верхнего предела — если вы указали значение по умолчанию для PredictiveScalingMaxCapacityBehavior.

TargetTrackingConfigurations -> (список)

Настройки отслеживания целевых значений (до 10). Каждая из этих структур должна указать уникальную метрику масштабирования и целевое значение для метрики.

(структура)

Описывает конфигурацию отслеживания целевых значений для использования с AWS Auto Scaling. Используется с ScalingInstruction и ScalingPolicy.

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

Предварительно определенная метрика. Вы можете указать либо предварительно определенную метрику, либо настраиваемую метрику.

PredefinedScalingMetricType -> (строка)

Тип метрики. Тип метрики ALBRequestCountPerTarget применим только к группам Auto Scaling, запросам Spot Fleet и сервисам ECS.

ResourceLabel -> (строка)

Идентифицирует ресурс, связанный с типом метрики. Вы не можете указать метку ресурса, если тип метрики — ALBRequestCountPerTarget, и нет группы целевых значений для балансировщика нагрузки Application Load Balancer, подключенного к группе Auto Scaling, запросу Spot Fleet или сервису ECS.

Вы создаете метку ресурса, добавляя последнюю часть ARN балансировщика нагрузки и последнюю часть ARN группы целевых значений в одно значение, разделенные слешем (/). Формат: app/<имя балансировщика нагрузки>/<идентификатор балансировщика нагрузки>/targetgroup/<имя группы целевых значений>/<идентификатор группы целевых значений>, где:

app/<имя балансировщика нагрузки>/<идентификатор балансировщика нагрузки> — это последняя часть ARN балансировщика нагрузки
targetgroup/<имя группы целевых значений>/<идентификатор группы целевых значений> — это последняя часть ARN группы целевых значений.

Пример: app/EC2Co-EcsEl-1TKLTMITMM0EO/f37c06a68c1748aa/targetgroup/EC2Co-Defau-LDNM7Q3ZH1ZN/6d4ea56ca2d6a18d.

Для получения ARN балансировщика нагрузки Application Load Balancer используйте операцию API DescribeLoadBalancers. Для получения ARN группы целевых значений используйте операцию API DescribeTargetGroups.

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

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

MetricName -> (строка)

Имя метрики.

Namespace -> (строка)

Пространство имен метрики.

Dimensions -> (список)

Размеры метрики.

Условие: Если вы опубликовали метрику с размерами, вы должны указать те же размеры в вашей настройке настраиваемой метрики масштабирования.

(структура)

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

Name -> (строка)

Имя размера.

Value -> (строка)

Значение размера.

Statistic -> (строка)

Статистика метрики.

Unit -> (строка)

Единица измерения метрики.

TargetValue -> (двойное)

Целевое значение для метрики. Хотя это свойство принимает числа типа Double, оно не будет принимать значения, которые слишком малы или слишком велики. Значения должны находиться в диапазоне от -2^360 до 2^360.

DisableScaleIn -> (булево)

Указывает, отключено ли масштабирование вниз политикой масштабирования по отслеживанию целевых значений. Если значение равно true, масштабирование вниз отключено, и политика масштабирования по отслеживанию целевых значений не удаляет емкость из масштабируемого ресурса. В противном случае масштабирование вниз включено, и политика масштабирования по отслеживанию целевых значений может удалить емкость из масштабируемого ресурса.

Значение по умолчанию равно false.

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

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

С периодом ожидания масштабирования вверх намерение состоит в том, чтобы непрерывно (но не чрезмерно) масштабировать вверх. После успешного масштабирования вверх с помощью политики масштабирования по отслеживанию целевых значений Auto Scaling начинает рассчитывать время ожидания. Политика масштабирования не увеличит желаемую емкость снова, если не будет инициировано большее масштабирование вверх или период ожидания не закончится.

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

Количество времени в секундах после завершения действия по масштабированию вниз, прежде чем может начаться другое действие по масштабированию вниз. Это свойство не используется, если масштабируемый ресурс — группа Auto Scaling.

С периодом ожидания масштабирования вниз цель состоит в том, чтобы масштабировать вниз осмотрительно, чтобы защитить доступность вашего приложения, поэтому действия по масштабированию вниз блокируются до истечения периода ожидания. Однако, если другая тревога запускает действие по масштабированию вверх во время периода ожидания масштабирования вниз, Auto Scaling масштабирует целевое значение немедленно. В этом случае период ожидания масштабирования вниз останавливается и не завершается.

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

Оцененное время в секундах до момента, когда новый запущенный экземпляр сможет внести вклад в метрики CloudWatch. Это значение используется только в том случае, если ресурс — группа Auto Scaling.

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

Предварительно определенная метрика нагрузки для использования в предсказательном масштабировании. Этот параметр или CustomizedLoadMetricSpecification требуется при настройке предсказательного масштабирования и не может быть использован в противном случае.

PredefinedLoadMetricType -> (строка)

Тип метрики.

ResourceLabel -> (строка)

Идентифицирует ресурс, связанный с типом метрики. Вы не можете указать метку ресурса, если тип метрики — ALBTargetGroupRequestCount, и нет группы целевых значений для балансировщика нагрузки Application Load Balancer, подключенного к группе Auto Scaling.

app/<имя балансировщика нагрузки>/<идентификатор балансировщика нагрузки> — это последняя часть ARN балансировщика нагрузки
targetgroup/<имя группы целевых значений>/<идентификатор группы целевых значений> — это последняя часть ARN группы целевых значений.

Пример: app/EC2Co-EcsEl-1TKLTMITMM0EO/f37c06a68c1748aa/targetgroup/EC2Co-Defau-LDNM7Q3ZH1ZN/6d4ea56ca2d6a18d.

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

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

MetricName -> (строка)

Имя метрики.

Namespace -> (строка)

Пространство имен метрики.

Dimensions -> (список)

Размеры метрики.

Условие: Если вы опубликовали метрику с размерами, вы должны указать те же размеры в вашей настройке настраиваемой метрики нагрузки.

(структура)

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

Name -> (строка)

Имя размера.

Value -> (строка)

Значение размера.

Statistic -> (строка)

Статистика метрики. Единственное допустимое значение — Sum.

Unit -> (строка)

Единица измерения метрики.

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

Количество времени в секундах для буферизации времени выполнения запланированных действий масштабирования при увеличении масштаба. Например, если прогноз указывает на добавление емкости в 10:00 утра, а время буфера составляет 5 минут, то время выполнения соответствующего запланированного действия масштабирования будет 9:55 утра. Цель состоит в том, чтобы дать ресурсам время для выделения. Например, запуск экземпляра EC2 может занять несколько минут. Фактическое необходимое время зависит от нескольких факторов, таких как размер экземпляра и наличие начальных скриптов для завершения.

Значение должно быть меньше длительности интервала прогноза 3600 секунд (60 минут). По умолчанию значение составляет 300 секунд.

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

PredictiveScalingMaxCapacityBehavior -> (строка)

Определяет поведение, которое должно применяться, если прогнозируемая емкость приближается к или превышает максимальную емкость, указанную для ресурса. Значение по умолчанию — SetForecastCapacityToMaxCapacity.

Возможные значения:

SetForecastCapacityToMaxCapacity — AWS Auto Scaling не может увеличить емкость ресурса выше максимальной емкости. Максимальная емкость применяется как жесткий лимит.
SetMaxCapacityToForecastCapacity — AWS Auto Scaling может увеличить емкость ресурса выше максимальной емкости, чтобы она была равна, но не превышала прогнозируемой емкости.
SetMaxCapacityAboveForecastCapacity — AWS Auto Scaling может увеличить емкость ресурса выше максимальной емкости на указанное значение буфера. Цель состоит в том, чтобы предоставить политике масштабирования по отслеживанию цели дополнительную емкость, если возникнет непредвиденный трафик.

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

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

Размер буфера емкости, который следует использовать, когда прогнозируемая емкость близка к или превышает максимальную емкость. Значение указывается в процентах от прогнозируемой емкости. Например, если буфер равен 10, это означает 10-процентный буфер, так что если прогнозируемая емкость составляет 50, а максимальная емкость — 40, то эффективная максимальная емкость составляет 55.

Действительно только при настройке прогнозируемого масштабирования. Требуется, если PredictiveScalingMaxCapacityBehavior установлено в SetMaxCapacityAboveForecastCapacity, и не может использоваться в противном случае.

Диапазон значений: 1-100.

PredictiveScalingMode -> (строка)

Режим прогнозируемого масштабирования. Значение по умолчанию — ForecastAndScale. В противном случае AWS Auto Scaling прогнозирует емкость, но не создает никаких запланированных действий масштабирования на основе прогноза емкости.

ScalingPolicyUpdateBehavior -> (строка)

Управляет тем, сохраняются или заменяются внешние политики масштабирования ресурса.

Значение по умолчанию — KeepExternalPolicies. Если параметр установлен в ReplaceExternalPolicies, все политики масштабирования, которые не являются частью AWS Auto Scaling, удаляются, а новые политики масштабирования по отслеживанию цели создаются.

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

Условие: количество существующих политик, которые должны быть заменены, должно быть меньше или равно 50. Если политик, подлежащих замене, больше 50, AWS Auto Scaling сохраняет все существующие политики и не создает новых.

DisableDynamicScaling -> (булево)

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

По умолчанию включено (false).

Синтаксис JSON:

[
  {
    "ServiceNamespace": "autoscaling"|"ecs"|"ec2"|"rds"|"dynamodb",
    "ResourceId": "string",
    "ScalableDimension": "autoscaling:autoScalingGroup:DesiredCapacity"|"ecs:service:DesiredCount"|"ec2:spot-fleet-request:TargetCapacity"|"rds:cluster:ReadReplicaCount"|"dynamodb:table:ReadCapacityUnits"|"dynamodb:table:WriteCapacityUnits"|"dynamodb:index:ReadCapacityUnits"|"dynamodb:index:WriteCapacityUnits",
    "MinCapacity": integer,
    "MaxCapacity": integer,
    "TargetTrackingConfigurations": [
      {
        "PredefinedScalingMetricSpecification": {
          "PredefinedScalingMetricType": "ASGAverageCPUUtilization"|"ASGAverageNetworkIn"|"ASGAverageNetworkOut"|"DynamoDBReadCapacityUtilization"|"DynamoDBWriteCapacityUtilization"|"ECSServiceAverageCPUUtilization"|"ECSServiceAverageMemoryUtilization"|"ALBRequestCountPerTarget"|"RDSReaderAverageCPUUtilization"|"RDSReaderAverageDatabaseConnections"|"EC2SpotFleetRequestAverageCPUUtilization"|"EC2SpotFleetRequestAverageNetworkIn"|"EC2SpotFleetRequestAverageNetworkOut",
          "ResourceLabel": "string"
        },
        "CustomizedScalingMetricSpecification": {
          "MetricName": "string",
          "Namespace": "string",
          "Dimensions": [
            {
              "Name": "string",
              "Value": "string"
            }
            ...
          ],
          "Statistic": "Average"|"Minimum"|"Maximum"|"SampleCount"|"Sum",
          "Unit": "string"
        },
        "TargetValue": double,
        "DisableScaleIn": true|false,
        "ScaleOutCooldown": integer,
        "ScaleInCooldown": integer,
        "EstimatedInstanceWarmup": integer
      }
      ...
    ],
    "PredefinedLoadMetricSpecification": {
      "PredefinedLoadMetricType": "ASGTotalCPUUtilization"|"ASGTotalNetworkIn"|"ASGTotalNetworkOut"|"ALBTargetGroupRequestCount",
      "ResourceLabel": "string"
    },
    "CustomizedLoadMetricSpecification": {
      "MetricName": "string",
      "Namespace": "string",
      "Dimensions": [
        {
          "Name": "string",
          "Value": "string"
        }
        ...
      ],
      "Statistic": "Average"|"Minimum"|"Maximum"|"SampleCount"|"Sum",
      "Unit": "string"
    },
    "ScheduledActionBufferTime": integer,
    "PredictiveScalingMaxCapacityBehavior": "SetForecastCapacityToMaxCapacity"|"SetMaxCapacityToForecastCapacity"|"SetMaxCapacityAboveForecastCapacity",
    "PredictiveScalingMaxCapacityBuffer": integer,
    "PredictiveScalingMode": "ForecastAndScale"|"ForecastOnly",
    "ScalingPolicyUpdateBehavior": "KeepExternalPolicies"|"ReplaceExternalPolicies",
    "DisableDynamicScaling": true|false
  }
  ...
]

--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
text
table
yaml
yaml-stream

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

on
off
auto

--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.

Обновление плана масштабирования

В следующем update-scaling-plan примере изменяется метрика масштабирования для группы Auto Scaling в указанном плане масштабирования.

aws autoscaling-plans update-scaling-plan \
    --scaling-plan-name my-scaling-plan \
    --scaling-plan-version 1 \
    --scaling-instructions '{"ScalableDimension":"autoscaling:autoScalingGroup:DesiredCapacity","ResourceId":"autoScalingGroup/my-asg","ServiceNamespace":"autoscaling","TargetTrackingConfigurations":[{"PredefinedScalingMetricSpecification": {"PredefinedScalingMetricType":"ALBRequestCountPerTarget","ResourceLabel":"app/my-alb/f37c06a68c1748aa/targetgroup/my-target-group/6d4ea56ca2d6a18d"},"TargetValue":40.0}],"MinCapacity": 1,"MaxCapacity": 10}'

Эта команда не генерирует вывод.

Дополнительную информацию см. в разделе Что такое AWS Auto Scaling? в руководстве пользователя AWS Auto Scaling.

Вывод

Нет