обновить-флот-контейнеров

Описание

Обновляет свойства управляемого флота контейнеров. В зависимости от обновляемых свойств, данная операция может инициировать развертывание флота. Вы можете отслеживать развертывания для флота, используя https://docs.aws.amazon.com/gamelift/latest/apireference/API_DescribeFleetDeployment.html .

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

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

Изменения следующих свойств инициируют развертывание флота:

• GameServerContainerGroupDefinition
• PerInstanceContainerGroupDefinition
• GameServerContainerGroupsPerInstance
• InstanceInboundPermissions
• InstanceConnectionPortRange
• LogConfiguration

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

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

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

Синопсис

  update-container-fleet
--fleet-id <value>
[--game-server-container-group-definition-name <value>]
[--per-instance-container-group-definition-name <value>]
[--game-server-container-groups-per-instance <value>]
[--instance-connection-port-range <value>]
[--instance-inbound-permission-authorizations <value>]
[--instance-inbound-permission-revocations <value>]
[--deployment-configuration <value>]
[--description <value>]
[--metric-groups <value>]
[--new-game-session-protection-policy <value>]
[--game-session-creation-limit-policy <value>]
[--log-configuration <value>]
[--remove-attributes <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]

Параметры

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

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

--per-instance-container-group-definition-name (строка)

--game-server-container-groups-per-instance (целое число)

--instance-connection-port-range (структура)

Упрощенный синтаксис:

FromPort=integer,ToPort=integer

Синтаксис JSON:

{
  "FromPort": integer,
  "ToPort": integer
}

--instance-inbound-permission-authorizations (список)

Упрощенный синтаксис:

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

Синтаксис JSON:

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

--instance-inbound-permission-revocations (список)

Упрощенный синтаксис:

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

Синтаксис JSON:

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

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

Упрощенный синтаксис:

ProtectionStrategy=string,MinimumHealthyPercentage=integer,ImpairmentStrategy=string

Синтаксис JSON:

{
  "ProtectionStrategy": "WITH_PROTECTION"|"IGNORE_PROTECTION",
  "MinimumHealthyPercentage": integer,
  "ImpairmentStrategy": "MAINTAIN"|"ROLLBACK"
}

--description (строка)

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

Синтаксис:

"string" "string" ...

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

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

Упрощенный синтаксис:

NewGameSessionsPerCreator=integer,PolicyPeriodInMinutes=integer

Синтаксис JSON:

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

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

Упрощенный синтаксис:

LogDestination=string,S3BucketName=string,LogGroupArn=string

Синтаксис JSON:

{
  "LogDestination": "NONE"|"CLOUDWATCH"|"S3",
  "S3BucketName": "string",
  "LogGroupArn": "string"
}

--remove-attributes (список)

Синтаксис:

"string" "string" ...

Where valid values are:
  PER_INSTANCE_CONTAINER_GROUP_DEFINITION

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

Вывод

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