amazon.aws.aws_service_ip_ranges поиск — Поиск диапазонов IP-адресов для служб, предоставляемых в AWS, таких как EC2 и S3.
Примечание
Этот плагин поиска входит в состав коллекции amazon.aws (версия 8.2.1).
У вас, возможно, уже установлена эта коллекция, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для её установки используйте: ansible-galaxy collection install amazon.aws. Для использования этого плагина поиска необходимы дополнительные требования. Подробнее см. Требования.
Чтобы использовать его в плейбуке, укажите: amazon.aws.aws_service_ip_ranges.
Описание
- AWS публикует диапазоны IP-адресов, используемые в общедоступном интернете для EC2, S3, CloudFront, CodeBuild, Route53 и проверки состояния Route53.
- Этот модуль создает список всех диапазонов (по умолчанию) или может сузить список до указанного региона или службы.
Требования
Ниже перечислены требования, необходимые на узле локального контроллера, который выполняет этот поиск.
- должен иметь подключение к общедоступному интернету
Параметры ключевых слов
Здесь описываются параметры ключевых слов поиска. Это значения key1=value1, key2=value2 и т.д. в следующих примерах: lookup('amazon.aws.aws_service_ip_ranges', key1=value1, key2=value2, ...) и query('amazon.aws.aws_service_ip_ranges', key1=value1, key2=value2, ...)
Параметр |
Комментарии |
|---|---|
ipv6_prefixes строка добавлен в amazon.aws 2.1.0 |
Когда ipv6_prefixes=True, поиск вернёт ipv6-адреса вместо ipv4-адресов |
region строка |
Регион AWS для сужения диапазонов. Примеры: us-east-1, eu-west-2, ap-southeast-1 |
service строка |
Служба для фильтрации диапазонов. Варианты: EC2, S3, CLOUDFRONT, CODEbUILD, ROUTE53, ROUTE53_HEALTHCHECKS |
Примеры
vars:
ec2_ranges: "{{ lookup('aws_service_ip_ranges', region='ap-southeast-2', service='EC2', wantlist=True) }}"
tasks:
- name: "use list return option and iterate as a loop"
debug: msg="{% for cidr in ec2_ranges %}{{ cidr }} {% endfor %}"
# "52.62.0.0/15 52.64.0.0/17 52.64.128.0/17 52.65.0.0/16 52.95.241.0/24 52.95.255.16/28 54.66.0.0/16 "
- name: "Pull S3 IP ranges, and print the default return style"
debug: msg="{{ lookup('aws_service_ip_ranges', region='us-east-1', service='S3') }}"
# "52.92.16.0/20,52.216.0.0/15,54.231.0.0/17"
Значение возврата
Ключ |
Описание |
|---|---|
Значение возврата строка |
Список CIDR-диапазонов, разделённых запятыми Возвращаемое значение: успех |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/amazon/aws/aws_service_ip_ranges_lookup.html