netapp.ontap.na_ontap_zapit – NetApp ONTAP Run any ZAPI on ONTAP

• Обзор
• Требования
• Параметры
• Примечания
• Примеры
• Возвращаемые значения

Обзор

• Вызов ZAPI на ONTAP.
• Кластерные ZAPI выполняются с использованием учетной записи администратора кластера.
• ZAPI виртуального сервера могут выполняться с использованием учетной записи vsadmin или с использованием туннелирования виртуального сервера (администратор кластера с опцией vserver).
• В случае успеха возвращается словарь JSON, как response.
• В случае ошибки ZAPI, status, errno, reason устанавливаются для помощи в диагностике проблемы,
• и вызов сообщается как ошибка ('failed').
• Другие ошибки (например, проблемы с подключением) сообщаются как ошибка Ansible.

Требования

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

• Физическая или виртуальная кластеризованная система Data ONTAP. Модули поддерживают Data ONTAP 9.1 и выше.
• Поддержка REST требует ONTAP 9.6 или более поздней версии.
• Ansible 2.6
• Ansible 2.9 или более поздней версии рекомендуется, так как она позволяет использовать новую систему доставки коллекций.
• Python2 netapp-lib (2017.10.30) или более поздняя версия. Установка с помощью 'pip install netapp-lib'
• Python3 netapp-lib (2018.11.13) или более поздняя версия. Установка с помощью 'pip install netapp-lib'
• netapp-lib 2020.3.12 настоятельно рекомендуется, так как он обеспечивает лучшую отчетность об ошибках при подключении.
• Для включения http в кластере необходимо выполнить следующие команды: «set -privilege advanced»; «system services web modify -http-enabled true»;

Параметры

Примечания

Примеры

-
  name: Ontap ZAPI
  hosts: localhost
  gather_facts: False
  collections:
    - netapp.ontap
  vars:
    login: &login
      hostname: "{{ admin_ip }}"
      username: "{{ admin_username }}"
      password: "{{ admin_password }}"
      https: true
      validate_certs: false
    svm_login: &svm_login
      hostname: "{{ svm_admin_ip }}"
      username: "{{ svm_admin_username }}"
      password: "{{ svm_admin_password }}"
      https: true
      validate_certs: false

  tasks:
    - name: run ontap ZAPI command as cluster admin
      na_ontap_zapit:
        <<: *login
        zapi:
          system-get-version:
      register: output
    - debug: var=output

    - name: run ontap ZAPI command as cluster admin
      na_ontap_zapit:
        <<: *login
        zapi:
          vserver-get-iter:
      register: output
    - debug: var=output

    - name: run ontap ZAPI command as cluster admin
      na_ontap_zapit:
        <<: *login
        zapi:
          vserver-get-iter:
            desired-attributes:
              vserver-info:
                - aggr-list:
                    - aggr-name
                - allowed-protocols:
                    - protocols
                - vserver-aggr-info-list:
                    - vserser-aggr-info
                - uuid
            query:
              vserver-info:
                vserver-name: trident_svm
      register: output
    - debug: var=output

    - name: run ontap ZAPI command as vsadmin
      na_ontap_zapit:
        <<: *svm_login
        zapi:
          vserver-get-iter:
            desired-attributes:
              vserver-info:
                - uuid
      register: output
    - debug: var=output

    - name: run ontap ZAPI command as vserver tunneling
      na_ontap_zapit:
        <<: *login
        vserver: trident_svm
        zapi:
          vserver-get-iter:
            desired-attributes:
              vserver-info:
                - uuid
      register: output
    - debug: var=output

    - name: run ontap active-directory ZAPI command
      na_ontap_zapit:
        <<: *login
        vserver: trident_svm
        zapi:
          active-directory-account-create:
            account-name: testaccount
            admin-username: testuser
            admin-password: testpass
            domain: testdomain
            organizational-unit: testou
      register: output
      ignore_errors: True
    - debug: var=output

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

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

Авторы

• Команда Ansible NetApp (@carchi8py) <ng-ansibleteam@netapp.com>