DHCP Range

network/
cidr

Required

Specifies the network to which the DHCP range must be added or removed. Specify the value in CIDR notation.

network_view

Optional

Specifies the name of the network view to associate with this object instance.
If a value is not specified, default is used as the network view name.
If you are using a custom network view, then you must specify this parameter.

options

Optional

Defines the set of DHCP options to be included as part of the configured network instance.
This parameter accepts a list of subparameters. When configuring the subparameters, you must define at least one of the name and num parameters.

• name: The name of the DHCP option to configure.
  The standard values are router, router-templates, domain-name-servers, domain-name, broadcast-address, broadcast-address-offset, dhcp-lease-time, and dhcp6.name-servers

• num: The number of DHCP options to configure.

• value (required): The value of the DHCP option specified by the name subparameter.

• use_option: Only applies to a subset of options (see the NIOS API documentation).
  The default value is yes.

• vendor_class: The name of the space with which this DHCP option is associated.
  The default value is DHCP.

start_addr/
start/
first_addr/
first

Required

Specifies the beginning IP address of the DHCP range object in a create operation.
If you configure start_addr and new_start_addr in a create operation, the value of new_start_addr overrides the value of start_addr.

If you need to update the DHCP range, use the new_start_addr and new_end_addr parameters to specify the values to update to, and the start_addr and end_addr parameters to specify the values of the existing DHCP range.

new_start_addr/
new_start/
new_first_addr/
new_first

Optional

Specifies the beginning IP address of the DHCP range object in an update operation.

end_addr/
end/
last_addr/
last

Required

Specifies the ending IP address of the DHCP range object in a create operation.
If you configure end_addr and new_end_addr in a create operation, the value of new_end_addr overrides the value of end_addr.

If you need to update the DHCP range, use the new_start_addr and new_end_addr parameters to specify the values to update to, and the start_addr and end_addr parameters to specify the values of the existing DHCP range.

new_end_addr/
new_end/
new_last_addr/
new_last

Optional

Specifies the ending IP address of the DHCP range to which you want to update.

member

Optional

Specifies the host name of the NIOS member configured to serve this object instance.

Do not configure this parameter when the ms_server or the failover_association parameter is configured.

failover_association

Optional

Specifies the name of the DHCP failover association configured to serve this object instance.
A failover of Microsoft or NIOS members can be configured.

Do not configure this parameter when the ms_server or the member parameter is configured.

ms_server

Optional

Specifies the host name of the Microsoft member configured to serve this object instance.

Do not configure this parameter when the failover_association or the member parameter is configured.

server_association_type

Optional

Specifies the type of server association assigned to serve this object instance.
The values you can specify are:

• NONE

• FAILOVER

• MEMBER

• FAILOVER_MS

• MS_SERVER

The default value is NONE.

state

Optional

Specifies the intended state of the object instance in NIOS.
Set one of the following values:

• present (default): Configures the object in NIOS.

• absent: Removes the object in NIOS.

disable

Optional

Determines whether the configured DHCP range is disabled or not. Set one of the following values:

• true: The DHCP range is disabled.

• false (default): The DHCP range is enabled.

name

Optional

Specifies the name of the Microsoft scope for the object instance in NIOS.

extattrs

Optional

Specifies extensible attributes for the DHCP range object.

comment

Optional

Describes the DHCP range object.

provider

Required

Defines the details of the connection:

• host: DNS host name or IP address to connect to the remote instance of NIOS.

• username: User name to use for authenticating the connection to the remote instance.

• password: Password to use for authenticating the connection to the remote instance.

For information on additional fields you can define, see the list of subparameters in the list of subparameters in the NIOS Modules for Ansible Collections topic.

connection

Required

The nios_range module must be run locally.