tasks

Documentation

Index

• type Client
  • func (c *Client) BuildPath(taskID string, path string) (string, error)
  • func (c *Client) ExpandPath(_ string) string
  • func (c *Client) GetTaskStatus(ctx context.Context, upid string) (*GetTaskStatusResponseData, error)
  • func (c *Client) WaitForTask(ctx context.Context, upid string, timeoutSec, delaySec int) error
• type GetTaskStatusResponseBody
• type GetTaskStatusResponseData
• type TaskID
  • func ParseTaskID(taskID string) (TaskID, error)

Types

type Client

type Client struct {
	api.Client
}

Client is an interface for performing requests against the Proxmox 'tasks' API.

func (*Client) BuildPath

func (c *Client) BuildPath(taskID string, path string) (string, error)

BuildPath builds a path using information from Task ID.

func (*Client) ExpandPath

func (c *Client) ExpandPath(_ string) string

ExpandPath expands a path relative to the client's base path.

func (*Client) GetTaskStatus

func (c *Client) GetTaskStatus(ctx context.Context, upid string) (*GetTaskStatusResponseData, error)

GetTaskStatus retrieves the status of a task.

func (*Client) WaitForTask

func (c *Client) WaitForTask(ctx context.Context, upid string, timeoutSec, delaySec int) error

WaitForTask waits for a specific task to complete.

type GetTaskStatusResponseBody

type GetTaskStatusResponseBody struct {
	Data *GetTaskStatusResponseData `json:"data,omitempty"`
}

GetTaskStatusResponseBody contains the body from a node get task status response.

type GetTaskStatusResponseData

type GetTaskStatusResponseData struct {
	PID      int    `json:"pid,omitempty"`
	Status   string `json:"status,omitempty"`
	ExitCode string `json:"exitstatus,omitempty"`
}

GetTaskStatusResponseData contains the data from a node get task status response.

type TaskID

type TaskID struct {
	NodeName  string
	PID       int
	PStart    int
	StartTime time.Time
	Type      string
	ID        string
	User      string
}

TaskID contains the components of a PVE task ID.

func ParseTaskID

func ParseTaskID(taskID string) (TaskID, error)

ParseTaskID parses a task ID into its component parts. The task ID is expected to be in the format of:

UPID:<node_name>:<pid_in_hex>:<pstart_in_hex>:<starttime_in_hex>:<type>:<id (optional)>:<user>@<realm>: