google.cloud.gcp_dns_resource_record_set_info – Сбор информации о ресурсе GCP ResourceRecordSet
Примечание
Этот плагин входит в состав коллекции google.cloud (версия 1.0.1).
Для его установки используйте: ansible-galaxy collection install google.cloud
Чтобы использовать его в книге задач, укажите: google.cloud.gcp_dns_resource_record_set_info
Описание
- Сбор информации о ресурсе GCP ResourceRecordSet
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.6
- requests >= 2.18.4
- google-auth >= 1.3.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
|
auth_kind
строка / обязательно
|
|
Тип используемых учетных данных.
|
|
env_type
строка
|
Указывает, в какой среде Ansible выполняется этот модуль.
Это значение не должно устанавливаться, если вы не знаете, что делаете.
Это изменяет только строку User Agent для всех запросов к API.
|
|
|
managed_zone
словарь / обязательно
|
Идентифицирует управляемую зону, на которую направлен этот запрос. Должен быть словарь, содержащий ключи 'name' и 'dnsName'. Можно передать результаты модуля gcp_dns_managed_zone, в котором оба ключа будут присутствовать.
|
|
|
project
строка
|
Проект Google Cloud Platform, который нужно использовать.
|
|
|
scopes
список / элементы=строка
|
Массив используемых областей видимости
|
|
|
service_account_contents
jsonarg
|
Содержание файла JSON учетной записи службы, либо в виде словаря, либо в виде JSON-строки, представляющей его.
|
|
|
service_account_email
строка
|
Необязательный адрес электронной почты учетной записи службы, если выбран machineaccount, и пользователь не хочет использовать адрес по умолчанию.
|
|
|
service_account_file
путь
|
Путь к файлу JSON учетной записи службы, если выбран тип serviceaccount.
|
Примечания
Примечание
- для аутентификации можно установить service_account_file с помощью переменной среды
gcp_service_account_file - для аутентификации можно установить service_account_contents с помощью переменной среды
GCP_SERVICE_ACCOUNT_CONTENTS - для аутентификации можно установить service_account_email с помощью переменной среды
GCP_SERVICE_ACCOUNT_EMAIL - для аутентификации можно установить auth_kind с помощью переменной среды
GCP_AUTH_KIND - для аутентификации можно установить scopes с помощью переменной среды
GCP_SCOPES - Значения переменных среды будут использоваться только в том случае, если значения в книге задач не заданы.
- Параметры service_account_email и service_account_file взаимно исключают друг друга.
Примеры
- name: get info on a resource record set
gcp_dns_resource_record_set_info:
managed_zone: "{{ managed_zone }}"
project: test_project
auth_kind: serviceaccount
service_account_file: "/tmp/auth.pem"
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращается | Описание | |
|---|---|---|---|
|
resources
сложное
|
всегда |
Список ресурсов
|
|
|
managed_zone
словарь
|
успех |
Идентифицирует управляемую зону, на которую направлен этот запрос. Должен быть словарь, содержащий ключи 'name' и 'dnsName'. Можно передать результаты модуля gcp_dns_managed_zone, в котором оба ключа будут присутствовать.
|
|
|
name
строка
|
успех |
Например, www.example.com.
|
|
|
target
список / элементы=строка
|
успех |
Как определено в RFC 1035 (раздел 5) и RFC 1034 (раздел 3.6.1).
|
|
|
ttl
целое число
|
успех |
Количество секунд, в течение которого этот ResourceRecordSet может кэшироваться резолверами.
|
|
|
type
строка
|
успех |
Один из допустимых типов ресурсов DNS.
|
|
Авторы
- Google Inc. (@googlecloudplatform)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/google/cloud/gcp_dns_resource_record_set_info_module.html
