Модуль amazon.aws.lambda_layer — создание уровня AWS Lambda или удаление версии уровня AWS Lambda

Примечание

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

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

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

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

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

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

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

Этот модуль позволяет управлять псевдонимами функций AWS Lambda с помощью Ansible
Создает уровень Lambda из ZIP-архива. При каждом вызове этого модуля с тем же именем уровня создается новая версия.
Удаляет версию уровня Lambda.

Требования

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

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 botocore SDK.
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.
compatible_architectures список / элементы=строка	Список совместимых архитектур набора команд. Например, x86_64. Взаимоисключающий параметр с `version`.
compatible_runtimes список / элементы=строка	Список совместимых сред выполнения функций. Игнорируется, если `state=absent`. Взаимоисключающий параметр с `version`.
content словарь	Архив уровня функции. Обязателен, если `state=present`. Игнорируется, если `state=absent`. Взаимоисключающий параметр с o(version).
s3_bucket строка	Бакет Amazon S3 с архивом уровня.
s3_key строка	Ключ Amazon S3 архива уровня.
s3_object_version строка	Для версионируемых объектов — версия объекта архива уровня, которую следует использовать.
zip_file путь	Путь к файлу архива уровня в кодировке base64.
debug_botocore_endpoint_logs логическое значение	Используйте регистратор `botocore.endpoint` для анализа уникальных (а не общего числа) вызовов API `"resource:action"`, выполненных во время задачи, и вывода набора в ключ resource_actions результатов задачи. Используйте callback `aws_resource_action` для вывода общего списка вызовов, выполненных в плейбуке. Также можно использовать переменную среды `ANSIBLE_DEBUG_BOTOCORE_LOGS`. Варианты: `false` ← (по умолчанию) `true`
description строка	Описание версии. Игнорируется, если `state=absent`. Взаимоисключающий параметр с `version`.
endpoint_url псевдонимы: aws_endpoint_url строка	URL для подключения вместо конечных точек AWS по умолчанию. Хотя этот параметр можно использовать для подключения к другим сервисам, совместимым с AWS, коллекции amazon.aws и community.aws тестируются только с AWS. Также можно использовать переменную среды `AWS_URL`.
license_info строка	Лицензия программного обеспечения уровня. Это может быть идентификатор лицензии SPDX, URL лицензии, размещенной в интернете, или полный текст лицензии. Игнорируется, если `state=absent`. Взаимоисключающий параметр с `version`.
name псевдонимы: layer_name строка / обязательный	Имя или Amazon Resource Name (ARN) уровня 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 botocore SDK.
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 являются взаимоисключающими.
state строка	Определяет, следует ли создать или удалить уровень Lambda. Если задано значение `present`, будет создана версия уровня Lambda. Если задано значение `absent`, существующая версия уровня Lambda будет удалена. Варианты: `"absent"` `"present"` ← (по умолчанию)
validate_certs логическое значение	Если задано значение `false`, SSL-сертификаты при взаимодействии с API AWS проверяться не будут. Настоятельно не рекомендуется задавать validate_certs=false; вместо этого рассмотрите возможность указать aws_ca_bundle. Варианты: `false` `true` ← (по умолчанию)
version целое число	Номер версии уровня, которую следует удалить. Задайте значение `-1`, чтобы удалить все версии указанного уровня. Обязателен, если `state=absent`. Игнорируется, если `state=present`. Взаимоисключающий параметр с `description`, `content`, `compatible_runtimes`, `license_info`, `compatible_architectures`.

Примечания

Примечание

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

Примеры

---
# Create a new Python library layer version from a zip archive located into a S3 bucket
- name: Create a new python library layer
  amazon.aws.lambda_layer:
    state: present
    name: sample-layer
    description: 'My Python layer'
    content:
      s3_bucket: 'lambda-layers-us-west-2-123456789012'
      s3_key: 'python_layer.zip'
    compatible_runtimes:
      - python3.6
      - python3.7
    license_info: MIT
    compatible_architectures:
      - x86_64

# Create a layer version from a zip in the local filesystem
- name: Create a new layer from a zip in the local filesystem
  amazon.aws.lambda_layer:
    state: present
    name: sample-layer
    description: 'My Python layer'
    content:
      zip_file: 'python_layer.zip'
    compatible_runtimes:
      - python3.6
      - python3.7
    license_info: MIT
    compatible_architectures:
      - x86_64

# Delete a layer version
- name: Delete a layer version
  amazon.aws.lambda_layer:
    state: absent
    name: sample-layer
    version: 2

# Delete all versions of test-layer
- name: Delete all versions
  amazon.aws.lambda_layer:
    state: absent
    name: test-layer
    version: -1

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

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

Ключ	Описание
layer_version список / элементы=словарь	Сведения о созданной или удаленной версии уровня. Возвращается: всегда
compatible_architectures список / элементы=строка	Список совместимых архитектур набора команд. Возвращается: если значение было задано для версии уровня.
compatible_runtimes список / элементы=строка	Список совместимых сред выполнения. Возвращается: если значение было задано для версии уровня. Пример: `["python3.7"]`
content сложный тип	Сведения о версии уровня. Возвращается: `state=present`
code_sha256 строка	Хеш SHA-256 архива уровня. Возвращается: `state=present` Пример: `"VLluleJZ3HTwDrdYolSMrS+8iPwEkcoXXaegjXf+dmc="`
code_size целое число	Размер архива уровня в байтах. Возвращается: `state=present` Пример: `9473675`
location строка	Ссылка на архив уровня в Amazon S3, действительная в течение 10 минут. Возвращается: `state=present` Пример: `"https://awslambda-us-east-1-layers.s3.us-east-1.amazonaws.com/snapshots/123456789012/pylayer-9da91deffd3b4941b8baeeae5daeffe4"`
signing_job_arn строка	Amazon Resource Name (ARN) задания на подпись. Возвращается: если задан профиль подписи
signing_profile_version_arn строка	Amazon Resource Name (ARN) версии профиля подписи. Возвращается: если задан профиль подписи
created_date строка	Дата создания версии уровня в формате ISO-8601 (YYYY-MM-DDThh:mm:ss.sTZD). Возвращается: если версия уровня существует или была создана Пример: `"2022-09-28T14:27:35.866+0000"`
description строка	Описание версии. Возвращается: `state=present`
layer_arn строка	ARN уровня. Возвращается: если версия уровня существует или была создана Пример: `"arn:aws:lambda:eu-west-2:123456789012:layer:pylayer"`
layer_version_arn строка	ARN версии уровня. Возвращается: если версия уровня существует или была создана Пример: `"arn:aws:lambda:eu-west-2:123456789012:layer:pylayer:2"`
license_info строка	Лицензия программного обеспечения уровня. Возвращается: если значение было задано для версии уровня. Пример: `"GPL-3.0-only"`
version целое число	Номер версии. Возвращается: если версия уровня существует или была создана Пример: `1`

Авторы

Aubin Bikouo (@abikouo)

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

© 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_layer_module.html