Skip to content

Latest commit

 

History

History
286 lines (207 loc) · 13.2 KB

README.md

File metadata and controls

286 lines (207 loc) · 13.2 KB

Butler

(Butler)

Overview

Butler is the task manager of the Plex Media Server Ecosystem.

Available Operations

GetButlerTasks

Returns a list of butler tasks

Example Usage

package main

import(
	"context"
	"github.com/LukeHagar/plexgo"
	"log"
)

func main() {
    ctx := context.Background()
    
    s := plexgo.New(
        plexgo.WithSecurity("<YOUR_API_KEY_HERE>"),
    )

    res, err := s.Butler.GetButlerTasks(ctx)
    if err != nil {
        log.Fatal(err)
    }
    if res.Object != nil {
        // handle response
    }
}

Parameters

Parameter Type Required Description
ctx context.Context ✔️ The context to use for the request.
opts []operations.Option ➖ The options for this request.

Response

*operations.GetButlerTasksResponse, error

Errors

Error Type Status Code Content Type
sdkerrors.GetButlerTasksBadRequest 400 application/json
sdkerrors.GetButlerTasksUnauthorized 401 application/json
sdkerrors.SDKError 4XX, 5XX */*

StartAllTasks

This endpoint will attempt to start all Butler tasks that are enabled in the settings. Butler tasks normally run automatically during a time window configured on the server's Settings page but can be manually started using this endpoint. Tasks will run with the following criteria:

  1. Any tasks not scheduled to run on the current day will be skipped.
  2. If a task is configured to run at a random time during the configured window and we are outside that window, the task will start immediately.
  3. If a task is configured to run at a random time during the configured window and we are within that window, the task will be scheduled at a random time within the window.
  4. If we are outside the configured window, the task will start immediately.

Example Usage

package main

import(
	"context"
	"github.com/LukeHagar/plexgo"
	"log"
)

func main() {
    ctx := context.Background()
    
    s := plexgo.New(
        plexgo.WithSecurity("<YOUR_API_KEY_HERE>"),
    )

    res, err := s.Butler.StartAllTasks(ctx)
    if err != nil {
        log.Fatal(err)
    }
    if res != nil {
        // handle response
    }
}

Parameters

Parameter Type Required Description
ctx context.Context ✔️ The context to use for the request.
opts []operations.Option ➖ The options for this request.

Response

*operations.StartAllTasksResponse, error

Errors

Error Type Status Code Content Type
sdkerrors.StartAllTasksBadRequest 400 application/json
sdkerrors.StartAllTasksUnauthorized 401 application/json
sdkerrors.SDKError 4XX, 5XX */*

StopAllTasks

This endpoint will stop all currently running tasks and remove any scheduled tasks from the queue.

Example Usage

package main

import(
	"context"
	"github.com/LukeHagar/plexgo"
	"log"
)

func main() {
    ctx := context.Background()
    
    s := plexgo.New(
        plexgo.WithSecurity("<YOUR_API_KEY_HERE>"),
    )

    res, err := s.Butler.StopAllTasks(ctx)
    if err != nil {
        log.Fatal(err)
    }
    if res != nil {
        // handle response
    }
}

Parameters

Parameter Type Required Description
ctx context.Context ✔️ The context to use for the request.
opts []operations.Option ➖ The options for this request.

Response

*operations.StopAllTasksResponse, error

Errors

Error Type Status Code Content Type
sdkerrors.StopAllTasksBadRequest 400 application/json
sdkerrors.StopAllTasksUnauthorized 401 application/json
sdkerrors.SDKError 4XX, 5XX */*

StartTask

This endpoint will attempt to start a single Butler task that is enabled in the settings. Butler tasks normally run automatically during a time window configured on the server's Settings page but can be manually started using this endpoint. Tasks will run with the following criteria:

  1. Any tasks not scheduled to run on the current day will be skipped.
  2. If a task is configured to run at a random time during the configured window and we are outside that window, the task will start immediately.
  3. If a task is configured to run at a random time during the configured window and we are within that window, the task will be scheduled at a random time within the window.
  4. If we are outside the configured window, the task will start immediately.

Example Usage

package main

import(
	"context"
	"github.com/LukeHagar/plexgo"
	"github.com/LukeHagar/plexgo/models/operations"
	"log"
)

func main() {
    ctx := context.Background()
    
    s := plexgo.New(
        plexgo.WithSecurity("<YOUR_API_KEY_HERE>"),
    )

    res, err := s.Butler.StartTask(ctx, operations.TaskNameCleanOldBundles)
    if err != nil {
        log.Fatal(err)
    }
    if res != nil {
        // handle response
    }
}

Parameters

Parameter Type Required Description
ctx context.Context ✔️ The context to use for the request.
taskName operations.TaskName ✔️ the name of the task to be started.
opts []operations.Option ➖ The options for this request.

Response

*operations.StartTaskResponse, error

Errors

Error Type Status Code Content Type
sdkerrors.StartTaskBadRequest 400 application/json
sdkerrors.StartTaskUnauthorized 401 application/json
sdkerrors.SDKError 4XX, 5XX */*

StopTask

This endpoint will stop a currently running task by name, or remove it from the list of scheduled tasks if it exists. See the section above for a list of task names for this endpoint.

Example Usage

package main

import(
	"context"
	"github.com/LukeHagar/plexgo"
	"github.com/LukeHagar/plexgo/models/operations"
	"log"
)

func main() {
    ctx := context.Background()
    
    s := plexgo.New(
        plexgo.WithSecurity("<YOUR_API_KEY_HERE>"),
    )

    res, err := s.Butler.StopTask(ctx, operations.PathParamTaskNameBackupDatabase)
    if err != nil {
        log.Fatal(err)
    }
    if res != nil {
        // handle response
    }
}

Parameters

Parameter Type Required Description
ctx context.Context ✔️ The context to use for the request.
taskName operations.PathParamTaskName ✔️ The name of the task to be started.
opts []operations.Option ➖ The options for this request.

Response

*operations.StopTaskResponse, error

Errors

Error Type Status Code Content Type
sdkerrors.StopTaskBadRequest 400 application/json
sdkerrors.StopTaskUnauthorized 401 application/json
sdkerrors.SDKError 4XX, 5XX */*