lambda_event - Создаёт, обновляет или удаляет сопоставления событий AWS Lambda функции.
Новая версия с 2.2.
- Обзор
- Требования (к хосту, на котором выполняется модуль)
- Параметры
- Примеры
- Возвращаемые значения
- Примечания
Обзор
- Этот модуль позволяет управлять сопоставлениями источников событий AWS Lambda функций, такими как события DynamoDB и потоков Kinesis, с помощью фреймворка Ansible. Эти сопоставления источников событий актуальны только в модели извлечения 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 | нет | stream |
| Источник события, запускающего функцию lambda. |
| lambda_function_arn | да | Имя или ARN функции lambda. псевдонимы: function_name, function_arn | ||
| profile (добавлен в 1.6)
| нет | Использует профиль boto. Работает только с boto >= 2.24.0. | ||
| security_token (добавлен в 1.6)
| нет | AWS STS security token. Если не задан, используется значение переменной окружения 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 | да | present |
| Описание желаемого состояния. |
| validate_certs (добавлен в 1.5)
| нет | да |
| При значении "нет", сертификаты SSL не будут проверены для версий boto >= 2.6.0. |
| version | нет | Версия функции Lambda. Взаимоисключающее с alias. |
Примеры
---
# 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, описывающих сопоставления событий потоков | успех | список |
Примечания
Примечание
- Если параметры не заданы в модуле, можно использовать следующие переменные окружения в порядке убывания приоритета
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.
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется обратной совместимостью.
Для получения помощи в разработке модулей, если вы заинтересованы, пожалуйста, прочитайте Информацию о сообществе и вклад, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/lambda_event_module.html