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 yes ←	Если `no`, прокси не будет использоваться, даже если он определён в переменной окружения на целевых хостах.
validate_certs логическое	Варианты: no yes ←	Логическое значение для проверки сертификата 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. [сообщество]

Авторы

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.9/modules/intersight_rest_api_module.html