dellemc.openmanage.ome_chassis_slots модуль — Переименование слотов накопителей на OpenManage Enterprise Modular

Примечание

Этот модуль является частью коллекции dellemc.openmanage (версия 9.7.0).

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

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

Чтобы использовать его в playbook, укажите: dellemc.openmanage.ome_chassis_slots.

Добавлен в dellemc.openmanage 3.6.0

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

Описание

Этот модуль позволяет переименовать слоты накопителей на OpenManage Enterprise Modular, используя идентификатор устройства или тег службы устройства, или используя тег службы шасси и номер слота.

Требования

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

python >= 3.9.6

Параметры

Параметр	Комментарии
ca_path путь добавлено в dellemc.openmanage 5.0.0	Файл Privacy Enhanced Mail (PEM), содержащий сертификат CA для проверки.
device_options список / элементы=словарь	Идентификатор или тег службы sled в слоте и новое имя для слота. device_options взаимоисключает slot_options.
device_id целое число	Идентификатор устройства sled в слоте. Взаимоисключает device_service_tag.
device_service_tag строка	Тег службы sled в слоте. Взаимоисключает device_id.
slot_name строка / обязательно	Укажите имя для слота.
hostname строка / обязательно	IP-адрес или имя хоста OpenManage Enterprise Modular.
password строка	Пароль OpenManage Enterprise Modular. Если пароль не предоставлен, используется переменная среды `OME_PASSWORD`. Пример: export OME_PASSWORD=пароль
port целое число	Порт HTTPS OpenManage Enterprise Modular. Значение по умолчанию: `443`
slot_options список / элементы=словарь	Тег службы шасси, номер слота, подлежащего переименованию, и новое имя слота. slot_options взаимоисключает device_options.
chassis_service_tag строка / обязательно	Тег службы шасси.
slots список / элементы=словарь / обязательно	Номер слота и новое имя для слота.
slot_name строка / обязательно	Укажите имя для слота.
slot_number целое число / обязательно	Номер слота, подлежащего переименованию.
timeout целое число добавлено в dellemc.openmanage 5.0.0	Таймаут уровня сокета в секундах. Значение по умолчанию: `30`
username строка	Имя пользователя OpenManage Enterprise Modular. Если имя пользователя не предоставлено, используется переменная среды `OME_USERNAME`. Пример: export OME_USERNAME=имя_пользователя
validate_certs булево добавлено в dellemc.openmanage 5.0.0	Если `false`, сертификаты SSL не будут проверены. Настраивайте `false` только на контролируемых вами сайтах, где используются самозаверенные сертификаты. До версии сборки `5.0.0`, validate_certs был `false` по умолчанию. Варианты: `false` `true` ← (по умолчанию)
x_auth_token строка добавлено в dellemc.openmanage 9.3.0	Токен аутентификации. Если x_auth_token не предоставлен, используется переменная среды `OME_X_AUTH_TOKEN`. Пример: export OME_X_AUTH_TOKEN=x_auth_token

Примечания

Примечание

Этот модуль запускает задачу обновления инвентаризации. Новые имена могут отобразиться через минуту. Если задача обновления занимает более 300 секунд, она завершится по таймауту.
Запускайте этот модуль с системы, имеющей прямой доступ к Dell OpenManage Enterprise Modular.
Этот модуль поддерживает check_mode.

Примеры

---
- name: Rename the slots in multiple chassis using slot number and chassis service tag
  dellemc.openmanage.ome_chassis_slots:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    slot_options:
      - chassis_service_tag: ABC1234
        slots:
          - slot_number: 1
            slot_name: sled_name_1
          - slot_number: 2
            slot_name: sled_name_2
      - chassis_service_tag: ABC1235
        slots:
          - slot_number: 1
            slot_name: sled_name_1
          - slot_number: 2
            slot_name: sled_name_2

- name: Rename single slot name of the sled using sled ID
  dellemc.openmanage.ome_chassis_slots:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    device_options:
      - device_id: 10054
        slot_name: slot_device_name_1

- name: Rename single slot name of the sled using sled service tag
  dellemc.openmanage.ome_chassis_slots:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    device_options:
      - device_service_tag: ABC1234
        slot_name: service_tag_slot

- name: Rename multiple slot names of the devices
  dellemc.openmanage.ome_chassis_slots:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    device_options:
      - device_id: 10054
        slot_name: sled_name_1
      - device_service_tag: ABC1234
        slot_name: sled_name_2
      - device_id: 10055
        slot_name: sled_name_3
      - device_service_tag: PQR1234
        slot_name: sled_name_4

Значения возврата

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

Ключ	Описание
error_info словарь	Подробности об ошибке HTTP. Возвращается: при ошибке HTTP Пример: {"error": {"@Message.ExtendedInfo": [{"Message": "Unable to complete the operation because an invalid value is entered for the property Invalid json type: STRING for Edm.Int64 property: Id .", "MessageArgs": ["Invalid json type: STRING for Edm.Int64 property: Id"], "MessageId": "CGEN1014", "RelatedProperties": [], "Resolution": "Enter a valid value for the property and retry the operation. For more information about valid values, see the OpenManage Enterprise-Modular User's Guide available on the support site.", "Severity": "Critical"}], "code": "Base.1.0.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information."}}
msg строка	Общий статус операции переименования слота. Возвращается: всегда Пример: `"Successfully renamed the slot(s)."`
rename_failed_slots список / элементы=словарь	Информация о корректных слотах, которые не были переименованы. `JobStatus` отображается, если работа по переименованию завершается ошибкой. `NOTE` Перечислены только слоты, которые не были переименованы. Возвращается: если хотя бы одно переименование слота завершается ошибкой Пример: `[{"ChassisId": "12345", "ChassisName": "MX-ABCD123", "ChassisServiceTag": "ABCD123", "DeviceType": "4000", "JobId": 1234, "JobStatus": "Aborted", "SlotId": "10061", "SlotName": "c2", "SlotNumber": "1", "SlotType": "4000"}, {"ChassisId": "10053", "ChassisName": "MX-PQRS123", "ChassisServiceTag": "PQRS123", "DeviceType": "1000", "JobId": 0, "JobStatus": "HTTP Error 400: Bad Request", "SlotId": "10069", "SlotName": "b2", "SlotNumber": "3", "SlotType": "2000"}]`
slot_info список / элементы=словарь	Информация о слотах, успешно переименованных. Параметры `DeviceServiceTag` и `DeviceId` доступны только при использовании device_options. `NOTE` Перечислены только переименованные слоты. Возвращается: если хотя бы один слот был переименован Пример: [{"ChassisId": 10053, "ChassisServiceTag": "ABCD123", "DeviceName": "", "DeviceType": 1000, "JobId": 15746, "SlotId": "10072", "SlotName": "slot_op2", "SlotNumber": "6", "SlotType": 2000}, {"ChassisId": 10053, "ChassisName": "MX-ABCD123", "ChassisServiceTag": "ABCD123", "DeviceType": "3000", "JobId": 15747, "SlotId": "10070", "SlotName": "slot_op2", "SlotNumber": "4", "SlotType": "2000"}, {"ChassisId": "10053", "ChassisName": "MX-PQRS123", "ChassisServiceTag": "PQRS123", "DeviceId": "10054", "DeviceServiceTag": "XYZ5678", "DeviceType": "1000", "JobId": 15761, "SlotId": "10067", "SlotName": "a1", "SlotNumber": "1", "SlotType": "2000"}]

Авторы

Jagadeesh N V(@jagadeeshnv)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/dellemc/openmanage/ome_chassis_slots_module.html