Spec-Zone.ru › AWS CLI v2

[ aws . lightsail ]

создать-балансировщик-нагрузки

Описание

Создает балансировщик нагрузки 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.

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

  • dualstack
  • ipv4
  • ipv6

--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 -> (строка)

Имя региона Amazon Web Services.

isTerminal -> (булево)

Булевое значение, указывающее, является ли операция конечной.

operationDetails -> (строка)

Подробности об операции (Debian-1GB-Ohio-1).

operationType -> (строка)

Тип операции.

status -> (строка)

Состояние операции.

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

Метка времени, когда состояние было изменено (1479816991.349).

errorCode -> (строка)

Код ошибки.

errorDetails -> (строка)

Подробности об ошибке.

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

Spec-Zone.ru

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