Модуль cisco.dnac.site_create – Модуль ресурса для создания сайта

Примечание

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

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

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

Чтобы использовать его в книге задач, укажите: cisco.dnac.site_create.

Новый в cisco.dnac 3.1.0

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

Описание

Управляет операцией создания ресурса «Создание сайта».
Создает сайт с областью/зданием/этажом со специфической иерархией.

Примечание

Этот модуль имеет соответствующий плагин действия.

Требования

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

dnacentersdk >= 2.7.2
python >= 3.5

Параметры

Параметр	Комментарии
dnac_debug boolean	Флаг для Cisco DNA Center SDK, чтобы включить отладку. Варианты: `false` ← (по умолчанию) `true`
dnac_host string / обязательно	Имя хоста Cisco DNA Center.
dnac_password string	Пароль Cisco DNA Center для аутентификации.
dnac_port integer	Порт Cisco DNA Center. По умолчанию: `443`
dnac_username псевдонимы: user string	Имя пользователя Cisco DNA Center для аутентификации. По умолчанию: `"admin"`
dnac_verify boolean	Флаг для включения или выключения проверки сертификата SSL. Варианты: `false` `true` ← (по умолчанию)
dnac_version string	Уведомляет SDK, какую версию Cisco DNA Center использовать. По умолчанию: `"2.3.7.6"`
headers dictionary	Дополнительные заголовки.
site dictionary	Сайт модуля Site Create.
area dictionary	Область модуля Site Create.
name string	Имя области (например, Area1).
parentName string	Родительское имя создаваемой области.
building dictionary	Здание модуля Site Create.
address string	Адрес создаваемого здания.
country string	Страна (например, Соединенные Штаты).
latitude float	Координата широты здания (например, 37.338).
longitude float	Координата долготы здания (например, -121.832).
name string	Название здания (например, building1).
parentName string	Родительское имя создаваемого здания.
floor dictionary	Этаж модуля Site Create.
floorNumber float	Номер этажа. (например, 5).
height float	Высота этажа. Единица измерения — футы. (например, 15).
length float	Длина этажа. Единица измерения — футы. (например, 100).
name string	Название этажа (например, floor-1).
parentName string	Родительское имя создаваемого этажа.
rfModel string	Тип этажа (например, Cubes And Walled Offices0).
width float	Ширина этажа. Единица измерения — футы. (например, 100).

тип строка	Тип создаваемого сайта (например, район, здание, этаж).
validate_response_schema логическое значение	Флаг для Cisco DNA Center SDK, позволяющий включить проверку запросов по схеме JSON. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Используемый метод SDK: sites.Sites.create_site,
Используемые пути: post /dna/intent/api/v1/site,
Не поддерживает check_mode
Плагин работает на узле управления и не использует плагины подключения ansible, а вместо этого использует встроенный менеджер подключения Cisco DNAC SDK
Параметры, начинающиеся с dnac_, используются Cisco DNAC Python SDK для установления подключения

См. также

Документация Cisco DNA Center для CreateSite: Полное описание API CreateSite.

Примеры

- name: Create
  cisco.dnac.site_create:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    headers: '{{my_headers | from_json}}'
    site:
      area:
        name: string
        parentName: string
      building:
        address: string
        country: string
        latitude: 0
        longitude: 0
        name: string
        parentName: string
      floor:
        floorNumber: 0
        height: 0
        length: 0
        name: string
        parentName: string
        rfModel: string
        width: 0
    type: string

Значения возврата

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

Ключ	Описание
dnac_response словарь	Словарь или список со значением ответа, возвращённым Cisco DNAC Python SDK Возвращается: всегда Пример: `{"executionId": "string", "executionStatusUrl": "string", "message": "string"}`

Авторы

Rafael Campos (@racampos)

Ссылки на сборку

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/cisco/dnac/site_create_module.html