Модуль cisco.intersight.intersight_resource_group — настройка группы ресурсов для Cisco Intersight
Примечание
Этот модуль входит в коллекцию cisco.intersight (версия 2.18.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install cisco.intersight.
Чтобы использовать её в плейбуке, укажите: cisco.intersight.intersight_resource_group.
Краткое описание
- Управляет настройкой группы ресурсов в Cisco Intersight.
- Группы ресурсов определяют набор ресурсов, который можно использовать для управления доступом и назначения организации.
- Пользователи указывают управляемые Intersight домены UCS по имени целевого объекта (как показано на странице Targets в Intersight).
- При необходимости можно выбрать определённые серверы (подцелевые объекты) в домене, указав их серийные номера.
- Группы ресурсов относятся к уровню учётной записи и не привязаны к организации.
- Дополнительную информацию см. в разделе Cisco Intersight.
Параметры
Параметр | Комментарии |
|---|---|
api_key_id string / обязательный | Идентификатор открытого API-ключа, связанного с закрытым ключом. Если значение не задано, используется значение переменной среды INTERSIGHT_API_KEY_ID. |
api_private_key path / обязательный | Имя файла (абсолютный путь) или строка с данными закрытого ключа в формате PEM, используемого для аутентификации в Intersight API. Если используется строка, для шифрования строковых данных следует использовать Ansible Vault. Ex. ansible-vault encrypt_string --vault-id tme@/Users/dsoper/Documents/vault_password_file ‘-----BEGIN EC PRIVATE KEY----- <your private key data> -----END EC PRIVATE KEY-----’ Если значение не задано, используется значение переменной среды INTERSIGHT_API_PRIVATE_KEY. |
api_uri string | URI для доступа к Intersight API. Если значение не задано, используется значение переменной среды INTERSIGHT_API_URI. По умолчанию: |
description псевдонимы: descr string | Описание группы ресурсов, заданное пользователем. |
name string / обязательный | Имя, присвоенное группе ресурсов. Имя должно содержать от 1 до 62 буквенно-цифровых символов; допускаются специальные символы :-_. |
resources list / элементы=dictionary | Список ресурсов доменов UCS, управляемых Intersight, которые необходимо включить в группу ресурсов. Обязательный параметр, если Каждая запись задаёт домен по имени целевого объекта, отображаемому на странице Targets в графическом интерфейсе Intersight. Если указан Можно сочетать несколько записей, некоторые из которых содержат подцелевые объекты, а другие — нет. |
|
domain_name string / обязательный |
Имя целевого объекта домена UCS, управляемого Intersight. Должно точно совпадать с именем целевого объекта, отображаемым на странице Targets в Intersight. |
|
sub_targets list / элементы=string |
Список серийных номеров серверов, которые необходимо включить в домен в качестве подцелевых объектов. Если параметр указан, включаются только эти серверы, а не весь домен. Тип серверов (Blades или RackUnits) определяется автоматически с помощью Intersight API. |
state string | Если Если Варианты:
|
tags list / элементы=dictionary | Список тегов в формате «Ключ:<определяемый пользователем ключ> Значение:<определяемое пользователем значение>». |
use_proxy boolean | Если Варианты:
|
validate_certs boolean | Логический параметр, управляющий проверкой TLS-сертификата api_uri Варианты:
|
Примеры
- name: Create Resource Group for full UCS domains
cisco.intersight.intersight_resource_group:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
name: "ucs-domains-group"
description: "Resource group for two UCS domains"
resources:
- domain_name: "ucs-domain-1"
- domain_name: "ucs-domain-2"
state: present
- name: Create Resource Group with sub-targets (specific servers)
cisco.intersight.intersight_resource_group:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
name: "specific-servers-group"
description: "Only specific servers from the domain"
resources:
- domain_name: "ucs-domain-1"
sub_targets:
- "FCH26387BD1"
- "FCH243974ZD"
- "WZP26030TAV"
state: present
- name: Create Resource Group with mixed resources
cisco.intersight.intersight_resource_group:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
name: "mixed-resources-group"
description: "Full domain and specific servers from another"
resources:
- domain_name: "ucs-domain-1"
- domain_name: "ucs-domain-2"
sub_targets:
- "FCH26387BD1"
- "WZP26030TAV"
state: present
- name: Delete Resource Group
cisco.intersight.intersight_resource_group:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
name: "ucs-domains-group"
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
api_response dictionary | Данные ответа API, возвращённые указанным ресурсом. Возвращается: всегда Пример: |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/cisco/intersight/intersight_resource_group_module.html
