publish-version
Описание
Создает версию из текущего кода и конфигурации функции. Используйте версии для создания моментального снимка кода и конфигурации вашей функции, которые не изменяются.
Lambda не публикует версию, если конфигурация и код функции не изменились с момента последней версии. Используйте UpdateFunctionCode или UpdateFunctionConfiguration для обновления функции перед публикацией версии.
Клиенты могут вызывать версии напрямую или с псевдонимом. Для создания псевдонима используйте CreateAlias.
См. также: Документация API AWS
Синтаксис
publish-version
--function-name <value>
[--code-sha256 <value>]
[--description <value>]
[--revision-id <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.
-
Имя функции -
MyFunction. -
ARN функции -
arn:aws:lambda:us-west-2:123456789012:function:MyFunction. -
Частичный ARN -
123456789012:function:MyFunction.
Ограничение длины применяется только к полному ARN. Если вы указываете только имя функции, оно ограничено длиной 64 символа.
--code-sha256 (строка)
--description (строка)
--revision-id (строка)
--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
- таблица
- 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.
Для публикации новой версии функции
Следующий publish-version пример публикует новую версию my-function функции Lambda.
aws lambda publish-version \
--function-name my-function
Вывод:
{
"TracingConfig": {
"Mode": "PassThrough"
},
"CodeSha256": "dBG9m8SGdmlEjw/JYXlhhvCrAv5TxvXsbL/RMr0fT/I=",
"FunctionName": "my-function",
"CodeSize": 294,
"RevisionId": "f31d3d39-cc63-4520-97d4-43cd44c94c20",
"MemorySize": 128,
"FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function:3",
"Version": "2",
"Role": "arn:aws:iam::123456789012:role/service-role/MyTestFunction-role-zgur6bf4",
"Timeout": 3,
"LastModified": "2019-09-23T18:32:33.857+0000",
"Handler": "my-function.handler",
"Runtime": "nodejs10.x",
"Description": ""
}
Для получения дополнительной информации, обратитесь к разделу Настройка псевдонимов функций AWS Lambda в Руководстве разработчика AWS Lambda.
Вывод
ИмяФункции -> (строка)
ФункцияArn -> (строка)
Интерпретатор -> (строка)
Идентификатор интерпретатора функции. Интерпретатор требуется, если пакет развертывания — архив .zip. Указание интерпретатора приведет к ошибке при развертывании функции с помощью контейнерного образа.
В этом списке указаны устаревшие интерпретаторы. Lambda прекратит создание новых функций и обновление существующих функций вскоре после того, как каждый интерпретатор устареет. Дополнительную информацию см. в разделе Использование интерпретатора после его устаревания.
Список всех поддерживаемых интерпретаторов см. в разделе Поддерживаемые интерпретаторы.
Роль -> (строка)
Обработчик -> (строка)
РазмерКода -> (длинное целое число)
Описание -> (строка)
Таймаут -> (целое число)
РазмерПамяти -> (целое число)
ДатаПоследнегоИзменения -> (строка)
CodeSha256 -> (строка)
Версия -> (строка)
VpcConfig -> (структура)
Настройка сети функции.
SubnetIds -> (список)
Список идентификаторов подсетей VPC.
(строка)
SecurityGroupIds -> (список)
Список идентификаторов групп безопасности VPC.
(строка)
VpcId -> (строка)
Ipv6AllowedForDualStack -> (булево)
DeadLetterConfig -> (структура)
Очередь «мертвых писем» функции.
TargetArn -> (строка)
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 -> (строка)
IdРевизии -> (строка)
Слои -> (список)
Слои функции.
(структура)
Слой Lambda.
Arn -> (строка)
РазмерКода -> (длинное целое число)
SigningProfileVersionArn -> (строка)
SigningJobArn -> (строка)
Состояние -> (строка)
Inactive вы можете повторно активировать функцию, вызвав ее.ПричинаСостояния -> (строка)
КодПричинаСостояния -> (строка)
Creating функцию нельзя вызывать или изменять.СтатусПоследнегоОбновления -> (строка)
Successful после завершения создания функции.ПричинаСтатусаПоследнегоОбновления -> (строка)
КодПричинаСтатусаПоследнегоОбновления -> (строка)
FileSystemConfigs -> (список)
Настройки подключения к файловой системе Amazon EFS.
(структура)
Подробности о подключении между функцией Lambda и файловой системой Amazon EFS.
Arn -> (строка)
LocalMountPath -> (строка)
/mnt/.ТипПакет -> (строка)
Image для контейнерного образа и в Zip для архива .zip.ImageConfigResponse -> (структура)
Значения конфигурации образа функции.
ImageConfig -> (структура)
Значения конфигурации, которые переопределяют Dockerfile контейнерного образа.
EntryPoint -> (список)
Определяет точку входа в приложение, которая обычно является расположением исполняемого файла среды выполнения.
(строка)
Команда -> (список)
Определяет параметры, которые вы хотите передать с ENTRYPOINT.
(строка)
РабочаяДиректория -> (строка)
Ошибка -> (структура)
Ответ об ошибке для GetFunctionConfiguration.
КодОшибки -> (строка)
Сообщение -> (строка)
SigningProfileVersionArn -> (строка)
SigningJobArn -> (строка)
Архитектуры -> (список)
Архитектура набора инструкций, которую поддерживает функция. Архитектура — строковый массив с одним из допустимых значений. Значение архитектуры по умолчанию — x86_64.
(строка)
ВременноеХранилище -> (структура)
Размер каталога /tmp функции в МБ. Значение по умолчанию — 512, но может быть любым целым числом от 512 до 10 240 МБ. Дополнительную информацию см. в разделе Настройка временного хранилища (консоль).
Размер -> (целое число)
/tmp функции.SnapStart -> (структура)
Установите ApplyOn на PublishedVersions, чтобы создать снимок инициализированной среды выполнения при публикации версии функции. Дополнительную информацию см. в разделе Улучшение производительности запуска с Lambda SnapStart.
ApplyOn -> (строка)
PublishedVersions Lambda создает снимок среды выполнения при публикации версии функции.СтатусОптимизации -> (строка)
RuntimeVersionConfig -> (структура)
ARN интерпретатора и любые возникшие ошибки.
RuntimeVersionArn -> (строка)
Ошибка -> (структура)
Ответ об ошибке, когда Lambda не может получить версию интерпретатора для функции.
КодОшибки -> (строка)
Сообщение -> (строка)
LoggingConfig -> (структура)
Настройки конфигурации журналов Amazon CloudWatch для функции.
ФорматЖурнала -> (строка)
УровеньПодробностиПриложения -> (строка)
TRACE — самый высокий уровень, а FATAL — самый низкий.УровеньПодробностиСистемы -> (строка)
DEBUG — самый высокий уровень, а WARN — самый низкий.ГруппаЖурналов -> (строка)
/aws/lambda/<function name>. Чтобы использовать другую группу журналов, введите существующую группу журналов или новое имя группы журналов.
© Copyright 2025, Amazon Web Services. Created using Sphinx.