Spec-Zone.ru › Ansible

Модуль cisco.mso.mso_tenant_site — управление арендаторами с облачными сайтами.

Примечание

Этот модуль входит в коллекцию cisco.mso (версия 2.13.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install cisco.mso. Для использования этого модуля необходимы дополнительные требования. Подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: cisco.mso.mso_tenant_site.

  • Краткое описание
  • Требования
  • Параметры
  • Примечания
  • Примеры

Краткое описание

  • Управление арендаторами с облачными сайтами в Cisco ACI Multi-Site.

Требования

Следующие требования необходимы на хосте, выполняющем этот модуль.

  • Multi Site Orchestrator версии 2.1 или новее

Параметры

Параметр

Комментарии

aws_access_key

string

Идентификатор ключа доступа к учётной записи AWS. Обязателен, если для aws_trusted задано значение false.

aws_account_org

boolean

Учётная запись AWS для организации.

Допустимые значения:

  • false ← (по умолчанию)
  • true

aws_trusted

boolean

Доступ к учётной записи AWS в доверенном режиме. Если задано значение false, требуются учётные данные.

Допустимые значения:

  • false
  • true

azure_access_type

string

Управляемый режим для Azure.

Неуправляемый режим для Azure.

Общий режим, если атрибут не указан.

Допустимые значения:

  • "managed"
  • "unmanaged"
  • "shared" ← (по умолчанию)

azure_active_directory_id

string

Идентификатор каталога Active Directory учётной записи Azure.

Этот атрибут обязателен, если для azure_access_type выбран неуправляемый режим.

azure_active_directory_name

string

Имя каталога Active Directory учётной записи Azure. Например, ‘CiscoINSBUAd’ — имя каталога Active Directory.

Этот атрибут обязателен, если для azure_access_type выбран неуправляемый режим.

azure_application_id

string

Идентификатор приложения учётной записи Azure.

Этот атрибут обязателен, если для azure_access_type выбран управляемый или неуправляемый режим.

azure_credential_name

string

Имя учётных данных учётной записи Azure.

Этот атрибут обязателен, если для azure_access_type выбран неуправляемый режим.

azure_subscription_id

string

Идентификатор подписки учётной записи Azure.

Этот атрибут обязателен, если для azure_access_type выбран управляемый или неуправляемый режим.

cloud_account

string

Обязателен для облачного сайта.

Идентификатор учётной записи AWS в формате ‘000000000000’.

Идентификатор учётной записи Azure в формате ‘uni/tn-(tenant_name)/act-[(subscription_id)]-azure_vendor-azure’.

Примеры значений в идентификаторе учётной записи Azure: ‘(tenant_name)=tenant_test и (subscription_id)=10’.

host

псевдонимы: hostname

string

IP-адрес или имя хоста узла ACI Multi Site Orchestrator.

Если значение не указано в задаче, вместо него будет использоваться значение переменной среды MSO_HOST.

login_domain

string

Имя домена входа, используемое для аутентификации.

Значение по умолчанию — Local.

Если значение не указано в задаче, вместо него будет использоваться значение переменной среды MSO_LOGIN_DOMAIN.

При использовании плагина подключения HTTPAPI, если этот атрибут не указан, будет использоваться переменная инвентаризации ansible_httpapi_login_domain.

output_level

string

Управляет выводом этого модуля MSO.

normal — стандартный вывод, включая словарь current

info добавляет информационный вывод, включая previous, proposed и словари sent

debug добавляет отладочный вывод, включая filter_string, method, response, status и информацию url

Если значение не указано в задаче, вместо него будет использоваться значение переменной среды MSO_OUTPUT_LEVEL.

Допустимые значения:

  • "debug"
  • "info"
  • "normal" ← (по умолчанию)

password

string

Пароль, используемый для аутентификации.

Если значение не указано в задаче, вместо него будет использоваться значение одной из переменных среды: MSO_PASSWORD или ANSIBLE_NET_PASSWORD.

port

integer

Номер порта для REST-подключения.

Значение по умолчанию зависит от параметра `use_ssl`.

Если значение не указано в задаче, вместо него будет использоваться значение переменной среды MSO_PORT.

secret_key

string

Секретный ключ AWS для недоверенной учётной записи. Обязателен, если для aws_trusted задано значение false.

Секретный ключ учётной записи Azure для неуправляемой идентификации. Обязателен в неуправляемом режиме учётной записи Azure.

security_domains

list / элементы=string

Список доменов безопасности для сайтов.

По умолчанию: []

site

псевдонимы: name

string

Имя сайта.

Это может быть облачный или обычный сайт.

state

string

Для добавления или удаления используйте present или absent.

Для получения списка одного или нескольких объектов используйте query.

Допустимые значения:

  • "absent"
  • "present" ← (по умолчанию)
  • "query"

tenant

string / обязательный

Имя арендатора.

timeout

integer

Тайм-аут на уровне сокета в секундах.

Значение по умолчанию — 30 секунд.

Если значение не указано в задаче, вместо него будет использоваться значение переменной среды MSO_TIMEOUT.

use_proxy

boolean

Если задано false, прокси использоваться не будет, даже если он определён в переменной среды на целевых хостах.

Если значение не указано в задаче, вместо него будет использоваться значение переменной среды MSO_USE_PROXY.

Значение по умолчанию — true.

Допустимые значения:

  • false
  • true

use_ssl

boolean

Если задано false, вместо HTTPS-подключения по умолчанию будет использоваться HTTP-подключение.

Если значение не указано в задаче, вместо него будет использоваться значение переменной среды MSO_USE_SSL.

При использовании плагина подключения HTTPAPI, если этот атрибут не указан, будет использоваться переменная инвентаризации ansible_httpapi_use_ssl.

По умолчанию используется false при подключении через плагин HTTPAPI (mso или nd) и true при использовании устаревшего способа подключения (только для mso).

Допустимые значения:

  • false
  • true

username

string

Имя пользователя, используемое для аутентификации.

Если значение не указано в задаче, вместо него будет использоваться значение одной из переменных среды: MSO_USERNAME или ANSIBLE_NET_USERNAME.

validate_certs

boolean

Если задано false, SSL-сертификаты проверяться не будут.

Значение false следует задавать только при использовании на сайтах под личным управлением с самоподписанными сертификатами.

Если значение не указано в задаче, вместо него будет использоваться значение переменной среды MSO_VALIDATE_CERTS.

Значение по умолчанию — true.

Допустимые значения:

  • false
  • true

Примечания

Примечание

  • Этот модуль разработан для поддержки Multi Site Orchestrator версии 2.1 или новее. Некоторые или все функции могут не работать в более ранних версиях.

Примеры

- name: Associate a non-cloud site with a tenant
  cisco.mso.mso_tenant_site:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    tenant: tenant_name
    site: site_name
    state: present

- name: Associate AWS site with a tenant, with aws_trusted set to true
  cisco.mso.mso_tenant_site:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    tenant: tenant_name
    site: site_name
    cloud_account: '000000000000'
    aws_trusted: true
    state: present

- name: Associate AWS site with a tenant, with aws_trusted set to false
  cisco.mso.mso_tenant_site:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    tenant: tenant_name
    site: AWS
    cloud_account: '000000000000'
    aws_trusted: false
    aws_access_key: '1'
    secret_key: '0'
    aws_account_org: false
    state: present

- name: Associate Azure site in managed mode
  mso.cisco.mso_tenant_site:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    tenant: tenant_name
    site: site_name
    cloud_account: uni/tn-ansible_test/act-[9]-azure_vendor-azure
    azure_access_type: managed
    azure_subscription_id: '9'
    azure_application_id: '100'
    state: present

- name: Associate Azure site in unmanaged mode
  mso.cisco.mso_tenant_site:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    tenant: tenant_name
    site: site_name
    cloud_account: uni/tn-ansible_test/act-[9]-azure_vendor-azure
    azure_access_type: unmanaged
    azure_subscription_id: '9'
    azure_application_id: '100'
    azure_credential_name: cApicApp
    secret_key: iins
    azure_active_directory_id: '32'
    azure_active_directory_name: CiscoINSBUAd
    state: present

- name: Dissociate a site
  cisco.mso.mso_tenant_site:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    tenant: tenant_name
    site: site_name
    state: absent

- name: Query a site
  cisco.mso.mso_tenant_site:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    tenant: tenant_name
    site: site_name
    state: query
  register: query_result

- name: Query all sites of a tenant
  cisco.mso.mso_tenant_site:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    tenant: tenant_name
    state: query
  register: query_result

Авторы

  • Shreyas Srish (@shrsr)

Ссылки на коллекцию

  • Отслеживание проблем
  • Главная страница
  • Репозиторий (исходный код)

© 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/cisco/mso/mso_tenant_site_module.html

Spec-Zone.ru

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