lambda_event - Создаёт, обновляет или удаляет сопоставления событий AWS Lambda функции.
Новая версия 2.2.
Обзор
- Этот модуль позволяет управлять сопоставлениями источников событий AWS Lambda функции, такими как события DynamoDB и Kinesis stream, через фреймворк Ansible. Эти сопоставления источников событий актуальны только в модели pull AWS Lambda, где AWS Lambda вызывает функцию. Он идемпотентен и поддерживает режим «Проверка». Используйте модуль lambda для управления самой функцией lambda и lambda_alias для управления псевдонимами функций.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- boto
- boto3
- python >= 2.6
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| alias обязательно | Имя псевдонима функции. Взаимоисключающее с version. | |
| aws_access_key | Ключ доступа AWS. Если не задан, используется значение переменной среды AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY или EC2_ACCESS_KEY. Псевдонимы: ec2_access_key, access_key | |
| aws_secret_key | Секретный ключ AWS. Если не задан, используется значение переменной среды AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY или EC2_SECRET_KEY. Псевдонимы: ec2_secret_key, secret_key | |
| ec2_url | URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль будет использовать конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех остальных модулей, если регион не используется. Если не задан, используется значение переменной среды EC2_URL, если таковое имеется. | |
| event_source |
| Источник события, которое запускает функцию lambda. |
| lambda_function_arn обязательно | Имя или ARN функции lambda. Псевдонимы: function_name, function_arn | |
| profile (добавлен в 1.6) | Использует профиль boto. Работает только с boto >= 2.24.0. | |
| region | Регион AWS для использования. Если не указан, используется значение переменной среды AWS_REGION или EC2_REGION, если таковое имеется. См. http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region
Псевдонимы: aws_region, ec2_region | |
| security_token (добавлен в 1.6) | Токен безопасности AWS STS. Если не задан, используется значение переменной среды AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. Псевдонимы: access_token | |
| source_params обязательно | Дополнительные параметры, необходимые для источника событий. == Источник событий stream == source_arn Amazon Resource Name (ARN) потока Kinesis или DynamoDB, являющегося источником события.enabled Указывает, должен ли AWS Lambda начать опрос источника события. Значение по умолчанию True.batch_size Максимальное количество записей, которое AWS Lambda получит из вашего источника событий при вызове вашей функции. Значение по умолчанию 100.starting_position Позиция в потоке, с которой AWS Lambda должен начать чтение. Доступные значения TRIM_HORIZON или LATEST. | |
| state обязательно |
| Определяет желаемое состояние. |
| validate_certs bool (добавлен в 1.5) |
| При значении "no", сертификаты SSL не будут проверены для версий boto >= 2.6.0. |
| version | Версия функции Lambda. Взаимоисключающее с alias. |
Примечания
Примечание
- Если параметры не заданы в модуле, можно использовать следующие переменные среды в порядке убывания приоритета
AWS_URLилиEC2_URL,AWS_ACCESS_KEY_IDилиAWS_ACCESS_KEYилиEC2_ACCESS_KEY,AWS_SECRET_ACCESS_KEYилиAWS_SECRET_KEYилиEC2_SECRET_KEY,AWS_SECURITY_TOKENилиEC2_SECURITY_TOKEN,AWS_REGIONилиEC2_REGION - Ansible использует конфигурационный файл boto (обычно ~/.boto), если данные для аутентификации не предоставлены. См. http://boto.readthedocs.org/en/latest/boto_config_tut.html
-
AWS_REGIONилиEC2_REGIONобычно используются для указания региона AWS, когда это необходимо, но это также можно настроить в конфигурационном файле boto
Примеры
---
# Example that creates a lambda event notification for a DynamoDB stream
- hosts: localhost
gather_facts: no
vars:
state: present
tasks:
- name: DynamoDB stream event mapping
lambda_event:
state: "{{ state | default('present') }}"
event_source: stream
function_name: "{{ function_name }}"
alias: Dev
source_params:
source_arn: arn:aws:dynamodb:us-east-1:123456789012:table/tableName/stream/2016-03-19T19:51:37.457
enabled: True
batch_size: 100
starting_position: TRIM_HORIZON
- name: Show source event
debug:
var: lambda_stream_events
Возвращаемые значения
Общие возвращаемые значения описаны в этом документе, ниже приведены поля, уникальные для этого модуля:
| Ключ | Возвращённое значение | Описание |
|---|---|---|
| lambda_stream_events список | успех | список словарей, возвращённых API, описывающих сопоставления событий stream |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантирует обратную совместимость.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. См. Поддержка и обслуживание модулей для получения дополнительной информации.
Список других модулей, которые также поддерживаются сообществом Ansible, см. здесь.
Автор
- Pierre Jodouin (@pjodouin), Ryan Brown (@ryansb)
Подсказка
Если вы заметите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/lambda_event_module.html