intersight_rest_api – REST API настройка для Cisco Intersight

Новая версия с 2.8.

Обзор
Параметры
Примеры
Возвращаемые значения
Статус

Обзор

Прямая настройка REST API для Cisco Intersight.
Все ресурсы и свойства REST API должны быть указаны.
Для получения дополнительной информации посетите Cisco Intersight.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_body словарь		Загрузка для запросов API, используемых для изменения ресурсов.
api_key_id строка / обязательно		Идентификатор публичного API ключа, связанный с закрытым ключом.
api_private_key путь / обязательно		Имя файла (полный путь) файла в формате PEM, содержащего ваш закрытый ключ, используемый для аутентификации API Intersight.
api_uri строка	По умолчанию: "https://intersight.com/api/v1"	URI, используемый для доступа к API Intersight.
query_params словарь		Параметры запроса для языка запросов API Intersight.
resource_path строка / обязательно		URI ресурса, настроенного в отношении api_uri.
state -	Варианты: present ← absent	Если `present`, проверит, присутствует ли ресурс, и создаст его при необходимости. Если `absent`, проверит, отсутствует ли ресурс, и удалит его при необходимости.
update_method строка	Варианты: patch ← post	Метод HTTP, используемый для операций обновления. Некоторые ресурсы Intersight требуют операций POST для модификаций.
use_proxy логическое значение	Варианты: нет да ←	Если `no`, прокси не будет использоваться, даже если он определён в переменной среды на целевых хостах.
validate_certs логическое значение	Варианты: нет да ←	Логическое управление проверкой сертификата TLS api_uri

Примеры

- name: Configure Boot Policy
  intersight_rest_api:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    api_key_uri: "{{ api_key_uri }}"
    validate_certs: "{{ validate_certs }}"
    resource_path: /boot/PrecisionPolicies
    query_params:
      $filter: "Name eq 'vmedia-localdisk'"
    api_body: {
      "Name": "vmedia-hdd",
      "ConfiguredBootMode": "Legacy",
      "BootDevices": [
        {
          "ObjectType": "boot.VirtualMedia",
          "Enabled": true,
          "Name": "remote-vmedia",
          "Subtype": "cimc-mapped-dvd"
        },
        {
          "ObjectType": "boot.LocalDisk",
          "Enabled": true,
          "Name": "localdisk",
          "Slot": "MRAID",
          "Bootloader": null
        }
      ],
    }
    state: present

- name: Delete Boot Policy
  intersight_rest_api:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    api_key_uri: "{{ api_key_uri }}"
    validate_certs: "{{ validate_certs }}"
    resource_path: /boot/PrecisionPolicies
    query_params:
      $filter: "Name eq 'vmedia-localdisk'"
    state: absent

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

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

Ключ	Возвращается	Описание
api_repsonse словарь	всегда	Вывод ответа API, возвращаемый указанным ресурсом. Пример: {'api_response': {'BootDevices': [{'Enabled': True, 'Name': 'remote-vmedia', 'ObjectType': 'boot.VirtualMedia', 'Subtype': 'cimc-mapped-dvd'}, {'Bootloader': None, 'Enabled': True, 'Name': 'boot-lun', 'ObjectType': 'boot.LocalDisk', 'Slot': 'MRAID'}], 'ConfiguredBootMode': 'Legacy', 'Name': 'vmedia-localdisk', 'ObjectType': 'boot.PrecisionPolicy'}}

Статус

Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

David Soper (@dsoper2)
CiscoUcs (@CiscoUcs)

Подсказка

Если вы заметите какие-либо проблемы в данной документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/intersight_rest_api_module.html