Модуль 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 / обязательный |
Оператор для сопоставления бакета(ов) со значением Варианты:
|
|
value string / обязательный |
Строковое значение для сопоставления бакета(ов) с указанным оператором |
description string | Краткое описание назначения правила ILM |
filters list / элементы=dictionary | Критерии фильтрации, используемые для определения того, следует ли применить правило ILM к проверяемому объекту. Правило ILM без фильтров применяется ко всем объектам По умолчанию: |
|
criteria list / элементы=dictionary |
Группа логических условий, основанных на метаданных объекта |
|
metadataName string / обязательный |
Идентификатор системных метаданных, имя пользовательских метаданных или имя тега |
|
metadataType string |
Указывает тип фильтруемых метаданных |
|
operator string / обязательный |
Используется для сравнения «metadataName» со строкой «value» Варианты:
|
|
value string |
Значение, с которым сравниваются значения метаданных, указанные параметром metadataName |
|
logicalOperator string |
Логический оператор, связывающий критерии фильтрации, если указано более одного критерия |
ingest_behavior string | Способ хранения объектов, соответствующих этому правилу, при приеме. Режим dual-commit создает временные копии и применяет правило позднее. Режимы strict и balanced немедленно создают копии, указанные в инструкциях правила для дня 0. Режим 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 Варианты:
|
state string | Должно ли указанное правило существовать. Варианты:
|
tenant_account_id string | Идентификаторы одной или нескольких учетных записей арендаторов S3 или Swift, к которым применяется правило ILM Если параметр не указан, правило применяется ко всем объектам |
validate_certs boolean | Следует ли проверять сертификаты HTTPS? Варианты:
|
Примечания
Примечание
- Модули с префиксом
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’. Пример: |
Ссылки на коллекцию
© 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