Модуль amazon.aws.lambda_policy – создание, обновление или удаление операторов политики AWS Lambda.

Примечание

Этот модуль входит в коллекцию amazon.aws (версия 11.3.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install amazon.aws. Для использования этого модуля требуются дополнительные зависимости; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: amazon.aws.lambda_policy.

Добавлено в amazon.aws 5.0.0

Краткое описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

Этот модуль позволяет управлять операторами политики AWS Lambda.
Модуль идемпотентен и поддерживает режим проверки.
Используйте модуль amazon.aws.lambda для управления самой функцией Lambda, amazon.aws.lambda_alias для управления псевдонимами функций, amazon.aws.lambda_event для управления сопоставлениями источников событий, например потоками Kinesis, community.aws.execute_lambda для выполнения функции Lambda и amazon.aws.lambda_info для сбора сведений об одной или нескольких функциях Lambda.
Этот модуль был первоначально добавлен в community.aws в выпуске 1.0.0.

Требования

На узле, выполняющем этот модуль, необходимы следующие компоненты.

python >= 3.6
boto3 >= 1.35.0
botocore >= 1.35.0

Параметры

Параметр	Комментарии
access_key псевдонимы: aws_access_key_id, aws_access_key строка	Идентификатор ключа доступа AWS. Дополнительные сведения о токенах доступа см. в документации AWS: https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys. Также можно использовать переменные окружения `AWS_ACCESS_KEY_ID` или `AWS_ACCESS_KEY` в порядке убывания приоритета. Параметры aws_access_key и profile нельзя использовать одновременно. Псевдоним aws_access_key_id добавлен в выпуске 5.1.0 для единообразия с AWS SDK botocore.
action строка / обязательный	Действие AWS Lambda, которое вы хотите разрешить этим оператором. Каждое действие Lambda представляет собой строку, начинающуюся с lambda: и далее содержащую имя API (см. раздел Operations). Например, `lambda:CreateFunction`. Чтобы предоставить разрешение на все действия AWS Lambda, можно использовать подстановочный знак (`lambda:*`).
alias строка	Имя псевдонима функции. Не может использоваться одновременно с `version`.
aws_ca_bundle путь	Путь к пакету центров сертификации, используемому для проверки SSL-сертификатов. Также можно использовать переменную окружения `AWS_CA_BUNDLE`.
aws_config словарь	Словарь для изменения конфигурации botocore. Описание параметров приведено в документации AWS: https://botocore.amazonaws.com/v1/documentation/api/latest/reference/config.html#botocore.config.Config.
debug_botocore_endpoint_logs логический	Использовать регистратор `botocore.endpoint` для анализа уникальных (а не общего количества) вызовов API `"resource:action"`, выполненных во время задачи, и выводить их набор в ключ resource_actions результатов задачи. Используйте обработчик `aws_resource_action`, чтобы вывести общий список вызовов, выполненных в ходе плейбука. Также можно использовать переменную окружения `ANSIBLE_DEBUG_BOTOCORE_LOGS`. Варианты: `false` ← (по умолчанию) `true`
endpoint_url псевдонимы: aws_endpoint_url строка	URL для подключения вместо конечных точек AWS по умолчанию. Хотя этот параметр можно использовать для подключения к другим совместимым с AWS службам, коллекции amazon.aws и community.aws тестируются только с AWS. Также можно использовать переменную окружения `AWS_URL`.
event_source_token строка	Строка токена, представляющая ARN источника или учетную запись. Не может использоваться одновременно с `source_arn` или `source_account`.
function_name псевдонимы: lambda_function_arn, function_arn строка / обязательный	Имя функции Lambda, политику ресурсов которой вы обновляете, добавляя новое разрешение. Можно указать имя функции (например, Thumbnail) или Amazon Resource Name (ARN) функции (например, `arn:aws:lambda:us-west-2:account-id:function:ThumbNail`). AWS Lambda также позволяет указывать частичный ARN (например, `account-id:Thumbnail`). Обратите внимание, что ограничение длины применяется только к ARN. Если указать только имя функции, его длина не должна превышать 64 символа.
principal строка / обязательный	Субъект, которому предоставляется это разрешение. Это может быть субъект-служба Amazon S3 (s3.amazonaws.com), если вы хотите разрешить Amazon S3 вызывать функцию, идентификатор учетной записи AWS, если вы предоставляете разрешение для межаккаунтного доступа, или любое допустимое имя субъекта-службы AWS, например sns.amazonaws.com. Например, можно разрешить пользовательскому приложению в другой учетной записи AWS отправлять события в AWS Lambda, вызывая вашу функцию.
profile псевдонимы: aws_profile строка	Именованный профиль AWS для аутентификации. Дополнительные сведения об именованных профилях см. в документации AWS: https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html. Также можно использовать переменную окружения `AWS_PROFILE`. Параметр profile нельзя использовать одновременно с параметрами aws_access_key, aws_secret_key и session_token.
region псевдонимы: aws_region строка	Используемый регион AWS. Для глобальных служб, таких как IAM, Route53 и CloudFront, параметр region игнорируется. Также можно использовать переменную окружения `AWS_REGION`. Дополнительные сведения см. в документации Amazon AWS: http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region.
secret_key псевдонимы: aws_secret_access_key, aws_secret_key строка	Секретный ключ доступа AWS. Дополнительные сведения о токенах доступа см. в документации AWS: https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys. Также можно использовать переменные окружения `AWS_SECRET_ACCESS_KEY` или `AWS_SECRET_KEY` в порядке убывания приоритета. Параметры secret_key и profile нельзя использовать одновременно. Псевдоним aws_secret_access_key добавлен в выпуске 5.1.0 для единообразия с AWS SDK botocore.
session_token псевдонимы: aws_session_token строка	Токен сеанса AWS STS для использования с временными учетными данными. Дополнительные сведения о токенах доступа см. в документации AWS: https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys. Также можно использовать переменную окружения `AWS_SESSION_TOKEN`. Параметры session_token и profile нельзя использовать одновременно.
source_account строка	Идентификатор учетной записи AWS (без дефиса), которой принадлежит источник. Например, если `source_arn` указывает на бакет, это идентификатор учетной записи владельца бакета. Это дополнительное условие позволяет убедиться, что указанный бакет принадлежит конкретной учетной записи (владелец мог удалить бакет, после чего его могла создать другая учетная запись AWS). Это условие также можно использовать для указания всех источников (то есть без указания `source_arn`), принадлежащих определенной учетной записи.
source_arn строка	Этот параметр необязателен; однако при предоставлении Amazon S3 разрешения на вызов функции следует указать в этом поле ARN бакета. Это гарантирует, что функцию смогут вызывать только события, созданные указанным бакетом.
state строка	Описывает требуемое состояние. Варианты: `"present"` ← (по умолчанию) `"absent"`
statement_id псевдонимы: sid строка / обязательный	Уникальный идентификатор оператора.
validate_certs логический	Если задано значение `false`, SSL-сертификаты при взаимодействии с API AWS проверяться не будут. Настоятельно не рекомендуется задавать validate_certs=false; вместо этого рассмотрите возможность указать aws_ca_bundle. Варианты: `false` `true` ← (по умолчанию)
version целое число	Версия функции Lambda. Не может использоваться одновременно с `alias`.

Примечания

Примечание

Внимание: Для модулей переменные окружения и файлы конфигурации считываются из контекста «узла» Ansible, а не из контекста «контроллера». Поэтому файлы может потребоваться явно скопировать на «узел». Для плагинов поиска и подключения переменные окружения и файлы конфигурации считываются из контекста «контроллера» Ansible, а не из контекста «узла».
Используемый Ansible пакет AWS SDK (boto3) также может считывать значения по умолчанию для учетных данных и других параметров, например региона, из файлов конфигурации в контексте «узла» Ansible (обычно ~/.aws/credentials). Дополнительные сведения см. на странице https://boto3.amazonaws.com/v1/documentation/api/latest/guide/credentials.html.

Примеры

- name: Lambda S3 event notification
  amazon.aws.lambda_policy:
    state: present
    function_name: functionName
    alias: Dev
    statement_id: lambda-s3-myBucket-create-data-log
    action: lambda:InvokeFunction
    principal: s3.amazonaws.com
    source_arn: arn:aws:s3:eu-central-1:123456789012:bucketName
    source_account: 123456789012
  register: lambda_policy_action

- name: show results
  ansible.builtin.debug:
    var: lambda_policy_action

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
lambda_policy_action строка	Описывает выполненное действие. Возвращается: при успешном выполнении Пример: `"added"`

Авторы

Pierre Jodouin (@pjodouin)
Michael De La Rue (@mikedlr)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/amazon/aws/lambda_policy_module.html