Spec-Zone.ru › AWS CLI v2

[ aws . apprunner ]

create-auto-scaling-configuration

Описание

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

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

Настройте более высокое значение MinSize, чтобы увеличить распределение вашего сервиса App Runner по большему количеству зон доступности в регионе Amazon Web Services. Цена при этом будет выше.

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

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

Синтаксис

  create-auto-scaling-configuration
--auto-scaling-configuration-name <value>
[--max-concurrency <value>]
[--min-size <value>]
[--max-size <value>]
[--tags <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]

Параметры

--auto-scaling-configuration-name (строка)

Имя конфигурации автоматического масштабирования. При первом использовании в регионе Amazon Web Services App Runner создает версию с номером 1 этого имени. При последующих вызовах с тем же именем App Runner создает последовательные версии конфигурации.

Примечание

До выпуска улучшений конфигурации автоматического масштабирования, имя DefaultConfiguration было зарезервировано.

Это ограничение больше не действует. Теперь вы можете управлять DefaultConfiguration так же, как и своими пользовательскими конфигурациями автоматического масштабирования. Это означает, что вы можете выполнять следующие действия с DefaultConfiguration, предоставляемыми App Runner:

  • Создавать новые версии DefaultConfiguration.
  • Удалять версии DefaultConfiguration.
  • Удалять конфигурацию автоматического масштабирования, для которой App Runner DefaultConfiguration был создан.
  • Если вы удалите конфигурацию автоматического масштабирования, вы можете создать другую пользовательскую конфигурацию автоматического масштабирования с тем же именем DefaultConfiguration. Исходный ресурс DefaultConfiguration, предоставленный App Runner, остается в вашей учетной записи, пока вы не внесете в него изменения.

--max-concurrency (целое число)

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

Значение по умолчанию: 100

--min-size (целое число)

Минимальное количество экземпляров, которые App Runner предоставляет для вашего сервиса. Сервис всегда имеет как минимум MinSize выделенных экземпляров. Некоторые из них активно обслуживают трафик. Остальные (выделенные и неактивные экземпляры) являются экономичной резервной вычислительной мощностью и готовы к быстрому активации. Вы платите за использование памяти всех выделенных экземпляров. Вы платите за использование ЦП только активной подгруппы.

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

Значение по умолчанию: 1

--max-size (целое число)

Максимальное количество экземпляров, до которого ваш сервис увеличивает масштаб. Максимальное количество экземпляров, активно обслуживающих трафик вашего сервиса - MaxSize.

Значение по умолчанию: 25

--tags (список)

Список элементов метаданных, которые вы можете связать с ресурсом вашей конфигурации автоматического масштабирования. Тег — это пара «ключ-значение».

(структура)

Описание тега, применяемого к ресурсу App Runner. Тег — это элемент метаданных, состоящий из пары «ключ-значение».

Ключ -> (строка)

Ключ тега.

Значение -> (строка)

Значение тега.

Сокращенный синтаксис:

Key=string,Value=string ...

Синтаксис JSON:

[
  {
    "Key": "string",
    "Value": "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
  • text
  • таблица
  • 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.

Для создания конфигурации автоматического масштабирования с высокой доступностью

Следующий create-auto-scaling-configuration пример создает конфигурацию автоматического масштабирования, оптимизированную для высокой доступности, задав значение MinSize равным 5. С этой конфигурацией App Runner пытается распределить ваши экземпляры сервиса по максимально возможному количеству зон доступности, до пяти, в зависимости от региона AWS.

Вызов возвращает AutoScalingConfiguration объект с другими настройками, установленными по умолчанию. В примере это первый вызов для создания конфигурации с именем high-availability. Версия установлена в 1 и является последней.

aws apprunner create-auto-scaling-configuration \
    --cli-input-json file://input.json

Содержание input.json:

{
    "AutoScalingConfigurationName": "high-availability",
    "MinSize": 5
}

Вывод:

{
    "AutoScalingConfiguration": {
        "AutoScalingConfigurationArn": "arn:aws:apprunner:us-east-1:123456789012:autoscalingconfiguration/high-availability/1/2f50e7656d7819fead0f59672e68042e",
        "AutoScalingConfigurationName": "high-availability",
        "AutoScalingConfigurationRevision": 1,
        "CreatedAt": "2020-11-03T00:29:17Z",
        "Latest": true,
        "Status": "ACTIVE",
        "MaxConcurrency": 100,
        "MaxSize": 50,
        "MinSize": 5
    }
}

Вывод

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

Описание конфигурации автоматического масштабирования App Runner, созданной этим запросом.

AutoScalingConfigurationArn -> (строка)

Amazon Resource Name (ARN) этой конфигурации автоматического масштабирования.

AutoScalingConfigurationName -> (строка)

Имя конфигурации автоматического масштабирования, заданное клиентом. Его можно использовать в нескольких версиях конфигурации.

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

Ревизия этой конфигурации автоматического масштабирования. Она уникальна среди всех активных конфигураций ("Status": "ACTIVE" ), которые используют тот же AutoScalingConfigurationName .

Latest -> (булево)

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

Status -> (строка)

Текущее состояние конфигурации автоматического масштабирования. Если статус ревизии конфигурации INACTIVE , она была удалена и больше не может быть использована. Неактивные ревизии конфигураций удаляются постоянно некоторое время после удаления.

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

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

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

Минимальное количество экземпляров, которые App Runner предоставляет для службы. Сервис всегда имеет как минимум MinSize предопределенных экземпляров. Некоторые из них активно обслуживают трафик. Остальные (предопределенные и неактивные экземпляры) являются рентабельным резервом вычислительных мощностей и готовы к быстрому активации. Вы платите за использование памяти всех предопределённых экземпляров. Вы платите за использование ЦП только активного подмножества.

App Runner временно удваивает количество предопределенных экземпляров во время развертываний, чтобы поддерживать одинаковый объём для старого и нового кода.

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

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

CreatedAt -> (метка времени)

Время создания конфигурации автоматического масштабирования. Формат — метка времени Unix.

DeletedAt -> (метка времени)

Время удаления конфигурации автоматического масштабирования. Формат — метка времени Unix.

HasAssociatedService -> (булево)

Указывает, связана ли с этой конфигурацией автоматического масштабирования служба App Runner. Значение true указывает, что связана одна или несколько служб. Значение false указывает, что служб не связано.

IsDefault -> (булево)

Указывает, должна ли эта конфигурация автоматического масштабирования использоваться в качестве значения по умолчанию для новой службы App Runner, для которой не указан ARN конфигурации автоматического масштабирования при создании. В каждом аккаунте может быть только одна конфигурация по умолчанию AutoScalingConfiguration в каждом регионе. Конфигурация по умолчанию AutoScalingConfiguration может быть любой ревизией в рамках того же AutoScalingConfigurationName .

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

Spec-Zone.ru

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