Documentation
¶
Index ¶
- type Action
- type ActionMessage
- type ActionResult
- type ActionSpec
- type Client
- func (c *Client) Actions(actionIDs []string) ([]ActionResult, error)
- func (c *Client) ApplicationCharmActions(appName string) (map[string]ActionSpec, error)
- func (c *Client) Cancel(actionIDs []string) ([]ActionResult, error)
- func (c *Client) EnqueueOperation(actions []Action) (EnqueuedActions, error)
- func (c *Client) ListOperations(arg OperationQueryArgs) (Operations, error)
- func (c *Client) Operation(ID string) (Operation, error)
- func (c *Client) Run(run RunParams) (EnqueuedActions, error)
- func (c *Client) RunOnAllMachines(commands string, timeout time.Duration) (EnqueuedActions, error)
- func (c *Client) WatchActionProgress(actionId string) (watcher.StringsWatcher, error)
- type EnqueuedActions
- type Facade
- type Operation
- type OperationQueryArgs
- type Operations
- type RunParams
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type ActionMessage ¶
ActionMessage represents a logged message on an action.
type ActionResult ¶
type ActionResult struct {
Action *Action
Enqueued time.Time
Started time.Time
Completed time.Time
Status string
Message string
Log []ActionMessage
Output map[string]interface{}
Error error
}
ActionResult is the result of running an action.
type ActionSpec ¶
ActionSpec is a definition of the parameters and traits of an Action. The Params map is expected to conform to JSON-Schema Draft 4 as defined at http://json-schema.org/draft-04/schema# (see http://json-schema.org/latest/json-schema-core.html)
type Client ¶
type Client struct {
base.ClientFacade
// contains filtered or unexported fields
}
Client provides access to the action facade.
func NewClient ¶
func NewClient(st base.APICallCloser) *Client
NewClient returns a new actions client.
func (*Client) Actions ¶
func (c *Client) Actions(actionIDs []string) ([]ActionResult, error)
Actions takes a list of action IDs, and returns the full Action for each ID.
func (*Client) ApplicationCharmActions ¶
func (c *Client) ApplicationCharmActions(appName string) (map[string]ActionSpec, error)
ApplicationCharmActions is a single query which uses ApplicationsCharmsActions to get the charm.Actions for a single Application by tag.
func (*Client) Cancel ¶
func (c *Client) Cancel(actionIDs []string) ([]ActionResult, error)
Cancel attempts to cancel a queued up Action from running.
func (*Client) EnqueueOperation ¶
func (c *Client) EnqueueOperation(actions []Action) (EnqueuedActions, error)
EnqueueOperation takes a list of Actions and queues them up to be executed as an operation, each action running as a task on the the designated ActionReceiver. We return the ID of the overall operation and each individual task.
func (*Client) ListOperations ¶
func (c *Client) ListOperations(arg OperationQueryArgs) (Operations, error)
ListOperations fetches the operation summaries for specified apps/units.
func (*Client) Run ¶
func (c *Client) Run(run RunParams) (EnqueuedActions, error)
Run the Commands specified on the machines identified through the ids provided in the machines, applications and units slices.
func (*Client) RunOnAllMachines ¶
RunOnAllMachines runs the command on all the machines with the specified timeout.
func (*Client) WatchActionProgress ¶
func (c *Client) WatchActionProgress(actionId string) (watcher.StringsWatcher, error)
WatchActionProgress returns a watcher that reports on action log messages. The result strings are json formatted core.actions.ActionMessage objects.
type EnqueuedActions ¶
type EnqueuedActions struct {
OperationID string
Actions []ActionResult
}
EnqueuedActions represents the result of enqueuing actions to run.
type Facade ¶
type Facade struct {
*common.ModelWatcher
// contains filtered or unexported fields
}
Facade allows calls to "ActionPruner" endpoints.
type Operation ¶
type Operation struct {
ID string
Summary string
Enqueued time.Time
Started time.Time
Completed time.Time
Status string
Actions []ActionResult
Error error
}
Operation holds a list of actions run as part of the operation
type OperationQueryArgs ¶
type OperationQueryArgs struct {
Applications []string
Units []string
Machines []string
ActionNames []string
Status []string
// These attributes are used to support client side
// batching of results.
Offset *int
Limit *int
}
OperationQueryArgs holds args for listing operations.
type Operations ¶
Operations holds a list of operations and whether the list has been truncated (used for batch queries).
type RunParams ¶
type RunParams struct {
Commands string
Timeout time.Duration
Machines []string
Applications []string
Units []string
Parallel *bool
ExecutionGroup *string
// WorkloadContext for CAAS is true when the Commands should be run on
// the workload not the operator.
WorkloadContext bool
}
RunParams is used to provide the parameters to the Run method.