Reservation¶
The Reservation Object defines a mapping between a token and an IP address. The token is defined by the assigned strategy. Similar to the subnet object, the only current strategy is MAC. This will use the MAC address of the incoming requests as the identity token. The reservation allows for the optional specification of specific options and a next server that override or augment the options defined in a subnet. Because the reservation is an explicit binding of the token to an IP address, the address can be handed out without the definition of a subnet. This requires that the reservation have the netmask option (DHCP option 1) specified. In general, it is a good idea to define a subnet that will cover the reservation with default options and parameters, but it is not required.
Reservations are what the DRP DHCP service uses to ensure that an IP address is always issued to the same device.
| Field | Definition |
|---|---|
| Addr | Addr is the IP address permanently assigned to the strategy/token combination. required: true swagger:strfmt ipv4 |
| Allocated | Allocated indicates this is a reapable reservation |
| Description | Description is a string for providing a simple description |
| Documentation | Documentation is a string for providing additional in depth information. |
| Duration | Duration is the time in seconds for which a lease can be valid. ExpireTime is calculated from Duration. |
| Machine | Machine is the associated machine |
| Meta | Meta contains the meta data of the object. The type of this field is a key / value map/dictionary. The key type is string. The value type is also string. The general content of the field is undefined and can be an arbritary store. There are some common known keys: color - The color the UX uses when displaying icon - The icon the UX uses when displaying * title - The UX uses this for additional display information. Often the source of the object. Specific Object types use additional meta data fields. These are described at: https://docs.rackn.io/stable/redirect/?ref=rs_object_metadata |
| NextServer | NextServer is the address the server should contact next. You should only set this if you want to talk to a DHCP or TFTP server other than the one provided by dr-provision. required: false swagger:strfmt ipv4 |
| Options | Options is the list of DHCP options that apply to this Reservation |
| Options/Code | Code is a DHCP Option Code. required: true |
| Options/Value | Value is a text/template that will be expanded and then converted into the proper format for the option code required: true |
| Parameter | Parameter is the parameter that this address should be stored in for the machine if specified |
| Params | Params holds the values of parameters on the object. The field is a key / value store of the parameters. The key is the name of a parameter. The key is of type string. The value is the value of the parameter. The type of the value is defined by the parameter object. If the key doesn't reference a parameter, the type of the object can be anything. The system will enforce the named parameter's value's type. Go calls the "anything" parameters as "interface {}". Hence, the type of this field is a map[string]interface{}. |
| PrefixParameter | PrefixParameter a string that should be the beginning of a set of option-based parameters |
| Profiles | Profiles is an array of profiles to apply to this object in order when looking for a parameter during rendering. |
| Scoped | Scoped indicates that this reservation is tied to a particular Subnet, as determined by the reservation's Addr. required: true |
| SkipDAD | SkipDAD will cause the DHCP server to skip duplicate address detection via ping testing when in discovery phase. Only set this if you know this reservation can never conflict with any other system. |
| Strategy | Strategy is the leasing strategy that will be used determine what to use from the DHCP packet to handle lease management. required: true |
| Subnet | Subnet is the name of the Subnet that this Reservation is associated with. This property is read-only. |
| Token | Token is the unique identifier that the strategy for this Reservation should use. required: true |
Note
If you create a static reservation, DRP will always respond to the request even if the subnet is disabled.
Note
If the reservation and its subnet, if present, define both option 12 and option 15, this will be used to find a matching DNS Zone for automatic A and PTR record creation.