Spec-Zone.ru › Ansible 2.10

azure.azcollection.azure_rm_resource_info – Общие сведения об Azure-ресурсах

Примечание

Этот плагин входит в коллекцию azure.azcollection (версия 1.3.1).

Для его установки используйте: ansible-galaxy collection install azure.azcollection.

Для использования в playbook укажите: azure.azcollection.azure_rm_resource_info.

Новый в версии 0.1.2: из azure.azcollection

  • Обзор
  • Требования
  • Параметры
  • Примечания
  • См. также
  • Примеры
  • Возвращаемые значения

Обзор

  • Получение сведений о любом ресурсе с помощью Azure REST API.
  • Этот модуль предоставляет доступ к ресурсам, которые не поддерживаются модулями Ansible.
  • Подробную информацию о REST API конкретного ресурса см. на странице https://docs.microsoft.com/en-us/rest/api/.

Требования

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

  • python >= 2.7
  • azure >= 2.0.0

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
ad_user
строка
Имя пользователя Active Directory. Используется при аутентификации с пользователем Active Directory, а не с принципалом службы.
adfs_authority_url
строка
добавлен в 0.0.1 из azure.azcollection
URL-адрес службы авторизации Azure AD. Используется при аутентификации с помощью имени пользователя/пароля и собственной службой ADFS авторизации.
api_profile
строка
добавлен в 0.0.1 из azure.azcollection
По умолчанию:
"latest"
Выбирает профиль API для взаимодействия с Azure-службами. Значение по умолчанию latest подходит для общедоступных облаков; будущие значения позволят использовать с Azure Stack.
api_version
строка
Конкретная версия API для использования.
auth_source
строка
добавлен в 0.0.1 из azure.azcollection
    Варианты:
  • auto ←
  • cli
  • credential_file
  • env
  • msi
Управляет источником учетных данных для аутентификации.
Также может быть задан через переменную среды ANSIBLE_AZURE_AUTH_SOURCE.
При значении auto (по умолчанию) приоритет имеет: параметры модуля -> env -> credential_file -> cli.
При значении env, учетные данные будут взяты из переменных среды.
При значении credential_file, будет считаться профиль из ~/.azure/credentials.
При значении cli, учетные данные будут взяты из профиля Azure CLI. subscription_id или переменная среды AZURE_SUBSCRIPTION_ID могут использоваться для определения идентификатора подписки, если их несколько, иначе используется подписка по умолчанию az cli.
При значении msi, хост-машина должна быть Azure-ресурсом с включенным расширением MSI. subscription_id или переменная среды AZURE_SUBSCRIPTION_ID могут использоваться для определения идентификатора подписки, если ресурсу предоставлен доступ к нескольким подпискам, иначе выбирается первая подписка.
Ключ msi был добавлен в Ansible 2.6.
cert_validation_mode
строка
добавлен в 0.0.1 из azure.azcollection
    Варианты:
  • ignore
  • validate
Управляет поведением проверки сертификата для Azure-точек конечного доступа. По умолчанию все модули проверяют серверный сертификат, но при использовании HTTPS-прокси или с Azure Stack может потребоваться отключить это поведение, передав ignore. Также может быть задан через профиль файла учетных данных или переменную среды AZURE_CERT_VALIDATION.
client_id
строка
Идентификатор клиента Azure. Используется при аутентификации с принципалом службы.
cloud_environment
строка
добавлен в 0.0.1 из azure.azcollection
По умолчанию:
"AzureCloud"
Для облачных сред, отличных от общедоступного облака США, имя среды (как определено Azure Python SDK, например, AzureChinaCloud, AzureUSGovernment), или URL-адрес конечной точки обнаружения метаданных (необходим для Azure Stack). Также может быть задан через профиль файла учетных данных или переменную среды AZURE_CLOUD_ENVIRONMENT.
password
строка
Пароль пользователя Active Directory. Используется при аутентификации с пользователем Active Directory, а не с принципалом службы.
profile
строка
Профиль безопасности, найденный в файле ~/.azure/credentials.
provider
строка
Тип провайдера, должен быть указан, если не задан URL.
resource_group
строка
Группа ресурсов для использования.
Требуется, если URL не указан.
resource_name
строка
Имя ресурса.
resource_type
строка
Тип ресурса.
secret
строка
Секрет клиента Azure. Используется при аутентификации с принципалом службы.
subresource
строка
Список подресурсов.
name
строка
Имя подресурса.
namespace
строка
Пространство имен подресурса.
type
строка
Тип подресурса.
subscription_id
строка
Ваш идентификатор подписки Azure.
tenant
строка
Идентификатор Azure-аренды. Используется при аутентификации с принципалом службы.
url
строка
URL-адрес Azure RM-ресурса.

Примечания

Примечание

  • Для аутентификации в Azure вы можете передать параметры, установить переменные среды, использовать профиль, сохраненный в ~/.azure/credentials, или выполнить вход перед запуском задач или playbook с помощью az login.
  • Аутентификация также возможна с использованием принципала службы или пользователя Active Directory.
  • Для аутентификации с помощью принципала службы передайте 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 CLI

Как выполнить аутентификацию с помощью команды az login.

Примеры

- name: Get scaleset info
  azure_rm_resource_info:
    resource_group: myResourceGroup
    provider: compute
    resource_type: virtualmachinescalesets
    resource_name: myVmss
    api_version: "2017-12-01"

- name: Query all the resources in the resource group
  azure_rm_resource_info:
    resource_group: "{{ resource_group }}"
    resource_type: resources

Возвращаемые значения

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

Ключевые поля Возвращаемое значение Описание
response
сложный тип
всегда
Ответ, специфичный для типа ресурса.
id
строка
всегда
Идентификатор ресурса Azure.

Пример:
/subscriptions/xxxx...xxxx/resourceGroups/v-xisuRG/providers/Microsoft.Compute/virtualMachines/myVM
location
строка
всегда
Расположение ресурса.

Пример:
eastus
name
строка
всегда
Имя ресурса.

Пример:
myVM
properties
сложный тип
всегда
Указывает свойства виртуальной машины.
diagnosticsProfile
сложный тип
всегда
Указывает состояние настроек диагностики загрузки.
bootDiagnostics
словарь
всегда
Функция отладки, позволяющая просматривать вывод консоли и скриншоты для диагностики состояния ВМ.

Пример:
{'enabled': True, 'storageUri': 'https://vxisurgdiag.blob.core.windows.net/'}
hardwareProfile
словарь
всегда
Указывает аппаратные настройки виртуальной машины.

Пример:
{'vmSize': 'Standard_D2s_v3'}
networkProfile
сложный тип
всегда
Указывает сетевые интерфейсы виртуальной машины.
networkInterfaces
список / элементы=строка
всегда
Описание ссылки на сетевой интерфейс.

Пример:
[{'id': '/subscriptions/xxxx...xxxx/resourceGroups/v-xisuRG/providers/Microsoft.Network/networkInterfaces/myvm441'}]
osProfile
сложный тип
всегда
Указывает настройки операционной системы виртуальной машины.
adminUsername
строка
всегда
Указывает имя учетной записи администратора.

Пример:
azureuser
allowExtensionOperations
булево
всегда
Указывает, разрешены ли операции с расширениями на виртуальной машине.
Это может быть установлено только в значение False, если на виртуальной машине нет расширений.

Пример:
True
computerName
строка
всегда
Указывает имя хост-ОС виртуальной машины.

Пример:
myVM
linuxConfiguration
словарь
если тип ОС — Linux
Указывает настройки операционной системы Linux на виртуальной машине.

Пример:
{'disablePasswordAuthentication': False, 'provisionVMAgent': True}
requireGuestProvisionSignale
булево
всегда
Указывает, требует ли хост сигнал о подготовке гостевой ОС.

Пример:
True
secrets
список / элементы=строка
всегда
Указывает набор сертификатов, которые должны быть установлены на виртуальную машину.
provisioningState
строка
всегда
Состояние подготовки.

Пример:
Успешно
storageProfile
сложный тип
всегда
Указывает тип хранилища для управляемого диска.
dataDisks
список / элементы=строка
всегда
Указывает параметры для добавления диска данных к виртуальной машине.

Пример:
[{'caching': 'None', 'createOption': 'Attach', 'diskSizeGB': 1023, 'lun': 2, 'managedDisk': {'id': '/subscriptions/xxxx....xxxx/resourceGroups/V-XISURG/providers/Microsoft.Compute/disks/testdisk2', 'storageAccountType': 'StandardSSD_LRS'}, 'name': 'testdisk2'}, {'caching': 'None', 'createOption': 'Attach', 'diskSizeGB': 1023, 'lun': 1, 'managedDisk': {'id': '/subscriptions/xxxx...xxxx/resourceGroups/V-XISURG/providers/Microsoft.Compute/disks/testdisk3', 'storageAccountType': 'StandardSSD_LRS'}, 'name': 'testdisk3'}]
imageReference
словарь
всегда
Указывает информацию об используемом образе.

Пример:
{'offer': 'UbuntuServer', 'publisher': 'Canonical', 'sku': '18.04-LTS', 'version': 'latest'}
osDisk
словарь
всегда
Указывает информацию о диске операционной системы, используемом виртуальной машиной.

Пример:
{'caching': 'ReadWrite', 'createOption': 'FromImage', 'diskSizeGB': 30, 'managedDisk': {'id': '/subscriptions/xxx...xxxx/resourceGroups/v-xisuRG/providers/Microsoft.Compute/disks/myVM_disk1_xxx', 'storageAccountType': 'Premium_LRS'}, 'name': 'myVM_disk1_xxx', 'osType': 'Linux'}
vmID
строка
всегда
Указывает уникальный идентификатор ВМ, 128-битный идентификатор, закодированный и хранящийся во всех виртуальных машинах Azure laaS в SMBIOS.
Его можно прочитать с помощью команд BIOS платформы.

Пример:
eb86d9bb-6725-4787-a487-2e497d5b340c
type
строка
всегда
Тип идентификации, используемой для виртуальной машины.

Пример:
Microsoft.Compute/virtualMachines


Авторы

  • Zim Kalinowski (@zikalino)

© 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/azure/azcollection/azure_rm_resource_info_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API