ec2_ami_find – Поиск AMIs для получения ID AMI и другой информации

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

УСТЕРЕЛО
Обзор
Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

УСТЕРЕЛО

Удалено в Ansible:
	версия: 2.9
Почему:	Различные модули AWS были объединены и заменены модулем ec2_ami_facts.
Альтернатива:	Используйте ec2_ami_facts вместо него.

Обзор

Возвращает список совпадающих AMIs с ID AMI и другой полезной информацией
Может искать AMIs разных владельцев
Может искать по совпадающим тегам, имени AMI и/или другим критериям
Результаты могут быть отсортированы и порезаны

Требования

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

boto
python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
ami_id -		ID AMI для соответствия.
ami_tags -		Хэш/словарь тегов для соответствия AMI.
architecture -		Тип архитектуры для соответствия (например, x86_64).
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, чтобы вывести в общий список, сделанный во время выполнения плейбука. Переменная окружения ANSIBLE_DEBUG_BOTOCORE_LOGS также может использоваться.
ec2_url строка		URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль будет использовать конечные точки EC2). Игнорируется для модулей, где необходим регион. Должен быть указан для всех остальных модулей, если регион не используется. Если не задан, используется значение переменной окружения EC2_URL, если она есть.
hypervisor -		Тип гипервизора для соответствия (например, xen).
is_public логическое значение	Варианты: нет да	Является ли изображение(я) общедоступным(и).
name -		Имя AMI для соответствия.
no_result_action -	Варианты: успешно ← отказ	Действие, которое нужно выполнить, когда результаты не найдены. 'успешно' сообщает об успехе и возвращает пустой массив 'отказ' приводит к тому, что модуль сообщает об ошибке
owner -		Поиск AMI, принадлежащих указанному владельцу Можно указать ID учетной записи AWS или один из специальных идентификаторов «self», «amazon» или «aws-marketplace» Если не указано, будут просматриваться все AMI EC2 в указанном регионе. Вы можете включать подстановочные знаки во многие параметры поиска. Звездочка () соответствует нулю или более символам, а вопросительный знак (?) соответствует ровно одному символу. Вы можете экранировать специальные символы, поместив перед ними обратную косую черту (\). Например, значение \amazon\?\\ ищет строку *amazon?\.
platform -		Тип платформы для соответствия.
product_code - добавлено в 2.3		Код продукта рынка для соответствия.
profile строка		Использует профиль boto. Работает только с boto >= 2.24.0.
region - / требуется		Регион AWS для использования. псевдонимы: aws_region, ec2_region
root_device_type - добавлено в 2.5		Тип корневого устройства для соответствия (например, ebs, instance-store).
security_token строка		Токен безопасности AWS STS. Если не задан, используется значение переменной окружения AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. псевдонимы: access_token
sort -	Варианты: name description tag architecture block_device_mapping creationDate hypervisor is_public location owner_id platform root_device_name root_device_type state virtualization_type	Необязательный атрибут для сортировки результатов. Если указан 'tag', требуется параметр 'tag_name'. Начиная с версии 2.1, поддерживаются дополнительные варианты сортировки architecture, block_device_mapping, creationDate, hypervisor, is_public, location, owner_id, platform, root_device_name, root_device_type, state и virtualization_type.
sort_end -		Индекс последнего результата (при сортировке). Соответствует синтаксису среза Python.
sort_order -	Варианты: по возрастанию ← по убыванию	Порядок сортировки результатов. Используется только при указании параметра 'sort'.
sort_start -		Индекс первого результата (при сортировке). Соответствует синтаксису среза Python.
sort_tag -		Имя тега для сортировки результатов. Требуется при указании 'sort=tag'.
state -	По умолчанию: "доступно"	Состояние AMI для соответствия.
validate_certs логическое значение	Варианты: нет да ←	При значении "нет", сертификаты SSL не будут проверяться для версий boto >= 2.6.0.
virtualization_type -		Тип виртуализации для соответствия (например, hvm).

Примечания

Примечание

Этот модуль не совместим с предыдущей версией модуля ec2_search_ami, который работал только с AMIs Ubuntu, перечисленными на cloud-images.ubuntu.com.
См. пример ниже для подсказки по поиску по дистрибутиву/релизу.
Если параметры не установлены в модуле, можно использовать следующие переменные среды в порядке убывания приоритета 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

Примеры

# Note: These examples do not set authentication details, see the AWS Guide for details.

# Search for the AMI tagged "project:website"
- ec2_ami_find:
    owner: self
    ami_tags:
      project: website
    no_result_action: fail
  register: ami_find

# Search for the latest Ubuntu 14.04 AMI
- ec2_ami_find:
    name: "ubuntu/images/ebs/ubuntu-trusty-14.04-amd64-server-*"
    owner: 099720109477
    sort: name
    sort_order: descending
    sort_end: 1
  register: ami_find

# Launch an EC2 instance
- ec2:
    image: "{{ ami_find.results[0].ami_id }}"
    instance_type: m3.medium
    key_name: mykey
    wait: yes

Значения возврата

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

Ключ	Возвращаемое значение	Описание
ami_id строка	при обнаружении AMI	идентификатор найденной amazon-образа Пример: ami-e9095e8c
architecture строка	при обнаружении AMI	архитектура образа Пример: x86_64
block_device_mapping словарь	при обнаружении AMI	отображение блочного устройства, связанного с образом Пример: { '/dev/xvda': { 'delete_on_termination': true, 'encrypted': false, 'size': 8, 'snapshot_id': 'snap-ca0330b8', 'volume_type': 'gp2' }
creationDate строка	при обнаружении AMI	дата создания образа Пример: 2015-10-15T22:43:44.000Z
description строка	при обнаружении AMI	описание образа Пример: test-server01
hypervisor строка	при обнаружении AMI	тип гипервизора Пример: xen
is_public логическое значение	при обнаружении AMI	является ли образ общедоступным
location строка	при обнаружении AMI	местоположение образа Пример: 435210894375/test-server01-20151015-234343
name строка	при обнаружении AMI	имя ami образа Пример: test-server01-20151015-234343
owner_id строка	при обнаружении AMI	владелец образа Пример: 435210894375
platform строка	при обнаружении AMI	платформа образа
root_device_name строка	при обнаружении AMI	имя корневого устройства образа Пример: /dev/xvda
root_device_type строка	при обнаружении AMI	тип корневого устройства образа Пример: ebs
state строка	при обнаружении AMI	состояние образа Пример: available
tags словарь	при обнаружении AMI	метки, назначенные образу Пример: { 'Environment': 'devel', 'Name': 'test-server01', 'Role': 'web' }
virtualization_type строка	при обнаружении AMI	тип виртуализации образа Пример: hvm

Статус

Этот модуль будет удален в версии 2.9. [устарел]
Для получения дополнительной информации см. УСТАРЕВШИЙ.

Авторы

Tom Bamford (@tombamford)

Подсказка

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

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