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.

Требования

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

• Ansible 2.9
• Python3 netapp-lib (2018.11.13) или новее. Установите с помощью ‘pip install netapp-lib’
• netapp-lib 2020.3.12 настоятельно рекомендуется, поскольку он обеспечивает лучшую отчетность об ошибках при подключении.
• Физическая или виртуальная кластеризованная система Data ONTAP. Модули поддерживают Data ONTAP 9.1 и новее.
• Поддержка REST требует ONTAP 9.6 или новее.
• Для включения 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>