модуль cisco.intersight.intersight_organization — настройка организации для Cisco Intersight

Примечание

Этот модуль входит в коллекцию cisco.intersight (версия 2.18.0).

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

Чтобы установить ее, используйте: ansible-galaxy collection install cisco.intersight.

Чтобы использовать ее в плейбуке, укажите: cisco.intersight.intersight_organization.

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

Обзор

Управляет настройками организации в Cisco Intersight.
Организации — это ресурсы на уровне учетной записи, используемые для упорядочивания ресурсов Intersight и управления ими.
Поддерживается назначение групп ресурсов для определения области действия ресурсов.
Поддерживается предоставление доступа к ресурсам другим организациям с помощью правил совместного использования.
Подробнее см. в документации Cisco Intersight.

Параметры

Параметр	Комментарии
api_key_id строка / обязательный	Идентификатор открытого ключа API, связанного с закрытым ключом. Если значение не задано, используется значение переменной среды INTERSIGHT_API_KEY_ID.
api_private_key путь / обязательный	Имя файла (абсолютный путь) или строка с данными закрытого ключа в формате PEM для аутентификации в API Intersight. Если используется строка, ее следует зашифровать с помощью Ansible Vault. Например: 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 строка	URI для доступа к API Intersight. Если значение не задано, используется значение переменной среды INTERSIGHT_API_URI. По умолчанию: `"https://intersight.com/api/v1"`
description псевдонимы: descr строка	Описание организации, заданное пользователем.
name строка / обязательный	Имя, присвоенное организации.
resource_groups список / элементы=строка	Список имен групп ресурсов, назначаемых организации. Имена групп ресурсов автоматически преобразуются в их Moid. Несовместимо с `share_resources` и `shared_orgs`.
share_resources логическое значение	Включите этот параметр, чтобы предоставлять доступ к ресурсам другим организациям. Если `true`, используйте `shared_orgs`, чтобы указать организации, которым предоставляется доступ. Несовместимо с `resource_groups`. Варианты: `false` ← (по умолчанию) `true`
shared_orgs список / элементы=строка	Список имен организаций, которым предоставляется доступ к ресурсам. Действительно только при условии, что `share_resources` имеет значение `true`. Имена организаций автоматически преобразуются в их Moid.
state строка	Если `present`, проверяет наличие ресурса и при необходимости создает его. Если `absent`, проверяет отсутствие ресурса и при необходимости удаляет его. Варианты: `"present"` ← (по умолчанию) `"absent"`
use_proxy логическое значение	Если `no`, прокси использоваться не будет, даже если он задан в переменной среды на целевых узлах. Варианты: `false` `true` ← (по умолчанию)
validate_certs логическое значение	Логический параметр для проверки сертификата TLS api_uri Варианты: `false` `true` ← (по умолчанию)

Примеры

- name: Create Organization with Resource Groups
  cisco.intersight.intersight_organization:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "my-organization"
    description: "My organization"
    resource_groups:
      - "my-resource-group"
    state: present

- name: Create Organization with shared resources
  cisco.intersight.intersight_organization:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "shared-org"
    description: "Organization sharing resources"
    share_resources: true
    shared_orgs:
      - "other-org-1"
      - "other-org-2"
    state: present

- name: Create Organization without Resource Groups
  cisco.intersight.intersight_organization:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "simple-org"
    description: "Simple organization"
    state: present

- name: Delete Organization
  cisco.intersight.intersight_organization:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "my-organization"
    state: absent

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

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

Ключ	Описание
api_response словарь	Результат ответа API, возвращенный указанным ресурсом. Возвращается: всегда Пример: `{"api_response": {"Description": "My organization", "Name": "my-organization", "ObjectType": "organization.Organization"}}`

Авторы

Ron Gershburg (@rgershbu)

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

© 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_organization_module.html