Skip to content

Commit 41c9568

Browse files
author
awlsring
committed
refactor: schema term updates
1 parent 5fa8df6 commit 41c9568

File tree

13 files changed

+231
-157
lines changed

13 files changed

+231
-157
lines changed

docs/data-sources/templates.md

Lines changed: 32 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -35,35 +35,32 @@ Required:
3535
<a id="nestedatt--templates"></a>
3636
### Nested Schema for `templates`
3737

38-
Optional:
38+
Read-Only:
3939

4040
- `agent` (Attributes) The agent configuration. (see [below for nested schema](#nestedatt--templates--agent))
4141
- `bios` (String) The BIOS type.
4242
- `cloud_init` (Attributes) (see [below for nested schema](#nestedatt--templates--cloud_init))
4343
- `cpu` (Attributes) The CPU configuration. (see [below for nested schema](#nestedatt--templates--cpu))
44-
- `description` (String) The CPU description.
45-
- `keyboard_layout` (String) The keyboard layout.
46-
- `machine_type` (String) The machine type.
47-
- `name` (String) The name of the virtual machine.
48-
- `resource_pool` (String) The resource pool the virtual machine is in.
49-
- `start_on_node_boot` (Boolean) Whether to start the virtual machine on node boot.
50-
- `tags` (Set of String) The tags of the virtual machine.
51-
- `type` (String) The operating system type.
52-
53-
Read-Only:
54-
44+
- `description` (String) The template description.
5545
- `disks` (Attributes Set) The terrafrom generated disks attached to the VM. (see [below for nested schema](#nestedatt--templates--disks))
56-
- `id` (Number) The identifier of the virtual machine.
46+
- `id` (Number) The identifier of the template.
47+
- `keyboard_layout` (String) The keyboard layout.
5748
- `kvm_arguments` (String) The arguments to pass to KVM.
49+
- `machine_type` (String) The machine type.
5850
- `memory` (Attributes) (see [below for nested schema](#nestedatt--templates--memory))
51+
- `name` (String) The name of the template.
5952
- `network_interfaces` (Attributes Set) (see [below for nested schema](#nestedatt--templates--network_interfaces))
60-
- `node` (String) The node to create the virtual machine on.
53+
- `node` (String) The node to create the template on.
6154
- `pci_devices` (Attributes Set) PCI devices passed through to the VM. (see [below for nested schema](#nestedatt--templates--pci_devices))
55+
- `resource_pool` (String) The resource pool the template is in.
56+
- `start_on_node_boot` (Boolean) Whether to start the template on node boot.
57+
- `tags` (Set of String) The tags of the template.
58+
- `type` (String) The operating system type.
6259

6360
<a id="nestedatt--templates--agent"></a>
6461
### Nested Schema for `templates.agent`
6562

66-
Optional:
63+
Read-Only:
6764

6865
- `enabled` (Boolean) Whether the agent is enabled.
6966
- `type` (String) The guest agent type.
@@ -73,7 +70,7 @@ Optional:
7370
<a id="nestedatt--templates--cloud_init"></a>
7471
### Nested Schema for `templates.cloud_init`
7572

76-
Optional:
73+
Read-Only:
7774

7875
- `dns` (Attributes) (see [below for nested schema](#nestedatt--templates--cloud_init--dns))
7976
- `ip` (Attributes Set) (see [below for nested schema](#nestedatt--templates--cloud_init--ip))
@@ -82,7 +79,7 @@ Optional:
8279
<a id="nestedatt--templates--cloud_init--dns"></a>
8380
### Nested Schema for `templates.cloud_init.dns`
8481

85-
Optional:
82+
Read-Only:
8683

8784
- `domain` (String) The domain to use for the machine.
8885
- `nameserver` (String) The nameserver to use for the machine.
@@ -91,7 +88,7 @@ Optional:
9188
<a id="nestedatt--templates--cloud_init--ip"></a>
9289
### Nested Schema for `templates.cloud_init.ip`
9390

94-
Optional:
91+
Read-Only:
9592

9693
- `position` (Number) The position of the network interface in the VM as an int. Used to determine the interface name (net0, net1, etc).
9794
- `v4` (Attributes) (see [below for nested schema](#nestedatt--templates--cloud_init--ip--v4))
@@ -100,7 +97,7 @@ Optional:
10097
<a id="nestedatt--templates--cloud_init--ip--v4"></a>
10198
### Nested Schema for `templates.cloud_init.ip.v6`
10299

103-
Optional:
100+
Read-Only:
104101

105102
- `address` (String) The IP address to use for the machine.
106103
- `dhcp` (Boolean) Whether to use DHCP to get the IP address.
@@ -111,7 +108,7 @@ Optional:
111108
<a id="nestedatt--templates--cloud_init--ip--v6"></a>
112109
### Nested Schema for `templates.cloud_init.ip.v6`
113110

114-
Optional:
111+
Read-Only:
115112

116113
- `address` (String) The IP address to use for the machine.
117114
- `dhcp` (Boolean) Whether to use DHCP to get the IP address.
@@ -123,18 +120,18 @@ Optional:
123120
<a id="nestedatt--templates--cloud_init--user"></a>
124121
### Nested Schema for `templates.cloud_init.user`
125122

126-
Optional:
123+
Read-Only:
127124

128125
- `name` (String) The name of the user.
129126
- `password` (String) The password of the user.
130-
- `public_keys` (List of String) The public ssh keys of the user.
127+
- `public_keys` (Set of String) The public ssh keys of the user.
131128

132129

133130

134131
<a id="nestedatt--templates--cpu"></a>
135132
### Nested Schema for `templates.cpu`
136133

137-
Optional:
134+
Read-Only:
138135

139136
- `architecture` (String) The CPU architecture.
140137
- `cores` (Number) The number of CPU cores.
@@ -146,25 +143,22 @@ Optional:
146143
<a id="nestedatt--templates--disks"></a>
147144
### Nested Schema for `templates.disks`
148145

149-
Optional:
146+
Read-Only:
150147

151148
- `discard` (Boolean) Whether the disk has discard enabled.
152149
- `file_format` (String) The file format of the disk.
153-
- `speed_limits` (Attributes) The speed limits of the disk. If not set, no speed limitations are applied. (see [below for nested schema](#nestedatt--templates--disks--speed_limits))
154-
- `ssd_emulation` (Boolean) Whether to use SSD emulation. conflicts with virtio disk type.
155-
- `use_iothread` (Boolean) Whether to use an iothread for the disk.
156-
157-
Read-Only:
158-
159150
- `interface_type` (String) The type of the disk.
160151
- `position` (Number) The position of the disk. (0, 1, 2, etc.) This is combined with the `interface_type` to determine the disk name.
161152
- `size` (Number) The size of the disk in GiB.
153+
- `speed_limits` (Attributes) The speed limits of the disk. If not set, no speed limitations are applied. (see [below for nested schema](#nestedatt--templates--disks--speed_limits))
154+
- `ssd_emulation` (Boolean) Whether to use SSD emulation. conflicts with virtio disk type.
162155
- `storage` (String) The storage the disk is on.
156+
- `use_iothread` (Boolean) Whether to use an iothread for the disk.
163157

164158
<a id="nestedatt--templates--disks--speed_limits"></a>
165159
### Nested Schema for `templates.disks.speed_limits`
166160

167-
Optional:
161+
Read-Only:
168162

169163
- `read` (Number) The read speed limit in bytes per second.
170164
- `read_burstable` (Number) The read burstable speed limit in bytes per second.
@@ -176,7 +170,7 @@ Optional:
176170
<a id="nestedatt--templates--memory"></a>
177171
### Nested Schema for `templates.memory`
178172

179-
Optional:
173+
Read-Only:
180174

181175
- `dedicated` (Number) The size of the memory in MB.
182176
- `floating` (Number) The floating memory in MB.
@@ -186,36 +180,30 @@ Optional:
186180
<a id="nestedatt--templates--network_interfaces"></a>
187181
### Nested Schema for `templates.network_interfaces`
188182

189-
Optional:
183+
Read-Only:
190184

185+
- `bridge` (String) The bridge the network interface is on.
191186
- `enabled` (Boolean) Whether the network interface is enabled.
192187
- `mac_address` (String) The MAC address of the network interface.
193188
- `model` (String) The model of the network interface.
194189
- `mtu` (Number) The MTU of the network interface. Only valid for virtio.
190+
- `position` (Number) The position of the network interface in the VM as an int. Used to determine the interface name (net0, net1, etc).
195191
- `rate_limit` (Number) The rate limit of the network interface in megabytes per second.
196192
- `use_firewall` (Boolean) Whether the firewall for the network interface is enabled.
197193
- `vlan` (Number) The VLAN tag of the network interface.
198194

199-
Read-Only:
200-
201-
- `bridge` (String) The bridge the network interface is on.
202-
- `position` (Number) The position of the network interface in the VM as an int. Used to determine the interface name (net0, net1, etc).
203-
204195

205196
<a id="nestedatt--templates--pci_devices"></a>
206197
### Nested Schema for `templates.pci_devices`
207198

208-
Optional:
199+
Read-Only:
209200

201+
- `id` (String) The device ID of the PCI device.
210202
- `mdev` (String) The mediated device name.
203+
- `name` (String) The device name of the PCI device.
211204
- `pcie` (Boolean) Whether the PCI device is PCIe.
212205
- `primary_gpu` (Boolean) Whether the PCI device is the primary GPU.
213206
- `rom_file` (String) The relative path to the ROM for the device.
214207
- `rombar` (Boolean) Make the firmware room visible to the VM.
215208

216-
Read-Only:
217-
218-
- `id` (String) The device ID of the PCI device.
219-
- `name` (String) The device name of the PCI device.
220-
221209

docs/data-sources/virtual_machines.md

Lines changed: 30 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -35,35 +35,32 @@ Required:
3535
<a id="nestedatt--virtual_machines"></a>
3636
### Nested Schema for `virtual_machines`
3737

38-
Optional:
38+
Read-Only:
3939

4040
- `agent` (Attributes) The agent configuration. (see [below for nested schema](#nestedatt--virtual_machines--agent))
4141
- `bios` (String) The BIOS type.
4242
- `cloud_init` (Attributes) (see [below for nested schema](#nestedatt--virtual_machines--cloud_init))
4343
- `cpu` (Attributes) The CPU configuration. (see [below for nested schema](#nestedatt--virtual_machines--cpu))
44-
- `description` (String) The CPU description.
45-
- `keyboard_layout` (String) The keyboard layout.
46-
- `machine_type` (String) The machine type.
47-
- `name` (String) The name of the virtual machine.
48-
- `resource_pool` (String) The resource pool the virtual machine is in.
49-
- `start_on_node_boot` (Boolean) Whether to start the virtual machine on node boot.
50-
- `tags` (Set of String) The tags of the virtual machine.
51-
- `type` (String) The operating system type.
52-
53-
Read-Only:
54-
44+
- `description` (String) The virtual machine description.
5545
- `disks` (Attributes Set) The terrafrom generated disks attached to the VM. (see [below for nested schema](#nestedatt--virtual_machines--disks))
5646
- `id` (Number) The identifier of the virtual machine.
47+
- `keyboard_layout` (String) The keyboard layout.
5748
- `kvm_arguments` (String) The arguments to pass to KVM.
49+
- `machine_type` (String) The machine type.
5850
- `memory` (Attributes) (see [below for nested schema](#nestedatt--virtual_machines--memory))
51+
- `name` (String) The name of the virtual machine.
5952
- `network_interfaces` (Attributes Set) (see [below for nested schema](#nestedatt--virtual_machines--network_interfaces))
6053
- `node` (String) The node to create the virtual machine on.
6154
- `pci_devices` (Attributes Set) PCI devices passed through to the VM. (see [below for nested schema](#nestedatt--virtual_machines--pci_devices))
55+
- `resource_pool` (String) The resource pool the virtual machine is in.
56+
- `start_on_node_boot` (Boolean) Whether to start the virtual machine on node boot.
57+
- `tags` (Set of String) The tags of the virtual machine.
58+
- `type` (String) The operating system type.
6259

6360
<a id="nestedatt--virtual_machines--agent"></a>
6461
### Nested Schema for `virtual_machines.agent`
6562

66-
Optional:
63+
Read-Only:
6764

6865
- `enabled` (Boolean) Whether the agent is enabled.
6966
- `type` (String) The guest agent type.
@@ -73,7 +70,7 @@ Optional:
7370
<a id="nestedatt--virtual_machines--cloud_init"></a>
7471
### Nested Schema for `virtual_machines.cloud_init`
7572

76-
Optional:
73+
Read-Only:
7774

7875
- `dns` (Attributes) (see [below for nested schema](#nestedatt--virtual_machines--cloud_init--dns))
7976
- `ip` (Attributes Set) (see [below for nested schema](#nestedatt--virtual_machines--cloud_init--ip))
@@ -82,7 +79,7 @@ Optional:
8279
<a id="nestedatt--virtual_machines--cloud_init--dns"></a>
8380
### Nested Schema for `virtual_machines.cloud_init.dns`
8481

85-
Optional:
82+
Read-Only:
8683

8784
- `domain` (String) The domain to use for the machine.
8885
- `nameserver` (String) The nameserver to use for the machine.
@@ -91,7 +88,7 @@ Optional:
9188
<a id="nestedatt--virtual_machines--cloud_init--ip"></a>
9289
### Nested Schema for `virtual_machines.cloud_init.ip`
9390

94-
Optional:
91+
Read-Only:
9592

9693
- `position` (Number) The position of the network interface in the VM as an int. Used to determine the interface name (net0, net1, etc).
9794
- `v4` (Attributes) (see [below for nested schema](#nestedatt--virtual_machines--cloud_init--ip--v4))
@@ -100,7 +97,7 @@ Optional:
10097
<a id="nestedatt--virtual_machines--cloud_init--ip--v4"></a>
10198
### Nested Schema for `virtual_machines.cloud_init.ip.v6`
10299

103-
Optional:
100+
Read-Only:
104101

105102
- `address` (String) The IP address to use for the machine.
106103
- `dhcp` (Boolean) Whether to use DHCP to get the IP address.
@@ -111,7 +108,7 @@ Optional:
111108
<a id="nestedatt--virtual_machines--cloud_init--ip--v6"></a>
112109
### Nested Schema for `virtual_machines.cloud_init.ip.v6`
113110

114-
Optional:
111+
Read-Only:
115112

116113
- `address` (String) The IP address to use for the machine.
117114
- `dhcp` (Boolean) Whether to use DHCP to get the IP address.
@@ -123,18 +120,18 @@ Optional:
123120
<a id="nestedatt--virtual_machines--cloud_init--user"></a>
124121
### Nested Schema for `virtual_machines.cloud_init.user`
125122

126-
Optional:
123+
Read-Only:
127124

128125
- `name` (String) The name of the user.
129126
- `password` (String) The password of the user.
130-
- `public_keys` (List of String) The public ssh keys of the user.
127+
- `public_keys` (Set of String) The public ssh keys of the user.
131128

132129

133130

134131
<a id="nestedatt--virtual_machines--cpu"></a>
135132
### Nested Schema for `virtual_machines.cpu`
136133

137-
Optional:
134+
Read-Only:
138135

139136
- `architecture` (String) The CPU architecture.
140137
- `cores` (Number) The number of CPU cores.
@@ -146,25 +143,22 @@ Optional:
146143
<a id="nestedatt--virtual_machines--disks"></a>
147144
### Nested Schema for `virtual_machines.disks`
148145

149-
Optional:
146+
Read-Only:
150147

151148
- `discard` (Boolean) Whether the disk has discard enabled.
152149
- `file_format` (String) The file format of the disk.
153-
- `speed_limits` (Attributes) The speed limits of the disk. If not set, no speed limitations are applied. (see [below for nested schema](#nestedatt--virtual_machines--disks--speed_limits))
154-
- `ssd_emulation` (Boolean) Whether to use SSD emulation. conflicts with virtio disk type.
155-
- `use_iothread` (Boolean) Whether to use an iothread for the disk.
156-
157-
Read-Only:
158-
159150
- `interface_type` (String) The type of the disk.
160151
- `position` (Number) The position of the disk. (0, 1, 2, etc.) This is combined with the `interface_type` to determine the disk name.
161152
- `size` (Number) The size of the disk in GiB.
153+
- `speed_limits` (Attributes) The speed limits of the disk. If not set, no speed limitations are applied. (see [below for nested schema](#nestedatt--virtual_machines--disks--speed_limits))
154+
- `ssd_emulation` (Boolean) Whether to use SSD emulation. conflicts with virtio disk type.
162155
- `storage` (String) The storage the disk is on.
156+
- `use_iothread` (Boolean) Whether to use an iothread for the disk.
163157

164158
<a id="nestedatt--virtual_machines--disks--speed_limits"></a>
165159
### Nested Schema for `virtual_machines.disks.speed_limits`
166160

167-
Optional:
161+
Read-Only:
168162

169163
- `read` (Number) The read speed limit in bytes per second.
170164
- `read_burstable` (Number) The read burstable speed limit in bytes per second.
@@ -176,7 +170,7 @@ Optional:
176170
<a id="nestedatt--virtual_machines--memory"></a>
177171
### Nested Schema for `virtual_machines.memory`
178172

179-
Optional:
173+
Read-Only:
180174

181175
- `dedicated` (Number) The size of the memory in MB.
182176
- `floating` (Number) The floating memory in MB.
@@ -186,36 +180,30 @@ Optional:
186180
<a id="nestedatt--virtual_machines--network_interfaces"></a>
187181
### Nested Schema for `virtual_machines.network_interfaces`
188182

189-
Optional:
183+
Read-Only:
190184

185+
- `bridge` (String) The bridge the network interface is on.
191186
- `enabled` (Boolean) Whether the network interface is enabled.
192187
- `mac_address` (String) The MAC address of the network interface.
193188
- `model` (String) The model of the network interface.
194189
- `mtu` (Number) The MTU of the network interface. Only valid for virtio.
190+
- `position` (Number) The position of the network interface in the VM as an int. Used to determine the interface name (net0, net1, etc).
195191
- `rate_limit` (Number) The rate limit of the network interface in megabytes per second.
196192
- `use_firewall` (Boolean) Whether the firewall for the network interface is enabled.
197193
- `vlan` (Number) The VLAN tag of the network interface.
198194

199-
Read-Only:
200-
201-
- `bridge` (String) The bridge the network interface is on.
202-
- `position` (Number) The position of the network interface in the VM as an int. Used to determine the interface name (net0, net1, etc).
203-
204195

205196
<a id="nestedatt--virtual_machines--pci_devices"></a>
206197
### Nested Schema for `virtual_machines.pci_devices`
207198

208-
Optional:
199+
Read-Only:
209200

201+
- `id` (String) The device ID of the PCI device.
210202
- `mdev` (String) The mediated device name.
203+
- `name` (String) The device name of the PCI device.
211204
- `pcie` (Boolean) Whether the PCI device is PCIe.
212205
- `primary_gpu` (Boolean) Whether the PCI device is the primary GPU.
213206
- `rom_file` (String) The relative path to the ROM for the device.
214207
- `rombar` (Boolean) Make the firmware room visible to the VM.
215208

216-
Read-Only:
217-
218-
- `id` (String) The device ID of the PCI device.
219-
- `name` (String) The device name of the PCI device.
220-
221209

0 commit comments

Comments
 (0)