Spec-Zone.ru › Ansible

модуль fortinet.fortimanager.fmgr_pkg_footer_shapingpolicy — Настройка политик управления трафиком.

Примечание

Этот модуль входит в коллекцию fortinet.fortimanager (версия 2.14.0).

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

Чтобы установить её, используйте: ansible-galaxy collection install fortinet.fortimanager.

Чтобы использовать её в плейбуке, укажите: fortinet.fortimanager.fmgr_pkg_footer_shapingpolicy.

Добавлено в fortinet.fortimanager 2.0.0

  • Краткое описание
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

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

  • Этот модуль позволяет настраивать устройство FortiManager.
  • Примеры содержат все параметры и значения, которые необходимо адаптировать к источникам данных перед использованием.

Параметры

Параметр

Комментарии

access_token

string

Токен для доступа к FortiManager без использования имени пользователя и пароля.

bypass_validation

boolean

Устанавливайте значение True только в том случае, если схема модуля отличается от структуры API FortiManager. Модуль продолжит выполнение без проверки параметров.

Варианты:

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

enable_log

boolean

Включить или отключить ведение журнала для задачи.

Варианты:

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

forticloud_access_token

string

Аутентификация клиента Ansible с помощью токена доступа к API FortiCloud.

pkg

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

Параметр (pkg) в запрошенном URL.

pkg_footer_shapingpolicy

dictionary

Параметры верхнего уровня.

app_category

псевдонимы: app-category

any

(list или str) Категория приложения.

app_group

псевдонимы: app-group

any

(list или str) Группа приложений.

application

any

(list) Приложение.

class_id

псевдонимы: class-id

any

(int или str) Идентификатор класса.

class_id_reverse

псевдонимы: class-id-reverse

integer

Обратный идентификатор класса.

comment

string

Комментарий.

cos

string

Шаблон битов CoS VLAN.

cos_mask

псевдонимы: cos-mask

string

Биты CoS VLAN, используемые для проверки.

diffserv_forward

псевдонимы: diffserv-forward

string

Пересылка Diffserv.

Варианты:

  • "disable"
  • "enable"

diffserv_reverse

псевдонимы: diffserv-reverse

string

Обратная обработка Diffserv.

Варианты:

  • "disable"
  • "enable"

diffservcode_forward

псевдонимы: diffservcode-forward

string

Код Diffserv для пересылки.

diffservcode_rev

псевдонимы: diffservcode-rev

string

Обратный код Diffserv.

dstaddr

any

(list или str) Адрес назначения.

dstaddr6

any

(list или str) Адрес назначения IPv6.

dstintf

any

(list или str) Интерфейс назначения.

groups

any

(list или str) Группы.

http_response_match

псевдонимы: http-response-match

string

Сопоставление HTTP-ответа.

Варианты:

  • "disable"
  • "enable"

id

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

Идентификатор.

internet_service

псевдонимы: internet-service

string

Интернет-сервис.

Варианты:

  • "disable"
  • "enable"

internet_service_custom

псевдонимы: internet-service-custom

any

(list или str) Пользовательский интернет-сервис.

internet_service_custom_group

псевдонимы: internet-service-custom-group

any

(list или str) Пользовательская группа интернет-сервисов.

internet_service_fortiguard

псевдонимы: internet-service-fortiguard

any

(list) Название интернет-сервиса FortiGuard.

internet_service_group

псевдонимы: internet-service-group

any

(list или str) Группа интернет-сервисов.

internet_service_id

псевдонимы: internet-service-id

any

(list или str) Идентификатор интернет-сервиса.

internet_service_name

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

any

(list или str) Название интернет-сервиса.

internet_service_src

псевдонимы: internet-service-src

string

Источник интернет-сервиса.

Варианты:

  • "disable"
  • "enable"

internet_service_src_custom

псевдонимы: internet-service-src-custom

any

(list или str) Пользовательский источник интернет-сервиса.

internet_service_src_custom_group

псевдонимы: internet-service-src-custom-group

any

(list или str) Пользовательская группа источников интернет-сервиса.

internet_service_src_fortiguard

псевдонимы: internet-service-src-fortiguard

any

(list) Название источника интернет-сервиса FortiGuard.

internet_service_src_group

псевдонимы: internet-service-src-group

any

(list или str) Группа источников интернет-сервиса.

internet_service_src_id

псевдонимы: internet-service-src-id

any

(list или str) Идентификатор источника интернет-сервиса.

internet_service_src_name

псевдонимы: internet-service-src-name

any

(list или str) Название источника интернет-сервиса.

ip_version

псевдонимы: ip-version

string

Версия IP.

Варианты:

  • "4"
  • "6"

per_ip_shaper

псевдонимы: per-ip-shaper

string

Ограничитель трафика для каждого IP-адреса.

schedule

string

Расписание.

service

any

(list или str) Служба.

service_type

псевдонимы: service-type

string

Тип службы.

Варианты:

  • "service"
  • "internet-service"

srcaddr

any

(list или str) Адрес источника.

srcaddr6

any

(list или str) Адрес источника IPv6.

srcintf

any

(list или str) Интерфейс источника.

status

string

Статус.

Варианты:

  • "disable"
  • "enable"

tos

string

ToS.

tos_mask

псевдонимы: tos-mask

string

Маска ToS.

tos_negate

псевдонимы: tos-negate

string

Инверсия ToS.

Варианты:

  • "disable"
  • "enable"

traffic_shaper

псевдонимы: traffic-shaper

string

Ограничитель трафика.

traffic_shaper_reverse

псевдонимы: traffic-shaper-reverse

string

Обратный ограничитель трафика.

traffic_type

псевдонимы: traffic-type

string

Тип трафика.

Варианты:

  • "forwarding"
  • "local-in"
  • "local-out"

url_category

псевдонимы: url-category

any

(list или str) Категория URL.

users

any

(list или str) Пользователи.

uuid

string

UUID.

uuid_idx

псевдонимы: uuid-idx

integer

Индекс UUID.

proposed_method

string

Переопределённый метод для базового запроса Json RPC.

Варианты:

  • "update"
  • "set"
  • "add"

rc_failed

list / elements=integer

Список кодов rc, для которых переопределяются условия сбоя.

rc_succeeded

list / elements=integer

Список кодов rc, для которых переопределяются условия успешного выполнения.

revision_note

string

Примечание об изменении, которое можно указать при создании или обновлении объекта.

state

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

Директива для создания, обновления или удаления объекта.

Варианты:

  • "present"
  • "absent"

workspace_locking_adom

string

ADOM, который нужно заблокировать для FortiManager, работающего в режиме рабочей области. В качестве значения можно указать global или другие ADOM, включая root.

workspace_locking_timeout

integer

Максимальное время в секундах ожидания снятия блокировки рабочей области другим пользователем.

По умолчанию: 300

Примечания

Примечание

  • Начиная с версии 2.4.0, имена всех входных аргументов задаются в стиле snake_case, где слова разделяются символом подчёркивания. Замените такие аргументы, как «var-name», на «var_name». Старые имена аргументов по-прежнему доступны, но при их использовании будут выдаваться предупреждения об устаревании. Это предупреждение можно отключить, задав deprecation_warnings=False в ansible.cfg.
  • Этот модуль FortiManager поддерживает работу в режиме блокировки рабочей области; верхнеуровневые параметры workspace_locking_adom и workspace_locking_timeout позволяют выполнять необходимые действия.
  • Обычно выполнение модуля завершается ошибкой, если возвращается ненулевой код rc. Условия сбоя или успешного выполнения также можно переопределить с помощью параметров rc_failed и rc_succeeded.
  • Для создания или обновления объекта используйте директиву state present.
  • Для удаления объекта используйте директиву state absent.

Примеры

- name: Example playbook (generated based on argument schema)
  hosts: fortimanagers
  connection: httpapi
  gather_facts: false
  tasks:
    - name: Configure shaping policies.
      fortinet.fortimanager.fmgr_pkg_footer_shapingpolicy:
        # workspace_locking_adom: <global or your adom name>
        pkg: <your own value>
        state: present # <value in [present, absent]>
        pkg_footer_shapingpolicy:
          id: 0 # Required variable, integer
          # app_category: <list or string>
          # app_group: <list or string>
          # application: <list or integer>
          # class_id: <integer or string>
          # comment: <string>
          # diffserv_forward: <value in [disable, enable]>
          # diffserv_reverse: <value in [disable, enable]>
          # diffservcode_forward: <string>
          # diffservcode_rev: <string>
          # dstaddr: <list or string>
          # dstaddr6: <list or string>
          # dstintf: <list or string>
          # groups: <list or string>
          # internet_service: <value in [disable, enable]>
          # internet_service_custom: <list or string>
          # internet_service_custom_group: <list or string>
          # internet_service_group: <list or string>
          # internet_service_id: <list or string>
          # internet_service_src: <value in [disable, enable]>
          # internet_service_src_custom: <list or string>
          # internet_service_src_custom_group: <list or string>
          # internet_service_src_group: <list or string>
          # internet_service_src_id: <list or string>
          # ip_version: <value in [4, 6]>
          # per_ip_shaper: <string>
          # schedule: <string>
          # service: <list or string>
          # srcaddr: <list or string>
          # srcaddr6: <list or string>
          # srcintf: <list or string>
          # status: <value in [disable, enable]>
          # tos: <string>
          # tos_mask: <string>
          # tos_negate: <value in [disable, enable]>
          # traffic_shaper: <string>
          # traffic_shaper_reverse: <string>
          # url_category: <list or string>
          # users: <list or string>
          # uuid: <string>
          # internet_service_name: <list or string>
          # internet_service_src_name: <list or string>
          # class_id_reverse: <integer>
          # service_type: <value in [service, internet-service]>
          # uuid_idx: <integer>
          # cos: <string>
          # cos_mask: <string>
          # traffic_type: <value in [forwarding, local-in, local-out]>
          # http_response_match: <value in [disable, enable]>
          # internet_service_fortiguard: <list or string>
          # internet_service_src_fortiguard: <list or string>

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

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

Ключ

Описание

meta

dictionary

Результат запроса.

Возвращается: всегда

request_url

string

Полный URL запроса.

Возвращается: всегда

Пример: "/sys/login/user"

response_code

integer

Статус запроса API.

Возвращается: всегда

Пример: 0

response_data

list / elements=string

Ответ API.

Возвращается: всегда

response_message

string

Текстовое описание ответа API.

Возвращается: всегда

Пример: "OK."

system_information

dictionary

Информация о целевой системе.

Возвращается: всегда

rc

integer

Статус запроса.

Возвращается: всегда

Пример: 0

version_check_warning

list / elements=string

Предупреждение о том, что используемые в сценарии параметры не поддерживаются текущей версией FortiManager.

Возвращается: при сложном результате

Авторы

  • Xinwei Du (@dux-fortinet)
  • Xing Li (@lix-fortinet)
  • Jie Xue (@JieX19)
  • Link Zheng (@chillancezen)
  • Frank Shen (@fshen01)
  • Hongbin Lu (@fgtdev-hblu)

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

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

© 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/fortinet/fortimanager/fmgr_pkg_footer_shapingpolicy_module.html

Spec-Zone.ru

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