cisco.ucs.ucs_disk_group_policy module – Configures disk group policies on Cisco UCS Manager
Note
This module is part of the cisco.ucs collection (version 1.14.0).
You might already have this collection installed if you are using the ansible
package.
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install cisco.ucs
.
You need further requirements to be able to use this module,
see Requirements for details.
To use it in a playbook, specify: cisco.ucs.ucs_disk_group_policy
.
Synopsis
Configures disk group policies on Cisco UCS Manager.
Requirements
The below requirements are needed on the host that executes this module.
ucsmsdk
Parameters
Parameter |
Comments |
---|---|
Disk group configuration mode. Choose one of the following: automatic - Automatically configures the disks in the disk group. manual - Enables you to manually configure the disks in the disk group. Choices:
|
|
The user-defined description of the storage profile. 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). |
|
Specify the drive type to use in the drive group. This can be one of the following: unspecified — Selects the first available drive type, and applies that to all drives in the group. HDD — Hard disk drive SSD — Solid state drive Option only applies when configuration mode is automatic. Choices:
|
|
IP address or hostname of Cisco UCS Manager. Modules can be used with the UCS Platform Emulator https://cs.co/ucspe |
|
List of manually configured disks. Options are only used when you choose manual configuration_mode. |
|
The role of the disk. This can be one of the following: normal - Normal ded-hot-spare - Dedicated Hot Spare glob-hot-spare - Glob Hot Spare Choices:
|
|
The slot number of the specific disk. |
|
The Span ID of the specific disk. Default: |
|
If Choices:
|
|
Specify the minimum drive size or unspecified to allow all drive sizes. This can be from 0 to 10240 GB. Option only applies when configuration mode is automatic. Default: |
|
The name of the disk group policy. This name can be between 1 and 16 alphanumeric characters. You cannot use spaces or any special characters other than - (hyphen), “_” (underscore), : (colon), and . (period). You cannot change this name after the policy is created. |
|
Specify the number of hot spares for the disk group. This can be from 0 to 24. Option only applies when configuration mode is automatic. Default: |
|
Specify the number of drives for the disk group. This can be from 0 to 24. Option only applies when configuration mode is automatic. Default: |
|
Specify the number of global hot spares for the disk group. This can be from 0 to 24. Option only applies when configuration mode is automatic. Default: |
|
The distinguished name (dn) of the organization where the resource is assigned. Default: |
|
Password for Cisco UCS Manager authentication. |
|
Port number to be used during connection (by default uses 443 for https and 80 for http connection). |
|
If use_proxy is no, specfies proxy to be used for connection. e.g. ‘http://proxy.xy.z:8080’ |
|
The RAID level for the disk group policy. This can be one of the following: stripe - UCS Manager shows RAID 0 Striped mirror - RAID 1 Mirrored mirror-stripe - RAID 10 Mirrored and Striped stripe-parity - RAID 5 Striped Parity stripe-dual-parity - RAID 6 Striped Dual Parity stripe-parity-stripe - RAID 50 Striped Parity and Striped stripe-dual-parity-stripe - RAID 60 Striped Dual Parity and Striped Choices:
|
|
Desired state of the disk group policy. If If Choices:
|
|
If Choices:
|
|
Specifies whether you can use all the remaining disks in the disk group or not. Option only applies when configuration mode is automatic. Choices:
|
|
If Choices:
|
|
Username for Cisco UCS Manager authentication. Default: |
|
Configuration of virtual drive options. |
|
Configure access policy to virtual drive. Choices:
|
|
Configure drive caching. Choices:
|
|
Direct or Cached IO path. Choices:
|
|
Read access policy to virtual drive. Choices:
|
|
Virtual drive strip size. Choices:
|
|
Write back cache policy. Choices:
|
Examples
- name: Configure Disk Group Policy
cisco.ucs.ucs_disk_group_policy:
hostname: 172.16.143.150
username: admin
password: password
name: DEE-DG
raid_level: mirror
configuration_mode: manual
manual_disks:
- slot_num: '1'
role: normal
- slot_num: '2'
role: normal
- name: Remove Disk Group Policy
cisco.ucs.ucs_disk_group_policy:
name: DEE-DG
hostname: 172.16.143.150
username: admin
password: password
state: absent
- name: Remove Disk from Policy
cisco.ucs.ucs_disk_group_policy:
hostname: 172.16.143.150
username: admin
password: password
name: DEE-DG
description: Testing Ansible
raid_level: stripe
configuration_mode: manual
manual_disks:
- slot_num: '1'
role: normal
- slot_num: '2'
role: normal
state: absent
virtual_drive:
access_policy: platform-default
io_policy: direct
strip_size: 64KB