Spec-Zone.ru › Ansible 2.11

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

Примечание

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

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

Для использования в книге задач укажите: 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, или выполнить вход до запуска задач или книги задач с помощью 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
complex
всегда
Отвечает на запрос, специфичный для типа ресурса.
id
string
всегда
Идентификатор Azure-ресурса.

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

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

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

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

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

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

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

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

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

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

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

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

Пример:
[{'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
dictionary
всегда
Указывает информацию об используемом образе.

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

Пример:
{'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
string
всегда
Указывает уникальный идентификатор ВМ, который представляет собой 128-битный идентификатор, закодированный и хранящийся во всех виртуальных машинах Azure SMBIOS.
Его можно прочитать с помощью команд платформенного BIOS.

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

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


Авторы

  • Зим Калиновский (@zikalino)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/azure/azcollection/azure_rm_resource_info_module.html

Spec-Zone.ru

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