модуль azure.azcollection.azure_rm_managementgroup_info — получение сведений о группах управления Azure
Примечание
Этот модуль входит в коллекцию azure.azcollection (версия 3.18.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install azure.azcollection. Для использования этого модуля необходимы дополнительные компоненты; подробности см. в разделе Требования.
Чтобы использовать модуль в плейбуке, укажите: azure.azcollection.azure_rm_managementgroup_info.
Добавлено в azure.azcollection 1.5.0
Краткое описание
- Получение сведений об указанной группе управления или обо всех группах управления.
Требования
Следующие требования должны быть выполнены на узле, на котором выполняется этот модуль.
- python >= 2.7
- На узле, выполняющем этот модуль, должна быть установлена коллекция azure.azcollection из Galaxy
- Все пакеты Python, перечисленные в файле requirements.txt коллекции, должны быть установлены с помощью pip на узле, выполняющем модули из azure.azcollection
- Полные инструкции по установке доступны по ссылке https://galaxy.ansible.com/azure/azcollection
Параметры
Параметр | Описание |
|---|---|
ad_user string | Имя пользователя Active Directory. Используется при аутентификации от имени пользователя Active Directory, а не субъекта-службы. |
adfs_authority_url string добавлено в azure.azcollection 0.0.1 | URL-адрес центра Azure AD. Используется при аутентификации по имени пользователя и паролю, если у вас есть собственный центр ADFS. |
api_profile string добавлено в azure.azcollection 0.0.1 | Выбирает профиль API для взаимодействия со службами Azure. Значение По умолчанию: |
auth_source string добавлено в azure.azcollection 0.0.1 | Определяет источник учетных данных для аутентификации. Также можно задать с помощью переменной окружения Если задано значение Если задано значение Если задано значение Если задано значение Если задано значение Параметр Варианты:
|
cert_validation_mode string добавлено в azure.azcollection 0.0.1 | Управляет проверкой сертификатов конечных точек Azure. По умолчанию все модули проверяют сертификат сервера, однако при использовании HTTPS-прокси или Azure Stack может потребоваться отключить эту проверку, передав Варианты:
|
children boolean | Если задано c(False), будут получены только группа name или id либо только список корневых групп. Если задано c(True), также будут возвращены дочерние группы. Варианты:
|
client_id string | Идентификатор клиента Azure. Используется при аутентификации с помощью субъекта-службы или управляемого удостоверения (msi). Также можно задать с помощью переменной окружения |
cloud_environment string добавлено в azure.azcollection 0.0.1 | Для облачных сред, отличных от общедоступного облака США, укажите имя среды (согласно Azure Python SDK, например По умолчанию: |
disable_instance_discovery boolean добавлено в azure.azcollection 2.3.0 | Определяет, выполняется ли обнаружение экземпляров при попытке аутентификации. Если задать значение true, обнаружение экземпляров и проверка центра будут полностью отключены. Эта функция предназначена для сценариев, в которых невозможно подключиться к конечной точке метаданных, например в частных облаках или Azure Stack. Обнаружение экземпляров включает получение метаданных центра с сайта https://login.microsoft.com/ для проверки центра. Если задать значение **True**, проверка центра будет отключена. Поэтому крайне важно убедиться, что настроенный узел центра является допустимым и заслуживающим доверия. Задается в профиле файла учетных данных или с помощью переменной окружения Варианты:
|
flatten boolean | Если задано c(True), дочерние элементы management_groups и subscriptions будут скопированы соответственно в корневой список возвращаемых элементов management_groups и subscriptions. По умолчанию задано c(False), поэтому дочерние элементы отображаются только во вложенной структуре. Параметр учитывается только при значении c(True) для children; в противном случае он будет проигнорирован без предупреждения. Варианты:
|
id string | Ограничивает результаты указанной группой управления по ее идентификатору. Взаимоисключающий параметр с name. |
log_mode string | Аргумент родительского модуля. |
log_path string | Аргумент родительского модуля. |
name псевдонимы: management_group_name string | Ограничивает результаты указанной группой управления по ее имени. Взаимоисключающий параметр с id. |
oidc_token string добавлено в azure.azcollection 3.17.0 | Токен OpenID Connect (OIDC) (JWT), используемый для аутентификации с помощью удостоверения рабочей нагрузки. Этот токен обменивается на токен Azure AD с использованием федеративного удостоверения OIDC. Полезен в системах CI (например, GitHub Actions, Azure DevOps), где платформа напрямую предоставляет токен OIDC. Также можно задать с помощью переменной окружения |
oidc_token_file_path path добавлено в azure.azcollection 3.17.0 | Путь к файлу с токеном OpenID Connect (OIDC) (JWT), используемым для аутентификации с помощью удостоверения рабочей нагрузки. Файл должен содержать только необработанный токен. Этот способ обычно используется на платформах, которые сохраняют токены OIDC в файлах. Также можно задать с помощью переменной окружения |
password string | Пароль пользователя Active Directory. Используется при аутентификации от имени пользователя Active Directory, а не субъекта-службы. |
profile string | Профиль безопасности из файла ~/.azure/credentials. |
recurse boolean | По умолчанию задано c(False): если для children установлено значение c(True), возвращаются только непосредственные дочерние элементы. Если задано c(True), возвращаются все потомки в иерархии. Параметр учитывается только при значении c(True) для children; в противном случае он будет проигнорирован без предупреждения. Варианты:
|
secret string | Секрет клиента Azure. Используется при аутентификации с помощью субъекта-службы. |
subscription_id string | Идентификатор вашей подписки Azure. |
tenant string | Идентификатор клиента Azure. Используется при аутентификации с помощью субъекта-службы. |
thumbprint string добавлено в azure.azcollection 1.14.0 | Отпечаток закрытого ключа, указанного в x509_certificate_path. Используется при аутентификации с помощью субъекта-службы. Обязателен, если задан x509_certificate_path. |
x509_certificate_path path добавлено в azure.azcollection 1.14.0 | Путь к сертификату X509 в формате PEM, используемому для создания субъекта-службы. Сертификат должен быть добавлен к закрытому ключу. Используется при аутентификации с помощью субъекта-службы. |
Примечания
Примечание
- azure_rm_managementgroup_info — роли, назначенные субъекту, выполняющему плейбук, определяют, какая группа management_group является корневой. Вы также можете запросить сведения о родительской группе управления, но не иметь возможности получить эту группу. Если для children задано значение c(True), настоятельно рекомендуется запрашивать конкретные группы управления, поскольку получение списка всех групп требует дополнительного вызова API Azure для каждой возвращаемой группы.
- Для аутентификации в Azure можно передать параметры, задать переменные окружения, использовать профиль из ~/.azure/credentials или выполнить вход перед запуском задач или плейбука с помощью
az login. - Также возможна аутентификация с помощью субъекта-службы или пользователя Active Directory.
- Для аутентификации через OIDC передайте client_id, tenant и oidc_token либо oidc_token_file_path или задайте переменные окружения AZURE_CLIENT_ID, AZURE_TENANT и AZURE_FEDERATED_TOKEN либо AZURE_FEDERATED_TOKEN_FILE.
- Для аутентификации с помощью субъекта-службы передайте subscription_id, client_id, secret и tenant или задайте переменные окружения AZURE_SUBSCRIPTION_ID, AZURE_CLIENT_ID, AZURE_SECRET и AZURE_TENANT.
- Для аутентификации от имени пользователя Active Directory передайте ad_user и password либо задайте в окружении AZURE_AD_USER и AZURE_PASSWORD.
- Кроме того, учетные данные можно хранить в ~/.azure/credentials. Это ini-файл, содержащий раздел [default] и следующие ключи: subscription_id, client_id, secret и tenant либо subscription_id, ad_user и password. Также можно добавить дополнительные профили. Укажите профиль, передав profile или задав в окружении AZURE_PROFILE.
См. также
См. также
- azure.azcollection.azure_rm_subscription_info
-
модуль для получения более подробных сведений о подписках, например тегов.
- azure.azcollection.azure_rm_roleassignment_info
-
модуль для получения сведений о назначениях ролей RBAC, в которых в качестве области действия можно использовать идентификатор группы управления.
- Вход с помощью Azure CLI
-
Инструкции по аутентификации с помощью команды
az login.
Примеры
- name: Get facts for all root management groups for authenticated principal
azure_rm_managementgroup_info:
- name: Get facts for one management group by id with direct children
azure_rm_managementgroup_info:
id: /providers/Microsoft.Management/managementGroups/contoso-group
children: true
- name: Get facts for one management group by name with all children, flattened into top list
azure_rm_managementgroup_info:
name: "contoso-group"
children: true
recurse: true
flatten: true
Возвращаемые значения
Общие возвращаемые значения описаны здесь, ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
management_groups list / elements=string | Список словарей групп управления. Возвращается: всегда |
|
children list / elements=string |
Дочерние группы управления или подписки. Возвращается: если children равно c(True) Пример: |
|
display_name string |
Отображаемое имя группы управления. Возвращается: всегда Пример: |
|
id string |
Полный идентификатор группы управления. Возвращается: всегда Пример: |
|
name string |
Отображаемое имя группы управления. Возвращается: всегда Пример: |
|
tenant_id string |
Идентификатор клиента группы управления Возвращается: всегда Пример: |
|
type string |
Тип группы управления Возвращается: всегда Пример: |
subscriptions list / elements=string | Список объектов подписок. Возвращается: если children и flatten оба равны c(True) |
|
display_name string |
Отображаемое имя подписки. Возвращается: всегда Пример: |
|
id string |
Полный идентификатор подписки. Возвращается: всегда Пример: |
|
subscription_id string |
GUID подписки. Возвращается: всегда Пример: |
|
type string |
Тип группы управления Возвращается: всегда Пример: |
Ссылки на коллекцию
© 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/azure/azcollection/azure_rm_managementgroup_info_module.html