[ aws . emr-serverless ]
update-application
Описание
Обновляет указанное приложение. Приложение должно быть в состоянии остановки или создания, чтобы его можно было обновить.
См. также: Документацию API AWS
Синтаксис
update-application
--application-id <value>
[--client-token <value>]
[--initial-capacity <value>]
[--maximum-capacity <value>]
[--auto-start-configuration <value>]
[--auto-stop-configuration <value>]
[--network-configuration <value>]
[--architecture <value>]
[--image-configuration <value>]
[--worker-type-specifications <value>]
[--interactive-configuration <value>]
[--release-label <value>]
[--runtime-configuration <value>]
[--monitoring-configuration <value>]
[--scheduler-configuration <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]
Параметры
--application-id (строка)
--client-token (строка)
--initial-capacity (массив)
Емкость для инициализации при обновлении приложения.
ключ -> (строка)
значение -> (структура)
Настройка начальной емкости на рабочем узле.
workerCount -> (целое число)
workerConfiguration -> (структура)
Настройка ресурсов начальной емкости.
cpu -> (строка)
memory -> (строка)
disk -> (строка)
diskType -> (строка)
STANDARD.Сокращенная синтаксическая запись:
KeyName1=workerCount=long,workerConfiguration={cpu=string,memory=string,disk=string,diskType=string},KeyName2=workerCount=long,workerConfiguration={cpu=string,memory=string,disk=string,diskType=string}
Синтаксис JSON:
{"string": {
"workerCount": long,
"workerConfiguration": {
"cpu": "string",
"memory": "string",
"disk": "string",
"diskType": "string"
}
}
...}
--maximum-capacity (структура)
Максимальная емкость для выделения при обновлении приложения. Эта емкость суммируется для всех рабочих узлов в любой момент времени на протяжении жизненного цикла приложения. Новые ресурсы не будут созданы, как только одно из определенных ограничений будет достигнуто.
cpu -> (строка)
memory -> (строка)
disk -> (строка)
Сокращенная синтаксическая запись:
cpu=string,memory=string,disk=string
Синтаксис JSON:
{
"cpu": "string",
"memory": "string",
"disk": "string"
}
--auto-start-configuration (структура)
Настройка для автоматического запуска приложения при подаче задания.
enabled -> (булево)
Сокращенная синтаксическая запись:
enabled=boolean
Синтаксис JSON:
{
"enabled": true|false
}
--auto-stop-configuration (структура)
Настройка для автоматической остановки приложения после определенного периода бездействия.
enabled -> (булево)
idleTimeoutMinutes -> (целое число)
Сокращенная синтаксическая запись:
enabled=boolean,idleTimeoutMinutes=integer
Синтаксис JSON:
{
"enabled": true|false,
"idleTimeoutMinutes": integer
}
--network-configuration (структура)
Настройка сети для подключения к VPC клиента.
subnetIds -> (список)
Массив идентификаторов подсетей для подключения к VPC клиента.
(строка)
securityGroupIds -> (список)
Массив идентификаторов групп безопасности для подключения к VPC клиента.
(строка)
Сокращенная синтаксическая запись:
subnetIds=string,string,securityGroupIds=string,string
Синтаксис JSON:
{
"subnetIds": ["string", ...],
"securityGroupIds": ["string", ...]
}
--architecture (строка)
Архитектура ЦП приложения.
Возможные значения:
ARM64X86_64
--image-configuration (структура)
Конфигурация образа, которая будет использоваться для всех типов рабочих узлов. Вы можете либо установить этот параметр, либо imageConfiguration для каждого типа рабочего узла в WorkerTypeSpecificationInput.
imageUri -> (строка)
Сокращенная синтаксическая запись:
imageUri=string
Синтаксис JSON:
{
"imageUri": "string"
}
--worker-type-specifications (массив)
Ключевые пары, которые определяют тип рабочего узла для WorkerTypeSpecificationInput. Этот параметр должен содержать все допустимые типы рабочих узлов для приложения Spark или Hive. Допустимые типы рабочих узлов включают Driver и Executor для приложений Spark и HiveDriver и TezTask для приложений Hive. Вы можете либо указать детали образа в этом параметре для каждого типа рабочего узла, либо в imageConfiguration для всех типов рабочих узлов.
ключ -> (строка)
значение -> (структура)
Характеристики типа рабочего узла.
imageConfiguration -> (структура)
Конфигурация образа для типа рабочего узла.
imageUri -> (строка)
Сокращенная синтаксическая запись:
KeyName1=imageConfiguration={imageUri=string},KeyName2=imageConfiguration={imageUri=string}
Синтаксис JSON:
{"string": {
"imageConfiguration": {
"imageUri": "string"
}
}
...}
--interactive-configuration (структура)
Объект конфигурации интерактивного режима, который содержит новые интерактивные сценарии при обновлении приложения.
studioEnabled -> (булево)
livyEndpointEnabled -> (булево)
Сокращенная синтаксическая запись:
studioEnabled=boolean,livyEndpointEnabled=boolean
Синтаксис JSON:
{
"studioEnabled": true|false,
"livyEndpointEnabled": true|false
}
--release-label (строка)
--runtime-configuration (список)
Настройки конфигурации для обновления приложения. Каждая конфигурация состоит из классификации и свойств. Эта конфигурация применяется ко всем запускам задач, выполняемым в рамках приложения.
(структура)
Настройка конфигурации для подготовки приложения. Конфигурация состоит из классификации, свойств и необязательных вложенных конфигураций. Классификация относится к файлу конфигурации, специфичному для приложения. Свойства — это параметры, которые вы хотите изменить в этом файле.
classification -> (строка)
properties -> (массив)
Набор свойств, указанных в классификации конфигурации.
ключ -> (строка)
значение -> (строка)
configurations -> (список)
Список дополнительных конфигураций для применения в объекте конфигурации.
(структура)
Настройка конфигурации для подготовки приложения. Конфигурация состоит из классификации, свойств и необязательных вложенных конфигураций. Классификация относится к файлу конфигурации, специфичному для приложения. Свойства — это параметры, которые вы хотите изменить в этом файле.
classification -> (строка)
properties -> (массив)
Набор свойств, указанных в классификации конфигурации.
ключ -> (строка)
значение -> (строка)
Сокращенная синтаксическая запись:
classification=string,properties={KeyName1=string,KeyName2=string},configurations=[{classification=string,properties={KeyName1=string,KeyName2=string},( ... recursive ... )},{classification=string,properties={KeyName1=string,KeyName2=string},( ... recursive ... )}] ...
Синтаксис JSON:
[
{
"classification": "string",
"properties": {"string": "string"
...},
"configurations": [
{
"classification": "string",
"properties": {"string": "string"
...},
"configurations":
}
...
]
}
...
]
--monitoring-configuration (структура)
Настройка мониторинга.
s3MonitoringConfiguration -> (структура)
Настройка Amazon S3 для публикации журналов мониторинга.
logUri -> (строка)
encryptionKeyArn -> (строка)
managedPersistenceMonitoringConfiguration -> (структура)
Настройка управляемой персистентности логов для запуска задачи.
enabled -> (булево)
encryptionKeyArn -> (строка)
cloudWatchLoggingConfiguration -> (структура)
Настройка Amazon CloudWatch для мониторинга логов. Вы можете настроить задачи на отправку информации о логах в CloudWatch.
enabled -> (булево)
logGroupName -> (строка)
logStreamNamePrefix -> (строка)
encryptionKeyArn -> (строка)
logTypes -> (массив)
Типы логов, которые вы хотите опубликовать в CloudWatch. Если вы не укажете типы логов, по умолчанию будут публиковаться логи STDOUT и STDERR драйвера в CloudWatch Logs. Для получения дополнительной информации, включая поддерживаемые типы рабочих узлов для Hive и Spark, см. Ведение журнала для EMR Serverless с CloudWatch.
-
Допустимые значения ключа :
SPARK_DRIVER,SPARK_EXECUTOR,HIVE_DRIVER,TEZ_TASK -
Допустимые значения элементов массива :
STDOUT,STDERR,HIVE_LOG,TEZ_AM,SYSTEM_LOGS
ключ -> (строка)
значение -> (список)
(строка)
prometheusMonitoringConfiguration -> (структура)
Объект конфигурации мониторинга, который можно настроить для отправки метрик в Amazon Managed Service for Prometheus для выполнения задачи.
remoteWriteUrl -> (строка)
Сокращенная синтаксическая запись:
s3MonitoringConfiguration={logUri=string,encryptionKeyArn=string},managedPersistenceMonitoringConfiguration={enabled=boolean,encryptionKeyArn=string},cloudWatchLoggingConfiguration={enabled=boolean,logGroupName=string,logStreamNamePrefix=string,encryptionKeyArn=string,logTypes={KeyName1=[string,string],KeyName2=[string,string]}},prometheusMonitoringConfiguration={remoteWriteUrl=string}
Синтаксис JSON:
{
"s3MonitoringConfiguration": {
"logUri": "string",
"encryptionKeyArn": "string"
},
"managedPersistenceMonitoringConfiguration": {
"enabled": true|false,
"encryptionKeyArn": "string"
},
"cloudWatchLoggingConfiguration": {
"enabled": true|false,
"logGroupName": "string",
"logStreamNamePrefix": "string",
"encryptionKeyArn": "string",
"logTypes": {"string": ["string", ...]
...}
},
"prometheusMonitoringConfiguration": {
"remoteWriteUrl": "string"
}
}
--scheduler-configuration (структура)
Настройка планировщика для пакетных и потоковых задач, выполняемых в этом приложении. Поддерживается с версиями release emr-7.0.0 и выше.
queueTimeoutMinutes -> (целое число)
maxConcurrentRuns -> (целое число)
Сокращенная синтаксическая запись:
queueTimeoutMinutes=integer,maxConcurrentRuns=integer
Синтаксис JSON:
{
"queueTimeoutMinutes": integer,
"maxConcurrentRuns": integer
}
--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.
Выходные данные
application -> (структура)
Информация об обновленном приложении.
applicationId -> (строка)
name -> (строка)
arn -> (строка)
releaseLabel -> (строка)
type -> (строка)
state -> (строка)
stateDetails -> (строка)
initialCapacity -> (массив)
Начальная емкость приложения.
key -> (строка)
value -> (структура)
Настройка начальной емкости на исполнителя.
workerCount -> (длинное целое)
workerConfiguration -> (структура)
Конфигурация ресурсов начальной емкости.
cpu -> (строка)
memory -> (строка)
disk -> (строка)
diskType -> (строка)
STANDARD.maximumCapacity -> (структура)
Максимальная емкость приложения. Она суммируется по всем исполнителям в любой момент времени на протяжении всего жизненного цикла приложения. После достижения одного из установленных пределов новые ресурсы создаваться не будут.
cpu -> (строка)
memory -> (строка)
disk -> (строка)
createdAt -> (метка времени)
updatedAt -> (метка времени)
tags -> (массив)
Теги, назначенные приложению.
key -> (строка)
value -> (строка)
autoStartConfiguration -> (структура)
Настройка для автоматического запуска приложения при отправке задания.
enabled -> (булево)
autoStopConfiguration -> (структура)
Настройка для автоматической остановки приложения после определенного времени простоя.
enabled -> (булево)
idleTimeoutMinutes -> (целое число)
networkConfiguration -> (структура)
Настройка сети для подключения к VPC клиента для приложения.
subnetIds -> (список)
Массив идентификаторов подсетей для подключения к VPC клиента.
(строка)
securityGroupIds -> (список)
Массив идентификаторов групп безопасности для подключения к VPC клиента.
(строка)
architecture -> (строка)
imageConfiguration -> (структура)
Настройка образа, применяемая ко всем типам исполнителей.
imageUri -> (строка)
resolvedImageDigest -> (строка)
workerTypeSpecifications -> (массив)
Настройка, применяемая к каждому типу исполнителей.
key -> (строка)
value -> (структура)
Настройки для типа исполнителя.
imageConfiguration -> (структура)
Настройка образа для типа исполнителя.
imageUri -> (строка)
resolvedImageDigest -> (строка)
runtimeConfiguration -> (список)
Настройки конфигурации приложения. Каждая конфигурация состоит из классификации и свойств. Используйте этот параметр при создании или обновлении приложения. Чтобы увидеть объект runtimeConfiguration приложения, выполните операцию API GetApplication.
(структура)
Спецификация конфигурации, используемой при развертывании приложения. Конфигурация состоит из классификации, свойств и необязательных вложенных конфигураций. Классификация относится к файлу конфигурации, специфичному для приложения. Свойства — это параметры, которые вы хотите изменить в этом файле.
classification -> (строка)
properties -> (массив)
Набор свойств, указанных в классификации конфигурации.
key -> (строка)
value -> (строка)
configurations -> (список)
Список дополнительных конфигураций, применяемых в объекте конфигурации.
(структура)
Спецификация конфигурации, используемой при развертывании приложения. Конфигурация состоит из классификации, свойств и необязательных вложенных конфигураций. Классификация относится к файлу конфигурации, специфичному для приложения. Свойства — это параметры, которые вы хотите изменить в этом файле.
classification -> (строка)
properties -> (массив)
Набор свойств, указанных в классификации конфигурации.
key -> (строка)
value -> (строка)
monitoringConfiguration -> (структура)
Настройка параметров мониторинга.
s3MonitoringConfiguration -> (структура)
Настройка Amazon S3 для публикации логов мониторинга.
logUri -> (строка)
encryptionKeyArn -> (строка)
managedPersistenceMonitoringConfiguration -> (структура)
Настройка управляемого хранения журналов для запуска задания.
enabled -> (булево)
encryptionKeyArn -> (строка)
cloudWatchLoggingConfiguration -> (структура)
Настройка Amazon CloudWatch для мониторинга журналов. Вы можете настроить свои задания на отправку информации о журналах в CloudWatch.
enabled -> (булево)
logGroupName -> (строка)
logStreamNamePrefix -> (строка)
encryptionKeyArn -> (строка)
logTypes -> (массив)
Типы журналов, которые вы хотите опубликовать в CloudWatch. Если вы не укажете никаких типов журналов, по умолчанию будут опубликованы журналы STDOUT и STDERR драйвера в CloudWatch Logs. Дополнительную информацию, включая поддерживаемые типы исполнителей для Hive и Spark, см. в разделе Ведение журнала для EMR Serverless с CloudWatch.
-
Допустимые значения ключей :
SPARK_DRIVER,SPARK_EXECUTOR,HIVE_DRIVER,TEZ_TASK -
Допустимые значения элементов массива :
STDOUT,STDERR,HIVE_LOG,TEZ_AM,SYSTEM_LOGS
key -> (строка)
value -> (список)
(строка)
prometheusMonitoringConfiguration -> (структура)
Объект конфигурации мониторинга, который вы можете настроить для отправки метрик в Amazon Managed Service for Prometheus для выполнения задания.
remoteWriteUrl -> (строка)
interactiveConfiguration -> (структура)
Объект конфигурации интерактивного использования, который позволяет использовать интерактивные сценарии для приложения.
studioEnabled -> (булево)
livyEndpointEnabled -> (булево)
schedulerConfiguration -> (структура)
Настройка планировщика для задач пакетной обработки и потоковой обработки, выполняемых в этом приложении. Поддерживается с версиями release label emr-7.0.0 и выше.
queueTimeoutMinutes -> (целое число)
maxConcurrentRuns -> (целое число)
© Copyright 2025, Amazon Web Services. Created using Sphinx.