create-fleet

Описание

Создаёт флот вычислительных ресурсов для размещения серверов вашей игры. Используйте эту операцию для настройки следующих типов флотов на основе типа вычислительных ресурсов:

Управляемый флот EC2

Флот EC2 — это набор экземпляров Amazon Elastic Compute Cloud (Amazon EC2). Ваш образ сервера игры развернут на каждом экземпляре флота. Amazon GameLift управляет экземплярами флота и контролирует жизненный цикл процессов серверов игр, которые принимают игровые сессии для игроков. Флоты EC2 могут иметь экземпляры в нескольких местоположениях. Каждый экземпляр в флоте обозначен Compute.

Для создания флота EC2 укажите следующие обязательные параметры:

Либо BuildId, либо ScriptId
ComputeType установлено в значение EC2 (значение по умолчанию)
EC2InboundPermissions
EC2InstanceType
FleetType
Name
RuntimeConfiguration с как минимум одной конфигурацией ServerProcesses

При успешном выполнении этой операции создаётся новый ресурс флота и он устанавливается в состояние NEW, в то время как Amazon GameLift запускает процесс создания флота. Для отладки флота, получения логов, просмотра метрик производительности или других действий с флотом создайте флот разработки с открытыми портами 22/3389. В качестве рекомендации, мы рекомендуем открывать порты для удалённого доступа только тогда, когда они необходимы, и закрывать их после завершения работы.

Когда состояние флота — ACTIVE, вы можете настроить параметры ёмкости и включить/выключить автоматическое масштабирование для каждого местоположения.

Флот Anywhere

Флот Anywhere представляет вычислительные ресурсы, которые не принадлежат или не управляются Amazon GameLift. Вы можете создать флот Anywhere с помощью локального компьютера для тестирования или использовать его для размещения серверов игры на локальном оборудовании или других решениях по размещению игр.

Для создания флота Anywhere укажите следующие обязательные параметры:

ComputeType установлено в значение ANYWHERE
Locations, определяющий пользовательское местоположение
Name

При успешном выполнении этой операции создаётся новый ресурс флота и он устанавливается в состояние ACTIVE. Вы можете зарегистрировать вычислительные ресурсы в флоте, находящемся в состоянии ACTIVE.

Дополнительная информация

Настройка флотов

Отладка проблем при создании флота

Флоты в нескольких местоположениях

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

Синтаксис

  create-fleet
--name <value>
[--description <value>]
[--build-id <value>]
[--script-id <value>]
[--server-launch-path <value>]
[--server-launch-parameters <value>]
[--log-paths <value>]
[--ec2-instance-type <value>]
[--ec2-inbound-permissions <value>]
[--new-game-session-protection-policy <value>]
[--runtime-configuration <value>]
[--resource-creation-limit-policy <value>]
[--metric-groups <value>]
[--peer-vpc-aws-account-id <value>]
[--peer-vpc-id <value>]
[--fleet-type <value>]
[--instance-role-arn <value>]
[--certificate-configuration <value>]
[--locations <value>]
[--tags <value>]
[--compute-type <value>]
[--anywhere-configuration <value>]
[--instance-role-credentials-provider <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]

Параметры

--name (строка)

Описание, связанное с флотом. Имена флотов не должны быть уникальными.

--description (строка)

Описание флота.

--build-id (строка)

Уникальный идентификатор пользовательского образа сервера игры, подлежащего развертыванию во флот с типом вычислительных ресурсов EC2. Вы можете использовать либо идентификатор, либо ARN образа. Образ должен быть загружен в Amazon GameLift и находиться в состоянии READY. Это свойство флота нельзя изменить после создания флота.

--script-id (строка)

Уникальный идентификатор сценария конфигурации Realtime, подлежащего развертыванию во флот с типом вычислительных ресурсов EC2. Вы можете использовать либо идентификатор, либо ARN сценария. Сценарии должны быть загружены в Amazon GameLift до создания флота. Это свойство флота нельзя изменить после создания флота.

--server-launch-path (строка)

Этот параметр больше не используется. Укажите путь запуска сервера с помощью параметра RuntimeConfiguration. Запросы, использующие этот параметр, по-прежнему считаются действительными.

--server-launch-parameters (строка)

Этот параметр больше не используется. Укажите параметры запуска сервера с помощью параметра RuntimeConfiguration. Запросы, использующие этот параметр, по-прежнему считаются действительными.

--log-paths (список)

Этот параметр больше не используется. Чтобы указать, где Amazon GameLift должен хранить файлы журналов после завершения работы процесса сервера, используйте API сервера Amazon GameLift ProcessReady() и укажите один или несколько путей к каталогам в logParameters. Дополнительную информацию см. в разделе «Инициализация процесса сервера» в руководстве разработчика Amazon GameLift.

(строка)

Синтаксис:

"string" "string" ...

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

Поддерживаемый Amazon GameLift тип экземпляра Amazon EC2, который следует использовать с управляемыми флотами EC2. Тип экземпляра определяет вычислительные ресурсы, которые будут использоваться для размещения серверов вашей игры, включая ЦП, память, хранилище и сетевую ёмкость. Подробные описания типов экземпляров Amazon EC2 см. в документации Amazon Elastic Compute Cloud Instance Types.

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

t2.micro
t2.small
t2.medium
t2.large
c3.large
c3.xlarge
c3.2xlarge
c3.4xlarge
c3.8xlarge
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
r3.large
r3.xlarge
r3.2xlarge
r3.4xlarge
r3.8xlarge
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
m3.medium
m3.large
m3.xlarge
m3.2xlarge
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
c5d.large
c5d.xlarge
c5d.2xlarge
c5d.4xlarge
c5d.9xlarge
c5d.12xlarge
c5d.18xlarge
c5d.24xlarge
c6a.large
c6a.xlarge
c6a.2xlarge
c6a.4xlarge
c6a.8xlarge
c6a.12xlarge
c6a.16xlarge
c6a.24xlarge
c6i.large
c6i.xlarge
c6i.2xlarge
c6i.4xlarge
c6i.8xlarge
c6i.12xlarge
c6i.16xlarge
c6i.24xlarge
r5d.large
r5d.xlarge
r5d.2xlarge
r5d.4xlarge
r5d.8xlarge
r5d.12xlarge
r5d.16xlarge
r5d.24xlarge
m6g.medium
m6g.large
m6g.xlarge
m6g.2xlarge
m6g.4xlarge
m6g.8xlarge
m6g.12xlarge
m6g.16xlarge
c6g.medium
c6g.large
c6g.xlarge
c6g.2xlarge
c6g.4xlarge
c6g.8xlarge
c6g.12xlarge
c6g.16xlarge
r6g.medium
r6g.large
r6g.xlarge
r6g.2xlarge
r6g.4xlarge
r6g.8xlarge
r6g.12xlarge
r6g.16xlarge
c6gn.medium
c6gn.large
c6gn.xlarge
c6gn.2xlarge
c6gn.4xlarge
c6gn.8xlarge
c6gn.12xlarge
c6gn.16xlarge
c7g.medium
c7g.large
c7g.xlarge
c7g.2xlarge
c7g.4xlarge
c7g.8xlarge
c7g.12xlarge
c7g.16xlarge
r7g.medium
r7g.large
r7g.xlarge
r7g.2xlarge
r7g.4xlarge
r7g.8xlarge
r7g.12xlarge
r7g.16xlarge
m7g.medium
m7g.large
m7g.xlarge
m7g.2xlarge
m7g.4xlarge
m7g.8xlarge
m7g.12xlarge
m7g.16xlarge
g5g.xlarge
g5g.2xlarge
g5g.4xlarge
g5g.8xlarge
g5g.16xlarge
r6i.large
r6i.xlarge
r6i.2xlarge
r6i.4xlarge
r6i.8xlarge
r6i.12xlarge
r6i.16xlarge
c6gd.medium
c6gd.large
c6gd.xlarge
c6gd.2xlarge
c6gd.4xlarge
c6gd.8xlarge
c6gd.12xlarge
c6gd.16xlarge
c6in.large
c6in.xlarge
c6in.2xlarge
c6in.4xlarge
c6in.8xlarge
c6in.12xlarge
c6in.16xlarge
c7a.medium
c7a.large
c7a.xlarge
c7a.2xlarge
c7a.4xlarge
c7a.8xlarge
c7a.12xlarge
c7a.16xlarge
c7gd.medium
c7gd.large
c7gd.xlarge
c7gd.2xlarge
c7gd.4xlarge
c7gd.8xlarge
c7gd.12xlarge
c7gd.16xlarge
c7gn.medium
c7gn.large
c7gn.xlarge
c7gn.2xlarge
c7gn.4xlarge
c7gn.8xlarge
c7gn.12xlarge
c7gn.16xlarge
c7i.large
c7i.xlarge
c7i.2xlarge
c7i.4xlarge
c7i.8xlarge
c7i.12xlarge
c7i.16xlarge
m6a.large
m6a.xlarge
m6a.2xlarge
m6a.4xlarge
m6a.8xlarge
m6a.12xlarge
m6a.16xlarge
m6gd.medium
m6gd.large
m6gd.xlarge
m6gd.2xlarge
m6gd.4xlarge
m6gd.8xlarge
m6gd.12xlarge
m6gd.16xlarge
m6i.large
m6i.xlarge
m6i.2xlarge
m6i.4xlarge
m6i.8xlarge
m6i.12xlarge
m6i.16xlarge
m7a.medium
m7a.large
m7a.xlarge
m7a.2xlarge
m7a.4xlarge
m7a.8xlarge
m7a.12xlarge
m7a.16xlarge
m7gd.medium
m7gd.large
m7gd.xlarge
m7gd.2xlarge
m7gd.4xlarge
m7gd.8xlarge
m7gd.12xlarge
m7gd.16xlarge
m7i.large
m7i.xlarge
m7i.2xlarge
m7i.4xlarge
m7i.8xlarge
m7i.12xlarge
m7i.16xlarge
r6gd.medium
r6gd.large
r6gd.xlarge
r6gd.2xlarge
r6gd.4xlarge
r6gd.8xlarge
r6gd.12xlarge
r6gd.16xlarge
r7a.medium
r7a.large
r7a.xlarge
r7a.2xlarge
r7a.4xlarge
r7a.8xlarge
r7a.12xlarge
r7a.16xlarge
r7gd.medium
r7gd.large
r7gd.xlarge
r7gd.2xlarge
r7gd.4xlarge
r7gd.8xlarge
r7gd.12xlarge
r7gd.16xlarge
r7i.large
r7i.xlarge
r7i.2xlarge
r7i.4xlarge
r7i.8xlarge
r7i.12xlarge
r7i.16xlarge
r7i.24xlarge
r7i.48xlarge
c5ad.large
c5ad.xlarge
c5ad.2xlarge
c5ad.4xlarge
c5ad.8xlarge
c5ad.12xlarge
c5ad.16xlarge
c5ad.24xlarge
c5n.large
c5n.xlarge
c5n.2xlarge
c5n.4xlarge
c5n.9xlarge
c5n.18xlarge
r5ad.large
r5ad.xlarge
r5ad.2xlarge
r5ad.4xlarge
r5ad.8xlarge
r5ad.12xlarge
r5ad.16xlarge
r5ad.24xlarge
c6id.large
c6id.xlarge
c6id.2xlarge

c6id.4xlarge
c6id.8xlarge
c6id.12xlarge
c6id.16xlarge
c6id.24xlarge
c6id.32xlarge
c8g.medium
c8g.large
c8g.xlarge
c8g.2xlarge
c8g.4xlarge
c8g.8xlarge
c8g.12xlarge
c8g.16xlarge
c8g.24xlarge
c8g.48xlarge
m5ad.large
m5ad.xlarge
m5ad.2xlarge
m5ad.4xlarge
m5ad.8xlarge
m5ad.12xlarge
m5ad.16xlarge
m5ad.24xlarge
m5d.large
m5d.xlarge
m5d.2xlarge
m5d.4xlarge
m5d.8xlarge
m5d.12xlarge
m5d.16xlarge
m5d.24xlarge
m5dn.large
m5dn.xlarge
m5dn.2xlarge
m5dn.4xlarge
m5dn.8xlarge
m5dn.12xlarge
m5dn.16xlarge
m5dn.24xlarge
m5n.large
m5n.xlarge
m5n.2xlarge
m5n.4xlarge
m5n.8xlarge
m5n.12xlarge
m5n.16xlarge
m5n.24xlarge
m6id.large
m6id.xlarge
m6id.2xlarge
m6id.4xlarge
m6id.8xlarge
m6id.12xlarge
m6id.16xlarge
m6id.24xlarge
m6id.32xlarge
m6idn.large
m6idn.xlarge
m6idn.2xlarge
m6idn.4xlarge
m6idn.8xlarge
m6idn.12xlarge
m6idn.16xlarge
m6idn.24xlarge
m6idn.32xlarge
m6in.large
m6in.xlarge
m6in.2xlarge
m6in.4xlarge
m6in.8xlarge
m6in.12xlarge
m6in.16xlarge
m6in.24xlarge
m6in.32xlarge
m8g.medium
m8g.large
m8g.xlarge
m8g.2xlarge
m8g.4xlarge
m8g.8xlarge
m8g.12xlarge
m8g.16xlarge
m8g.24xlarge
m8g.48xlarge
r5dn.large
r5dn.xlarge
r5dn.2xlarge
r5dn.4xlarge
r5dn.8xlarge
r5dn.12xlarge
r5dn.16xlarge
r5dn.24xlarge
r5n.large
r5n.xlarge
r5n.2xlarge
r5n.4xlarge
r5n.8xlarge
r5n.12xlarge
r5n.16xlarge
r5n.24xlarge
r6a.large
r6a.xlarge
r6a.2xlarge
r6a.4xlarge
r6a.8xlarge
r6a.12xlarge
r6a.16xlarge
r6a.24xlarge
r6a.32xlarge
r6a.48xlarge
r6id.large
r6id.xlarge
r6id.2xlarge
r6id.4xlarge
r6id.8xlarge
r6id.12xlarge
r6id.16xlarge
r6id.24xlarge
r6id.32xlarge
r6idn.large
r6idn.xlarge
r6idn.2xlarge
r6idn.4xlarge
r6idn.8xlarge
r6idn.12xlarge
r6idn.16xlarge
r6idn.24xlarge
r6idn.32xlarge
r6in.large
r6in.xlarge
r6in.2xlarge
r6in.4xlarge
r6in.8xlarge
r6in.12xlarge
r6in.16xlarge
r6in.24xlarge
r6in.32xlarge
r8g.medium
r8g.large
r8g.xlarge
r8g.2xlarge
r8g.4xlarge
r8g.8xlarge
r8g.12xlarge
r8g.16xlarge
r8g.24xlarge
r8g.48xlarge
m4.16xlarge
c6a.32xlarge
c6a.48xlarge
c6i.32xlarge
r6i.24xlarge
r6i.32xlarge
c6in.24xlarge
c6in.32xlarge
c7a.24xlarge
c7a.32xlarge
c7a.48xlarge
c7i.24xlarge
c7i.48xlarge
m6a.24xlarge
m6a.32xlarge
m6a.48xlarge
m6i.24xlarge
m6i.32xlarge
m7a.24xlarge
m7a.32xlarge
m7a.48xlarge
m7i.24xlarge
m7i.48xlarge
r7a.24xlarge
r7a.32xlarge
r7a.48xlarge

--ec2-inbound-permissions (список)

Диапазоны IP-адресов и настройки портов, которые позволяют входящему трафику получать доступ к процессам сервера игры и другим процессам в этом флоте. Установите этот параметр для управляемых флотов EC2. Вы можете оставить этот параметр пустым при создании флота, но должны вызвать https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateFleetPortSettings, чтобы установить его, прежде чем пользователи смогут подключиться к игровым сессиям. В качестве рекомендации, мы рекомендуем открывать порты для удалённого доступа только тогда, когда это необходимо, и закрывать их по завершении. Для флотов Amazon GameLift Realtime Amazon GameLift автоматически устанавливает диапазоны TCP и UDP.

(структура)

Диапазон IP-адресов и настроек портов, позволяющих входящему трафику подключаться к процессам на экземпляре во флоте. Процессам назначается комбинация IP-адрес/номер порта, которая должна находиться в разрешённом диапазоне флота.

Для флотов Amazon GameLift Realtime Amazon GameLift автоматически открывает два диапазона портов, один для TCP-сообщений и один для UDP.

FromPort -> (целое число)

Начальное значение для диапазона разрешённых номеров портов.

Для флотов, использующих Linux-сборки, допустимы только порты 22 и 1026-60000.

Для флотов, использующих Windows-сборки, допустимы только порты 1026-60000.

ToPort -> (целое число)

Конечное значение для диапазона разрешённых номеров портов. Номера портов включают конечное значение. Это значение должно быть равно или больше FromPort.

Для флотов, использующих Linux-сборки, допустимы только порты 22 и 1026-60000.

Для флотов, использующих Windows-сборки, допустимы только порты 1026-60000.

IpRange -> (строка)

Диапазон разрешённых IP-адресов. Это значение должно быть выражено в CIDR-нотации. Пример: “000.000.000.000/[subnet mask]” или необязательно сокращённая версия “0.0.0.0/[subnet mask]”.

Protocol -> (строка)

Протокол сетевого взаимодействия, используемый флотом.

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

FromPort=integer,ToPort=integer,IpRange=string,Protocol=string ...

Синтаксис JSON:

[
  {
    "FromPort": integer,
    "ToPort": integer,
    "IpRange": "string",
    "Protocol": "TCP"|"UDP"
  }
  ...
]

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

Состояние защиты от завершения активных игровых сессий в флоте. По умолчанию этот параметр установлен в NoProtection. Вы также можете установить защиту игровой сессии для отдельной игровой сессии, вызвав UpdateGameSession.

NoProtection - Игровые сессии могут быть завершены во время активной игры в результате события уменьшения масштаба.
FullProtection - Игровые сессии в состоянии ACTIVE не могут быть завершены во время события уменьшения масштаба.

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

NoProtection
FullProtection

--runtime-configuration (структура)

Инструкции по запуску и выполнению серверных процессов в флоте. Установите конфигурацию выполнения для управляемых флотов EC2. Для флотов Anywhere установите этот параметр только в том случае, если флот выполняет агент Amazon GameLift. Конфигурация выполнения определяет одну или несколько конфигураций серверных процессов. Каждый серверный процесс определяет исполняемый файл игры или файл сценария Realtime и количество процессов, которые необходимо запустить одновременно.

Примечание

Этот параметр заменяет параметры ServerLaunchPath и ServerLaunchParameters , которые по-прежнему поддерживаются для обратной совместимости.

ServerProcesses -> (список)

Коллекция конфигураций серверных процессов, которые определяют, какие серверные процессы нужно запустить на вычислительных ресурсах флота.

(структура)

Набор инструкций для запуска серверных процессов на вычислительных ресурсах флота. Серверные процессы выполняют либо исполняемый файл в пользовательском сборе игры, либо скрипт Amazon GameLift Realtime. Конфигурации серверных процессов являются частью конфигурации выполнения флота.

LaunchPath -> (строка)

Расположение исполняемого файла сборки игры или скрипта Realtime. Сборки игр и скрипты Realtime устанавливаются на экземпляры в корневой директории:

Windows (только пользовательские сборки игр): C:\game . Пример: “C:\game\MyGame\server.exe “
Linux: /local/game . Примеры: “/local/game/MyGame/server.exe “ или “/local/game/MyRealtimeScript.js “

Примечание

Amazon GameLift не поддерживает использование скриптов настройки для запуска исполняемого файла игры. Для пользовательских сборок игр этот параметр должен указывать исполняемый файл, который вызывает операции серверного SDK initSDK() и ProcessReady() .

Parameters -> (строка)

Необязательный список параметров, которые нужно передать исполняемому файлу сервера или скрипту Realtime при запуске.

ConcurrentExecutions -> (целое число)

Количество серверных процессов, использующих эту конфигурацию, которые выполняются одновременно на каждом экземпляре или вычислительном ресурсе.

MaxConcurrentGameSessionActivations -> (целое число)

Количество игровых сессий в состоянии ACTIVATING, разрешенных на экземпляре или вычислительном ресурсе. Это ограничение ограничивает ресурсы экземпляра, которые могут быть использованы для новых активаций игр в любое время.

GameSessionActivationTimeoutSeconds -> (целое число)

Максимальное время (в секундах), разрешенное для запуска новой игровой сессии и ее сообщения о готовности к приему игроков. В течение этого времени игровая сессия находится в состоянии ACTIVATING. Если игровой сессии не удастся активироваться до истечения таймаута, она завершится, а состояние игровой сессии будет изменено на TERMINATED.

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

ServerProcesses=[{LaunchPath=string,Parameters=string,ConcurrentExecutions=integer},{LaunchPath=string,Parameters=string,ConcurrentExecutions=integer}],MaxConcurrentGameSessionActivations=integer,GameSessionActivationTimeoutSeconds=integer

Синтаксис JSON:

{
  "ServerProcesses": [
    {
      "LaunchPath": "string",
      "Parameters": "string",
      "ConcurrentExecutions": integer
    }
    ...
  ],
  "MaxConcurrentGameSessionActivations": integer,
  "GameSessionActivationTimeoutSeconds": integer
}

--resource-creation-limit-policy (структура)

Политика, которая ограничивает количество игровых сессий, которые может создать один игрок на экземплярах в этом флоте в течение определенного промежутка времени.

NewGameSessionsPerCreator -> (целое число)

Политика, которая устанавливает ограничения на количество игровых сессий, которые может создать игрок в течение определенного промежутка времени. С помощью этой политики можно контролировать возможность игроков потреблять доступные ресурсы.

Политика оценивается, когда игрок пытается создать новую игровую сессию. Получив запрос CreateGameSession, Amazon GameLift проверяет, что игрок (определяемый по CreatorId) создал меньше, чем лимит игровых сессий в указанный период времени.

PolicyPeriodInMinutes -> (целое число)

Промежуток времени, используемый для оценки политики ограничения создания ресурсов.

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

NewGameSessionsPerCreator=integer,PolicyPeriodInMinutes=integer

Синтаксис JSON:

{
  "NewGameSessionsPerCreator": integer,
  "PolicyPeriodInMinutes": integer
}

--metric-groups (список)

Имя группы метрик Amazon Web Services CloudWatch, к которой нужно добавить этот флот. Группа метрик используется для агрегирования метрик для нескольких флотов. Можно указать имя существующей группы метрик или задать новое имя для создания новой группы метрик. Флот может быть включен только в одну группу метрик за раз.

(строка)

Синтаксис:

"string" "string" ...

--peer-vpc-aws-account-id (строка)

Используется при сопряжении вашего флота Amazon GameLift с VPC, уникальный идентификатор учетной записи Amazon Web Services, которая владеет VPC. Вы можете найти свой идентификатор учетной записи в консоли управления Amazon Web Services в настройках учетной записи.

--peer-vpc-id (строка)

Уникальный идентификатор VPC с ресурсами, к которым будет иметь доступ ваш флот Amazon GameLift. VPC должен находиться в той же области, что и ваш флот. Чтобы найти ID VPC, используйте панель управления VPC в консоли управления Amazon Web Services. Узнайте больше о сопряжении VPC в разделе Сопряжение VPC с флотами Amazon GameLift.

--fleet-type (строка)

Указывает, использовать ли для этого флота экземпляры On-Demand или Spot. По умолчанию этот параметр установлен в ON_DEMAND. Узнайте больше о том, когда использовать экземпляры On-Demand и Spot. Это свойство флота нельзя изменить после создания флота.

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

ON_DEMAND
SPOT

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

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

--certificate-configuration (структура)

Приглашает Amazon GameLift сгенерировать сертификат TLS/SSL для флота. Amazon GameLift использует сертификаты для шифрования трафика между клиентами игр и серверами игр, работающими на Amazon GameLift. По умолчанию CertificateConfiguration равен DISABLED. Это свойство нельзя изменить после создания флота.

Сертификаты Certificate Manager (ACM) истекают через 13 месяцев. Истечение срока действия сертификата может привести к сбоям в работе флотов, что помешает игрокам подключиться к экземплярам в флоте. Рекомендуется заменить флоты до истечения 13 месяцев, рассмотрите использование псевдонимов флотов для плавного перехода.

Примечание

ACM недоступен во всех регионах Amazon Web Services. Запрос на создание флота с включенной генерацией сертификатов в недоступном регионе завершится ошибкой 4xx. Дополнительную информацию о поддерживаемых регионах см. в руководстве пользователя Certificate Manager.

CertificateType -> (строка)

Указывает, генерируется ли для флота сертификат TLS/SSL.

Допустимые значения:

GENERATED - Сгенерировать сертификат TLS/SSL для этого флота.
DISABLED - (по умолчанию) Не генерировать сертификат TLS/SSL для этого флота.

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

CertificateType=string

Синтаксис JSON:

{
  "CertificateType": "DISABLED"|"GENERATED"
}

--locations (список)

Набор удаленных расположений для развертывания дополнительных экземпляров и управления ими как многолокальным флотом. Используйте этот параметр при создании флота в регионах Amazon Web Services, которые поддерживают несколько локаций. Можно добавить любой регион Amazon Web Services или локальную зону, поддерживаемую Amazon GameLift. Укажите список одного или нескольких кодов региона Amazon Web Services, таких как us-west-2 , или имена локальных зон. При использовании этого параметра Amazon GameLift требует включения вашей домашней локации в запрос. Список поддерживаемых регионов и локальных зон см. в документации Amazon GameLift по расположениям услуг для управляемого хостинга.

(структура)

Удаленное расположение, в котором многолокальный флот может развернуть серверы игр для хостинга игр.

Location -> (строка)

Код региона Amazon Web Services, например us-west-2 . Список поддерживаемых регионов и локальных зон см. в документации Amazon GameLift по расположениям услуг для управляемого хостинга.

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

Location=string ...

Синтаксис JSON:

[
  {
    "Location": "string"
  }
  ...
]

--tags (список)

Список меток, которые необходимо назначить новому ресурсу флота. Теги — это определяемые разработчиком пары «ключ-значение». Использование тегов ресурсов Amazon Web Services полезно для управления ресурсами, управления доступом и распределения затрат. Дополнительную информацию см. в документе Amazon Web Services General Reference: Маркирование ресурсов Amazon Web Services.

(структура)

Метка, которую можно назначить ресурсу Amazon GameLift.

Дополнительная информация

Маркирование ресурсов Amazon Web Services в Amazon Web Services General Reference

Стратегии маркирования Amazon Web Services

Связанные действия

Все API по задачам

Key -> (строка)

Ключ для определяемой разработчиком пары «ключ-значение» для маркирования ресурса Amazon Web Services.

Value -> (строка)

Значение для определяемой разработчиком пары «ключ-значение» для маркирования ресурса Amazon Web Services.

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

Key=string,Value=string ...

Синтаксис JSON:

[
  {
    "Key": "string",
    "Value": "string"
  }
  ...
]

--compute-type (строка)

Тип вычислительных ресурсов, используемых для размещения ваших серверов игр.

EC2 – Сборка сервера игры развертывается на экземплярах Amazon EC2 для облачного хостинга. Это значение по умолчанию.
ANYWHERE – Серверы игр и вспомогательное программное обеспечение развертываются на предоставленных и управляемых вами вычислительных ресурсах. При использовании этого типа вычислительных ресурсов можно также установить параметр AnywhereConfiguration.

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

EC2
ANYWHERE

--anywhere-configuration (структура)

Параметры конфигурации Amazon GameLift Anywhere.

Cost -> (строка)

Стоимость работы вашего флота в час. Amazon GameLift использует предоставленную стоимость вашего флота для балансировки использования в очередях. Дополнительную информацию об очередях см. в руководстве разработчика Amazon GameLift. Настройка очередей.

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

Cost=string

Синтаксис JSON:

{
  "Cost": "string"
}

--instance-role-credentials-provider (строка)

Принуждает Amazon GameLift сгенерировать файл общих учетных данных для роли IAM, которая определена в InstanceRoleArn. Файл общих учетных данных хранится на каждом экземпляре флота и обновляется по мере необходимости. Используйте общие учетные данные для приложений, развертываемых вместе с исполняемым файлом сервера игры, если сервер игры интегрирован с серверной SDK версии 5.x. Более подробную информацию об использовании общих учетных данных см. в разделе Связь с другими ресурсами Amazon Web Services из ваших флотов.

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

SHARED_CREDENTIAL_FILE

--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 выполнит только один вызов для первой страницы результатов.

--query (строка)

Стиль форматирования вывода команды.

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-auto-prompt (булево)

Автоматически запрашивать параметры ввода CLI.

--no-cli-auto-prompt (булево)

Отключить автоматическое запроса параметров ввода CLI.

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. См. руководство по началу работы в руководстве пользователя AWS CLI для получения дополнительной информации.

Если не указано иное, все примеры имеют правила цитирования наподобие unix-систем. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной среды. См. Использование кавычек со строками в руководстве пользователя AWS CLI.

Пример 1: Создание базового Linux-флота

Следующий пример create-fleet создает минимально настроенный флот экземпляров Linux по требованию для размещения пользовательской сборки сервера. Вы можете завершить настройку, используя update-fleet.

aws gamelift create-fleet \
    --name MegaFrogRaceServer.NA.v2 \
    --description 'Hosts for v2 North America' \
    --build-id build-1111aaaa-22bb-33cc-44dd-5555eeee66ff \
    --certificate-configuration 'CertificateType=GENERATED' \
    --ec2-instance-type c4.large \
    --fleet-type ON_DEMAND \
    --runtime-configuration 'ServerProcesses=[{LaunchPath=/local/game/release-na/MegaFrogRace_Server.exe,ConcurrentExecutions=1}]'

Вывод:

{
    "FleetAttributes": {
        "BuildId": "build-1111aaaa-22bb-33cc-44dd-5555eeee66ff",
        "CertificateConfiguration": {
            "CertificateType": "GENERATED"
        },
        "CreationTime": 1496365885.44,
        "Description": "Hosts for v2 North America",
        "FleetArn": "arn:aws:gamelift:us-west-2:444455556666:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
        "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
        "FleetType": "ON_DEMAND",
        "InstanceType": "c4.large",
        "MetricGroups": ["default"],
        "Name": "MegaFrogRace.NA.v2",
        "NewGameSessionProtectionPolicy": "NoProtection",
        "OperatingSystem": "AMAZON_LINUX",
        "ServerLaunchPath": "/local/game/release-na/MegaFrogRace_Server.exe",
        "Status": "NEW"
    }
}

Пример 2: Создание базового Windows-флота

Следующий пример create-fleet создает минимально настроенный флот экземпляров Windows spot для размещения пользовательской сборки сервера. Вы можете завершить настройку, используя update-fleet.

aws gamelift create-fleet \
    --name MegaFrogRace.NA.v2 \
    --description 'Hosts for v2 North America' \
    --build-id build-2222aaaa-33bb-44cc-55dd-6666eeee77ff  \
    --certificate-configuration 'CertificateType=GENERATED' \
    --ec2-instance-type c4.large \
    --fleet-type SPOT \
    --runtime-configuration 'ServerProcesses=[{LaunchPath=C:\game\Bin64.Release.Dedicated\MegaFrogRace_Server.exe,ConcurrentExecutions=1}]'

Вывод:

{
    "FleetAttributes": {
        "BuildId": "build-2222aaaa-33bb-44cc-55dd-6666eeee77ff",
        "CertificateConfiguration": {
            "CertificateType": "GENERATED"
        },
        "CreationTime": 1496365885.44,
        "Description": "Hosts for v2 North America",
        "FleetArn": "arn:aws:gamelift:us-west-2:444455556666:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
        "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
        "FleetType": "SPOT",
        "InstanceType": "c4.large",
        "MetricGroups": ["default"],
        "Name": "MegaFrogRace.NA.v2",
        "NewGameSessionProtectionPolicy": "NoProtection",
        "OperatingSystem": "WINDOWS_2012",
        "ServerLaunchPath": "C:\game\Bin64.Release.Dedicated\MegaFrogRace_Server.exe",
        "Status": "NEW"
    }
}

Пример 3: Создание полностью настроенного флота

Следующий пример create-fleet создает флот экземпляров Windows spot для пользовательской сборки сервера с предоставленными наиболее часто используемыми настройками конфигурации.

aws gamelift create-fleet \
    --name MegaFrogRace.NA.v2 \
    --description 'Hosts for v2 North America' \
    --build-id build-2222aaaa-33bb-44cc-55dd-6666eeee77ff \
    --certificate-configuration 'CertificateType=GENERATED' \
    --ec2-instance-type c4.large \
    --ec2-inbound-permissions 'FromPort=33435,ToPort=33435,IpRange=10.24.34.0/23,Protocol=UDP' \
    --fleet-type SPOT \
    --new-game-session-protection-policy FullProtection \
    --runtime-configuration file://runtime-config.json \
    --metric-groups default \
    --instance-role-arn 'arn:aws:iam::444455556666:role/GameLiftS3Access'

Содержимое runtime-config.json:

GameSessionActivationTimeoutSeconds=300,
 MaxConcurrentGameSessionActivations=2,
 ServerProcesses=[
   {LaunchPath=C:\game\Bin64.Release.Dedicated\MegaFrogRace_Server.exe,Parameters=-debug,ConcurrentExecutions=1},
   {LaunchPath=C:\game\Bin64.Release.Dedicated\MegaFrogRace_Server.exe,ConcurrentExecutions=1}]

Вывод:

{
    "FleetAttributes": {
        "InstanceRoleArn": "arn:aws:iam::444455556666:role/GameLiftS3Access",
        "Status": "NEW",
        "InstanceType": "c4.large",
        "FleetArn": "arn:aws:gamelift:us-west-2:444455556666:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
        "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
        "Description": "Hosts for v2 North America",
        "FleetType": "SPOT",
        "OperatingSystem": "WINDOWS_2012",
        "Name": "MegaFrogRace.NA.v2",
        "CreationTime": 1569309011.11,
        "MetricGroups": [
            "default"
        ],
        "BuildId": "build-2222aaaa-33bb-44cc-55dd-6666eeee77ff",
        "ServerLaunchParameters": "abc",
        "ServerLaunchPath": "C:\\game\\Bin64.Release.Dedicated\\MegaFrogRace_Server.exe",
        "NewGameSessionProtectionPolicy": "FullProtection",
        "CertificateConfiguration": {
            "CertificateType": "GENERATED"
        }
    }
}

Пример 4: Создание флота Realtime Servers

Следующий пример create-fleet создает флот экземпляров Spot с конфигурационным скриптом Realtime, который был загружен в Amazon GameLift. Все серверы Realtime развертываются на машинах Linux. Для целей этого примера предположим, что загруженный скрипт Realtime включает в себя несколько скриптовых файлов, с функцией Init(), расположенной в скриптовом файле, названном MainScript.js. Как показано, этот файл идентифицируется как скрипт запуска в конфигурации времени выполнения.

aws gamelift create-fleet \
    --name MegaFrogRace.NA.realtime \
    --description 'Mega Frog Race Realtime fleet' \
    --script-id script-1111aaaa-22bb-33cc-44dd-5555eeee66ff \
    --ec2-instance-type c4.large \
    --fleet-type SPOT \
    --certificate-configuration 'CertificateType=GENERATED' --runtime-configuration 'ServerProcesses=[{LaunchPath=/local/game/MainScript.js,Parameters=+map Winter444,ConcurrentExecutions=5}]'

Вывод:

{
    "FleetAttributes": {
        "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
        "Status": "NEW",
        "CreationTime": 1569310745.212,
        "InstanceType": "c4.large",
        "NewGameSessionProtectionPolicy": "NoProtection",
        "CertificateConfiguration": {
            "CertificateType": "GENERATED"
        },
        "Name": "MegaFrogRace.NA.realtime",
        "ScriptId": "script-1111aaaa-22bb-33cc-44dd-5555eeee66ff",
        "FleetArn": "arn:aws:gamelift:us-west-2:444455556666:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
        "FleetType": "SPOT",
        "MetricGroups": [
            "default"
        ],
        "Description": "Mega Frog Race Realtime fleet",
        "OperatingSystem": "AMAZON_LINUX"
    }
}

Вывод

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

Свойства нового флота, включая текущий статус. Все флоты при создании размещаются в статусе NEW.

FleetId -> (строка)

Уникальный идентификатор флота.

FleetArn -> (строка)

Amazon Resource Name (ARN), присваиваемый ресурсу Amazon GameLift и уникально его идентифицирующий. ARNs уникальны во всех регионах. Формат: arn:aws:gamelift:<region>::fleet/fleet-a1234567-b8c9-0d1e-2fa3-b45c6d7e8912. В ARN флота GameLift идентификатор ресурса соответствует значению FleetId.

FleetType -> (строка)

Указывает, использует ли флот On-Demand или Spot-инстансы. Дополнительную информацию см. в разделе On-Demand versus Spot Instances. Это свойство флота изменить нельзя после создания.

InstanceType -> (строка)

Тип экземпляра Amazon EC2, используемый флотом. Тип экземпляра определяет вычислительные ресурсы каждого экземпляра в флоте, включая процессор, память, хранилище и сетевую емкость. Подробные описания см. в Amazon Elastic Compute Cloud Instance Types. Это атрибут используется с флотами, где ComputeType является EC2.

Description -> (строка)

Описание флота, понятное человеку.

Name -> (строка)

Дескриптивное имя, связанное с флотом. Имена флотов не должны быть уникальными.

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

Метка времени, указывающая момент создания этого объекта данных. Формат — число, выраженное в миллисекундах Unix time (например, "1469498468.057").

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

Метка времени, указывающая момент завершения работы с этим объектом данных. Формат — число, выраженное в миллисекундах Unix time (например, "1469498468.057").

Status -> (строка)

Текущий статус флота. Возможные статусы флота включают:

NEW – Создан новый ресурс флота, и Amazon GameLift начал создание флота. Желаемое количество экземпляров установлено в 1.
DOWNLOADING/VALIDATING/BUILDING – Amazon GameLift загружает сборку сервера игр, выполняет скрипты установки и проверяет файлы сборки. По завершении Amazon GameLift запускает экземпляр флота.
ACTIVATING – Amazon GameLift запускает процесс сервера игр и проверяет его подключение к сервису Amazon GameLift.
ACTIVE – Флот готов принимать игровые сессии.
ERROR – При загрузке, проверке, сборке или активации флота произошла ошибка.
DELETING – Экземпляры отвечают на запрос удаления флота.
TERMINATED – Флот больше не существует.

BuildId -> (строка)

Уникальный идентификатор ресурса сборки, развернутого на экземплярах этого флота. Этот атрибут используется с флотами, где ComputeType равно “EC2”.

BuildArn -> (строка)

Amazon Resource Name (ARN) связанный с ресурсом сборки Amazon GameLift, развернутым на экземплярах этого флота. В ARN сборки GameLift идентификатор ресурса соответствует значению BuildId. Этот атрибут используется с флотами, где ComputeType равно “EC2”.

ScriptId -> (строка)

Уникальный идентификатор ресурса скрипта Realtime, развернутого на экземплярах этого флота. Этот атрибут используется с флотами, где ComputeType равно “EC2”.

ScriptArn -> (строка)

Amazon Resource Name (ARN) связанный с ресурсом скрипта GameLift, развернутым на экземплярах этого флота. В ARN скрипта GameLift идентификатор ресурса соответствует значению ScriptId.

ServerLaunchPath -> (строка)

Этот параметр больше не используется. Пути запуска серверов теперь определяются с помощью RuntimeConfiguration флота. Запросы, использующие этот параметр, остаются валидными.

ServerLaunchParameters -> (строка)

Этот параметр больше не используется. Параметры запуска серверов теперь определяются с помощью конфигурации выполнения флота. Запросы, использующие этот параметр, остаются валидными.

LogPaths -> (список)

Этот параметр больше не используется. Пути журналов игровых сессий теперь определяются с помощью API сервера Amazon GameLift ProcessReady() logParameters. Дополнительную информацию см. в справке по API сервера.

(строка)

NewGameSessionProtectionPolicy -> (строка)

Тип защиты игровой сессии для всех новых экземпляров, запускаемых в флоте. Этот атрибут используется с флотами, где ComputeType равно EC2.

NoProtection – Игровая сессия может быть завершена во время события масштабирования вниз.
FullProtection – Если игровая сессия находится в статусе ACTIVE, она не может быть завершена во время события масштабирования вниз.

OperatingSystem -> (строка)

Операционная система вычислительных ресурсов флота. Операционная система флота определяется ОС сборки или скрипта, развернутых на этом флоте. Этот атрибут используется с флотами, где ComputeType равно EC2.

Примечание

Amazon Linux 2 (AL2) достигнет конца поддержки 30 июня 2025 года. Подробности см. в часто задаваемых вопросах по Amazon Linux 2. Для серверов игр, размещенных на AL2 и использующих версию серверного SDK 4.x для Amazon GameLift, сначала обновите сборку сервера игр до серверного SDK 5.x, а затем разверните на экземплярах AL2023. См. Миграция на версию серверного SDK 5.

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

Политика, устанавливающая ограничения на количество игровых сессий, которые игрок может создать в течение определенного промежутка времени. С помощью этой политики вы можете контролировать возможность игроков потреблять доступные ресурсы.

Политика оценивается при попытке игрока создать новую игровую сессию. Получив запрос CreateGameSession, Amazon GameLift проверяет, что игрок (идентифицированный по CreatorId) создал меньше, чем лимит игровых сессий за указанный период времени.

NewGameSessionsPerCreator -> (целое число)

PolicyPeriodInMinutes -> (целое число)

Промежуток времени, используемый при оценке политики ограничения создания ресурсов.

MetricGroups -> (список)

Имя группы метрик, к которой добавляются метрики для этого флота. В Amazon CloudWatch вы можете просмотреть агрегированные метрики для флотов, которые находятся в группе метрик. Флот может быть включен только в одну группу метрик за раз. Этот атрибут используется с флотами, где ComputeType равно EC2.

(строка)

StoppedActions -> (список)

Список действий флота, приостановленных с помощью StopFleetActions. Включает автоматическое масштабирование флота. Этот атрибут используется с флотами, где ComputeType равно EC2.

(строка)

InstanceRoleArn -> (строка)

Уникальный идентификатор IAM-роли, управляющей доступом к вашим сервисам Amazon Web Services. После установки ARN роли экземпляра любое приложение, работающее на экземпляре в этом флоте, может принять роль, включая скрипты установки, процессы сервера и демоны (фоновые процессы). Создайте роль или найдите ARN роли с помощью панели управления IAM в Amazon Web Services Management Console. Дополнительные сведения об использовании учетных данных на устройстве для ваших серверов игр см. в разделе Access external resources from a game server. Этот атрибут используется с флотами, где ComputeType равно EC2.

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

Определяет, генерируется ли TLS/SSL сертификат для флота. Эта функция должна быть включена при создании флота. Все экземпляры в флоте используют один и тот же сертификат.

CertificateType -> (строка)

Указывает, генерируется ли TLS/SSL сертификат для флота.

Допустимые значения:

GENERATED - Сгенерировать TLS/SSL сертификат для этого флота.
DISABLED - (по умолчанию) Не генерировать TLS/SSL сертификат для этого флота.

ComputeType -> (строка)

Тип вычислительных ресурсов, используемых для размещения ваших серверов игр. Вы можете использовать собственные вычислительные ресурсы с Amazon GameLift Anywhere или использовать экземпляры Amazon EC2 с управляемым Amazon GameLift.

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

Набор атрибутов, специфичных для флота Anywhere.

Cost -> (строка)

Стоимость работы вашего флота в час. Amazon GameLift использует предоставленную стоимость вашего флота для балансировки использования в очередях. Дополнительную информацию об очередях см. в разделе Настройка очередей в Руководстве разработчика Amazon GameLift.

InstanceRoleCredentialsProvider -> (строка)

Указывает, что экземпляры флота сохраняют общий файл учетных данных для IAM-роли, определенной в InstanceRoleArn. Общие учетные данные позволяют приложениям, развернутым вместе с исполняемым файлом сервера игр, взаимодействовать с другими ресурсами Amazon Web Services. Это свойство используется только при интеграции сервера игры с серверным SDK версии 5.x. Дополнительную информацию об использовании общих учетных данных см. в разделе Взаимодействие с другими ресурсами Amazon Web Services из ваших флотов. Этот атрибут используется с флотами, где ComputeType равно EC2.

LocationStates -> (список)

Расположение флота и статус жизненного цикла каждого расположения. Для новых флотов статус всех расположений установлен в NEW. Во время создания флота Amazon GameLift обновляет статус каждого расположения по мере развертывания экземпляров и подготовки их для размещения игр. Этот список включает запись для домашнего региона флота. Для флотов без удаленных расположений возвращается только одна запись, представляющая домашний регион.

(структура)

Расположение флота и его состояние жизненного цикла. Объект состояния расположения может быть использован для описания удаленного расположения или домашнего региона флота. Состояние жизненного цикла отслеживает прогресс запуска первого экземпляра в новом расположении и подготовку его к размещению игр, а затем удаление всех экземпляров и удаление расположения из флота.

НОВЫЙ – Определено новое расположение флота, и желаемое количество экземпляров установлено в 1.
ЗАГРУЖАЕТСЯ/ВАЛИДИРУЕТСЯ/СТРОИТСЯ/АКТИВИРУЕТСЯ – Amazon GameLift настраивает новое расположение флота, создает новые экземпляры с игрой или скриптом Realtime и запускает серверные процессы.
АКТИВНЫЙ – Хосты теперь могут принимать игровые сессии.
ОШИБКА – При загрузке, валидации, построении или активации расположения флота произошла ошибка.
УДАЛЯЕТСЯ – Хосты отвечают на запрос об удалении расположения флота.
ЗАВЕРШЁН – Расположение флота больше не существует.
НЕ_НАЙДЕНО – Расположение флота не найдено. Это может быть связано с удалением пользовательского расположения или отсутствием его создания.

Расположение -> (строка)

Расположение флота, выраженное в коде региона Amazon Web Services, например, us-west-2.

Статус -> (строка)

Статус жизненного цикла расположения флота.