# ucs_service_profile_template – Configures Service Profile Templates on Cisco UCS Manager

New in version 2.8.

- Synopsis
- Requirements
- Parameters
- Examples
- Status

## Synopsis

- Configures Service Profile Templates on Cisco UCS Manager.
- Examples can be used with the UCS Platform Emulator https://communities.cisco.com/ucspe.

## Requirements

The below requirements are needed on the host that executes this module.

- ucsmsdk

## Parameters

Parameter | Choices/Defaults | Comments
--- | --- | ---
bios_policy - |  | The name of the BIOS policy you want to associate with service profiles created from this template.
boot_policy - | Default: "default" | The name of the boot order policy you want to associate with service profiles created from this template.
description - |  | A user-defined description of the service profile template. Enter up to 256 characters. You can use any characters or spaces except the following: ` (accent mark), (backslash), ^ (carat), " (double quote), = (equal sign), > (greater than), < (less than), or ' (single quote). aliases: descr
graphics_card_policy - |  | The name of the graphics card policy you want to associate with service profiles created from this template.
host_firmware_package - |  | The name of the host firmware package you want to associate with service profiles created from this template.
hostname string / required |  | IP address or hostname of Cisco UCS Manager.
ipmi_access_profile - |  | The name of the IPMI access profile you want to associate with service profiles created from this template.
iqn_pool - |  | The name of the IQN pool (initiator) you want to apply to all iSCSI vNICs for service profiles created from this template.
kvm_mgmt_policy - |  | The name of the KVM management policy you want to associate with service profiles created from this template.
lan_connectivity_policy - |  | The name of the LAN connectivity policy you want to associate with service profiles created from this template.
local_disk_policy - |  | The name of the local disk policy you want to associate with service profiles created from this template.
maintenance_policy - |  | The name of the maintenance policy you want to associate with service profiles created from this template.
mgmt_inband_pool_name - |  | How the inband management IPv4 address is derived for the server associated with this service profile.

mgmt_interface_mode
-

Choices:
- in-band

The Management Interface you want to assign to service profiles created from this template.

mgmt_ip_pool - | Default: "ext-mgmt" | The name of the management IP pool you want to use with service profiles created from this template.
mgmt_vnet_name - |  | A VLAN selected from the associated VLAN group.
name - / required |  | The name of the service profile template. This name can be between 2 and 32 alphanumeric characters. You cannot use spaces or any special characters other than - (hyphen), "_" (underscore), : (colon), and . (period). This name must be unique across all service profiles and service profile templates within the same organization.
org_dn - | Default: "org-root" | Org dn (distinguished name)
password string / required |  | Password for Cisco UCS Manager authentication.
port integer |  | Port number to be used during connection (by default uses 443 for https and 80 for http connection).
power_control_policy - | Default: "default" | The name of the power control policy you want to associate with service profiles created from this template.

power_state
-

Choices:
- up ←
- down

The power state to be applied when a service profile created from this template is associated with a server.

power_sync_policy - |  | The name of the power sync policy you want to associate with service profiles created from this template.
proxy string |  | If use_proxy is no, specfies proxy to be used for connection. e.g. 'http://proxy.xy.z:8080'
san_connectivity_policy - |  | The name of the SAN connectivity policy you want to associate with service profiles created from this template.
scrub_policy - |  | The name of the scrub policy you want to associate with service profiles created from this template.
server_pool - |  | The name of the server pool you want to associate with this service profile template.
server_pool_qualification - |  | The name of the server pool policy qualification you want to use for this service profile template.
sol_policy - |  | The name of the Serial over LAN (SoL) policy you want to associate with service profiles created from this template.

state
-

Choices:
- present ←
- absent

If `present`, will verify Service Profile Templates are present and will create if needed.
If `absent`, will verify Service Profile Templates are absent and will delete if needed.

storage_profile - |  | The name of the storage profile you want to associate with service profiles created from this template

template_type
-

Choices:
- initial-template ←
- updating-template

The template type field which can be one of the following:
initial-template — Any service profiles created from this template are not updated if the template changes.
updating-template — Any service profiles created from this template are updated if the template changes.

threshold_policy - | Default: "default" | The name of the threshold policy you want to associate with service profiles created from this template.

use_proxy
boolean

Choices:
- no
- yes ←

If `no`, will not use the proxy as defined by system environment variable.

use_ssl
boolean

Choices:
- no
- yes ←

If `no`, an HTTP connection will be used instead of the default HTTPS connection.

user_label - |  | The User Label you want to assign to service profiles created from this template.
username string | Default: "admin" | Username for Cisco UCS Manager authentication.

uuid_pool
-

Default:
"default"

Specifies how the UUID will be set on a server associated with a service profile created from this template.
The uuid_pool option can be the name of the UUID pool to use or '' (the empty string).
An empty string will use the UUID assigned to the server by the manufacturer, and the
UUID remains unassigned until a service profile created from this template is associated with a server. At that point,
the UUID is set to the UUID value assigned to the server by the manufacturer. If the service profile is later moved to
a different server, the UUID is changed to match the new server."

vmedia_policy - |  | The name of the vMedia policy you want to associate with service profiles created from this template.

## Examples

    - name: Configure Service Profile Template with LAN/SAN Connectivity and all other options defaulted
      ucs_service_profile_template:
        hostname: 172.16.143.150
        username: admin
        password: password
        name: DEE-Ctrl
        template_type: updating-template
        uuid_pool: UUID-Pool
        storage_profile: DEE-StgProf
        lan_connectivity_policy: Cntr-FC-Boot
        iqn_pool: iSCSI-Boot-A
        san_connectivity_policy: Cntr-FC-Boot
        boot_policy: DEE-vMedia
        maintenance_policy: default
        server_pool: Container-Pool
        host_firmware_package: 3.1.2b
        bios_policy: Docker

    - name: Remove Service Profile Template
      ucs_service_profile_template:
        hostname: 172.16.143.150
        username: admin
        password: password
        name: DEE-Ctrl
        state: absent

## Status

- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]

### Authors

- David Soper (@dsoper2)
- CiscoUcs (@CiscoUcs)

Hint

If you notice any issues in this documentation, you can edit this document to improve it.