describe-ec2-instance-limits

Описание

Получает пределы экземпляров и текущую загрузку для региона или расположения Amazon Web Services. Пределы экземпляров контролируют количество экземпляров, на тип экземпляра, на местоположение, которые ваша учетная запись Amazon Web Services может использовать. Узнайте больше в Amazon EC2 Instance Types. Возвращаемая информация включает максимальное количество разрешенных экземпляров и текущее использование вашей учетной записи по всем флотам. Эта информация может повлиять на вашу возможность масштабирования ваших флотов Amazon GameLift. Вы можете запросить увеличение лимитов для вашей учетной записи, используя страницу «Пределы сервиса» в консоли Amazon GameLift.

Пределы экземпляров отличаются в зависимости от того, развернуты ли экземпляры в родном регионе флота или в удаленном расположении. Для удаленных расположений пределы также отличаются в зависимости от комбинации родного региона и удаленного расположения. Все запросы должны указывать регион Amazon Web Services (явно или как ваши стандартные настройки). Чтобы получить предел для удаленного расположения, вы также должны указать расположение. Например, следующие запросы возвращают разные результаты:

• Запрос указывает регион ap-northeast-1 без местоположения. Результатом являются пределы и данные об использовании всех типов экземпляров, развернутых в us-east-2, всеми флотами, находящимися в ap-northeast-1.
• Запрос указывает регион us-east-1 с расположением ca-central-1. Результатом являются пределы и данные об использовании всех типов экземпляров, развернутых в ca-central-1, всеми флотами, находящимися в us-east-2. Эти пределы не влияют на флоты в других регионах, которые развертывают экземпляры в ca-central-1.
• Запрос указывает регион eu-west-1 с расположением ca-central-1. Результатом являются пределы и данные об использовании всех типов экземпляров, развернутых в ca-central-1, всеми флотами, находящимися в eu-west-1.

Эта операция может быть использована следующим образом:

• Чтобы получить данные о лимитах и использовании для всех типов экземпляров, развернутых в регионе Amazon Web Services флотами, находящимися в том же регионе: укажите только регион. Дополнительно, укажите один тип экземпляра для получения информации.
• Чтобы получить данные о лимитах и использовании для всех типов экземпляров, развернутых в удаленном расположении флотами, находящимися в другом регионе Amazon Web Services: укажите как регион Amazon Web Services, так и удаленное расположение. Дополнительно, укажите один тип экземпляра для получения информации.

При успешном выполнении возвращается объект EC2InstanceLimits с данными о лимитах и использовании для каждого запрошенного типа экземпляра.

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

Синтаксис

  describe-ec2-instance-limits
[--ec2-instance-type <value>]
[--location <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]

Параметры

--ec2-instance-type (строка)

--location (строка)

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

Примеры

Чтобы получить пределы сервиса для типа EC2-инстанса

Следующий describe-ec2-instance-limits пример отображает максимальное количество разрешенных экземпляров и текущее количество используемых экземпляров для указанного типа EC2-инстанса в текущем регионе. Результат указывает, что используется только пять из двадцати разрешенных экземпляров.

aws gamelift describe-ec2-instance-limits \
    --ec2-instance-type m5.large

Вывод:

{
    "EC2InstanceLimits": [
        {
            "EC2InstanceType": ""m5.large",
            "CurrentInstances": 5,
            "InstanceLimit": 20
        }
    ]
}

Для получения дополнительной информации см. раздел «Выбор вычислительных ресурсов» в Руководстве разработчика Amazon GameLift.

Вывод

EC2InstanceLimits -> (список)