feat: Add support for custom cloud-init vendor data file

.github/auto-label.yaml

@@ -7,4 +7,4 @@ staleness:
 path:
   pullrequest: true
   paths:
-    .: 'docs'
+    docs: 'documentation'

docs/resources/virtual_environment_vm.md

@@ -216,6 +216,7 @@ output "ubuntu_vm_public_key" {
         * `username` - (Optional) The SSH username.
     * `user_data_file_id` - (Optional) The identifier for a file containing custom user data (conflicts
       with `user_account`).
+    * `vendor_data_file_id` - (Optional) The identifier for a file containing all vendor data passed to the VM via cloud-init.
 * `keyboard_layout` - (Optional) The keyboard layout (defaults to `en-us`).
     * `da` - Danish.
     * `de` - German.

proxmox/virtual_environment_vm_types.go

@@ -48,6 +48,7 @@ type CustomCloudInitFiles struct {
 	MetaVolume    *string `json:"meta,omitempty" url:"meta,omitempty"`
 	NetworkVolume *string `json:"network,omitempty" url:"network,omitempty"`
 	UserVolume    *string `json:"user,omitempty" url:"user,omitempty"`
+	VendorVolume  *string `json:"vendor,omitempty" url:"vendor,omitempty"`
 }
 
 // CustomCloudInitIPConfig handles QEMU cloud-init IP configuration parameters.
@@ -221,7 +222,7 @@ type VirtualEnvironmentVMCloneRequestBody struct {
 	VMIDNew             int         `json:"newid" url:"newid"`
 }
 
-// VirtualEnvironmentVMCreateRequestBody contains the data for an virtual machine create request.
+// VirtualEnvironmentVMCreateRequestBody contains the data for a virtual machine create request.
 type VirtualEnvironmentVMCreateRequestBody struct {
 	ACPI                 *CustomBool                  `json:"acpi,omitempty" url:"acpi,omitempty,int"`
 	Agent                *CustomAgent                 `json:"agent,omitempty" url:"agent,omitempty"`
@@ -623,7 +624,7 @@ func (r CustomAudioDevices) EncodeValues(key string, v *url.Values) error {
 	return nil
 }
 
-// EncodeValues converts a CustomCloudInitConfig struct to multiple URL vlaues.
+// EncodeValues converts a CustomCloudInitConfig struct to multiple URL values.
 func (r CustomCloudInitConfig) EncodeValues(_ string, v *url.Values) error {
 	if r.Files != nil {
 		var volumes []string
@@ -640,6 +641,10 @@ func (r CustomCloudInitConfig) EncodeValues(_ string, v *url.Values) error {
 			volumes = append(volumes, fmt.Sprintf("user=%s", *r.Files.UserVolume))
 		}
 
+		if r.Files.VendorVolume != nil {
+			volumes = append(volumes, fmt.Sprintf("vendor=%s", *r.Files.VendorVolume))
+		}
+
 		if len(volumes) > 0 {
 			v.Add("cicustom", strings.Join(volumes, ","))
 		}

proxmoxtf/resource_virtual_environment_vm.go

@@ -65,6 +65,7 @@ const (
 	dvResourceVirtualEnvironmentVMInitializationIPConfigIPv6Gateway = ""
 	dvResourceVirtualEnvironmentVMInitializationUserAccountPassword = ""
 	dvResourceVirtualEnvironmentVMInitializationUserDataFileID      = ""
+	dvResourceVirtualEnvironmentVMInitializationVendorDataFileID    = ""
 	dvResourceVirtualEnvironmentVMInitializationType                = ""
 	dvResourceVirtualEnvironmentVMKeyboardLayout                    = "en-us"
 	dvResourceVirtualEnvironmentVMMemoryDedicated                   = 512
@@ -160,6 +161,7 @@ const (
 	mkResourceVirtualEnvironmentVMInitializationUserAccountPassword = "password"
 	mkResourceVirtualEnvironmentVMInitializationUserAccountUsername = "username"
 	mkResourceVirtualEnvironmentVMInitializationUserDataFileID      = "user_data_file_id"
+	mkResourceVirtualEnvironmentVMInitializationVendorDataFileID    = "vendor_data_file_id"
 	mkResourceVirtualEnvironmentVMIPv4Addresses                     = "ipv4_addresses"
 	mkResourceVirtualEnvironmentVMIPv6Addresses                     = "ipv6_addresses"
 	mkResourceVirtualEnvironmentVMKeyboardLayout                    = "keyboard_layout"
@@ -741,6 +743,14 @@ func resourceVirtualEnvironmentVM() *schema.Resource {
 							Default:          dvResourceVirtualEnvironmentVMInitializationUserDataFileID,
 							ValidateDiagFunc: getFileIDValidator(),
 						},
+						mkResourceVirtualEnvironmentVMInitializationVendorDataFileID: {
+							Type:             schema.TypeString,
+							Description:      "The ID of a file containing vendor data",
+							Optional:         true,
+							ForceNew:         true,
+							Default:          dvResourceVirtualEnvironmentVMInitializationVendorDataFileID,
+							ValidateDiagFunc: getFileIDValidator(),
+						},
 						mkResourceVirtualEnvironmentVMInitializationType: {
 							Type:             schema.TypeString,
 							Description:      "The cloud-init configuration format",
@@ -2087,6 +2097,15 @@ func resourceVirtualEnvironmentVMGetCloudInitConfig(d *schema.ResourceData) (*pr
 			}
 		}
 
+		initializationVendorDataFileID := initializationBlock[mkResourceVirtualEnvironmentVMInitializationVendorDataFileID].(string)
+
+		if initializationVendorDataFileID != "" {
+			if initializationConfig.Files == nil {
+				initializationConfig.Files = &proxmox.CustomCloudInitFiles{}
+			}
+			initializationConfig.Files.VendorVolume = &initializationVendorDataFileID
+		}
+
 		initializationType := initializationBlock[mkResourceVirtualEnvironmentVMInitializationType].(string)
 
 		if initializationType != "" {
@@ -2817,8 +2836,14 @@ func resourceVirtualEnvironmentVMReadCustom(ctx context.Context, d *schema.Resou
 		} else {
 			initialization[mkResourceVirtualEnvironmentVMInitializationUserDataFileID] = ""
 		}
+		if vmConfig.CloudInitFiles.VendorVolume != nil {
+			initialization[mkResourceVirtualEnvironmentVMInitializationVendorDataFileID] = *vmConfig.CloudInitFiles.VendorVolume
+		} else {
+			initialization[mkResourceVirtualEnvironmentVMInitializationVendorDataFileID] = ""
+		}
 	} else if len(initialization) > 0 {
 		initialization[mkResourceVirtualEnvironmentVMInitializationUserDataFileID] = ""
+		initialization[mkResourceVirtualEnvironmentVMInitializationVendorDataFileID] = ""
 	}
 
 	if vmConfig.CloudInitType != nil {