create-game-server-group

Описание

Создаёт группу серверов игры Amazon GameLift FleetIQ для управления хостингом игр на наборе экземпляров Amazon Elastic Compute Cloud для хостинга игр. Данная операция создаёт группу серверов игры, создаёт группу автоматического масштабирования в вашем аккаунте Amazon Web Services и устанавливает связь между этими группами. Вы можете просмотреть статус ваших групп серверов игры в консоли Amazon GameLift. Метрики и события группы серверов игры передаются в Amazon CloudWatch.

Перед созданием новой группы серверов игры у вас должны быть:

• Шаблон запуска Amazon Elastic Compute Cloud, который определяет, как запускать экземпляры Amazon Elastic Compute Cloud с вашей сборкой сервера игры. Дополнительную информацию см. в разделе Запуск экземпляра из шаблона запуска в Руководстве пользователя Amazon Elastic Compute Cloud.
• Роль IAM, предоставляющая ограниченный доступ к вашему аккаунту Amazon Web Services, чтобы позволить Amazon GameLift FleetIQ создавать и взаимодействовать с группой автоматического масштабирования. Дополнительную информацию см. в разделе Создание ролей IAM для межсервисного взаимодействия в Руководстве разработчика Amazon GameLift FleetIQ.

Для создания новой группы серверов игры укажите уникальное имя группы, роль IAM и шаблон запуска Amazon Elastic Compute Cloud, а также предоставьте список типов экземпляров, которые могут использоваться в группе. Вы также должны установить начальные максимальные и минимальные лимиты на количество экземпляров группы. Вы можете дополнительно установить политику автоматического масштабирования с отслеживанием цели, основанной на метрике Amazon GameLift FleetIQ.

После создания группы серверов игры и соответствующей группы автоматического масштабирования у вас будет полный доступ для изменения конфигурации группы автоматического масштабирования по мере необходимости. Некоторые свойства, задаваемые при создании группы серверов игры, включая максимальный/минимальный размер и настройки политики автоматического масштабирования, должны обновляться непосредственно в группе автоматического масштабирования. Имейте в виду, что некоторые свойства группы автоматического масштабирования периодически обновляются Amazon GameLift FleetIQ в рамках своих операций балансировки для оптимизации доступности и стоимости.

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

Синтаксис

  create-game-server-group
--game-server-group-name <value>
--role-arn <value>
--min-size <value>
--max-size <value>
--launch-template <value>
--instance-definitions <value>
[--auto-scaling-policy <value>]
[--balancing-strategy <value>]
[--game-server-protection-policy <value>]
[--vpc-subnets <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]

Параметры

--game-server-group-name (строка)

--role-arn (строка)

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

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

--launch-template (структура)

Сокращенная синтаксическая запись:

LaunchTemplateId=string,LaunchTemplateName=string,Version=string

Синтаксис JSON:

{
  "LaunchTemplateId": "string",
  "LaunchTemplateName": "string",
  "Version": "string"
}

--instance-definitions (список)

Сокращенная синтаксическая запись:

InstanceType=string,WeightedCapacity=string ...

Синтаксис JSON:

[
  {
    "InstanceType": "c4.large"|"c4.xlarge"|"c4.2xlarge"|"c4.4xlarge"|"c4.8xlarge"|"c5.large"|"c5.xlarge"|"c5.2xlarge"|"c5.4xlarge"|"c5.9xlarge"|"c5.12xlarge"|"c5.18xlarge"|"c5.24xlarge"|"c5a.large"|"c5a.xlarge"|"c5a.2xlarge"|"c5a.4xlarge"|"c5a.8xlarge"|"c5a.12xlarge"|"c5a.16xlarge"|"c5a.24xlarge"|"c6g.medium"|"c6g.large"|"c6g.xlarge"|"c6g.2xlarge"|"c6g.4xlarge"|"c6g.8xlarge"|"c6g.12xlarge"|"c6g.16xlarge"|"r4.large"|"r4.xlarge"|"r4.2xlarge"|"r4.4xlarge"|"r4.8xlarge"|"r4.16xlarge"|"r5.large"|"r5.xlarge"|"r5.2xlarge"|"r5.4xlarge"|"r5.8xlarge"|"r5.12xlarge"|"r5.16xlarge"|"r5.24xlarge"|"r5a.large"|"r5a.xlarge"|"r5a.2xlarge"|"r5a.4xlarge"|"r5a.8xlarge"|"r5a.12xlarge"|"r5a.16xlarge"|"r5a.24xlarge"|"r6g.medium"|"r6g.large"|"r6g.xlarge"|"r6g.2xlarge"|"r6g.4xlarge"|"r6g.8xlarge"|"r6g.12xlarge"|"r6g.16xlarge"|"m4.large"|"m4.xlarge"|"m4.2xlarge"|"m4.4xlarge"|"m4.10xlarge"|"m5.large"|"m5.xlarge"|"m5.2xlarge"|"m5.4xlarge"|"m5.8xlarge"|"m5.12xlarge"|"m5.16xlarge"|"m5.24xlarge"|"m5a.large"|"m5a.xlarge"|"m5a.2xlarge"|"m5a.4xlarge"|"m5a.8xlarge"|"m5a.12xlarge"|"m5a.16xlarge"|"m5a.24xlarge"|"m6g.medium"|"m6g.large"|"m6g.xlarge"|"m6g.2xlarge"|"m6g.4xlarge"|"m6g.8xlarge"|"m6g.12xlarge"|"m6g.16xlarge",
    "WeightedCapacity": "string"
  }
  ...
]

--auto-scaling-policy (структура)

Сокращенная синтаксическая запись:

EstimatedInstanceWarmup=integer,TargetTrackingConfiguration={TargetValue=double}

Синтаксис JSON:

{
  "EstimatedInstanceWarmup": integer,
  "TargetTrackingConfiguration": {
    "TargetValue": double
  }
}

--balancing-strategy (строка)

--game-server-protection-policy (строка)

--vpc-subnets (список)

Синтаксис:

"string" "string" ...

--tags (список)

Сокращенная синтаксическая запись:

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 версии 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.

Вывод

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