Модуль netapp.storagegrid.na_sg_grid_traffic_classes — управление конфигурацией политики классификации трафика в StorageGRID.

Примечание

Этот модуль входит в коллекцию netapp.storagegrid (версия 21.16.0).

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

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

Чтобы использовать её в плейбуке, укажите: netapp.storagegrid.na_sg_grid_traffic_classes.

Добавлено в netapp.storagegrid 21.10.0

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Создание, обновление и удаление политик классификации трафика в NetApp StorageGRID.

Параметры

Параметр	Комментарии
api_url string / обязательный	URL REST API узла администрирования StorageGRID.
auth_token string / обязательный	Токен авторизации для запроса API
description string	Описание политики классификации трафика.
limits list / elements=dictionary	Необязательные ограничения для клиентских запросов, соответствующих этому классу трафика. Для каждого типа ограничения можно указать только одно значение.
type string / обязательный	Тип применяемого ограничения. `aggregateBandwidthIn` — максимальная суммарная пропускная способность загрузки в байтах в секунду для всех одновременно выполняемых запросов, соответствующих этой политике. `aggregateBandwidthOut` — максимальная суммарная пропускная способность скачивания в байтах в секунду для всех одновременно выполняемых запросов, соответствующих этой политике. `concurrentReadRequests` — максимальное количество запросов на скачивание, которые могут выполняться одновременно. `concurrentWriteRequests` — максимальное количество запросов на загрузку, которые могут выполняться одновременно. `readRequestRate` — максимальное количество запросов на скачивание, которые могут запускаться каждую секунду. `writeRequestRate` — максимальное количество запросов на скачивание, которые могут запускаться каждую секунду. `perRequestBandwidthIn` — максимальная пропускная способность загрузки в байтах в секунду, разрешённая для каждого запроса, соответствующего этой политике. `perRequestBandwidthOut` — максимальная пропускная способность скачивания в байтах в секунду, разрешённая для каждого запроса, соответствующего этой политике. Допустимые значения: `"aggregateBandwidthIn"` `"aggregateBandwidthOut"` `"concurrentReadRequests"` `"concurrentWriteRequests"` `"readRequestRate"` `"writeRequestRate"` `"perRequestBandwidthIn"` `"perRequestBandwidthOut"`
value integer / обязательный	Применяемое ограничение. Допустимые значения зависят от типа ограничения.
matchers list / elements=dictionary	Набор параметров для сопоставления. Класс трафика будет соответствовать запросам, совпадающим с любым из этих критериев.
inverse boolean	Если значение равно true, сущности, соответствующие значению, исключаются. Допустимые значения: `false` ← (по умолчанию) `true`
members list / elements=string / обязательный	Список элементов для сопоставления.
type string / обязательный	Атрибут запроса для сопоставления. `bucket` — используемый бакет S3 (или контейнер Swift). `bucket-regex` — регулярное выражение для проверки используемого бакета S3 (или контейнера Swift). `cidr` — соответствует, если исходный IP-адрес клиентского запроса входит в указанную сеть IPv4 CIDR (RFC4632). `tenant` — соответствует, если бакет S3 (или контейнер Swift) принадлежит учётной записи арендатора с этим идентификатором. Допустимые значения: `"bucket"` `"bucket-regex"` `"cidr"` `"endpoint"` `"tenant"`
name string	Название политики классификации трафика.
policy_id string	Идентификатор политики классификации трафика. Может использоваться для изменения или удаления.
state string	Должна ли существовать указанная политика классификации трафика. Допустимые значения: `"present"` ← (по умолчанию) `"absent"`
validate_certs boolean	Следует ли проверять сертификаты HTTPS? Допустимые значения: `false` `true` ← (по умолчанию)

Примечания

Примечание

Модули с префиксом na_sg предназначены для управления NetApp StorageGRID.

Примеры

- name: create Traffic Classification Policy with bandwidth limit on buckets
  netapp.storagegrid.na_sg_grid_traffic_classes:
    api_url: "https://<storagegrid-endpoint-url>"
    auth_token: "storagegrid-auth-token"
    validate_certs: false
    state: present
    name: Traffic-Policy1
    matchers:
      - type: bucket
        members: bucket1,anotherbucket
    limits:
      - type: aggregateBandwidthOut
        value: 100000000

- name: create Traffic Classification Policy with bandwidth limits except for specific tenant account
  netapp.storagegrid.na_sg_grid_traffic_classes:
    api_url: "https://<storagegrid-endpoint-url>"
    auth_token: "storagegrid-auth-token"
    validate_certs: false
    state: present
    name: Fabricpool-Policy
    description: "Limit all to 500MB/s except FabricPool tenant"
    matchers:
      - type: tenant
        inverse: true
        members: 12345678901234567890
    limits:
      - type: aggregateBandwidthIn
        value: 50000000
      - type: aggregateBandwidthOut
        value: 50000000

- name: rename Traffic Classification Policy
  netapp.storagegrid.na_sg_grid_traffic_classes:
    api_url: "https://<storagegrid-endpoint-url>"
    auth_token: "storagegrid-auth-token"
    validate_certs: false
    state: present
    policy_id: 00000000-0000-0000-0000-000000000000
    name: Traffic-Policy1-New-Name
    matchers:
      - type: bucket
        members: bucket1,anotherbucket
    limits:
      - type: aggregateBandwidthOut
        value: 100000000

- name: delete Traffic Classification Policy
  netapp.storagegrid.na_sg_grid_traffic_classes:
    api_url: "https://<storagegrid-endpoint-url>"
    auth_token: "storagegrid-auth-token"
    validate_certs: false
    state: absent
    name: Traffic-Policy1

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

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

Ключ	Описание
resp dictionary	Возвращает сведения о политике классификации трафика StorageGRID. Возвращается: при успехе Пример: `{"description": "Traffic Classification Policy 1", "id": "6b2946e6-7fed-40d0-9262-8e922580aba7", "limits": [{"type": "aggregateBandwidthOut", "value": 100000000}], "matchers": [{"inverse": false, "members": ["192.168.50.0/24"], "type": "cidr"}, {"inverse": false, "members": ["mybucket1", "mybucket2"], "type": "bucket"}], "name": "Traffic-Policy1"}`

Ключ

Описание

resp

dictionary

Возвращает сведения о политике классификации трафика StorageGRID.

Возвращается: при успехе

Пример: {"description": "Traffic Classification Policy 1", "id": "6b2946e6-7fed-40d0-9262-8e922580aba7", "limits": [{"type": "aggregateBandwidthOut", "value": 100000000}], "matchers": [{"inverse": false, "members": ["192.168.50.0/24"], "type": "cidr"}, {"inverse": false, "members": ["mybucket1", "mybucket2"], "type": "bucket"}], "name": "Traffic-Policy1"}

Авторы

Команда NetApp Ansible (@joshedmonds)

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

© 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/netapp/storagegrid/na_sg_grid_traffic_classes_module.html