создать-балансировщик-нагрузки
Описание
Создает балансировщик нагрузки Lightsail. Чтобы узнать больше о том, стоит ли нагружать ваше приложение, см. Настройка ваших экземпляров Lightsail для балансировки нагрузки . Вы можете создать до 5 балансировщиков нагрузки на регион AWS в вашей учетной записи.
При создании балансировщика вы можете указать уникальное имя и настройки порта. Чтобы изменить дополнительные настройки балансировщика, используйте операцию UpdateLoadBalancerAttribute.
Операция create load balancer поддерживает контроль доступа на основе тегов в запросах. Дополнительную информацию см. в руководстве разработчика Amazon Lightsail .
См. также: Документация API AWS
Синтаксис
create-load-balancer
--load-balancer-name <value>
--instance-port <value>
[--health-check-path <value>]
[--certificate-name <value>]
[--certificate-domain-name <value>]
[--certificate-alternative-names <value>]
[--tags <value>]
[--ip-address-type <value>]
[--tls-policy-name <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]
Параметры
--load-balancer-name (строка)
--instance-port (целое число)
--health-check-path (строка)
Путь, который вы указали для проверки состояния балансировщика нагрузки. Если вы не указали путь проверки состояния, Lightsail использует корневой путь вашего веб-сайта ("/" ).
Возможно, вам потребуется указать пользовательский путь проверки состояния, отличный от корневого пути вашего приложения, если ваша главная страница загружается медленно или содержит много медиа-файлов или скриптов.
--certificate-name (строка)
Имя сертификата SSL/TLS.
Если вы указываете certificateName , то certificateDomainName является обязательным (и наоборот).
--certificate-domain-name (строка)
Имя домена, с которым связан ваш сертификат (example.com ).
Если вы указываете certificateDomainName , то certificateName является обязательным (и наоборот).
--certificate-alternative-names (список)
Дополнительные домены и поддомены для использования с вашим сертификатом SSL/TLS (www.example.com , example.com , m.example.com , blog.example.com ).
(строка)
Синтаксис:
"string" "string" ...
--tags (список)
Ключи тегов и необязательные значения, которые необходимо добавить к ресурсу во время создания.
Используйте действие TagResource для добавления тегов к ресурсу после его создания.
(структура)
Описание ключа и необязательного значения тега, назначенного ресурсу Amazon Lightsail.
Дополнительную информацию о тегах в Lightsail см. в руководстве разработчика Amazon Lightsail.
key -> (строка)
Ключ тега.
Ограничения: ключи тегов принимают максимум 128 букв, цифр, пробелов в UTF-8 или следующих символов: + - = . _ : / @
value -> (строка)
Значение тега.
Ограничения: значения тегов принимают максимум 256 букв, цифр, пробелов в UTF-8 или следующих символов: + - = . _ : / @
Сокращенный синтаксис:
key=string,value=string ...
Синтаксис JSON:
[
{
"key": "string",
"value": "string"
}
...
]
--ip-address-type (строка)
Тип IP-адреса для балансировщика нагрузки.
Возможные значения: ipv4 для только IPv4, ipv6 для только IPv6 и dualstack для IPv4 и IPv6.
Значение по умолчанию: dualstack.
Возможные значения:
dualstackipv4ipv6
--tls-policy-name (строка)
Имя политики TLS для применения к балансировщику нагрузки.
Используйте действие GetLoadBalancerTlsPolicies для получения списка имен политик TLS, которые можно указать.
Дополнительную информацию о политиках TLS балансировщика нагрузки см. в разделе «Настройка политик безопасности TLS для балансировщиков нагрузки Amazon Lightsail» в руководстве разработчика Amazon Lightsail.
--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 версии 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.
Примеры
Примечание
Чтобы использовать следующие примеры, вы должны иметь установленный и настроенный AWS CLI. Дополнительную информацию см. в руководстве по началу работы в руководстве пользователя AWS CLI.
Если не указано иное, во всех примерах используются правила кавычек Unix-подобных систем. Эти примеры необходимо адаптировать к правилам кавычек вашей терминальной оболочки. См. раздел «Использование кавычек со строками» в руководстве пользователя AWS CLI.
Для создания балансировщика нагрузки
Следующий пример create-load-balancer создает балансировщик нагрузки с сертификатом TLS. Сертификат TLS применяется к указанным доменам и перенаправляет трафик на экземпляры по порту 80.
aws lightsail create-load-balancer \
--certificate-alternative-names www.example.com test.example.com \
--certificate-domain-name example.com \
--certificate-name Certificate-1 \
--instance-port 80 \
--load-balancer-name LoadBalancer-1
Вывод:
{
"operations": [
{
"id": "cc7b920a-83d8-4762-a74e-9174fe1540be",
"resourceName": "LoadBalancer-1",
"resourceType": "LoadBalancer",
"createdAt": 1569867169.406,
"location": {
"availabilityZone": "all",
"regionName": "us-west-2"
},
"isTerminal": false,
"operationType": "CreateLoadBalancer",
"status": "Started",
"statusChangedAt": 1569867169.406
},
{
"id": "658ed43b-f729-42f3-a8e4-3f8024d3c98d",
"resourceName": "LoadBalancer-1",
"resourceType": "LoadBalancerTlsCertificate",
"createdAt": 1569867170.193,
"location": {
"availabilityZone": "all",
"regionName": "us-west-2"
},
"isTerminal": true,
"operationDetails": "LoadBalancer-1",
"operationType": "CreateLoadBalancerTlsCertificate",
"status": "Succeeded",
"statusChangedAt": 1569867170.54
},
{
"id": "4757a342-5181-4870-b1e0-227eebc35ab5",
"resourceName": "LoadBalancer-1",
"resourceType": "LoadBalancer",
"createdAt": 1569867170.193,
"location": {
"availabilityZone": "all",
"regionName": "us-west-2"
},
"isTerminal": true,
"operationDetails": "Certificate-1",
"operationType": "CreateLoadBalancerTlsCertificate",
"status": "Succeeded",
"statusChangedAt": 1569867170.54
}
]
}
Дополнительную информацию см. в разделе «Балансировщики нагрузки Lightsail» в руководстве разработчика Lightsail.
Вывод
operations -> (список)
Массив объектов, описывающих результат действия, такой как состояние запроса, метка времени запроса и ресурсы, затронутые запросом.
(структура)
Описание операции API.
id -> (строка)
resourceName -> (строка)
resourceType -> (строка)
createdAt -> (метка времени)
1479816991.349).location -> (структура)
Регион и зона доступности Amazon Web Services.
availabilityZone -> (строка)
us-east-2a (регистрозависимый).regionName -> (строка)
isTerminal -> (булево)
operationDetails -> (строка)
Debian-1GB-Ohio-1).operationType -> (строка)
status -> (строка)
statusChangedAt -> (метка времени)
1479816991.349).errorCode -> (строка)
errorDetails -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.