azure_rm_availabilityset – Управление набором доступности Azure.

Новое в версии 2.4.

Описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

Описание

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

Требования

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

python >= 2.7
azure >= 2.0.0

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
ad_user -		Имя пользователя Active Directory. Используется при аутентификации с пользователем Active Directory, а не с принципалом службы.
adfs_authority_url - добавлено в 2.6	Значение по умолчанию: null	URL-адрес авторизации Azure AD. Используется при аутентификации с именем пользователя/паролем и собственной службой ADFS.
api_profile - добавлено в 2.5	Значение по умолчанию: "latest"	Выбирает профиль API для взаимодействия с Azure-сервисами. Значение по умолчанию `latest` подходит для общедоступных облаков; будущие значения позволят использовать Azure Stack.
append_tags boolean	Варианты: no да ←	Управляет тем, является ли поле тегов каноническим или просто добавляет существующие теги. При каноническом значении все теги, отсутствующие в параметре тегов, будут удалены из метаданных объекта.
auth_source - добавлено в 2.5	Варианты: auto cli credential_file env msi	Управляет источником учетных данных для аутентификации. Если не указано, будет использоваться переменная среды ANSIBLE_AZURE_AUTH_SOURCE и по умолчанию будет `auto` , если переменная не определена. `auto` будет следовать по умолчанию приоритету параметров модуля -> переменных среды -> профилю по умолчанию в файле учетных данных `~/.azure/credentials`. При установке в `cli`, учетные данные будут получены из профиля Azure CLI по умолчанию. Также можно установить через переменную среды `ANSIBLE_AZURE_AUTH_SOURCE`. При установке в `msi`, хост-машина должна быть Azure-ресурсом с включенным расширением MSI. `subscription_id` или переменная среды `AZURE_SUBSCRIPTION_ID` можно использовать для определения идентификатора подписки, если ресурсу предоставлен доступ к нескольким подпискам, в противном случае выбирается первая подписка. `msi` было добавлено в Ansible 2.6.
cert_validation_mode - добавлено в 2.5	Варианты: validate ignore	Управляет поведением проверки сертификата для Azure-точек конечного доступа. По умолчанию все модули проверяют сертификат сервера, но при использовании HTTPS-прокси или при работе с Azure Stack может потребоваться отключить это поведение, передав `ignore`. Также можно задать через профиль файла учетных данных или переменную среды `AZURE_CERT_VALIDATION`.
client_id -		Идентификатор клиента Azure. Используется при аутентификации с принципалом службы.
cloud_environment - добавлено в 2.4	Значение по умолчанию: "AzureCloud"	Для облачных сред, отличных от общедоступного облака США, имя среды (определено в Azure Python SDK, например, `AzureChinaCloud`, `AzureUSGovernment` ), или URL-адрес точки конечного доступа для обнаружения метаданных (требуется для Azure Stack). Также можно задать через профиль файла учетных данных или переменную среды `AZURE_CLOUD_ENVIRONMENT`.
location -		Действительное расположение Azure. По умолчанию - расположение группы ресурсов.
name - / обязательно		Имя набора доступности.
password -		Пароль пользователя Active Directory. Используется при аутентификации с пользователем Active Directory, а не с принципалом службы.
platform_fault_domain_count -	Значение по умолчанию: 3	Домены отказоустойчивости определяют группу виртуальных машин, которые используют общий источник питания и сетевой коммутатор. Должно быть от 1 до 3. По умолчанию 3.
platform_update_domain_count -	Значение по умолчанию: 5	Облачные домены указывают группы виртуальных машин и базовое физическое оборудование, которые можно перезагрузить одновременно. По умолчанию 5.
profile -		Профиль безопасности в файле ~/.azure/credentials.
resource_group - / обязательно		Имя группы ресурсов, где существует или будет создан набор доступности.
secret -		Секрет клиента Azure. Используется при аутентификации с принципалом службы.
sku -	Варианты: Классический ← Выровненный	Определяет, поддерживает ли набор доступности управляемые диски.
state -	Варианты: отсутствует наличие ←	Утверждает состояние набора доступности. Используйте 'наличие', чтобы создать или обновить набор доступности, и 'отсутствует', чтобы удалить набор доступности.
subscription_id -		Ваш идентификатор подписки Azure.
tags -		Словарь пар ключ-значение типа строка:строка, назначаемый в качестве метаданных объекту. Метаданные тегов объекта будут обновлены любыми предоставленными значениями. Для удаления тегов установите параметр append_tags в false.
tenant -		Идентификатор Azure-аренды. Используется при аутентификации с принципалом службы.

Примечания

Примечание

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

Примеры

- name: Create an availability set with default options
  azure_rm_availabilityset:
    name: myavailabilityset
    location: eastus
    resource_group: Testing

- name: Create an availability set with advanced options
  azure_rm_availabilityset:
    name: myavailabilityset
    location: eastus
    resource_group: Testing
    platform_update_domain_count: 5
    platform_fault_domain_count: 3
    sku: Aligned

- name: Delete an availability set
  azure_rm_availabilityset:
    name: myavailabilityset
    location: eastus
    resource_group: Testing
    state: absent

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

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

Ключ	Возвращаемое значение	Описание
changed boolean	всегда	Изменился ли ресурс или нет
state словарь	всегда	Текущее состояние набора доступности

Статус

Этот модуль не гарантирует обратной совместимости интерфейса. [preview]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

Julien Stroheker (@julienstroheker)

Подсказка

Если вы обнаружите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/azure_rm_availabilityset_module.html