create-load-balancer
Описание
Создает балансировщик нагрузки Classic Load Balancer.
Вы можете добавить слушатели, группы безопасности, подсети и теги при создании балансировщика или добавить их позже с помощью CreateLoadBalancerListeners , ApplySecurityGroupsToLoadBalancer , AttachLoadBalancerToSubnets и AddTags .
Чтобы описать текущие балансировщики нагрузки, см. DescribeLoadBalancers . После завершения работы с балансировщиком нагрузки, вы можете удалить его с помощью DeleteLoadBalancer .
Вы можете создать до 20 балансировщиков нагрузки на регион на аккаунт. Вы можете запросить увеличение количества балансировщиков нагрузки для вашего аккаунта. Дополнительная информация приведена в разделе «Лимиты для вашего Classic Load Balancer» в руководстве Classic Load Balancers Guide .
См. также: Документация API AWS
Синтаксис
create-load-balancer
--load-balancer-name <value>
--listeners <value>
[--availability-zones <value>]
[--subnets <value>]
[--security-groups <value>]
[--scheme <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]
Параметры
--load-balancer-name (строка)
Имя балансировщика нагрузки.
Это имя должно быть уникальным в вашем наборе балансировщиков нагрузки для региона, иметь максимальную длину 32 символа, содержать только буквенно-цифровые символы или дефисы и не должно начинаться или заканчиваться дефисом.
--listeners (список)
Слушатели.
Дополнительная информация приведена в разделе «Слушатели для вашего Classic Load Balancer» в руководстве Classic Load Balancers Guide .
(структура)
Информация о слушателе.
Информация о протоколах и портах, поддерживаемых Elastic Load Balancing, приведена в разделе «Слушатели для вашего Classic Load Balancer» в руководстве Classic Load Balancers Guide .
Protocol -> (строка)
LoadBalancerPort -> (целое число)
InstanceProtocol -> (строка)
Протокол для маршрутизации трафика к экземплярам: HTTP, HTTPS, TCP или SSL.
Если протокол на фронте TCP или SSL, протокол на бэке должен быть TCP или SSL. Если протокол на фронте HTTP или HTTPS, протокол на бэке должен быть HTTP или HTTPS.
Если есть другой слушатель с тем же InstancePort, чьим InstanceProtocol является защищённым (HTTPS или SSL), то протокол слушателя должен также быть защищённым.
Если есть другой слушатель с тем же InstancePort, чьим InstanceProtocol является HTTP или TCP, то протокол слушателя должен также быть HTTP или TCP.
InstancePort -> (целое число)
SSLCertificateId -> (строка)
Сокращенный синтаксис:
Protocol=string,LoadBalancerPort=integer,InstanceProtocol=string,InstancePort=integer,SSLCertificateId=string ...
Синтаксис JSON:
[
{
"Protocol": "string",
"LoadBalancerPort": integer,
"InstanceProtocol": "string",
"InstancePort": integer,
"SSLCertificateId": "string"
}
...
]
--availability-zones (список)
Одна или несколько зон доступности из того же региона, что и балансировщик нагрузки.
Необходимо указать как минимум одну зону доступности.
Вы можете добавить больше зон доступности после создания балансировщика с помощью EnableAvailabilityZonesForLoadBalancer .
(строка)
Синтаксис:
"string" "string" ...
--subnets (список)
Идентификаторы подсетей в вашей VPC, которые необходимо подключить к балансировщику. Укажите одну подсеть на зону доступности, указанную в AvailabilityZones .
(строка)
Синтаксис:
"string" "string" ...
--security-groups (список)
Идентификаторы групп безопасности, которые необходимо назначить балансировщику нагрузки.
(строка)
Синтаксис:
"string" "string" ...
--scheme (строка)
Тип балансировщика. Действителен только для балансировщиков в VPC.
По умолчанию Elastic Load Balancing создает балансировщик с именем DNS, которое разрешается в общедоступные IP-адреса. Дополнительную информацию об общедоступных и внутренних балансировщиках см. в разделе «Схема балансировщика» в руководстве Elastic Load Balancing User Guide .
Укажите internal для создания балансировщика с именем DNS, которое разрешается в частные IP-адреса.
--tags (список)
Список тегов для назначения балансировщику нагрузки.
Дополнительную информацию о тегах балансировщика см. в разделе «Добавление тегов в балансировщик Classic Load Balancer» в руководстве Classic Load Balancers Guide .
(структура)
Информация о теге.
Key -> (строка)
Value -> (строка)
Сокращенный синтаксис:
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
- 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 User Guide .
Если не указано иное, все примеры используют правила цитирования Unix-подобных систем. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. Использование кавычек со строками в руководстве AWS CLI User Guide .
Создание балансировщика HTTP
В этом примере создается балансировщик с HTTP-слушателем в VPC.
Команда:
aws elb create-load-balancer --load-balancer-name my-load-balancer --listeners "Protocol=HTTP,LoadBalancerPort=80,InstanceProtocol=HTTP,InstancePort=80" --subnets subnet-15aaab61 --security-groups sg-a61988c3
Вывод:
{
"DNSName": "my-load-balancer-1234567890.us-west-2.elb.amazonaws.com"
}
В этом примере создается балансировщик с HTTP-слушателем в EC2-Classic.
Команда:
aws elb create-load-balancer --load-balancer-name my-load-balancer --listeners "Protocol=HTTP,LoadBalancerPort=80,InstanceProtocol=HTTP,InstancePort=80" --availability-zones us-west-2a us-west-2b
Вывод:
{
"DNSName": "my-load-balancer-123456789.us-west-2.elb.amazonaws.com"
}
Создание балансировщика HTTPS
В этом примере создается балансировщик с HTTPS-слушателем в VPC.
Команда:
aws elb create-load-balancer --load-balancer-name my-load-balancer --listeners "Protocol=HTTP,LoadBalancerPort=80,InstanceProtocol=HTTP,InstancePort=80" "Protocol=HTTPS,LoadBalancerPort=443,InstanceProtocol=HTTP,InstancePort=80,SSLCertificateId=arn:aws:iam::123456789012:server-certificate/my-server-cert" --subnets subnet-15aaab61 --security-groups sg-a61988c3
Вывод:
{
"DNSName": "my-load-balancer-1234567890.us-west-2.elb.amazonaws.com"
}
В этом примере создается балансировщик с HTTPS-слушателем в EC2-Classic.
Команда:
aws elb create-load-balancer --load-balancer-name my-load-balancer --listeners "Protocol=HTTP,LoadBalancerPort=80,InstanceProtocol=HTTP,InstancePort=80" "Protocol=HTTPS,LoadBalancerPort=443,InstanceProtocol=HTTP,InstancePort=80,SSLCertificateId=arn:aws:iam::123456789012:server-certificate/my-server-cert" --availability-zones us-west-2a us-west-2b
Вывод:
{
"DNSName": "my-load-balancer-123456789.us-west-2.elb.amazonaws.com"
}
Создание внутреннего балансировщика
В этом примере создается внутренний балансировщик с HTTP-слушателем в VPC.
Команда:
aws elb create-load-balancer --load-balancer-name my-load-balancer --listeners "Protocol=HTTP,LoadBalancerPort=80,InstanceProtocol=HTTP,InstancePort=80" --scheme internal --subnets subnet-a85db0df --security-groups sg-a61988c3
Вывод:
{
"DNSName": "internal-my-load-balancer-123456789.us-west-2.elb.amazonaws.com"
}
Вывод
DNSName -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.