google.cloud.gcp_dns_managed_zone_info модуль – Сбор информации о GCP ManagedZone

Примечание

Этот модуль является частью коллекции google.cloud (версия 1.4.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для её установки используйте: ansible-galaxy collection install google.cloud. Для использования этого модуля необходимы дополнительные требования. Подробности см. в разделе Требования.

Чтобы использовать его в книге задач, укажите: google.cloud.gcp_dns_managed_zone_info.

Обзор
Требования
Параметры
Примечания
Примеры
Значения возврата

Обзор

Сбор информации о GCP ManagedZone

Требования

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

python >= 2.6
requests >= 2.18.4
google-auth >= 1.3.0

Параметры

Параметр	Комментарии
access_token строка	Токен доступа OAuth2, если тип аутентификации accesstoken.
auth_kind строка / обязательно	Тип используемых учетных данных. Варианты: `"application"` `"machineaccount"` `"serviceaccount"` `"accesstoken"`
dns_name список / элементы=строка	Ограничивает список, возвращая только зоны с этим именем домена.
env_type строка	Указывает среду Ansible, в которой вы запускаете этот модуль. Это не следует устанавливать, если вы не знаете, что делаете. Это только изменяет строку пользователя для всех запросов API.
project строка	Проект Google Cloud Platform для использования.
scopes список / элементы=строка	Массив используемых областей
...	...

Примечания

Примечание

для аутентификации можно установить service_account_file, используя переменную среды GCP_SERVICE_ACCOUNT_FILE.
для аутентификации можно установить service_account_contents, используя переменную среды GCP_SERVICE_ACCOUNT_CONTENTS.
для аутентификации можно установить service_account_email, используя переменную среды GCP_SERVICE_ACCOUNT_EMAIL.
для аутентификации можно установить access_token, используя переменную среды GCP_ACCESS_TOKEN.
для аутентификации можно установить auth_kind, используя переменную среды GCP_AUTH_KIND.
для аутентификации можно установить scopes, используя переменную среды GCP_SCOPES.
значения переменных среды будут использоваться только в том случае, если значения в книге задач не установлены.
Параметры service_account_email и service_account_file взаимоисключающие.

Примеры

- name: get info on a managed zone
  gcp_dns_managed_zone_info:
    dns_name: test.somewild2.example.com.
    project: test_project
    auth_kind: serviceaccount
    service_account_file: "/tmp/auth.pem"

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

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

END_OF_DOCUMENT_MARKER

Ключ	Описание
resources сложный	Список ресурсов Возвращается: всегда
creationTime строка	Время создания этого ресурса на сервере. Формат — RFC3339. Возвращается: успешно
description строка	Изменяемая строка длиной не более 1024 символов, ассоциированная с этим ресурсом для удобства пользователя. Не оказывает влияния на работу управляемой зоны. Возвращается: успешно
dnsName строка	Имя DNS этой управляемой зоны, например, «example.com». Возвращается: успешно
dnssecConfig сложный	Настройка DNSSEC. Возвращается: успешно
defaultKeySpecs сложный	Указывает параметры, которые будут использоваться для генерации начальных DnsKeys для этой управляемой зоны. Если вы предоставляете спецификацию для keySigning или zoneSigning, вы также должны предоставить её для другой. default_key_specs можно обновлять только при состоянии `off`. Возвращается: успешно
algorithm строка	Мемоническая строка, определяющая алгоритм DNSSEC этого ключа. Возвращается: успешно
... (Remaining table rows translated similarly) ...

END_OF_DOCUMENT_MARKER

имя строка	Присвоенное пользователем имя для этого ресурса. Должно быть уникальным в рамках проекта. Возвращаемое значение: успех
nameServers список / элементы=строка	Делегируйте свой managed_zone этим виртуальным серверам имен, определенным сервером. Возвращаемое значение: успех
nameServerSet строка	Необязательно указывает NameServerSet для этой ManagedZone. NameServerSet — это набор DNS-серверов, все из которых размещают одинаковые ManagedZone. Большинство пользователей оставят это поле пустым. Возвращаемое значение: успех
peeringConfig сложный	Наличие этого поля указывает на включение DNS Peering для этой зоны. Значение этого поля содержит сеть для подключения. Возвращаемое значение: успех
targetNetwork сложный	Сеть для подключения. Возвращаемое значение: успех
networkUrl строка	Полный URL сети VPC для переадресации запросов. Должен быть отформатирован как `https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network}`. Возвращаемое значение: успех
privateVisibilityConfig сложный	Для зон с частной видимость, набор ресурсов Virtual Private Cloud, из которых зона видна. Возвращаемое значение: успех
networks сложный	Список сетей VPC, которые могут видеть эту зону. Возвращаемое значение: успех
networkUrl строка	Полный URL сети VPC, к которой необходимо привязаться. Должен быть отформатирован как `https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network}`. Возвращаемое значение: успех
visibility строка	Видимость зоны: публичные зоны доступны в Интернете, в то время как частные зоны видны только для ресурсов Virtual Private Cloud. Возвращаемое значение: успех

Авторы

Google Inc. (@googlecloudplatform)

Ссылки на сборку

© 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/google/cloud/gcp_dns_managed_zone_info_module.html