cisco.ucs.ucs_service_profile_association 模块 – 在 Cisco UCS Manager 上配置服务配置文件关联

注意

此模块是 cisco.ucs 集合 (版本 1.14.0) 的一部分。

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

要安装它，请使用：ansible-galaxy collection install cisco.ucs。您需要其他要求才能使用此模块，请参阅 要求 了解详细信息。

要在剧本中使用它，请指定：cisco.ucs.ucs_service_profile_association。

概要

  • 在 Cisco UCS Manager 上配置服务配置文件关联（更改关联或取消关联）。

要求

执行此模块的主机需要满足以下要求。

  • ucsmsdk

参数

参数

注释

hostname

字符串 / 必需

Cisco UCS Manager 的 IP 地址或主机名。

模块可以与 UCS 平台仿真器 https://cs.co/ucspe 一起使用

org_dn

字符串

分配资源的组织的 distinguished name (dn)。

默认值： "org-root"

password

字符串 / 必需

Cisco UCS Manager 身份验证的密码。

port

整数

连接期间要使用的端口号（默认情况下，https 连接使用 443，http 连接使用 80）。

proxy

字符串

如果 use_proxy 为 no，则指定用于连接的代理。例如 ‘http://proxy.xy.z:8080’

restrict_migration

字符串

限制服务配置文件在与服务器关联后迁移。

如果设置为 no，则 Cisco UCS Manager 在迁移现有服务配置文件之前不会对新服务器执行任何兼容性检查。

如果设置为 no 并且迁移中使用的两台服务器的硬件不相似，则关联可能会失败。

选择

  • "yes"

  • "no" ← (默认)

server_assignment

字符串

指定如何使用以下选择将服务器与此服务配置文件关联

server - 用于预配置槽或选择现有服务器。槽或服务器由 server_dn 选项指定。

pool - 用于从服务器池中选择。server_pool 选项指定要使用的服务器池的名称。

如果服务配置文件绑定到模板，则该选项无效。

如果状态为 absent，则可选。

选择

  • "server"

  • "pool"

server_dn

字符串

用于预配置或选择现有服务器的服务器对象的 Distinguished Name (dn)。

如果 server_assignment 选项为 server，则为必需。

如果状态为 absent，则可选。

server_pool_name

字符串

用于基于服务器池分配的服务器池的名称。

如果 server_assignment 选项为 pool，则为必需。

如果状态为 absent，则可选。

service_profile_name

字符串 / 必需

正在关联或取消关联的服务配置文件的名称。

state

字符串

如果 present，将验证服务配置文件关联，并在需要时与指定的服务器或服务器池关联。

如果 absent，将验证服务配置文件未关联，并在需要时取消关联。这与在 webUI 中指定稍后分配相同。

选择

  • "present" ← (默认)

  • "absent"

use_proxy

布尔值

如果 no，则不会使用系统环境变量定义的代理。

选择

  • false

  • true ← (默认)

use_ssl

布尔值

如果 no，则将使用 HTTP 连接而不是默认的 HTTPS 连接。

选择

  • false

  • true ← (默认)

username

字符串

Cisco UCS Manager 身份验证的用户名。

默认值： "admin"

示例

- name: Change Service Profile Association to server pool Container-Pool and restrict migration
  cisco.ucs.ucs_service_profile_association:
    hostname: 172.16.143.150
    username: admin
    password: password
    service_profile_name: test-sp
    server_assignment: pool
    server_pool_name: Container-Pool
    restrict_migration: 'yes'

- name: Attempt to change association once a minute for up to 10 minutes
  cisco.ucs.ucs_service_profile_association:
    hostname: 172.16.143.150
    username: admin
    password: password
    service_profile_name: test-sp
    server_assignment: server
    server_dn: sys/chassis-2/blade-1
  register: result
  until: result.assign_state == 'assigned' and result.assoc_state == 'associated'
  retries: 10
  delay: 60

- name: Disassociate Service Profile
  cisco.ucs.ucs_service_profile_association:
    hostname: 172.16.143.150
    username: admin
    password: password
    service_profile_name: test-sp
    state: absent

返回值

常见返回值记录在 此处，以下是此模块特有的字段

键

描述

assign_state

字符串

逻辑服务器分配状态（已分配、未分配或失败）。

返回值： 成功

示例： "assigned"

assoc_state

字符串

逻辑服务器关联状态（已关联或未关联）。

返回值： 成功

示例： "associated"

作者

  • David Soper (@dsoper2)

  • CiscoUcs (@CiscoUcs)