mirror of
https://github.com/ansible-collections/community.general.git
synced 2025-04-22 10:21:25 -07:00
[PR #9524/568fcea1 backport][stable-10] pr*: style adjustments (#9560)
pr*: style adjustments (#9524)
* pr*: style adjustments
* revert removal of "null"
* Update plugins/modules/redfish_command.py
* Update plugins/modules/redhat_subscription.py
Co-authored-by: Felix Fontein <felix@fontein.de>
---------
Co-authored-by: Felix Fontein <felix@fontein.de>
(cherry picked from commit 568fcea15e
)
Co-authored-by: Alexei Znamensky <103110+russoz@users.noreply.github.com>
This commit is contained in:
parent
b23d011582
commit
18afa4e8b0
48 changed files with 380 additions and 310 deletions
|
@ -35,8 +35,8 @@ options:
|
|||
agent:
|
||||
description:
|
||||
- Specify if the QEMU Guest Agent should be enabled/disabled.
|
||||
- Since community.general 5.5.0, this can also be a string instead of a boolean.
|
||||
This allows to specify values such as V(enabled=1,fstrim_cloned_disks=1).
|
||||
- Since community.general 5.5.0, this can also be a string instead of a boolean. This allows to specify values such
|
||||
as V(enabled=1,fstrim_cloned_disks=1).
|
||||
type: str
|
||||
args:
|
||||
description:
|
||||
|
@ -97,7 +97,8 @@ options:
|
|||
version_added: 1.3.0
|
||||
clone:
|
||||
description:
|
||||
- Name of VM to be cloned. If O(vmid) is set, O(clone) can take an arbitrary value but is required for initiating the clone.
|
||||
- Name of VM to be cloned. If O(vmid) is set, O(clone) can take an arbitrary value but is required for initiating the
|
||||
clone.
|
||||
type: str
|
||||
cores:
|
||||
description:
|
||||
|
@ -143,22 +144,24 @@ options:
|
|||
type: str
|
||||
format:
|
||||
description:
|
||||
- V(format) is the drive's backing file's data format. Please refer to the Proxmox VE Administrator Guide, section Proxmox VE Storage
|
||||
(see U(https://pve.proxmox.com/pve-docs/chapter-pvesm.html) for the latest version, tables 3 to 14) to find out format supported by
|
||||
the provided storage backend.
|
||||
- V(format) is the drive's backing file's data format. Please refer to the Proxmox VE Administrator Guide, section
|
||||
Proxmox VE Storage (see U(https://pve.proxmox.com/pve-docs/chapter-pvesm.html) for the latest version, tables
|
||||
3 to 14) to find out format supported by the provided storage backend.
|
||||
type: str
|
||||
efitype:
|
||||
description:
|
||||
- V(efitype) indicates the size of the EFI disk.
|
||||
- V(2m) will allow for a 2MB EFI disk, which will be enough to persist boot order and new boot entries.
|
||||
- V(4m) will allow for a 4MB EFI disk, which will additionally allow to store EFI keys in order to enable Secure Boot.
|
||||
- V(4m) will allow for a 4MB EFI disk, which will additionally allow to store EFI keys in order to enable Secure
|
||||
Boot.
|
||||
type: str
|
||||
choices:
|
||||
- 2m
|
||||
- 4m
|
||||
pre_enrolled_keys:
|
||||
description:
|
||||
- V(pre_enrolled_keys) indicates whether EFI keys for Secure Boot should be enrolled V(1) in the VM firmware upon creation or not (0).
|
||||
- V(pre_enrolled_keys) indicates whether EFI keys for Secure Boot should be enrolled V(1) in the VM firmware upon
|
||||
creation or not (0).
|
||||
- If set to V(1), Secure Boot will also be enabled by default when the VM is created.
|
||||
type: bool
|
||||
version_added: 4.5.0
|
||||
|
@ -203,7 +206,8 @@ options:
|
|||
- V(pcie=boolean) V(default=0) Choose the PCI-express bus (needs the q35 machine model).
|
||||
- V(rombar=boolean) V(default=1) Specify whether or not the device's ROM will be visible in the guest's memory map.
|
||||
- V(x-vga=boolean) V(default=0) Enable vfio-vga device support.
|
||||
- /!\ This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care.
|
||||
- /!\ This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use
|
||||
with special care.
|
||||
type: dict
|
||||
hotplug:
|
||||
description:
|
||||
|
@ -223,9 +227,9 @@ options:
|
|||
- Values allowed are - V("storage:size,format=value").
|
||||
- V(storage) is the storage identifier where to create the disk.
|
||||
- V(size) is the size of the disk in GB.
|
||||
- V(format) is the drive's backing file's data format. V(qcow2|raw|subvol). Please refer to the Proxmox VE Administrator Guide, section
|
||||
Proxmox VE Storage (see U(https://pve.proxmox.com/pve-docs/chapter-pvesm.html) for the latest version, tables 3 to 14) to find out format
|
||||
supported by the provided storage backend.
|
||||
- V(format) is the drive's backing file's data format. V(qcow2|raw|subvol). Please refer to the Proxmox VE Administrator
|
||||
Guide, section Proxmox VE Storage (see U(https://pve.proxmox.com/pve-docs/chapter-pvesm.html) for the latest version,
|
||||
tables 3 to 14) to find out format supported by the provided storage backend.
|
||||
type: dict
|
||||
ipconfig:
|
||||
description:
|
||||
|
@ -300,11 +304,13 @@ options:
|
|||
- A hash/dictionary of network interfaces for the VM. O(net='{"key":"value", "key":"value"}').
|
||||
- Keys allowed are - C(net[n]) where 0 ≤ n ≤ N.
|
||||
- Values allowed are - C("model="XX:XX:XX:XX:XX:XX",bridge="value",rate="value",tag="value",firewall="1|0",trunks="vlanid"").
|
||||
- Model is one of C(e1000 e1000-82540em e1000-82544gc e1000-82545em i82551 i82557b i82559er ne2k_isa ne2k_pci pcnet rtl8139 virtio vmxnet3).
|
||||
- Model is one of C(e1000 e1000-82540em e1000-82544gc e1000-82545em i82551 i82557b i82559er ne2k_isa ne2k_pci pcnet
|
||||
rtl8139 virtio vmxnet3).
|
||||
- C(XX:XX:XX:XX:XX:XX) should be an unique MAC address. This is automatically generated if not specified.
|
||||
- The C(bridge) parameter can be used to automatically add the interface to a bridge device. The Proxmox VE standard bridge is called 'vmbr0'.
|
||||
- Option C(rate) is used to limit traffic bandwidth from and to this interface. It is specified as floating point number, unit is 'Megabytes
|
||||
per second'.
|
||||
- The C(bridge) parameter can be used to automatically add the interface to a bridge device. The Proxmox VE standard
|
||||
bridge is called 'vmbr0'.
|
||||
- Option C(rate) is used to limit traffic bandwidth from and to this interface. It is specified as floating point number,
|
||||
unit is 'Megabytes per second'.
|
||||
- If you specify no bridge, we create a kvm 'user' (NATed) network device, which provides DHCP and DNS services.
|
||||
type: dict
|
||||
newid:
|
||||
|
@ -361,9 +367,9 @@ options:
|
|||
- Values allowed are - C("storage:size,format=value").
|
||||
- C(storage) is the storage identifier where to create the disk.
|
||||
- C(size) is the size of the disk in GB.
|
||||
- C(format) is the drive's backing file's data format. C(qcow2|raw|subvol). Please refer to the Proxmox VE Administrator Guide, section
|
||||
Proxmox VE Storage (see U(https://pve.proxmox.com/pve-docs/chapter-pvesm.html) for the latest version, tables 3 to 14) to find out format
|
||||
supported by the provided storage backend.
|
||||
- C(format) is the drive's backing file's data format. C(qcow2|raw|subvol). Please refer to the Proxmox VE Administrator
|
||||
Guide, section Proxmox VE Storage (see U(https://pve.proxmox.com/pve-docs/chapter-pvesm.html) for the latest version,
|
||||
tables 3 to 14) to find out format supported by the provided storage backend.
|
||||
type: dict
|
||||
scsi:
|
||||
description:
|
||||
|
@ -372,9 +378,9 @@ options:
|
|||
- Values allowed are - C("storage:size,format=value").
|
||||
- C(storage) is the storage identifier where to create the disk.
|
||||
- C(size) is the size of the disk in GB.
|
||||
- C(format) is the drive's backing file's data format. C(qcow2|raw|subvol). Please refer to the Proxmox VE Administrator Guide, section
|
||||
Proxmox VE Storage (see U(https://pve.proxmox.com/pve-docs/chapter-pvesm.html) for the latest version, tables 3 to 14) to find out format
|
||||
supported by the provided storage backend.
|
||||
- C(format) is the drive's backing file's data format. C(qcow2|raw|subvol). Please refer to the Proxmox VE Administrator
|
||||
Guide, section Proxmox VE Storage (see U(https://pve.proxmox.com/pve-docs/chapter-pvesm.html) for the latest version,
|
||||
tables 3 to 14) to find out format supported by the provided storage backend.
|
||||
type: dict
|
||||
scsihw:
|
||||
description:
|
||||
|
@ -393,7 +399,8 @@ options:
|
|||
- A hash/dictionary of serial device to create inside the VM. V('{"key":"value", "key":"value"}').
|
||||
- Keys allowed are - serial[n](str; required) where 0 ≤ n ≤ 3.
|
||||
- Values allowed are - V((/dev/.+|socket\)).
|
||||
- /!\ If you pass through a host serial device, it is no longer possible to migrate such machines - use with special care.
|
||||
- /!\ If you pass through a host serial device, it is no longer possible to migrate such machines - use with special
|
||||
care.
|
||||
type: dict
|
||||
shares:
|
||||
description:
|
||||
|
@ -483,7 +490,8 @@ options:
|
|||
timeout:
|
||||
description:
|
||||
- Timeout for operations.
|
||||
- When used with O(state=stopped) the option sets a graceful timeout for VM stop after which a VM will be forcefully stopped.
|
||||
- When used with O(state=stopped) the option sets a graceful timeout for VM stop after which a VM will be forcefully
|
||||
stopped.
|
||||
type: int
|
||||
default: 30
|
||||
tpmstate0:
|
||||
|
@ -517,16 +525,17 @@ options:
|
|||
update:
|
||||
description:
|
||||
- If V(true), the VM will be updated with new value.
|
||||
- Because of the operations of the API and security reasons, I have disabled the update of the following parameters O(net), O(virtio), O(ide),
|
||||
O(sata), O(scsi). Per example updating O(net) update the MAC address and O(virtio) create always new disk... This security feature can
|
||||
be disabled by setting the O(update_unsafe) to V(true).
|
||||
- Because of the operations of the API and security reasons, I have disabled the update of the following parameters
|
||||
O(net), O(virtio), O(ide), O(sata), O(scsi). Per example updating O(net) update the MAC address and O(virtio) create
|
||||
always new disk... This security feature can be disabled by setting the O(update_unsafe) to V(true).
|
||||
- Update of O(pool) is disabled. It needs an additional API endpoint not covered by this module.
|
||||
type: bool
|
||||
default: false
|
||||
update_unsafe:
|
||||
description:
|
||||
- If V(true), do not enforce limitations on parameters O(net), O(virtio), O(ide), O(sata), O(scsi), O(efidisk0), and O(tpmstate0). Use this
|
||||
option with caution because an improper configuration might result in a permanent loss of data (for example disk recreated).
|
||||
- If V(true), do not enforce limitations on parameters O(net), O(virtio), O(ide), O(sata), O(scsi), O(efidisk0), and
|
||||
O(tpmstate0). Use this option with caution because an improper configuration might result in a permanent loss of data
|
||||
(for example disk recreated).
|
||||
type: bool
|
||||
default: false
|
||||
version_added: 8.4.0
|
||||
|
@ -546,9 +555,9 @@ options:
|
|||
- Values allowed are - V(storage:size,format=value).
|
||||
- V(storage) is the storage identifier where to create the disk.
|
||||
- V(size) is the size of the disk in GB.
|
||||
- V(format) is the drive's backing file's data format. V(qcow2|raw|subvol). Please refer to the Proxmox VE Administrator Guide, section
|
||||
Proxmox VE Storage (see U(https://pve.proxmox.com/pve-docs/chapter-pvesm.html) for the latest version, tables 3 to 14) to find out format
|
||||
supported by the provided storage backend.
|
||||
- V(format) is the drive's backing file's data format. V(qcow2|raw|subvol). Please refer to the Proxmox VE Administrator
|
||||
Guide, section Proxmox VE Storage (see U(https://pve.proxmox.com/pve-docs/chapter-pvesm.html) for the latest version,
|
||||
tables 3 to 14) to find out format supported by the provided storage backend.
|
||||
type: dict
|
||||
watchdog:
|
||||
description:
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue