Модуль amazon.aws.route53 – добавление и удаление записей в DNS-службе Amazon Route 53

access_key

псевдонимы: aws_access_key_id, aws_access_key

string

Идентификатор ключа доступа AWS.

Дополнительные сведения о токенах доступа см. в документации AWS: https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys.

Также можно использовать переменные среды AWS_ACCESS_KEY_ID или AWS_ACCESS_KEY в порядке убывания предпочтения.

Параметры aws_access_key и profile являются взаимоисключающими.

Псевдоним aws_access_key_id добавлен в выпуске 5.1.0 для согласованности с AWS botocore SDK.

alias

boolean

Указывает, является ли это записью-псевдонимом.

Взаимоисключающий параметр с ttl.

По умолчанию используется false.

Варианты:

• false
• true

alias_evaluate_target_health

boolean

Учитывать ли состояние работоспособности целевого объекта псевдонима. Полезно для псевдонимов Elastic Load Balancers.

Варианты:

• false ← (по умолчанию)
• true

alias_hosted_zone_id

string

Идентификатор размещённой зоны.

aws_ca_bundle

path

Путь к пакету сертификатов центра сертификации для проверки SSL-сертификатов.

Также можно использовать переменную среды AWS_CA_BUNDLE.

aws_config

dictionary

Словарь для изменения конфигурации botocore.

Описание параметров см. в документации AWS: https://botocore.amazonaws.com/v1/documentation/api/latest/reference/config.html#botocore.config.Config.

aws_region

string

добавлен в amazon.aws 11.2.0

Регион AWS для запросов API.

Если параметр не указан, используется значение переменной среды AWS_REGION или AWS_DEFAULT_REGION.

Дополнительные сведения см. в документации AWS: https://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region.

Если aws_region не указан, модуль также может использовать профиль из конфигурации AWS.

debug_botocore_endpoint_logs

boolean

Использовать регистратор botocore.endpoint для анализа уникальных (а не общего числа) вызовов API "resource:action", выполненных в ходе задачи, и выводить их набор в ключ resource_actions результатов задачи. Используйте обработчик обратного вызова aws_resource_action, чтобы вывести полный список вызовов, выполненных в ходе плейбука.

Также можно использовать переменную среды ANSIBLE_DEBUG_BOTOCORE_LOGS.

Варианты:

• false ← (по умолчанию)
• true

endpoint_url

псевдонимы: aws_endpoint_url

string

URL для подключения вместо конечных точек AWS по умолчанию. Этот параметр можно использовать для подключения к другим совместимым с AWS службам, однако коллекции amazon.aws и community.aws тестируются только с AWS.

Также можно использовать переменную среды AWS_URL.

failover

string

Только для наборов записей ресурсов с аварийным переключением. Указывает, является ли набор записей ресурсов основным или вторичным. Допустимые значения: PRIMARY и SECONDARY.

Взаимоисключающий параметр с weight, routing_region и region.

Варианты:

• "SECONDARY"
• "PRIMARY"

geo_location

dictionary

добавлен в community.aws 3.3.0

Позволяет управлять ответами Amazon Route 53 на DNS-запросы в зависимости от географического расположения источника запроса.

Нельзя создать два набора записей ресурсов с геолокацией, указывающих одно и то же географическое расположение.

Нельзя создать наборы записей ресурсов без геолокации, значения элементов Name и Type которых совпадают со значениями этих элементов у наборов записей ресурсов с геолокацией.

continent_code

string

Двухбуквенный код континента.

Указание geo_location.continent_code вместе с geo_location.country_code или geo_location.subdivision_code приводит к ошибке InvalidInput.

country_code

string

Двухбуквенный код страны.

Amazon Route 53 использует двухбуквенные коды стран, определённые стандартом ISO 3166-1 alpha-2.

subdivision_code

string

Двухбуквенный код штата США.

Чтобы указать geo_location.subdivision_code, для geo_location.country_code необходимо задать значение US.

health_check

string

Проверка работоспособности, связанная с этой записью

hosted_zone_id

string

Идентификатор размещённой зоны DNS, которую нужно изменить.

Этот параметр обязателен, если параметр zone не указан.

identifier

string

Обязателен только для наборов записей ресурсов с распределением нагрузки по весам, на основе задержки и с аварийным переключением. Идентификатор, который различает несколько наборов записей ресурсов с одинаковым сочетанием имени и типа DNS.

overwrite

boolean

Следует ли перезаписывать существующую запись при создании, если её значения не совпадают.

Варианты:

• false
• true

private_zone

boolean

Если задано значение true, при наличии общедоступной и частной зон будет использоваться частная зона, соответствующая запрошенному имени в домене.

По умолчанию используется общедоступная зона.

Варианты:

• false ← (по умолчанию)
• true

profile

псевдонимы: aws_profile

string

Именованный профиль AWS для аутентификации.

Дополнительные сведения об именованных профилях см. в документации AWS: https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html.

Также можно использовать переменную среды AWS_PROFILE.

Параметр profile является взаимоисключающим с параметрами aws_access_key, aws_secret_key и session_token.

record

string / обязательный

Полная DNS-запись для создания или удаления.

region

string

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

Взаимоисключающий параметр с weight и failover.

Этот параметр устарел и будет удалён в выпуске после 2027-06-01.

Вместо него используйте routing_region.

retry_interval

integer

Если Route 53 всё ещё обрабатывает предыдущий запрос, модуль подождёт указанное число секунд и повторит попытку. Если у вас много доменных имён, значение по умолчанию 500 секунд может быть слишком большим.

По умолчанию: 500

routing_region

string

добавлен в amazon.aws 11.2.0

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

Взаимоисключающий параметр с weight и failover.

secret_key

псевдонимы: aws_secret_access_key, aws_secret_key

string

Секретный ключ доступа AWS.

Дополнительные сведения о токенах доступа см. в документации AWS: https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys.

Также можно использовать переменные среды AWS_SECRET_ACCESS_KEY или AWS_SECRET_KEY в порядке убывания предпочтения.

Параметры secret_key и profile являются взаимоисключающими.

Псевдоним aws_secret_access_key добавлен в выпуске 5.1.0 для согласованности с AWS botocore SDK.

session_token

псевдонимы: aws_session_token

string

Токен сеанса AWS STS для использования с временными учётными данными.

Дополнительные сведения о токенах доступа см. в документации AWS: https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys.

Также можно использовать переменную среды AWS_SESSION_TOKEN.

Параметры session_token и profile являются взаимоисключающими.

state

псевдонимы: command

string / обязательный

Задаёт состояние записи ресурса.

Варианты:

• "present"
• "absent"
• "get"
• "create"
• "delete"

ttl

integer

Время жизни (TTL) новой записи в секундах.

Взаимоисключающий параметр с alias.

По умолчанию: 3600

type

string / обязательный

Тип создаваемой DNS-записи.

Поддержка SSHFP добавлена в выпуске 9.2.0. Дополнительные сведения см. в документации AWS: https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/ResourceRecordTypes.html.

Варианты:

• "A"
• "CNAME"
• "MX"
• "AAAA"
• "TXT"
• "PTR"
• "SRV"
• "SPF"
• "CAA"
• "NS"
• "SOA"
• "SSHFP"

validate_certs

boolean

Если задано значение false, SSL-сертификаты при обмене данными с API AWS проверяться не будут.

Не рекомендуется задавать validate_certs=false; вместо этого рассмотрите возможность указать aws_ca_bundle.

Варианты:

• false
• true ← (по умолчанию)

value

list / элементы=string

Новое значение при создании DNS-записи. Для записей, не являющихся псевдонимами, допускаются списки YAML или несколько значений, разделённых запятыми.

vpc_id

string

При использовании вместе с private_zone=true этот параметр ограничивает изменение записей частной размещённой зоной, связанной с данной VPC.

Это позволяет подключать к разным VPC несколько частных размещённых зон с одинаковым именем.

wait

boolean

Ожидать репликации изменений на всех DNS-серверах Amazon Route 53.

Варианты:

• false ← (по умолчанию)
• true

wait_timeout

integer

Время ожидания репликации изменений в секундах.

По умолчанию: 300

weight

integer

Только для взвешенных наборов записей ресурсов. Среди наборов записей ресурсов с одинаковым сочетанием имени и типа DNS значение определяет, какая доля трафика для текущего набора записей ресурсов будет направлена в связанное с ним расположение.

Взаимоисключающий параметр с routing_region, region и failover.

zone

string

DNS-зона для изменения.

Этот параметр обязателен, если параметр hosted_zone_id не указан.

nameservers

list / elements=string

Серверы имён, связанные с зоной.

Возвращается: когда state имеет значение ‘get’

Пример: ["ns-1036.awsdns-00.org.", "ns-516.awsdns-00.net.", "ns-1504.awsdns-00.co.uk.", "ns-1.awsdns-00.com."]

resource_record_sets

complex

Информация о ресурсе, специфичная для записи.

Возвращается: когда state имеет значение ‘get’

alias

boolean

Является ли запись псевдонимом.

Возвращается: всегда

Пример: false

failover

string

Является ли этот набор ресурсных записей основным или вторичным.

Возвращается: всегда

Пример: "PRIMARY"

geo_location

dictionary

добавлено в community.aws 3.3.0

Географическое местоположение, на основе которого Route53 отвечает на DNS-запросы.

Возвращается: если настроено

Пример: {"continent_code": "NA", "country_code": "US", "subdivision_code": "CA"}

health_check

string

Проверка работоспособности, связанная с этой записью.

Возвращается: всегда

identifier

string

Идентификатор, различающий несколько наборов ресурсных записей с одинаковой комбинацией DNS-имени и типа.

Возвращается: всегда

name

string

Доменное имя для набора записей.

Возвращается: всегда

Пример: "new.foo.com"

record

string

Доменное имя для набора записей.

Возвращается: всегда

Пример: "new.foo.com"

record_values

list / elements=string

добавлено в amazon.aws 11.0.0

Значения записей в виде списка.

Возвращается: всегда

Пример: ["52.43.18.27"]

region

string

Регион, с которым следует связать запись для маршрутизации с учётом задержки.

Это возвращаемое значение устарело и будет удалено в одном из выпусков после 2027-06-01. Вместо него используйте resource_record_sets.routing_region.

Возвращается: всегда

Пример: "us-west-2"

resource_records

list / elements=string

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

Возвращается: всегда

Пример: [{"value": "1.1.1.1"}]

routing_region

string

добавлено в amazon.aws 11.2.0

Регион, с которым следует связать запись для маршрутизации с учётом задержки.

Возвращается: всегда

Пример: "us-west-2"

ttl

string

Время жизни записи ресурса в кэше (TTL).

Возвращается: всегда

Пример: "3600"

type

string

Тип набора ресурсных записей.

Возвращается: всегда

Пример: "A"

value

string

Значение записи.

Возвращается: всегда

Пример: "52.43.18.27"

values

list / elements=string

Значения записей в виде списка.

Это возвращаемое значение устарело и будет удалено в одном из выпусков после 2026-12-01. Вместо него используйте resource_record_sets.record_values.

Возвращается: всегда

Пример: ["52.43.18.27"]

weight

string

Вес записи.

Возвращается: всегда

Пример: "3"

zone

string

Зона, к которой относится этот набор записей.

Возвращается: всегда

Пример: "foo.bar.com"

wait_id

string

добавлено в amazon.aws 6.3.0

Идентификатор ожидания для применённого изменения. Его можно использовать, чтобы позднее дождаться распространения изменения, когда wait=false.

Возвращается: если были внесены изменения