Spec-Zone.ru › Ansible

Модуль netapp.ontap.na_ontap_s3_services — сервисы NetApp ONTAP S3

Примечание

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

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

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

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

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

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

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

  • Создание, удаление или изменение сервиса S3

Требования

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

  • 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

string

добавлено в netapp.ontap 20.6.0

Путь к файлу сертификата клиента SSL (.pem).

Не поддерживается в Python 2.6.

certificate_name

string

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

comment

string

Комментарий о сервисе

enabled

boolean

Включение или отключение сервиса

Варианты:

  • false
  • true

feature_flags

dictionary

добавлено в netapp.ontap 20.5.0

Включение или отключение новой функции.

Этот параметр можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость.

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

force_ontap_version

string

добавлено в netapp.ontap 21.23.0

Переопределение версии ONTAP кластера при использовании REST.

Поведение не определено, если версия не совпадает с версией целевого кластера.

Этот параметр предназначен для обхода ситуации, когда невозможно прочитать версию кластера из-за проблем с разрешениями. См. https://github.com/ansible-collections/netapp.ontap/wiki/Known-issues.

Значение должно иметь вид 9.10 или 9.10.1, где каждый элемент — целое число.

hostname

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

Имя хоста или IP-адрес экземпляра ONTAP.

http_port

integer

Переопределение порта по умолчанию (80 или 443) этим портом

https

boolean

Включение и отключение HTTPS.

Игнорируется при использовании REST, поскольку поддерживается только HTTPS.

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

Варианты:

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

is_http_enabled

boolean

добавлено в netapp.ontap 22.13.0

Указывает, включен ли HTTP на создаваемом или изменяемом сервере S3

Варианты:

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

is_https_enabled

boolean

добавлено в netapp.ontap 22.13.0

Указывает, включен ли HTTPS на создаваемом или изменяемом сервере S3

Варианты:

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

key_filepath

string

добавлено в netapp.ontap 20.6.0

Путь к файлу ключа клиента SSL.

lambda_config

dictionary

добавлено в netapp.ontap 23.4.0

Параметры конфигурации функции прокси AWS Lambda.

Этот параметр и его вложенные параметры поддерживаются только при использовании REST.

aws_profile

string

Имя профиля AWS, используемого для аутентификации.

aws_region

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

Имя региона AWS.

function_name

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

Имя вызываемой функции AWS Lambda.

name

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

Имя сервиса S3.

password

псевдонимы: pass

string

Пароль указанного пользователя.

port

integer

добавлено в netapp.ontap 22.13.0

Указывает порт HTTP-прослушивателя для сервера S3

По умолчанию: 80

secure_port

integer

добавлено в netapp.ontap 22.13.0

Указывает порт HTTPS-прослушивателя для сервера S3

По умолчанию: 443

state

string

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

Варианты:

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

use_lambda

boolean

добавлено в netapp.ontap 23.4.0

Указывает, следует ли использовать функцию прокси AWS Lambda для подключения к системе ONTAP.

Поддерживается только при использовании REST.

Варианты:

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

use_rest

string

Этот модуль поддерживает только REST.

always — всегда использовать REST API. Если модуль не поддерживает REST, выводится предупреждение.

По умолчанию: "always"

username

псевдонимы: user

string

Это может быть учетная запись уровня кластера или уровня SVM — в зависимости от того, требуется ли API уровня кластера или уровня SVM.

Дополнительную информацию см. в документации: https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html.

Поддерживаются два метода аутентификации

  1. Базовая аутентификация с использованием имени пользователя и пароля.
  2. Аутентификация с сертификатом SSL с использованием файла сертификата клиента SSL и, при необходимости, файла закрытого ключа.

Для использования сертификата его необходимо установить в кластере ONTAP и включить аутентификацию по сертификату.

validate_certs

boolean

Если задано значение no, сертификаты SSL проверяться не будут.

Задавать это значение следует только для False на контролируемых вами сайтах, использующих самоподписанные сертификаты.

Варианты:

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

vserver

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

Имя используемого vserver.

Примечания

Примечание

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

Примеры

- name: Create or modify s3 service
  netapp.ontap.na_ontap_s3_services:
    state: present
    name: carchi-test
    vserver: ansibleSVM
    comment: not enabled
    enabled: false
    certificate_name: ansibleSVM_16E1C1284D889609
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: false
    use_rest: always

- name: Create or modify s3 service with https
  netapp.ontap.na_ontap_s3_services:
    state: present
    name: carchi-test
    vserver: ansibleSVM
    comment: not enabled
    enabled: true
    is_https_enabled: true
    port: 80
    certificate_name: ansibleSVM_16E1C1284D889609
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: false
    use_rest: always

- name: Delete s3 service
  netapp.ontap.na_ontap_s3_services:
    state: absent
    name: carchi-test
    vserver: ansibleSVM
    certificate_name: ansibleSVM_16E1C1284D889609
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: false
    use_rest: always

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

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

Ключ

Описание

s3_service_info

dictionary

Возвращает ответ сервиса S3.

Возвращается: при создании или изменении сервиса S3

Пример: "{ \"s3_service_info\": { \"name\": \"Service1\", \"enabled\": false, \"certificate_name\": \"testSVM_177966509ABA4EC6\", \"users\": [{\"name\": \"root\"}, {\"name\": \"user1\", \"access_key\": \"IWE711019OW02ZB3WH6Q\"}], \"svm\": {\"name\": \"testSVM\", \"uuid\": \"39c2a5a0-35e2-11ee-b8da-005056b37403\"}} } }"

Авторы

  • Команда 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_services_module.html

Spec-Zone.ru

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