amazon.aws.aws_service_ip_ranges lookup – Поиск диапазонов IP-адресов сервисов AWS, таких как EC2 и S3

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет 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 Health Checking.
Этот модуль возвращает список всех диапазонов (по умолчанию) или может сузить список до указанного региона или сервиса.

Требования

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

необходимо подключение к общедоступному интернету

Именованные параметры

Здесь описаны именованные параметры поиска. В следующих примерах это значения 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 string добавлено в amazon.aws 2.1.0	Если `ipv6_prefixes=true`, поиск вернёт адреса IPv6 вместо адресов IPv4.
region string	Регион AWS, по которому нужно отфильтровать диапазоны. Например: `us-east-1`, `eu-west-2`, `ap-southeast-1`.
service string	Сервис, по которому нужно отфильтровать диапазоны. Возможные варианты: `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"
    ansible.builtin.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"
    ansible.builtin.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"

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

Ключ	Описание
Возвращаемое значение string	Разделённый запятыми список диапазонов CIDR. Возвращается: при успешном выполнении

Авторы

James Turner

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

© 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/aws_service_ip_ranges_lookup.html