Spec-Zone.ru › AWS CLI v2

[ aws . lambda ]

обновить-код-функции

Описание

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

Если тип пакета функции — Image, то вы должны указать пакет кода в ImageUri в качестве URI контейнерного образа в реестре Amazon ECR.

Если тип пакета функции — Zip, то вы должны указать пакет развертывания в виде архива .zip. Укажите ведро и ключ Amazon S3 для расположения файла кода .zip. Вы также можете указать код функции непосредственно с помощью поля ZipFile.

Код в пакете развертывания должен быть совместим с целевой архитектурой набора инструкций функции (x86-64 или arm64).

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

Примечание

Для функции, определенной как контейнерный образ, Lambda разрешает метку образа до образа-дайджеста. В Amazon ECR, если вы обновите метку образа на новый образ, Lambda не обновит функцию автоматически.

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

Синтаксис

  update-function-code
--function-name <value>
[--zip-file <value>]
[--s3-bucket <value>]
[--s3-key <value>]
[--s3-object-version <value>]
[--image-uri <value>]
[--publish | --no-publish]
[--dry-run | --no-dry-run]
[--revision-id <value>]
[--architectures <value>]
[--source-kms-key-arn <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 символа.

--zip-file (байтовый массив)

Путь к zip-архиву {param_type}, который вы загружаете. Укажите –zip-file или –{param_type}, но не оба. Пример: fileb://{param_type}.zip

--s3-bucket (строка)

Ведро Amazon S3 в той же области Amazon Web Services, что и ваша функция. Ведро может находиться в другом аккаунте Amazon Web Services. Используйте только с функцией, определенной с пакетом развертывания в виде архива .zip.

--s3-key (строка)

Ключ Amazon S3 пакета развертывания. Используйте только с функцией, определенной с пакетом развертывания в виде архива .zip.

--s3-object-version (строка)

Для версионированных объектов — версия объекта пакета развертывания, которую нужно использовать.

--image-uri (строка)

URI контейнерного образа в реестре Amazon ECR. Не используйте для функции, определенной с пакетом развертывания в виде архива .zip.

--publish | --no-publish (логическое значение)

Установите в значение true, чтобы опубликовать новую версию функции после обновления кода. Это имеет тот же эффект, что и вызов PublishVersion отдельно.

--dry-run | --no-dry-run (логическое значение)

Установите в значение true, чтобы проверить параметры запроса и разрешения доступа без изменения кода функции.

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

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

--architectures (список)

Архитектура набора инструкций, которую поддерживает функция. Введите массив строк с одним из допустимых значений (arm64 или x86_64). Значение по умолчанию — x86_64.

(строка)

Синтаксис:

"string" "string" ...

Where valid values are:
  x86_64
  arm64

--source-kms-key-arn (строка)

ARN управляемого клиентом ключа службы управления ключами (KMS), используемого для шифрования вашего пакета развертывания .zip функции. Если вы не предоставите управляемый клиентом ключ, Lambda использует управляемый Amazon Web Services ключ.

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

Примеры

Примечание

Для использования следующих примеров вам необходимо установить и настроить AWS CLI. Дополнительные сведения см. в руководстве по началу работы в руководстве пользователя AWS CLI.

За исключением случаев, когда указано иное, во всех примерах используются правила цитирования в стиле Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей консоли. Дополнительные сведения см. в разделе Использование кавычек со строками в руководстве пользователя AWS CLI.

Чтобы обновить код функции Lambda

Следующий пример update-function-code заменяет код неопубликованной ($LATEST) версии функции my-function содержимым указанного zip-файла.

aws lambda update-function-code \
    --function-name  my-function \
    --zip-file fileb://my-function.zip

Вывод:

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

Вывод

ИмяФункции -> (строка)

Название функции.

FunctionArn -> (строка)

Amazon Resource Name (ARN) функции.

Runtime -> (строка)

Идентификатор среды выполнения функции. Среда выполнения требуется, если пакет развертывания — это архив .zip. Указание среды выполнения приводит к ошибке, если вы разрабатываете функцию с помощью контейнерного образа.

В следующем списке указаны устаревшие среды выполнения. Lambda блокирует создание новых функций и обновление существующих функций вскоре после устаревания каждой среды выполнения. Дополнительную информацию см. в разделе Использование среды выполнения после устаревания .

Список всех поддерживаемых сред выполнения см. в разделе Поддерживаемые среды выполнения .

Роль -> (строка)

Роль выполнения функции.

Обработчик -> (строка)

Функция, которую Lambda вызывает для начала выполнения вашей функции.

РазмерКода -> (целое число)

Размер пакета развертывания функции в байтах.

Описание -> (строка)

Описание функции.

Таймаут -> (целое число)

Время в секундах, которое Lambda позволяет функции выполняться, прежде чем остановить её.

РазмерПамяти -> (целое число)

Объем памяти, доступный функции во время выполнения.

ПоследнееОбновление -> (строка)

Дата и время последнего обновления функции в формате ISO-8601 (ГГГГ-ММ-ДДТчч:мм:сс.sTZD).

CodeSha256 -> (строка)

Хеш SHA256 пакета развертывания функции.

Версия -> (строка)

Версия функции Lambda.

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

Настройка сети функции.

SubnetIds -> (список)

Список идентификаторов подсетей VPC.

(строка)

SecurityGroupIds -> (список)

Список идентификаторов групп безопасности VPC.

(строка)

VpcId -> (строка)

Идентификатор VPC.

Ipv6AllowedForDualStack -> (булево)

Разрешает исходящий трафик IPv6 для функций VPC, подключенных к подсетям с двойной адресацией.

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

Очередь необработанных сообщений функции.

TargetArn -> (строка)

Amazon Resource Name (ARN) очереди Amazon SQS или темы Amazon SNS.

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

Переменные окружения функции. Не включаются в журналы CloudTrail.

Variables -> (карта)

Пара пары значений переменных окружения. Не включаются в журналы CloudTrail.

ключ -> (строка)

значение -> (строка)

Ошибка -> (структура)

Сообщения об ошибках для переменных окружения, которые не были применены.

КодОшибки -> (строка)

Код ошибки.

Сообщение -> (строка)

Сообщение об ошибке.

KMSKeyArn -> (строка)

ARN управляемого клиентом ключа Key Management Service (KMS), используемого для шифрования следующих ресурсов:

  • Переменных окружения функции.
  • Снапшотов Lambda SnapStart функции.
  • При использовании с SourceKMSKeyArn , распакованной версии пакета развертывания .zip, используемой для вызовов функции. Дополнительную информацию см. в разделе Указание управляемого клиентом ключа для Lambda .
  • Оптимизированной версии контейнерного образа, используемой для вызовов функции. Обратите внимание, что это не тот же ключ, который используется для защиты вашего контейнерного образа в Amazon Elastic Container Registry (Amazon ECR). Дополнительную информацию см. в разделе Жизненный цикл функции .

Если вы не предоставите управляемый клиентом ключ, Lambda будет использовать ключ, принадлежащий Amazon Web Services, или управляемый Amazon Web Services ключ.

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

Настройка трассировки X-Ray функции.

Режим -> (строка)

Режим трассировки.

MasterArn -> (строка)

Для функций Lambda@Edge — ARN основной функции.

RevisionId -> (строка)

Последняя обновленная ревизия функции или псевдонима.

Слои -> (список)

Слои функции.

(структура)

Слой Lambda.

Arn -> (строка)

Amazon Resource Name (ARN) слоя функции.

РазмерКода -> (целое число)

Размер архива слоя в байтах.

SigningProfileVersionArn -> (строка)

Amazon Resource Name (ARN) для версии профиля подписи.

SigningJobArn -> (строка)

Amazon Resource Name (ARN) задания подписи.

Состояние -> (строка)

Текущее состояние функции. Когда состояние равно Inactive, вы можете повторно активировать функцию, вызвав её.

ПричинаСостояния -> (строка)

Причина текущего состояния функции.

КодПричиныСостояния -> (строка)

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

СтатусПоследнегоОбновления -> (строка)

Статус последнего обновления, выполненного для функции. После завершения создания функции, он сначала устанавливается в значение Successful.

ПричинаПоследнегоОбновления -> (строка)

Причина последнего обновления, выполненного для функции.

КодПричиныПоследнегоОбновления -> (строка)

Код причины последнего обновления, выполненного для функции.

FileSystemConfigs -> (список)

Настройки подключения к файловой системе Amazon EFS.

(структура)

Подробности о подключении между функцией Lambda и файловой системой Amazon EFS.

Arn -> (строка)

Amazon Resource Name (ARN) точки доступа Amazon EFS, предоставляющей доступ к файловой системе.

LocalMountPath -> (строка)

Путь, по которому функция может получить доступ к файловой системе, начинающийся с /mnt/.

ТипПакет -> (строка)

Тип пакета развертывания. Установлено в Image для контейнерного образа и Zip для архива .zip.

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

Значения конфигурации образа функции.

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

Значения конфигурации, которые переопределяют Dockerfile контейнерного образа.

EntryPoint -> (список)

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

(строка)

Command -> (список)

Указывает параметры, которые вы хотите передать с ENTRYPOINT.

(строка)

РабочаяДиректория -> (строка)

Указывает рабочую директорию.

Ошибка -> (структура)

Ответ об ошибке на GetFunctionConfiguration.

КодОшибки -> (строка)

Код ошибки.

Сообщение -> (строка)

Сообщение об ошибке.

SigningProfileVersionArn -> (строка)

ARN версии профиля подписи.

SigningJobArn -> (строка)

ARN задания подписи.

Архитектуры -> (список)

Архитектура набора команд, которую поддерживает функция. Архитектура — массив строк с одним из допустимых значений. Значение архитектуры по умолчанию — x86_64.

(строка)

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

Размер каталога /tmp функции в МБ. Значение по умолчанию составляет 512, но может быть любым целым числом от 512 до 10240 МБ. Дополнительную информацию см. в разделе Настройка временного хранилища (консоль) .

Размер -> (целое число)

Размер каталога /tmp функции.

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

Установите ApplyOn в PublishedVersions, чтобы создать снимок начальной среды выполнения при публикации версии функции. Дополнительную информацию см. в разделе Улучшение производительности запуска с помощью Lambda SnapStart .

ApplyOn -> (строка)

При установке в значение PublishedVersions Lambda создает снимок среды выполнения при публикации версии функции.

СтатусОптимизации -> (строка)

При предоставлении квалифицированного Amazon Resource Name (ARN), этот элемент ответа указывает, активирована ли SnapStart для указанной версии функции.

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

ARN среды выполнения и любые возникшие ошибки.

RuntimeVersionArn -> (строка)

ARN версии среды выполнения, которую вы хотите использовать для функции.

Ошибка -> (структура)

Ответ об ошибке, когда Lambda не может получить версию среды выполнения для функции.

КодОшибки -> (строка)

Код ошибки.

Сообщение -> (строка)

Сообщение об ошибке.

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

Настройки конфигурации журналов Amazon CloudWatch для функции.

ФорматЖурнала -> (строка)

Формат, в котором Lambda отправляет приложение и системные журналы вашей функции в CloudWatch. Выберите между обычным текстом и структурированным JSON.

УровеньПодробностиПриложения -> (строка)

Установите это свойство, чтобы отфильтровать приложение, журналы для вашей функции, которые Lambda отправляет в CloudWatch. Lambda отправляет только журналы приложения на выбранном уровне детализации и ниже, где TRACE — самый высокий уровень, а FATAL — самый низкий.

УровеньПодробностиСистемы -> (строка)

Установите это свойство, чтобы отфильтровать системные журналы вашей функции, которые Lambda отправляет в CloudWatch. Lambda отправляет только системные журналы на выбранном уровне детализации и ниже, где DEBUG — самый высокий уровень, а WARN — самый низкий.

ГруппаЖурналов -> (строка)

Имя группы журналов Amazon CloudWatch, в которую функция отправляет журналы. По умолчанию функции Lambda отправляют журналы в группу журналов по умолчанию с именем /aws/lambda/<function name>. Чтобы использовать другую группу журналов, введите существующую группу журналов или введите имя новой группы журналов.

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

Spec-Zone.ru

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