community.aws.aws_inspector_target – Создание, обновление и удаление целевых объектов оценки Amazon Inspector

Примечание

Этот плагин входит в состав коллекции community.aws (версия 1.3.0).

Для его установки используйте: ansible-galaxy collection install community.aws.

Чтобы использовать его в книге задач, укажите: community.aws.aws_inspector_target.

Новое в версии 1.0.0: коллекции community.aws

Обзор
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Создаёт, обновляет или удаляет целевые объекты оценки Amazon Inspector и управляет необходимыми группами ресурсов.

Требования

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

boto
boto3
botocore
python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
aws_access_key строка		Ключ доступа AWS. Если не задан, используется значение переменной окружения AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY или EC2_ACCESS_KEY. Если параметр profile установлен, этот параметр игнорируется. Одновременное указание параметров aws_access_key и profile устарело и после 2022-06-01 эти параметры будут взаимно исключающими. псевдонимы: ec2_access_key, access_key
aws_ca_bundle путь		Путь к файлу с набором сертификатов CA, используемых для проверки SSL-сертификатов. Используется только для модулей на основе boto3. Примечание: набор сертификатов CA считывается со стороны модуля и может потребоваться его явное копирование с контроллера, если он не выполняется локально.
aws_config словарь		Словарь для изменения конфигурации botocore. Параметры можно найти по адресу https://botocore.amazonaws.com/v1/documentation/api/latest/reference/config.html#botocore.config.Config. Для модулей boto используется только ключ 'user_agent'. Дополнительную информацию о конфигурации boto можно найти по адресу http://boto.cloudhackers.com/en/latest/boto_config_tut.html#boto.
aws_secret_key строка		Секретный ключ AWS. Если не задан, используется значение переменной окружения AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY или EC2_SECRET_KEY. Если параметр profile установлен, этот параметр игнорируется. Одновременное указание параметров aws_secret_key и profile устарело и после 2022-06-01 эти параметры будут взаимно исключающими. псевдонимы: ec2_secret_key, secret_key
debug_botocore_endpoint_logs булево	Варианты: нет ← да	Используйте логирование botocore.endpoint для анализа уникальных (а не общих) API-вызовов «ресурс:действие», выполняемых в задаче, выводя набор в ключ resource_actions результатов задачи. Используйте обратный вызов aws_resource_action для вывода в список всех вызовов, выполненных в ходе книги задач.
ec2_url строка		URL, используемый для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль использует конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех других модулей, если регион не используется. Если не указан, используется значение переменной окружения EC2_URL, если она есть. псевдонимы: aws_endpoint_url, endpoint_url
name строка / обязательно		Определяемое пользователем имя, идентифицирующее целевой объект оценки. Имя должно быть уникальным в рамках учетной записи AWS.
profile строка		Использует профиль boto. Работает только с boto >= 2.24.0. Использование profile переопределяет aws_access_key, aws_secret_key и security_token. Поддержка одновременного указания этих параметров с profile устарела. aws_access_key, aws_secret_key и security_token будут взаимно исключающими с profile после 2022-06-01. псевдонимы: aws_profile
region строка		Регион AWS для использования. Если не указан, используется значение переменной окружения AWS_REGION или EC2_REGION, если она есть. См. http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region псевдонимы: aws_region, ec2_region
security_token строка		Токен безопасности AWS STS. Если не задан, используется значение переменной окружения AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. Если параметр profile установлен, этот параметр игнорируется. Одновременное указание параметров security_token и profile устарело и после 2022-06-01 эти параметры будут взаимно исключающими. псевдонимы: aws_security_token, access_token
state строка	Варианты: отсутствует присутствует ←	Состояние целевого объекта оценки.
tags словарь		Теги экземпляров EC2, которые будут добавлены к целевому объекту оценки. Обязательно, если `state=present`.
validate_certs булево	Варианты: нет да ←	Если значение «нет», SSL-сертификаты не будут проверены для версий boto >= 2.6.0.

Примечания

Примечание

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

Примеры

- name: Create my_target Assessment Target
  community.aws.aws_inspector_target:
    name: my_target
    tags:
      role: scan_target

- name: Update Existing my_target Assessment Target with Additional Tags
  community.aws.aws_inspector_target:
    name: my_target
    tags:
      env: dev
      role: scan_target

- name: Delete my_target Assessment Target
  community.aws.aws_inspector_target:
    name: my_target
    state: absent

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

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

Ключ	Возвращаемое значение	Описание
arn строка	успех	ARN, определяющий целевой объект оценки Amazon Inspector. Пример: arn:aws:inspector:eu-west-1:123456789012:target/0-O4LnL7n1
created_at строка	успех	Время создания целевого объекта оценки. Пример: 2018-01-29T13:48:51.958000+00:00
name строка	успех	Имя целевого объекта оценки Amazon Inspector. Пример: my_target
resource_group_arn строка	успех	ARN, определяющий группу ресурсов, связанную с целевым объектом оценки. Пример: arn:aws:inspector:eu-west-1:123456789012:resourcegroup/0-qY4gDel8
tags список / элементы=строка	успех	Теги группы ресурсов, связанной с целевым объектом оценки. Пример: {'env': 'dev', 'role': 'scan_target'}
updated_at строка	успех	Время последнего обновления целевого объекта оценки. Пример: 2018-01-29T13:48:51.958000+00:00

Авторы

Dennis Conrad (@dennisconrad)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/aws/aws_inspector_target_module.html