Method DeleteStorageContent

pkg/api/storage_content.go:283–318

DeleteStorageContent deletes a storage content item and returns the queued task UPID.

(nodeName, storageName, volID string)

// DeleteStorageContent deletes a storage content item and returns the queued task UPID.
func (c *Client) DeleteStorageContent(nodeName, storageName, volID string) (string, error) {
	if strings.TrimSpace(nodeName) == "" {
		return "", fmt.Errorf("node name is required")
	}
	if strings.TrimSpace(storageName) == "" {
		return "", fmt.Errorf("storage name is required")
	}
	if strings.TrimSpace(volID) == "" {
		return "", fmt.Errorf("volume ID is required")
	}

	path := fmt.Sprintf(
		"/nodes/%s/storage/%s/content/%s",
		nodeName,
		storageName,
		url.PathEscape(strings.TrimSpace(volID)),
	)

	var res map[string]interface{}
	if err := c.DeleteWithResponse(path, &res); err != nil {
		return "", fmt.Errorf("failed to delete storage content %s on %s/%s: %w", volID, nodeName, storageName, err)
	}

	if errMsg, ok := res["error"].(string); ok && errMsg != "" {
		return "", fmt.Errorf("storage content delete failed: %s", errMsg)
	}

	upid, ok := res["data"].(string)
	if !ok || !strings.HasPrefix(upid, "UPID:") {
		return "", fmt.Errorf("failed to get delete task ID")
	}

	c.ClearAPICache()

	return upid, nil
}

// RestoreGuestFromBackup restores a VM or container from a backup volume and returns the queued task UPID.
func (c *Client) RestoreGuestFromBackup(nodeName, guestType string, vmid int, volID string, force bool) (string, error) {