update-function-configuration
Описание
Изменение параметров функции Lambda для определенной версии.
При обновлении функции Lambda создаётся экземпляр функции и её вспомогательных ресурсов. Если ваша функция подключена к VPC, этот процесс может занять минуту. В течение этого времени вы не можете изменить функцию, но можете её вызывать. Поля LastUpdateStatus , LastUpdateStatusReason и LastUpdateStatusReasonCode в ответе от GetFunctionConfiguration указывают, когда обновление завершено и функция обрабатывает события с новой конфигурацией. Для получения дополнительной информации см. Состояния функций Lambda .
Эти параметры могут отличаться в разных версиях функции и блокируются при публикации версии. Вы не можете изменить конфигурацию опубликованной версии, только не опубликованной.
Для настройки конкурентности функции используйте PutFunctionConcurrency . Для предоставления прав вызова учетной записи Amazon Web Services или сервису Amazon Web Services используйте AddPermission .
См. также: Документация AWS API
Синтаксис
update-function-configuration
--function-name <value>
[--role <value>]
[--handler <value>]
[--description <value>]
[--timeout <value>]
[--memory-size <value>]
[--vpc-config <value>]
[--environment <value>]
[--runtime <value>]
[--dead-letter-config <value>]
[--kms-key-arn <value>]
[--tracing-config <value>]
[--revision-id <value>]
[--layers <value>]
[--file-system-configs <value>]
[--image-config <value>]
[--ephemeral-storage <value>]
[--snap-start <value>]
[--logging-config <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]
Параметры
--function-name (строка)
Имя или ARN функции Lambda.
-
Имя функции –
my-function. -
ARN функции –
arn:aws:lambda:us-west-2:123456789012:function:my-function. -
Частичный ARN –
123456789012:function:my-function.
Ограничение по длине применяется только к полному ARN. Если вы указываете только имя функции, оно ограничено 64 символами.
--role (строка)
--handler (строка)
--description (строка)
--timeout (целое число)
--memory-size (целое число)
--vpc-config (структура)
Для сетевой связи с ресурсами Amazon Web Services в VPC укажите список сетевых групп и подсетей в VPC. Когда вы подключаете функцию к VPC, она может получать доступ к ресурсам и интернету только через эту VPC. Для получения дополнительной информации см. Настройка функции Lambda для доступа к ресурсам в VPC.
SubnetIds -> (список)
Список идентификаторов подсетей VPC.
(строка)
SecurityGroupIds -> (список)
Список идентификаторов сетевых групп VPC.
(строка)
Ipv6AllowedForDualStack -> (булево)
Сокращенная синтаксическая запись:
SubnetIds=string,string,SecurityGroupIds=string,string,Ipv6AllowedForDualStack=boolean
Синтаксис JSON:
{
"SubnetIds": ["string", ...],
"SecurityGroupIds": ["string", ...],
"Ipv6AllowedForDualStack": true|false
}
--environment (структура)
Переменные среды, доступные из кода функции во время выполнения.
Variables -> (карта)
Значения пар ключ-значение переменных среды. Для получения дополнительной информации см. Использование переменных среды Lambda.
key -> (строка)
value -> (строка)
Сокращенная синтаксическая запись:
Variables={KeyName1=string,KeyName2=string}
Синтаксис JSON:
{
"Variables": {"string": "string"
...}
}
--runtime (строка)
Идентификатор среды выполнения функции. Среда выполнения требуется, если пакет развертывания является архивом .zip. Указание среды выполнения приведет к ошибке, если вы развертываете функцию с помощью образа контейнера.
В следующем списке указаны устаревшие среды выполнения. Lambda блокирует создание новых функций и обновление существующих функций вскоре после устаревания каждой среды выполнения. Для получения дополнительной информации см. Использование среды выполнения после устаревания.
Список всех поддерживаемых в настоящее время сред выполнения см. в Поддерживаемые среды выполнения.
Возможные значения:
nodejsnodejs4.3nodejs6.10nodejs8.10nodejs10.xnodejs12.xnodejs14.xnodejs16.xjava8java8.al2java11python2.7python3.6python3.7python3.8python3.9dotnetcore1.0dotnetcore2.0dotnetcore2.1dotnetcore3.1dotnet6dotnet8nodejs4.3-edgego1.xruby2.5ruby2.7providedprovided.al2nodejs18.xpython3.10java17ruby3.2ruby3.3ruby3.4python3.11nodejs20.xprovided.al2023python3.12java21python3.13nodejs22.x
--dead-letter-config (структура)
Настройка очереди с необработанными событиями, которая определяет очередь или тему, куда Lambda отправляет асинхронные события при их сбое в обработке. Для получения дополнительной информации см. Очереди с необработанными событиями.
TargetArn -> (строка)
Сокращенная синтаксическая запись:
TargetArn=string
Синтаксис JSON:
{
"TargetArn": "string"
}
--kms-key-arn (строка)
ARN управляемого ключа KMS, используемого для шифрования следующих ресурсов:
- Переменные окружения функции.
- Снимки Lambda SnapStart функции.
- При использовании с
SourceKMSKeyArn, распакованная версия пакета развертывания .zip, используемого для вызовов функций. Для получения дополнительной информации см. Указание управляемого ключа клиента для Lambda. - Оптимизированная версия образа контейнера, используемого для вызовов функций. Обратите внимание, что это не тот же ключ, который используется для защиты вашего образа контейнера в Amazon Elastic Container Registry (Amazon ECR). Для получения дополнительной информации см. Жизненный цикл функций.
Если вы не предоставите управляемый ключ клиента, Lambda будет использовать управляемый ключ Amazon Web Services или ключ Amazon Web Services.
--tracing-config (структура)
Установите Mode в Active для выборки и отслеживания подмножества входящих запросов с X-Ray.
Mode -> (строка)
Сокращенная синтаксическая запись:
Mode=string
Синтаксис JSON:
{
"Mode": "Active"|"PassThrough"
}
--revision-id (строка)
--layers (список)
Список слоёв функции, которые необходимо добавить к среде выполнения функции. Укажите каждый слой по его ARN, включая версию.
(строка)
Синтаксис:
"string" "string" ...
--file-system-configs (список)
Параметры подключения к файловой системе Amazon EFS.
(структура)
Подробная информация о подключении функции Lambda к файловой системе Amazon EFS.
Arn -> (строка)
LocalMountPath -> (строка)
/mnt/.Сокращенная синтаксическая запись:
Arn=string,LocalMountPath=string ...
Синтаксис JSON:
[
{
"Arn": "string",
"LocalMountPath": "string"
}
...
]
--image-config (структура)
EntryPoint -> (список)
Указывает точку входа в приложение, которая обычно является местоположением исполняемого файла среды выполнения.
(строка)
Command -> (список)
Указывает параметры, которые вы хотите передать с ENTRYPOINT.
(строка)
WorkingDirectory -> (строка)
Сокращенная синтаксическая запись:
EntryPoint=string,string,Command=string,string,WorkingDirectory=string
Синтаксис JSON:
{
"EntryPoint": ["string", ...],
"Command": ["string", ...],
"WorkingDirectory": "string"
}
--ephemeral-storage (структура)
Размер каталога /tmp функции в МБ. Значение по умолчанию — 512, но может быть любым целым числом от 512 до 10240 МБ. Для получения дополнительной информации см. Настройка временного хранилища (консоль).
Size -> (целое число)
/tmp функции.Сокращенная синтаксическая запись:
Size=integer
Синтаксис JSON:
{
"Size": integer
}
--snap-start (структура)
Настройка SnapStart функции.
ApplyOn -> (строка)
PublishedVersions для создания снимка инициализированной среды выполнения при публикации версии функции.Сокращенная синтаксическая запись:
ApplyOn=string
Синтаксис JSON:
{
"ApplyOn": "PublishedVersions"|"None"
}
--logging-config (структура)
Настройки конфигурации журналов Amazon CloudWatch для функции.
LogFormat -> (строка)
ApplicationLogLevel -> (строка)
TRACE — самый высокий уровень, а FATAL — самый низкий.SystemLogLevel -> (строка)
DEBUG — самый высокий уровень, а WARN — самый низкий.LogGroup -> (строка)
/aws/lambda/<function name>. Чтобы использовать другую группу журналов, введите существующую группу журналов или введите имя новой группы журналов.Сокращенная синтаксическая запись:
LogFormat=string,ApplicationLogLevel=string,SystemLogLevel=string,LogGroup=string
Синтаксис JSON:
{
"LogFormat": "JSON"|"Text",
"ApplicationLogLevel": "TRACE"|"DEBUG"|"INFO"|"WARN"|"ERROR"|"FATAL",
"SystemLogLevel": "DEBUG"|"INFO"|"WARN",
"LogGroup": "string"
}
--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON-строки. JSON-строка следует формату, предоставленному --generate-cli-skeleton. Если другие аргументы предоставляются в командной строке, эти значения переопределяют значения, предоставленные через JSON. Передача произвольных двоичных данных с помощью значения, предоставленного через JSON, невозможна, так как строка будет воспринята буквально. Это не может быть указано вместе с --cli-input-yaml.
(строка) Выводит 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.
Примеры
Примечание
Чтобы использовать следующие примеры, необходимо установить и настроить AWS CLI. Дополнительные сведения см. в руководстве по началу работы в Руководстве пользователя AWS CLI.
Если не указано иное, все примеры используют правила цитирования в стиле Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. Дополнительные сведения см. в разделе «Использование кавычек со строками» в Руководстве пользователя AWS CLI.
Изменение конфигурации функции
Следующий пример изменяет размер памяти на 256 МБ для неопубликованной версии ($LATEST) функции my-function.
aws lambda update-function-configuration \
--function-name my-function \
--memory-size 256
Вывод:
{
"FunctionName": "my-function",
"LastModified": "2019-09-26T20:28:40.438+0000",
"RevisionId": "e52502d4-9320-4688-9cd6-152a6ab7490d",
"MemorySize": 256,
"Version": "$LATEST",
"Role": "arn:aws:iam::123456789012:role/service-role/my-function-role-uy3l9qyq",
"Timeout": 3,
"Runtime": "nodejs10.x",
"TracingConfig": {
"Mode": "PassThrough"
},
"CodeSha256": "5tT2qgzYUHaqwR716pZ2dpkn/0J1FrzJmlKidWoaCgk=",
"Description": "",
"VpcConfig": {
"SubnetIds": [],
"VpcId": "",
"SecurityGroupIds": []
},
"CodeSize": 304,
"FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function",
"Handler": "index.handler"
}
Дополнительные сведения см. в разделе «Конфигурация функции AWS Lambda» в Руководстве разработчика AWS Lambda.
Вывод
ИмяФункции -> (строка)
ФункцияArn -> (строка)
ВременнаяОбработка -> (строка)
Идентификатор среды выполнения функции. ВременнаяОбработка необходима, если пакет развертывания — архив .zip. Указание временнойОбработки при развертывании функции с помощью контейнерного образа приведёт к ошибке.
В этом списке перечислены устаревшие среды выполнения. Lambda блокирует создание новых функций и обновление существующих функций вскоре после того, как среда выполнения устареет. Дополнительные сведения см. в разделе Использование среды выполнения после устаревания .
Список всех поддерживаемых сред выполнения см. в разделе Поддерживаемые среды выполнения .
Роль -> (строка)
Обработчик -> (строка)
РазмерКода -> (длинное целое)
Описание -> (строка)
Таймаут -> (целое число)
РазмерПамяти -> (целое число)
ПоследнееИзменение -> (строка)
ХешКодаSha256 -> (строка)
Версия -> (строка)
КонфигурацияVpc -> (структура)
Конфигурация сети функции.
ИдентификаторыПодсетей -> (список)
Список идентификаторов подсетей VPC.
(строка)
ИдентификаторыГруппБезопасности -> (список)
Список идентификаторов групп безопасности VPC.
(строка)
ИдентификаторVpc -> (строка)
РазрешеноIpv6ДляДвухстековой -> (булево)
КонфигурацияОчередиОтказа -> (структура)
Очередь отказа функции.
ЦелевойArn -> (строка)
Среда -> (структура)
Переменные среды функции. Исключены из журналов CloudTrail.
Переменные -> (отображение)
Значения пар "ключ-значение" переменных среды. Исключены из журналов CloudTrail.
ключ -> (строка)
значение -> (строка)
Ошибка -> (структура)
Сообщения об ошибках для переменных среды, которые не удалось применить.
КодОшибки -> (строка)
Сообщение -> (строка)
ArnКлючаKMS -> (строка)
ARN управляемого клиентом ключа Key Management Service (KMS), используемого для шифрования следующих ресурсов:
- Переменные среды функции.
- Снимки Lambda SnapStart функции.
- При использовании с
SourceKMSKeyArn, распакованная версия пакета развертывания .zip, используемая для вызовов функций. Дополнительные сведения см. в разделе Указание управляемого клиентом ключа для Lambda . - Оптимизированная версия контейнерного образа, используемая для вызовов функций. Обратите внимание, что это не тот ключ, который используется для защиты вашего контейнерного образа в Amazon Elastic Container Registry (Amazon ECR). Дополнительные сведения см. в разделе Жизненный цикл функций .
Если вы не укажете управляемый клиентом ключ, Lambda будет использовать ключ, принадлежащий Amazon Web Services, или управляемый Amazon Web Services ключ.
КонфигурацияОтслеживания -> (структура)
Конфигурация отслеживания X-Ray функции.
Режим -> (строка)
MasterArn -> (строка)
ИдентификаторРевизии -> (строка)
Слои -> (список)
Слои функции.
(структура)
Слой Lambda.
Arn -> (строка)
РазмерКода -> (длинное целое)
SigningProfileVersionArn -> (строка)
SigningJobArn -> (строка)
Состояние -> (строка)
Inactive вы можете повторно активировать функцию, вызвав её.ПричинаСостояния -> (строка)
КодПричиныСостояния -> (строка)
Creating вы не можете вызывать или изменять функцию.СтатусПоследнегоОбновления -> (строка)
Successful после завершения создания функции.ПричинаПоследнегоОбновления -> (строка)
КодПричиныПоследнегоОбновления -> (строка)
КонфигурацииФайловойСистемы -> (список)
Настройки подключения к системе файлов Amazon EFS.
(структура)
Подробности о подключении между функцией Lambda и системой файлов Amazon EFS.
Arn -> (строка)
ЛокальныйПутьМонтирования -> (строка)
/mnt/.ТипПакетa -> (строка)
Image для контейнерного образа и в Zip для архива .zip.ОтветКонфигурацииОбраза -> (структура)
Значения конфигурации образа функции.
КонфигурацияОбраза -> (структура)
Значения конфигурации, которые переопределяют Dockerfile контейнерного образа.
ТочкаВходa -> (список)
Указывает точку входа в приложение, которая, как правило, расположена в месте исполняемого файла среды выполнения.
(строка)
Команда -> (список)
Указывает параметры, которые вы хотите передать с ENTRYPOINT.
(строка)
РабочийКаталог -> (строка)
Ошибка -> (структура)
Ответ об ошибке для GetFunctionConfiguration.
КодОшибки -> (строка)
Сообщение -> (строка)
SigningProfileVersionArn -> (строка)
SigningJobArn -> (строка)
Архитектуры -> (список)
Архитектура набора инструкций, которую поддерживает функция. Архитектура — это строковый массив со значением одного из допустимых значений. Значение архитектуры по умолчанию — x86_64.
(строка)
ВременноеХранилище -> (структура)
Размер каталога /tmp функции в МБ. Значение по умолчанию — 512, но может быть любым целым числом от 512 до 10 240 МБ. Дополнительные сведения см. в разделе Настройка временного хранилища (консоль) .
Размер -> (целое число)
/tmp функции.SnapStart -> (структура)
Установите ApplyOn в PublishedVersions для создания снимка начальной среды выполнения при публикации версии функции. Дополнительные сведения см. в разделе Улучшение производительности запуска с Lambda SnapStart .
ПрименитьК -> (строка)
PublishedVersions Lambda создаст снимок среды выполнения при публикации версии функции.СтатусОптимизации -> (строка)
RuntimeVersionConfig -> (структура)
ARN среды выполнения и любые возникшие ошибки.
RuntimeVersionArn -> (строка)
Ошибка -> (структура)
Ответ об ошибке, когда Lambda не может получить версию среды выполнения для функции.
КодОшибки -> (строка)
Сообщение -> (строка)
КонфигурацияЖурналирования -> (структура)
Настройки конфигурации журналов Amazon CloudWatch функции.
ФорматЖурнала -> (строка)
УровеньПодробностиПриложения -> (строка)
TRACE — самый высокий уровень, а FATAL — самый низкий.УровеньПодробностиСистемы -> (строка)
DEBUG — самый высокий уровень, а WARN — самый низкий.ГруппаЖурналов -> (строка)
/aws/lambda/<function name>. Для использования другой группы журналов введите существующую группу журналов или введите имя новой группы журналов.
© Copyright 2025, Amazon Web Services. Created using Sphinx.