create-script
Описание
Создаёт новую запись скрипта для вашего Amazon GameLift Realtime скрипта. Realtime скрипты — это JavaScript, предоставляющие параметры конфигурации и необязательную пользовательскую логику игры для вашей игры. Скрипт развертывается при создании Amazon GameLift Realtime флота для размещения ваших игровых сессий. Логика скрипта выполняется во время активной игровой сессии.
Для создания новой записи скрипта укажите имя скрипта и предоставьте файл(ы) скрипта. Файлы скрипта и все зависимости должны быть сжаты в один файл. Вы можете извлечь файл zip из следующих мест:
- Из локально доступного каталога. Используйте параметр ZipFile для этого варианта.
- Из ведра Amazon Simple Storage Service (Amazon S3) в рамках вашей учётной записи Amazon Web Services. Используйте параметр StorageLocation для этого варианта. Вам понадобится роль Identity Access Management (IAM), которая позволит службе Amazon GameLift получать доступ к вашему ведру S3.
Если вызов успешен, создаётся новая запись скрипта с уникальным идентификатором скрипта. Если файл скрипта предоставлен как локальный файл, файл загружается в ведро S3, принадлежащее Amazon GameLift, и местоположение хранения записи скрипта отражает это местоположение. Если файл скрипта предоставлен как ведро S3, Amazon GameLift получает доступ к файлу в этом месте хранения по мере необходимости для развертывания.
Подробнее
Amazon GameLift Amazon GameLift Realtime
Настройка роли для доступа Amazon GameLift
Связанные действия
Все API по задачам
См. также: Документация AWS API
Синтаксис
create-script
[--name <value>]
[--storage-location <value>]
[--zip-file <value>]
[--tags <value>]
[--script-version <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 (строка)
--storage-location (структура)
Местоположение ведра Amazon S3, где хранится сжатый файл, содержащий ваши Realtime скрипты. Местоположение хранения должно указать имя ведра Amazon S3, имя файла zip (ключ) и ARN роли, которая позволяет Amazon GameLift получать доступ к местоположению хранения Amazon S3. Ведро S3 должно находиться в том же регионе, где вы хотите создать новый скрипт. По умолчанию Amazon GameLift загружает последнюю версию файла zip; если у вас включено управление версиями объектов S3, вы можете использовать параметр ObjectVersion для указания более ранней версии.
Bucket -> (строка)
Идентификатор ведра Amazon S3. Имя ведра S3.
Примечание
Amazon GameLift не поддерживает загрузку из ведёр Amazon S3 с именами, содержащими точку (.).Key -> (строка)
RoleArn -> (строка)
ObjectVersion -> (строка)
Сокращённый синтаксис:
Bucket=string,Key=string,RoleArn=string,ObjectVersion=string
Синтаксис JSON:
{
"Bucket": "string",
"Key": "string",
"RoleArn": "string",
"ObjectVersion": "string"
}
--zip-file (байты)
Объект данных, содержащий ваши Realtime скрипты и зависимости в виде файла zip. Файл zip может содержать один или несколько файлов. Максимальный размер файла zip составляет 5 МБ.
При использовании инструмента командной строки Amazon Web Services CLI для создания скрипта этот параметр устанавливается в имя файла zip. Он должен начинаться со строки «fileb://», чтобы указать, что данные файла — это двоичный объект. Например: --zip-file fileb://myRealtimeScript.zip .
--tags (список)
Список меток для назначения новому ресурсу скрипта. Метки — это определённые разработчиком пары «ключ-значение». Использование меток ресурсов Amazon Web Services полезно для управления ресурсами, управления доступом и распределения затрат. Дополнительную информацию см. в разделе «Использование меток ресурсов Amazon Web Services» в «Общие сведения об Amazon Web Services». После создания ресурса вы можете использовать TagResource, UntagResource и ListTagsForResource для добавления, удаления и просмотра меток. Максимальное ограничение меток может быть ниже указанного значения. См. общие сведения об Amazon Web Services для фактических ограничений меток.
(структура)
Метка, которую вы можете назначить ресурсу Amazon GameLift.
Подробнее
Использование меток ресурсов Amazon Web Services в «Общие сведения об Amazon Web Services»
Стратегии использования меток Amazon Web Services
Связанные действия
Все API по задачам
Key -> (строка)
Value -> (строка)
Сокращённый синтаксис:
Key=string,Value=string ...
Синтаксис JSON:
[
{
"Key": "string",
"Value": "string"
}
...
]
--script-version (строка)
--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 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.
Вывод
Скрипт -> (структура)
Созданный скрипт с уникальным идентификатором скрипта и ARN. Местоположение хранения нового скрипта отражает расположение в Amazon S3: (1) Если скрипт был загружен из ведра S3 в вашей учетной записи, местоположение хранения отражает информацию, предоставленную в запросе CreateScript; (2) Если файл скрипта был загружен из локального zip-файла, местоположение хранения отражает расположение в S3, управляемое службой Amazon GameLift.
ScriptId -> (строка)
ScriptArn -> (строка)
Name -> (строка)
Version -> (строка)
SizeOnDisk -> (длинное целое)
CreationTime -> (временная метка)
"1469498468.057").StorageLocation -> (структура)
Расположение ведра Amazon S3, где хранится сжатый файл, содержащий ваши скрипты Realtime. Местоположение хранения должно указывать имя ведра Amazon S3, имя zip-файла (ключ) и ARN роли, которая позволяет Amazon GameLift получить доступ к расположению хранения Amazon S3. Ведро S3 должно находиться в том же регионе, где вы хотите создать новый скрипт. По умолчанию Amazon GameLift загружает последнюю версию zip-файла; если у вас включено управление версиями объектов S3, вы можете использовать параметр ObjectVersion, чтобы указать более раннюю версию.
Bucket -> (строка)
Идентификатор ведра Amazon S3. Имя ведра S3.
Примечание
Amazon GameLift не поддерживает загрузку из ведер Amazon S3 с именами, содержащими точку (.).Key -> (строка)
RoleArn -> (строка)
ObjectVersion -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.