gcp_compute_interconnect_attachment_facts – Сбор фактов для GCP InterconnectAttachment
Новое в версии 2.8.
Обзор
- Сбор фактов для GCP InterconnectAttachment
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- python >= 2.6
- requests >= 2.18.4
- google-auth >= 1.3.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| auth_kind строка / обязательно |
| Тип используемых учетных данных. |
| filters - | Список пар значений фильтров. Доступные фильтры перечислены здесь https://cloud.google.com/sdk/gcloud/reference/topic/filters.
Каждый дополнительный фильтр в списке будет добавлен как условие И (filter1 и filter2). | |
| project строка | Проект Google Cloud Platform для использования. | |
| region - / обязательно | Регион, в котором находится региональное подключение межсоединения. | |
| scopes список | Массив используемых областей. | |
| service_account_contents строка | Строка, представляющая содержимое файла JSON учетной записи службы. Это не должно передаваться как словарь, а как строка, содержащая точное содержимое файла json учетной записи службы (валидный JSON). | |
| service_account_email строка | Необязательный адрес электронной почты учетной записи службы, если выбран machineaccount, и пользователь не хочет использовать адрес по умолчанию. | |
| service_account_file путь | Путь к файлу JSON учетной записи службы, если в качестве типа выбран serviceaccount. |
Примечания
Примечание
- Для аутентификации можно установить service_account_file с помощью переменной среды
GCP_SERVICE_ACCOUNT_FILE. - Для аутентификации можно установить service_account_email с помощью переменной среды
GCP_SERVICE_ACCOUNT_EMAIL. - Для аутентификации можно установить service_account_contents с помощью переменной среды
GCP_SERVICE_ACCOUNT_CONTENTS. - Для аутентификации можно установить auth_kind с помощью переменной среды
GCP_AUTH_KIND. - Для аутентификации можно установить scopes с помощью переменной среды
GCP_SCOPES. - Значения переменных среды будут использоваться только в том случае, если значения в сценарии не заданы.
- Параметры service_account_email и service_account_file взаимоисключающие.
Примеры
- name: " a interconnect attachment facts"
gcp_compute_interconnect_attachment_facts:
region: us-central1
filters:
- name = test_object
project: test_project
auth_kind: serviceaccount
service_account_file: "/tmp/auth.pem"
state: facts
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание | ||
|---|---|---|---|---|
| items сложное | всегда | Список элементов | ||
| candidateSubnets список | успех | До 16 кандидатов префиксов, которые могут быть использованы для ограничения выделения cloudRouterIpAddress и customerRouterIpAddress для этого подключения. Все префиксы должны находиться в пространстве адресов link-local (169.254.0.0/16) и должны быть /29 или короче (/28, /27 и т. д.). Google попытается выбрать неиспользуемый /29 из предоставленного(ых) префикса(ов) кандидата(ов). Запрос завершится ошибкой, если все возможные /29 заняты на периферийном оборудовании Google. Если префиксы не предоставлены, Google случайным образом выберет неиспользуемый /29 из всего пространства link-local. | ||
| cloudRouterIpAddress строка | успех | IPv4-адрес + длина префикса, который необходимо настроить на интерфейсе маршрутизатора Google Cloud для этого подключения к межсетевому соединению. | ||
| creationTimestamp строка | успех | Маркер времени создания в формате RFC3339. | ||
| customerRouterIpAddress строка | успех | IPv4-адрес + длина префикса, который необходимо настроить на подинтерфейсе маршрутизатора клиента для этого подключения к межсетевому соединению. | ||
| description строка | успех | Необязательное описание этого ресурса. | ||
| edgeAvailabilityDomain строка | успех | Желаемая область доступности для подключения. Доступно только для типа PARTNER при создании. Для повышения надежности пользователи должны настроить пару подключений, по одному на каждую область доступности. Выбранная область доступности будет предоставлена партнеру через ключ сопоставления, чтобы предоставленный канал находился в указанной области. Если не указано, значение по умолчанию — AVAILABILITY_DOMAIN_ANY. | ||
| googleReferenceId строка | успех | Идентификатор Google, который необходимо использовать при подаче обращений в службу поддержки Google или для отладки проблем с подключением к бэкенду. | ||
| id строка | успех | Уникальный идентификатор ресурса. Этот идентификатор определяется сервером. | ||
| interconnect строка | успех | URL базового объекта межсетевого соединения, по которому будет проходить трафик этого подключения. Требуется, если тип DEDICATED, не должен быть задан, если тип PARTNER. | ||
| name строка | успех | Имя ресурса. Предоставляется клиентом при создании ресурса. Длина имени должна составлять от 1 до 63 символов и соответствовать RFC1035. То есть длина имени должна составлять от 1 до 63 символов и соответствовать регулярному выражению `[a-z]([-a-z0-9]*[a-z0-9])?`, что означает, что первый символ должен быть строчной буквой, а все последующие символы должны быть дефисом, строчной буквой или цифрой, за исключением последнего символа, который не может быть дефисом. | ||
| pairingKey строка | успех | [Только для вывода, тип PARTNER. Отсутствует для DEDICATED]. Непрозрачный идентификатор подключения PARTNER, используемый для инициирования настройки с выбранным партнером. Формат: "XXXXX/регион/домен". | ||
| partnerAsn строка | успех | [Только для вывода, тип PARTNER. Отсутствует для DEDICATED]. Необязательный ASN BGP для маршрутизатора, который должен быть предоставлен партнером уровня 3, если он настраивает BGP от имени клиента. | ||
| privateInterconnectInfo сложное | успех | Информация, специфичная для подключения к межсетевому соединению. Это свойство заполняется, если межсетевое соединение, к которому оно подключено, имеет тип DEDICATED. | ||
| tag8021q целое число | успех | Тег инкапсуляции 802.1q, который будет использоваться для трафика между Google и клиентом в направлении к и от этой сети и региона. | ||
| region строка | успех | Регион, в котором находится региональное подключение к межсетевому соединению. | ||
| router словарь | успех | URL маршрутизатора Google Cloud, который будет использоваться для динамической маршрутизации. Этот маршрутизатор должен находиться в том же регионе, что и это подключение к межсетевому соединению. Подключение к межсетевому соединению автоматически подключит межсетевое соединение к сети и региону, в котором настроен маршрутизатор Google Cloud. | ||
| state строка | успех | [Только для вывода] Текущее состояние функциональности этого подключения. | ||
| type строка | успех | Тип подключения к межсетевому соединению, которое вы хотите создать. По умолчанию — DEDICATED. | ||
| vlanTag8021q целое число | успех | Тег VLAN IEEE 802.1Q для этого подключения в диапазоне от 2 до 4094. | ||
Состояние
- Данный модуль не гарантирует обратную совместимость интерфейса. [предварительная версия]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- 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.8/modules/gcp_compute_interconnect_attachment_facts_module.html
