Spec-Zone.ru › Ansible

Модуль netapp.storagegrid.na_sg_grid_ilm_rule — управление правилами ILM в StorageGRID.

Примечание

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

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

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

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

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

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

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

  • Взаимодействие с правилами ILM в NetApp StorageGRID.

Параметры

Параметр

Комментарии

api_url

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

URL REST API узла администрирования StorageGRID.

auth_token

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

Токен авторизации для запроса API

bucket_filter

dictionary

Бакеты S3 или Swift, к которым применяется правило ILM.

Если параметр не указан, правило соответствует всем объектам в любых указанных учетных записях арендаторов

operator

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

Оператор для сопоставления бакета(ов) со значением

Варианты:

  • "contains"
  • "endsWith"
  • "equals"
  • "startsWith"

value

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

Строковое значение для сопоставления бакета(ов) с указанным оператором

description

string

Краткое описание назначения правила ILM

filters

list / элементы=dictionary

Критерии фильтрации, используемые для определения того, следует ли применить правило ILM к проверяемому объекту.

Правило ILM без фильтров применяется ко всем объектам

По умолчанию: []

criteria

list / элементы=dictionary

Группа логических условий, основанных на метаданных объекта

metadataName

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

Идентификатор системных метаданных, имя пользовательских метаданных или имя тега

metadataType

string

Указывает тип фильтруемых метаданных

operator

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

Используется для сравнения «metadataName» со строкой «value»

Варианты:

  • "contains"
  • "notContains"
  • "equals"
  • "notEquals"
  • "startsWith"
  • "notStartsWith"
  • "endsWith"
  • "notEndsWith"
  • "exists"
  • "notExists"
  • "lessThan"
  • "lessThanOrEquals"
  • "greaterThan"
  • "greaterThanOrEquals"

value

string

Значение, с которым сравниваются значения метаданных, указанные параметром metadataName

logicalOperator

string

Логический оператор, связывающий критерии фильтрации, если указано более одного критерия

ingest_behavior

string

Способ хранения объектов, соответствующих этому правилу, при приеме.

Режим dual-commit создает временные копии и применяет правило позднее.

Режимы strict и balanced немедленно создают копии, указанные в инструкциях правила для дня 0.

Режим balanced использует dual-commit, если выполнить инструкции правила невозможно.

Варианты:

  • "strict"
  • "balanced" ← (по умолчанию)
  • "dual-commit"

name

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

Отображаемое имя правила ILM.

Понятное и уникальное имя правила ILM.

Неизменяемо после создания правила ILM

placements

list / элементы=dictionary

Указывает, где и каким образом хранятся данные объектов, соответствующих правилу ILM

erasureCoded

list / элементы=dictionary

Создает копии данных объектов с кодированием стирания; в противном случае параметр следует опустить

poolId

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

Пул хранения, в котором хранятся данные объектов

profileId

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

Используемый профиль кодирования стирания. Только для данных объектов с кодированием стирания

replicated

list / элементы=dictionary

Создает реплицированные копии данных объектов; в противном случае параметр следует опустить

cloudStoragePoolId

string

Пул облачного хранения, в котором сохраняются данные объектов. Пулы облачного хранения нельзя использовать в одном размещении с пулом хранения.

Необходимо указать либо poolId, либо cloudStoragePoolId.

copies

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

Количество реплицированных копий

poolId

string

Один или несколько пулов хранения, в которых сохраняются данные объектов; значения указываются через запятую. Необходимо указать либо poolId, либо cloudStoragePoolId.

temporaryPoolId

string

Временные расположения устарели и не должны использоваться в новых правилах ILM.

Если выбран режим приема Strict, временное расположение игнорируется.

retention

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

Указывает, где и каким образом данные объектов, соответствующих правилу ILM, хранятся с течением времени

after

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

День, с которого начинается хранение объектов

duration

integer

Количество дней хранения данных объектов в указанных расположениях. Если значение равно null, объекты хранятся бессрочно

reference_time

string

Указывает время, с которого применяется правило ILM

Варианты:

  • "ingestTime" ← (по умолчанию)
  • "lastAccessTime"
  • "noncurrentTime"
  • "userDefinedCreationTime"

state

string

Должно ли указанное правило существовать.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

tenant_account_id

string

Идентификаторы одной или нескольких учетных записей арендаторов S3 или Swift, к которым применяется правило ILM

Если параметр не указан, правило применяется ко всем объектам

validate_certs

boolean

Следует ли проверять сертификаты HTTPS?

Варианты:

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

Примечания

Примечание

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

Примеры

- name: Create ILM rule with existing EC pool
  na_sg_grid_ilm_rule:
    api_url: "https://<storagegrid-endpoint-url>"
    auth_token: "storagegrid-auth-token"
    name: "1 Copy Per Site"
    state: present
    reference_time: "ingestTime"
    ingest_behavior: "balanced"
    filters: []
    placements:
      - retention:
          after: 0
        erasureCoded:
          - profileId: "1"
            poolId: "p10771105546308032398"

- name: Delete existing ILM rule
  na_sg_grid_ilm_rule:
    api_url: "https://<storagegrid-endpoint-url>"
    auth_token: "storagegrid-auth-token"
    name: "1 Copy Per Site"
    state: absent

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

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

Ключ

Описание

resp

dictionary

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

Возвращается: если state имеет значение ‘present’.

Пример: {"active": false, "api": "s3OrSwift", "displayName": "1 Copy Per Site", "filters": [], "id": "r14896911895584977919", "ingestBehavior": "balanced", "permissions": ["delete", "edit"], "placements": [{"erasureCoded": [{"poolId": "p10771105546308032398", "profileld": "1"}], "retention": {"after": 0}}], "proposed": false, "referenceTime": "ingestTime", "schemaVersion": "1.0", "version": "1.0"}

Авторы

  • Denis Magel (@dmagel-netapp)

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

  • Домашняя страница
  • Репозиторий (исходный код)

© 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_ilm_rule_module.html

Spec-Zone.ru

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