restconf_config – Обработка создания, обновления, чтения и удаления данных конфигурации на устройствах с поддержкой RESTCONF

Новая версия с 2.8.

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

Описание

RESTCONF — стандартный механизм, позволяющий веб-приложениям настраивать и управлять данными. RESTCONF — стандарт IETF, документированный в RFC 8040.
Этот модуль позволяет пользователю настраивать данные на устройствах с поддержкой RESTCONF.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
content -		Данные конфигурации в формате, как указано в параметре `format`. Требуется, если `method` не delete.
format -	Варианты: json ← xml	Формат конфигурации, предоставляемой в качестве значения `content`. Допустимые значения — xml и json, и данный формат конфигурации должен поддерживаться удалённым сервером RESTCONF.
method -	Варианты: post ← put patch delete	Метод RESTCONF для управления изменением конфигурации на устройстве. Значение post используется для создания ресурса данных или вызова ресурса операции, put используется для замены целевого ресурса данных, patch — для изменения целевого ресурса, а delete — для удаления целевого ресурса.
path - / обязательно		URI, используемый для выполнения вызовов API.

Примеры

- name: create l3vpn services
  restconf_config:
    path: /config/ietf-l3vpn-svc:l3vpn-svc/vpn-services
    content: |
          {
            "vpn-service":[
                            {
                              "vpn-id": "red_vpn2",
                              "customer-name": "blue",
                              "vpn-service-topology": "ietf-l3vpn-svc:any-to-any"
                            },
                            {
                              "vpn-id": "blue_vpn1",
                              "customer-name": "red",
                              "vpn-service-topology": "ietf-l3vpn-svc:any-to-any"
                            }
                          ]
           }

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

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

Ключ	Возвращаемое значение	Описание
candidate словарь	При методе не delete	Конфигурация, отправленная на устройство. Пример: { "vpn-service": [ { "customer-name": "красный", "vpn-id": "синий_vpn1", "vpn-service-topology": "ietf-l3vpn-svc:любой-к-любому" } ] }
running словарь	При методе не delete	Текущая конфигурация устройства. Пример: { "vpn-service": [ { "vpn-id": "красный_vpn2", "customer-name": "синий", "vpn-service-topology": "ietf-l3vpn-svc:любой-к-любому" }, { "vpn-id": "синий_vpn1", "customer-name": "красный", "vpn-service-topology": "ietf-l3vpn-svc:любой-к-любому" } ] }

Статус

Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
Этот модуль поддерживается командой Ansible Network Team. [сеть]

Поддержка Red Hat

Дополнительную информацию о поддержке этого модуля Red Hat можно найти в этой статье базы знаний Red Hat.

Авторы

Ganesh Nalawade (@ganeshrn)

Подсказка

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

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