модуль netapp.ontap.na_ontap_s3_policies — политики S3 NetApp ONTAP

Примечание

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

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

Для установки используйте: ansible-galaxy collection install netapp.ontap. Для использования этого модуля необходимы дополнительные требования; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: netapp.ontap.na_ontap_s3_policies.

Добавлено в netapp.ontap 21.21.0

Краткое описание
Требования
Параметры
Примечания
Примеры

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

Создание, удаление и изменение политик S3 в NetApp ONTAP.

Требования

На узле, выполняющем этот модуль, должны быть соблюдены следующие требования.

Ansible версии 2.9 или более поздней; рекомендуется версия 2.12 или более поздняя.
Python3; рекомендуется версия 3.9 или более поздняя.
netapp-lib требуется только при использовании ZAPI (установите с помощью «pip install netapp-lib»). Обратите внимание: netapp-lib устарел и больше не поддерживается. Используйте на свой страх и риск.
Физическая или виртуальная кластерная система Data ONTAP; модули поддерживают Data ONTAP 9.1 и более поздние версии, для поддержки REST требуется ONTAP 9.6 или более поздняя версия.

Параметры

Параметр	Комментарии
cert_filepath строка добавлено в netapp.ontap 20.6.0	путь к файлу сертификата SSL-клиента (.pem). не поддерживается в Python 2.6.
comment строка	комментарий к политике
feature_flags словарь добавлено в netapp.ontap 20.5.0	Включение или отключение новой функции. Этот параметр можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут изменяться без уведомления. Неизвестные ключи игнорируются.
force_ontap_version строка добавлено в netapp.ontap 21.23.0	Переопределение версии ONTAP кластера при использовании REST. Поведение не определено, если версия не соответствует целевому кластеру. Этот параметр служит обходным решением, если версию кластера не удаётся прочитать из-за проблем с разрешениями. См. https://github.com/ansible-collections/netapp.ontap/wiki/Known-issues. Значение должно иметь вид 9.10 или 9.10.1, причём каждый элемент должен быть целым числом.
hostname строка / обязательный	Имя хоста или IP-адрес экземпляра ONTAP.
http_port целое число	Переопределение порта по умолчанию (80 или 443).
https логическое значение	Включение и отключение HTTPS. Игнорируется при использовании REST, так как поддерживается только HTTPS. Игнорируется при аутентификации с помощью сертификата SSL, так как для неё требуется SSL. Допустимые значения: `false` ← (по умолчанию) `true`
key_filepath строка добавлено в netapp.ontap 20.6.0	путь к файлу ключа SSL-клиента.
lambda_config словарь добавлено в netapp.ontap 23.4.0	Параметры конфигурации для функции прокси AWS Lambda. Этот параметр и вложенные параметры поддерживаются только при использовании REST.
aws_profile строка	Имя профиля AWS, используемого для аутентификации.
aws_region строка / обязательный	Название региона AWS.
function_name строка / обязательный	Имя вызываемой функции AWS Lambda.
name строка / обязательный	Имя политики S3.
password псевдонимы: pass строка	Пароль указанного пользователя.
state строка	Наличие указанной политики S3. Допустимые значения: `"present"` ← (по умолчанию) `"absent"`
statements список / элементы=словарь	Операторы политики формируются с использованием этой структуры для задания разрешений. Предоставьте <Effect>, чтобы разрешить или запретить <Principal> выполнять <Action> над <Resource>, если выполняется условие <Condition>.
actions список / элементы=строка / обязательный	Можно указать *, чтобы выбрать все действия, либо указать одно или несколько действий из следующего списка: GetObject PutObject DeleteObject ListBucket GetBucketAcl GetObjectAcl ListBucketMultipartUploads ListMultipartUploadParts
effect строка / обязательный	Оператор может разрешать или запрещать доступ. Допустимые значения: `"allow"` `"deny"`
resources список / элементы=строка / обязательный	Бакет и все содержащиеся в нём объекты. Для формирования регулярного выражения при указании ресурса можно использовать подстановочные символы * и ?.
sid строка / обязательный	Идентификатор оператора
use_lambda логическое значение добавлено в netapp.ontap 23.4.0	Указывает, следует ли использовать функцию прокси AWS Lambda для подключения к системе ONTAP. Поддерживается только при использовании REST. Допустимые значения: `false` ← (по умолчанию) `true`
use_rest строка	Этот модуль поддерживает только REST. always — всегда использовать REST API. Если модуль не поддерживает REST, будет выдано предупреждение. По умолчанию: `"always"`
username псевдонимы: user строка	Это может быть учётная запись уровня кластера или уровня SVM — в зависимости от того, какой API требуется: уровня кластера или уровня SVM. Дополнительные сведения см. в документации: https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html. Поддерживаются два метода аутентификации: Базовая аутентификация с использованием имени пользователя и пароля. Аутентификация с помощью сертификата SSL: используется файл сертификата SSL-клиента и, при необходимости, файл закрытого ключа. Для использования сертификата он должен быть установлен в кластере ONTAP, а аутентификация по сертификату должна быть включена.
validate_certs логическое значение	Если задано значение `no`, сертификаты SSL не будут проверяться. Устанавливайте это значение только для `False` на контролируемых вами сайтах, где используются самоподписанные сертификаты. Допустимые значения: `false` `true` ← (по умолчанию)
vserver строка / обязательный	Имя используемого vserver.

Примечания

Примечание

Поддерживается функция прокси AWS Lambda. Пример использования см. в README.
Модули с префиксом na_ontap предназначены для поддержки платформы хранения ONTAP.
HTTPS включён по умолчанию и рекомендуется к использованию. Чтобы включить HTTP в кластере, выполните следующие команды: «set -privilege advanced;» «system services web modify -http-enabled true;»

Примеры

- name: Create and modify a S3 policy
  netapp.ontap.na_ontap_s3_policies:
    state: present
    name: carchi-s3-policy
    comment: carchi8py was here
    vserver: ansibleSVM
    statements:
      - sid: 1
        resources:
          - "bucket1"
          - "bucket1/*"
        actions:
          - "*"
        effect:
          allow
      - sid: 2
        resources:
          - "bucket2"
          - "bucket2/*"
        actions:
          - "*"
        effect:
          allow
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: false
    use_rest: always

- name: Delete S3 policy
  netapp.ontap.na_ontap_s3_policies:
    state: absent
    name: carchi-s3-policy
    vserver: ansibleSVM
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: false
    use_rest: always

Авторы

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

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

© 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/ontap/na_ontap_s3_policies_module.html