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

Примечание

Этот модуль входит в коллекцию netapp.storagegrid (версия 21.12.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 строка / обязательно	URL узла администрирования StorageGRID REST API.
auth_token строка / обязательно	Токен авторизации для запроса API.
description строка	Описание политики классификации трафика.
limits список / элементы=словарь	Дополнительные лимиты для запросов клиентов, соответствующих этому классу трафика. Можно указать только один тип лимита.
type строка / обязательно	Тип применяемого лимита. `aggregateBandwidthIn` — Максимальная совокупная пропускная способность загрузки в байтах/секунду для всех одновременных запросов, соответствующих этой политике. `aggregateBandwidthOut` — Максимальная совокупная пропускная способность для скачивания в байтах/секунду для всех одновременных запросов, соответствующих этой политике. `concurrentReadRequests` — Максимальное количество запросов на загрузку, которые могут выполняться одновременно. `concurrentWriteRequests` — Максимальное количество запросов на загрузку, которые могут выполняться одновременно. `readRequestRate` — Максимальное количество запросов на загрузку, которые могут быть начаты каждую секунду. `writeRequestRate` — Максимальное количество запросов на загрузку, которые могут быть начаты каждую секунду. `perRequestBandwidthIn` — Максимальная пропускная способность загрузки в байтах/секунду, разрешенная для каждого запроса, соответствующего этой политике. `perRequestBandwidthOut` — Максимальная пропускная способность загрузки в байтах/секунду, разрешенная для каждого запроса, соответствующего этой политике. Варианты: `"aggregateBandwidthIn"` `"aggregateBandwidthOut"` `"concurrentReadRequests"` `"concurrentWriteRequests"` `"readRequestRate"` `"writeRequestRate"` `"perRequestBandwidthIn"` `"perRequestBandwidthOut"`
value целое число / обязательно	Применяемый лимит. Значения лимитов зависят от типа.
matchers список / элементы=словарь	Набор параметров для сопоставления. Класс трафика будет сопоставлять запросы, где совпадают какие-либо из этих сопоставителей.
inverse логический тип	Если истина, сущности, которые соответствуют значению, исключаются. Варианты: `false` ← (по умолчанию) `true`
members список / элементы=строка / обязательно	Список членов для сопоставления.
type строка / обязательно	Атрибут запроса для сопоставления. `bucket` — Ведро S3 (или контейнер Swift), к которому осуществляется доступ. `bucket-regex` — Регулярное выражение для проверки ведра S3 (или контейнера Swift), к которому осуществляется доступ. `cidr` — Соответствует, если IP-адрес источника клиентского запроса находится в указанном IPv4 CIDR (RFC4632). `tenant` — Соответствует, если ведро S3 (или контейнер Swift) принадлежит учетной записи клиента с данным идентификатором. Варианты: `"bucket"` `"bucket-regex"` `"cidr"` `"endpoint"` `"tenant"`
name строка	Имя политики классификации трафика.
policy_id строка	Идентификатор политики классификации трафика. Может использоваться для операций изменения или удаления.
state строка	Следует ли создавать указанную политику классификации трафика. Варианты: `"present"` ← (по умолчанию) `"absent"`
validate_certs логический тип	Нужно ли проверять сертификаты 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

END_OF_DOCUMENT_MARKER

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

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

Ключ	Описание
resp словарь	Возвращает информацию о политике классификации трафика 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

словарь

Возвращает информацию о политике классификации трафика 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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/netapp/storagegrid/na_sg_grid_traffic_classes_module.html