aws_config_rule – Управление ресурсами AWS Config

Новая версия с 2.6.

Описание
Требования
Параметры
Примечания
Примеры
Статус

Описание

Модуль управляет правилами AWS Config

Требования

Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.

boto
boto3
botocore
python >= 2.6

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
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
debug_botocore_endpoint_logs логический тип добавлено в 2.8		Варианты: нет ← да	Использовать логгер botocore.endpoint для анализа уникальных (а не общих) API-вызовов «ресурс:действие» во время выполнения задачи, выводя набор в ключ resource_actions результатов задачи. Используйте обратный вызов aws_resource_action, чтобы вывести полный список, созданный во время выполнения playbook. Также может использоваться переменная среды ANSIBLE_DEBUG_BOTOCORE_LOGS.
description -			Описание, которое вы предоставляете для правила AWS Config.
ec2_url строка			URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль будет использовать конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех остальных модулей, если регион не используется. Если не задан, используется значение переменной среды EC2_URL, если она существует.
execution_frequency -		Варианты: Один_час Три_часа Шесть_часов Двенадцать_часов Двадцатьчетыре_часа	Максимальная частота, с которой AWS Config выполняет оценки для правила.
input_parameters -			Строка в формате JSON, передаваемая в функцию AWS Config Lambda.
name - / обязательно			Имя ресурса AWS Config.
profile строка			Использует профиль 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
scope -			Определяет, какие ресурсы могут инициировать оценку для правила.
	compliance_id -		Идентификатор единственного AWS-ресурса, для которого вы хотите инициировать оценку правила. Если вы указываете идентификатор ресурса, вы должны указать один тип ресурса для `compliance_types`.
	compliance_types -		Типы ресурсов только тех AWS-ресурсов, для которых вы хотите инициировать оценку правила. Вы можете указать только один тип, если вы также указываете идентификатор ресурса для `compliance_id`.
	tag_key -		Ключ тега, который применяется только к тем AWS-ресурсам, для которых вы хотите инициировать оценку правила.
	tag_value -		Значение тега, примененное только к тем AWS-ресурсам, для которых вы хотите инициировать оценку правила. Если вы указываете значение для `tag_value`, вы также должны указать значение для `tag_key`.
security_token строка			AWS STS security token. Если не задан, используется значение переменной среды AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. Псевдонимы: access_token
source -			Предоставляет владельца правила (AWS или пользователь), идентификатор правила и уведомления, вызывающие оценку ваших AWS-ресурсов.
	details -		Предоставляет источник и тип события, вызывающего оценку AWS Config ваших AWS-ресурсов. Этот параметр ожидает список словарей. Каждый словарь ожидает следующие пары ключ/значение. Ключ `EventSource` Источник события, например, AWS-сервис, который вызывает AWS Config для оценки ваших AWS-ресурсов. Ключ `MessageType` Тип уведомления, вызывающего запуск AWS Config для оценки правила. Ключ `MaximumExecutionFrequency` Частота, с которой вы хотите, чтобы AWS Config выполнял оценки для пользовательского правила с периодическим триггером.
	identifier -		Идентификатор единственного AWS-ресурса, для которого вы хотите инициировать оценку правила. Если вы указываете идентификатор ресурса, вы должны указать один тип ресурса для `compliance_types`.
	owner -		Типы ресурсов только тех AWS-ресурсов, для которых вы хотите инициировать оценку правила. Вы можете указать только один тип, если вы также указываете идентификатор ресурса для `compliance_id`.
state -		Варианты: присутствует ← отсутствует	Указывает, должно ли правило Config присутствовать или отсутствовать.
validate_certs логический тип		Варианты: нет да ←	При значении «нет» сертификаты SSL для boto-версий >= 2.6.0 не будут проверяться.

Примечания

Примечание

Если параметры не заданы в модуле, могут быть использованы следующие переменные среды в порядке убывания приоритета 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), если учетные данные не предоставлены. См. https://boto.readthedocs.io/en/latest/boto_config_tut.html
AWS_REGION или EC2_REGION обычно используются для указания AWS-региона, когда это необходимо, но это также можно настроить в файле конфигурации boto

Примеры

- name: Create Config Rule for AWS Config
  aws_config_rule:
    name: test_config_rule
    state: present
    description: 'This AWS Config rule checks for public write access on S3 buckets'
    scope:
        compliance_types:
            - 'AWS::S3::Bucket'
    source:
        owner: AWS
        identifier: 'S3_BUCKET_PUBLIC_WRITE_PROHIBITED'

Статус

Этот модуль не гарантирует обратную совместимость. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

Aaron Smith (@slapula)

Подсказка

Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/aws_config_rule_module.html