Spec-Zone.ru › AWS CLI v2

[ aws . gamelift ]

update-script

Описание

Обновляет метаданные и содержимое скрипта Realtime.

Для обновления метаданных скрипта укажите ID скрипта и предоставьте обновленные значения имени и/или версии.

Для обновления содержимого скрипта предоставьте обновленный zip-архив, указав локальный файл или расположение в Amazon S3. Вы можете использовать любой метод независимо от того, как был загружен исходный скрипт. Используйте параметр Version для отслеживания обновлений скрипта.

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

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

Amazon GameLift Amazon GameLift Realtime

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

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

См. также: AWS API Documentation

Синтаксис

  update-script
--script-id <value>
[--name <value>]
[--storage-location <value>]
[--zip-file <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]

Параметры

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

Уникальный идентификатор скрипта Realtime для обновления. Вы можете использовать либо ID скрипта, либо значение ARN.

--name (строка)

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

--storage-location (структура)

Расположение ведра Amazon S3, где хранится zip-архив с вашими скриптами Realtime. Местоположение хранилища должно содержать имя ведра Amazon S3, имя zip-архива (ключ) и ARN роли, позволяющей Amazon GameLift получить доступ к месту хранения Amazon S3. Ведро S3 должно находиться в той же области, где вы хотите создать новый скрипт. По умолчанию Amazon GameLift загружает последнюю версию zip-архива; если у вас включено управление версиями объектов S3, вы можете использовать параметр ObjectVersion для указания более ранней версии.

Bucket -> (строка)

Идентификатор ведра Amazon S3. Название ведра S3.

Примечание

Amazon GameLift не поддерживает загрузку из ведер Amazon S3 с именами, содержащими точку (.).

Key -> (строка)

Имя zip-архива, содержащего файлы сборки или скрипты.

RoleArn -> (строка)

Amazon Resource Name (ARN) для IAM-роли, которая позволяет Amazon GameLift получать доступ к ведру S3.

ObjectVersion -> (строка)

Версия файла, если для ведра включено управление версиями объектов. Amazon GameLift использует эту информацию при получении файлов из ведра S3, которое вам принадлежит. Используйте этот параметр для указания определенной версии файла. Если не указано, извлекается последняя версия файла.

Краткая запись синтаксиса:

Bucket=string,Key=string,RoleArn=string,ObjectVersion=string

Синтаксис JSON:

{
  "Bucket": "string",
  "Key": "string",
  "RoleArn": "string",
  "ObjectVersion": "string"
}

--zip-file (блок данных)

Объект данных, содержащий ваши скрипты Realtime и зависимости в виде zip-архива. Zip-архив может содержать один или несколько файлов. Максимальный размер zip-архива составляет 5 МБ.

При использовании инструмента AWS CLI для создания скрипта этот параметр устанавливается в имя zip-архива. Он должен быть префиксным строкой «fileb://», чтобы указать, что данные файла являются двоичным объектом. Например: --zip-file fileb://myRealtimeScript.zip .

--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
  • текст
  • таблица
  • 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 для вывода.

--cli-auto-prompt (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

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

Вывод

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

Созданная запись скрипта с уникальным ID скрипта. Местоположение нового скрипта отражает расположение Amazon S3: (1) Если скрипт был загружен из ведра S3 в вашей учетной записи, местоположение хранилища отражает информацию, предоставленную в запросе CreateScript; (2) Если файл скрипта был загружен из локального zip-архива, местоположение хранилища отражает расположение S3, контролируемое сервисом Amazon GameLift.

ScriptId -> (строка)

Уникальный идентификатор скрипта Realtime

ScriptArn -> (строка)

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

Name -> (строка)

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

Version -> (строка)

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

SizeOnDisk -> (длинное целое число)

Размер загруженного скрипта Realtime в байтах. Если файлы загружены из расположения S3, это значение остается равным «0».

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

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

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

Расположение ведра Amazon S3, где хранится zip-архив с вашими скриптами Realtime. Местоположение хранилища должно содержать имя ведра Amazon S3, имя zip-архива (ключ) и ARN роли, позволяющей Amazon GameLift получить доступ к месту хранения Amazon S3. Ведро S3 должно находиться в той же области, где вы хотите создать новый скрипт. По умолчанию Amazon GameLift загружает последнюю версию zip-архива; если у вас включено управление версиями объектов S3, вы можете использовать параметр ObjectVersion для указания более ранней версии.

Bucket -> (строка)

Идентификатор ведра Amazon S3. Название ведра S3.

Примечание

Amazon GameLift не поддерживает загрузку из ведер Amazon S3 с именами, содержащими точку (.).

Key -> (строка)

Имя zip-архива, содержащего файлы сборки или скрипты.

RoleArn -> (строка)

Amazon Resource Name (ARN) для IAM-роли, которая позволяет Amazon GameLift получать доступ к ведру S3.

ObjectVersion -> (строка)

Версия файла, если для ведра включено управление версиями объектов. Amazon GameLift использует эту информацию при получении файлов из ведра S3, которое вам принадлежит. Используйте этот параметр для указания определенной версии файла. Если не указано, извлекается последняя версия файла.

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

Spec-Zone.ru

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