создание-функции

Описание

Создает функцию Lambda. Для создания функции требуется пакет развертывания и роль выполнения. Пакет развертывания — это архив .zip или контейнерный образ, содержащий код вашей функции. Роль выполнения предоставляет функции разрешения на использование сервисов Amazon Web Services, таких как Amazon CloudWatch Logs для потоковой передачи логов и X-Ray для отслеживания запросов.

Если пакет развертывания — это контейнерный образ, то вы устанавливаете тип пакета в Image. Для контейнерного образа свойство code должно включать URI контейнерного образа в реестре Amazon ECR. Вам не нужно указывать свойства handler и runtime.

Если пакет развертывания — это архив .zip, то вы устанавливаете тип пакета в Zip. Для архива .zip свойство code указывает расположение файла .zip. Вы также должны указать свойства handler и runtime. Код в пакете развертывания должен быть совместим с целевой архитектурой набора команд функции (x86-64 или arm64). Если вы не укажете архитектуру, то значение по умолчанию — x86-64.

При создании функции Lambda предоставляет экземпляр функции и её вспомогательные ресурсы. Если ваша функция подключена к VPC, этот процесс может занять минуту или около того. В течение этого времени вы не можете вызвать или изменить функцию. Поля State, StateReason и StateReasonCode в ответе от GetFunctionConfiguration указывают, когда функция готова к вызову. Для получения дополнительной информации см. состояния функций Lambda.

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

Другие параметры позволяют настроить параметры, специфичные для версии и уровня функции. Вы можете изменить параметры, специфичные для версии, позже с помощью UpdateFunctionConfiguration. Параметры уровня функции применяются как к неопубликованным, так и к опубликованным версиям функции и включают теги ( TagResource ) и ограничения одновременного выполнения для функции ( PutFunctionConcurrency ).

Вы можете использовать подпись кода, если ваш пакет развертывания — архив .zip. Чтобы включить подпись кода для этой функции, укажите ARN конфигурации подписи кода. Когда пользователь пытается развернуть пакет кода с помощью UpdateFunctionCode, Lambda проверяет, что пакет кода имеет действительную подпись от надёжного издателя. Конфигурация подписи кода включает набор профилей подписи, которые определяют надёжных издателей для этой функции.

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

Чтобы вызвать свою функцию напрямую, используйте Invoke. Чтобы вызвать свою функцию в ответ на события в других сервисах Amazon Web Services, создайте сопоставление источника событий ( CreateEventSourceMapping ) или настройте триггер функции в другом сервисе. Для получения дополнительной информации см. вызов функций Lambda.

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

Синопсис

  create-function
--function-name <value>
[--runtime <value>]
--role <value>
[--handler <value>]
[--code <value>]
[--description <value>]
[--timeout <value>]
[--memory-size <value>]
[--publish | --no-publish]
[--vpc-config <value>]
[--package-type <value>]
[--dead-letter-config <value>]
[--environment <value>]
[--kms-key-arn <value>]
[--tracing-config <value>]
[--tags <value>]
[--layers <value>]
[--file-system-configs <value>]
[--image-config <value>]
[--code-signing-config-arn <value>]
[--architectures <value>]
[--ephemeral-storage <value>]
[--snap-start <value>]
[--logging-config <value>]
[--zip-file <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 (строка)

--runtime (строка)

--role (строка)

--handler (строка)

--code (структура)

Краткий синтаксис:

S3Bucket=string,S3Key=string,S3ObjectVersion=string,ImageUri=string,SourceKMSKeyArn=string

Синтаксис JSON:

{
  "S3Bucket": "string",
  "S3Key": "string",
  "S3ObjectVersion": "string",
  "ImageUri": "string",
  "SourceKMSKeyArn": "string"
}

--description (строка)

--timeout (целое число)

--memory-size (целое число)

--publish | --no-publish (булево)

--vpc-config (структура)

Краткий синтаксис:

SubnetIds=string,string,SecurityGroupIds=string,string,Ipv6AllowedForDualStack=boolean

Синтаксис JSON:

{
  "SubnetIds": ["string", ...],
  "SecurityGroupIds": ["string", ...],
  "Ipv6AllowedForDualStack": true|false
}

--package-type (строка)

--dead-letter-config (структура)

Краткий синтаксис:

TargetArn=string

Синтаксис JSON:

{
  "TargetArn": "string"
}

--environment (структура)

Краткий синтаксис:

Variables={KeyName1=string,KeyName2=string}

Синтаксис JSON:

{
  "Variables": {"string": "string"
    ...}
}

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

--tracing-config (структура)

Краткий синтаксис:

Mode=string

Синтаксис JSON:

{
  "Mode": "Active"|"PassThrough"
}

--tags (отображение)

Краткий синтаксис:

KeyName1=string,KeyName2=string

Синтаксис JSON:

{"string": "string"
  ...}

--layers (список)

Синтаксис:

"string" "string" ...

--file-system-configs (список)

Краткий синтаксис:

Arn=string,LocalMountPath=string ...

Синтаксис JSON:

[
  {
    "Arn": "string",
    "LocalMountPath": "string"
  }
  ...
]

--image-config (структура)

Краткий синтаксис:

EntryPoint=string,string,Command=string,string,WorkingDirectory=string

Синтаксис JSON:

{
  "EntryPoint": ["string", ...],
  "Command": ["string", ...],
  "WorkingDirectory": "string"
}

--code-signing-config-arn (строка)

--architectures (список)

Синтаксис:

"string" "string" ...

Where valid values are:
  x86_64
  arm64

--ephemeral-storage (структура)

Краткий синтаксис:

Size=integer

Синтаксис JSON:

{
  "Size": integer
}

--snap-start (структура)

Сокращенная синтаксическая запись:

ApplyOn=string

Синтаксис JSON:

{
  "ApplyOn": "PublishedVersions"|"None"
}

--logging-config (структура)

Сокращенная синтаксическая запись:

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"
}

--zip-file (блоб)

--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 (булево)

Отключить тулбар AWS CLI для вывода.

--cli-auto-prompt (булево)

Автоматически запрашивать параметры входных данных CLI.

--no-cli-auto-prompt (булево)

Отключить автоматическую запрос параметров входных данных CLI.

Примеры

Создание функции Lambda

Следующий create-function пример создает функцию Lambda под названием my-function.

aws lambda create-function \
    --function-name my-function \
    --runtime nodejs18.x \
    --zip-file fileb://my-function.zip \
    --handler my-function.handler \
    --role arn:aws:iam::123456789012:role/service-role/MyTestFunction-role-tges6bf4

Содержимое my-function.zip:

This file is a deployment package that contains your function code and any dependencies.

Вывод:

{
    "TracingConfig": {
        "Mode": "PassThrough"
    },
    "CodeSha256": "PFn4S+er27qk+UuZSTKEQfNKG/XNn7QJs90mJgq6oH8=",
    "FunctionName": "my-function",
    "CodeSize": 308,
    "RevisionId": "873282ed-4cd3-4dc8-a069-d0c647e470c6",
    "MemorySize": 128,
    "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:my-function",
    "Version": "$LATEST",
    "Role": "arn:aws:iam::123456789012:role/service-role/MyTestFunction-role-zgur6bf4",
    "Timeout": 3,
    "LastModified": "2023-10-14T22:26:11.234+0000",
    "Handler": "my-function.handler",
    "Runtime": "nodejs18.x",
    "Description": ""
}

Дополнительную информацию см. в разделе «Настройка функции AWS Lambda» в «Руководстве разработчика AWS Lambda».

Вывод

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

FunctionArn -> (строка)

Runtime -> (строка)

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

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

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

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

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

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

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

CodeSha256 -> (строка)

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

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

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

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

KMSKeyArn -> (строка)

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

MasterArn -> (строка)

RevisionId -> (строка)

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

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

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

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

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

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

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

FileSystemConfigs -> (список)

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

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

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

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

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

(строка)

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

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

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

ПрименитьК -> (строка)

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

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

RuntimeVersionArn -> (строка)

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

Параметры конфигурации журнала Amazon CloudWatch функции.

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

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

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

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