cisco.intersight.intersight_virtual_media_policy 模块 – 用于 Cisco Intersight 的虚拟介质策略配置

注意

此模块是 cisco.intersight 集合（版本 2.0.20）的一部分。

如果您正在使用 ansible 包，则可能已安装此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install cisco.intersight。

要在 playbook 中使用它，请指定：cisco.intersight.intersight_virtual_media_policy。

概要

• 用于 Cisco Intersight 的虚拟介质策略配置。

• 用于在 Cisco Intersight 管理的设备上配置虚拟介质映像映射。

• 有关更多信息，请参见 Cisco Intersight。

参数

参数	注释
api_key_id 字符串 / 必需	与私钥关联的公共 API 密钥 ID。 如果未设置，则使用 INTERSIGHT_API_KEY_ID 环境变量的值。
api_private_key 路径 / 必需	用于 Intersight API 身份验证的 PEM 格式私钥数据的绝对路径文件名或字符串。 如果使用字符串，则应使用 Ansible vault 加密字符串数据。 例如：ansible-vault encrypt_string –vault-id tme@/Users/dsoper/Documents/vault_password_file ‘—–BEGIN EC PRIVATE KEY—– <您的私钥数据> —–END EC PRIVATE KEY—–’ 如果未设置，则使用 INTERSIGHT_API_PRIVATE_KEY 环境变量的值。
api_uri 字符串	用于访问 Intersight API 的 URI。 如果未设置，则使用 INTERSIGHT_API_URI 环境变量的值。 默认值： "https://intersight.com/api/v1"
cdd_virtual_media 字典	CDD 虚拟介质映像映射选项。
authentication_protocol 字符串	CIFS 挂载类型的身份验证协议 默认值： "none"
enable 布尔值	启用或禁用 CDD 映像映射。 选项 false true ←（默认值）
mount_options 字符串	虚拟介质映射的挂载选项。 对于 NFS，支持的选项有 ro、rw、nolock、noexec、soft、port=VALUE、timeo=VALUE、retry=VALUE 对于 CIFS，支持的选项有 soft、nounix、noserverino、guest
mount_type 字符串 / 必需	remote_hostname 使用的网络共享的类型（协议）。 确保可以从托管端点访问您选择的挂载类型的 remote_hostname 通信端口。 对于作为挂载类型的 CIFS，请确保可以访问 remote_hostname 上的端口 445（这是它的通信端口）。 对于 HTTP，请确保可以访问端口 80。 对于 HTTPS，请确保可以访问端口 443。 对于 NFS，请确保可以访问端口 2049。 选项 "nfs" "cifs" "http" "https"
password 字符串	如果需要，所选用户名的密码。
remote_file 字符串 / 必需	远程映像的文件名。 例如：custom_image.iso
remote_hostname 字符串 / 必需	托管虚拟介质映像的服务器的主机名或 IP 地址。
remote_path 字符串 / 必需	远程映像的文件路径（不包括文件名）。 例如：mnt/SHARE/ISOS
username 字符串	如果需要，指定挂载类型的用户名。
volume 字符串 / 必需	为映射挂载的映像的用户定义名称。
description 别名：descr 字符串	NTP 策略的用户定义描述。 描述可以包含字母 (a-z、A-Z)、数字 (0-9)、连字符 (-)、句点 (.)、冒号 (:) 或下划线 (_)。
enable 布尔值	启用或禁用虚拟介质。 选项 false true ←（默认值）
encryption 布尔值	如果启用，则允许加密所有虚拟介质通信 选项 false ←（默认值） true
hdd_virtual_media 字典	HDD 虚拟介质映像映射选项。
authentication_protocol 字符串	CIFS 挂载类型的身份验证协议 默认值： "none"
enable 布尔值	启用或禁用 HDD 映像映射。 选项 false true ←（默认值）
mount_options 字符串	虚拟介质映射的挂载选项。 对于 NFS，支持的选项有 ro、rw、nolock、noexec、soft、port=VALUE、timeo=VALUE、retry=VALUE 对于 CIFS，支持的选项有 soft、nounix、noserverino、guest
mount_type 字符串 / 必需	remote_hostname 使用的网络共享的类型（协议）。 确保可以从托管端点访问您选择的挂载类型的 remote_hostname 通信端口。 对于作为挂载类型的 CIFS，请确保可以访问 remote_hostname 上的端口 445（这是它的通信端口）。 对于 HTTP，请确保可以访问端口 80。 对于 HTTPS，请确保可以访问端口 443。 对于 NFS，请确保可以访问端口 2049。 选项 "nfs" "cifs" "http" "https"
password 字符串	如果需要，所选用户名的密码。
remote_file 字符串 / 必需	远程映像的文件名。 例如：custom_image.iso
remote_hostname 字符串 / 必需	托管虚拟介质映像的服务器的主机名或 IP 地址。
remote_path 字符串 / 必需	远程映像的文件路径（不包括文件名）。 例如：mnt/SHARE/ISOS
username 字符串	如果需要，指定挂载类型的用户名。
volume 字符串 / 必需	为映射挂载的映像的用户定义名称。
low_power_usb 布尔值	如果启用，虚拟驱动器会在映射映像并重新启动主机后出现在启动选择菜单中。 选项 false true ←（默认值）
name 字符串 / 必需	分配给 NTP 策略的名称。 该名称必须介于 1 到 62 个字母数字字符之间，允许特殊字符 :-_。
organization 字符串	此资源分配到的组织的名称。 在自定义组织中创建的配置文件和策略仅适用于同一组织中的设备。 默认值： "default"
state 字符串	如果 present，将验证资源是否存在，并在需要时创建。 如果 absent，将验证资源不存在，如果需要则会删除。 选项 "present" ← (默认) "absent"
标签 列表 / 元素=字典	以键：<用户定义的键> 值：<用户定义的值> 格式的标签列表。
use_proxy 布尔值	如果为 no，则即使目标主机上的环境变量中定义了代理，也不会使用代理。 选项 false true ←（默认值）
validate_certs 布尔值	用于验证 api_uri TLS 证书的布尔控制。 选项 false true ←（默认值）

示例

- name: Configure Virtual Media Policy
  cisco.intersight.intersight_virtual_media_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: DevNet
    name: lab-vmedia
    description: Virutal Media policy for lab use
    tags:
      - Key: Site
        Value: RCDN
    cdd_virtual_media:
      mount_type: nfs
      volume: nfs-cdd
      remote_hostname: 172.28.224.77
      remote_path: mnt/SHARE/ISOS/CENTOS
      remote_file: CentOS7.iso
    hdd_virtual_media:
      mount_type: nfs
      volume: nfs-hdd
      remote_hostname: 172.28.224.77
      remote_path: mnt/SHARE/ISOS/CENTOS
      remote_file: CentOS7.iso

- name: Delete Virtual Media Policy
  cisco.intersight.intersight_virtual_media_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: DevNet
    name: lab-vmedia
    state: absent

返回值

常见返回值请参考此处，以下是此模块特有的字段

键	描述
api_repsonse 字典	指定资源返回的 API 响应输出。 返回： 总是 示例： {"api_response": {"Name": "lab-ntp", "ObjectType": "ntp.Policy", "Tags": [{"Key": "Site", "Value": "RCDN"}]}}

作者

• David Soper (@dsoper2)

• Sid Nath (@SidNath21)

集合链接

• 问题跟踪器
• 仓库 (源代码)