api

Documentation

Overview

Package api implements REST API support for Aptomi, including user-level and admin-level calls. It relies on httprouter to process HTTP requests and serve HTTP responses.

Index

• Variables
• func Serve(router *httprouter.Router, store store.Core, externalData *external.Data)
• type Endpoints
• type PolicyUpdateResult
  • func (result *PolicyUpdateResult) AsColumns() map[string]string
  • func (result *PolicyUpdateResult) GetDefaultColumns() []string
• type ServerError
  • func NewServerError(error string) *ServerError
• type Version

Variables

var EndpointsObject = &runtime.Info{
	Kind:        "endpoints",
	Constructor: func() runtime.Object { return &Endpoints{} },
}

EndpointsObject is an informational data structure with Kind and Constructor for Endpoints

var (
	// Objects is a list of all objects used in API
	Objects = runtime.AppendAll([]*runtime.Info{
		EndpointsObject,
		PolicyUpdateResultObject,
		VersionObject,
		ServerErrorObject,
	}, lang.PolicyObjects, engine.Objects)
)

var PolicyUpdateResultObject = &runtime.Info{
	Kind:        "policy-update-result",
	Constructor: func() runtime.Object { return &PolicyUpdateResult{} },
}

PolicyUpdateResultObject is an informational data structure with Kind and Constructor for PolicyUpdateResult

var ServerErrorObject = &runtime.Info{
	Kind:        "error",
	Constructor: func() runtime.Object { return &ServerError{} },
}

ServerErrorObject contains Info for the Error type

var VersionObject = &runtime.Info{
	Kind:        "version",
	Constructor: func() runtime.Object { return &Version{} },
}

VersionObject is an informational data structure with Kind and Constructor for Version

Functions

func Serve

func Serve(router *httprouter.Router, store store.Core, externalData *external.Data)

Serve initializes everything needed by REST API and registers all API endpoints in the provided http router

Types

type Endpoints

type Endpoints struct {
	runtime.TypeKind `yaml:",inline"`
	List             map[string]map[string]string
}

Endpoints object represents

type PolicyUpdateResult

type PolicyUpdateResult struct {
	runtime.TypeKind `yaml:",inline"`
	PolicyGeneration runtime.Generation
	PolicyChanged    bool
	Actions          []string
}

PolicyUpdateResult represents results for the policy update request (estimated list of actions to be executed to update existing actual state to the desired state)

func (*PolicyUpdateResult) AsColumns

func (result *PolicyUpdateResult) AsColumns() map[string]string

AsColumns returns PolicyUpdateResult representation as columns

func (*PolicyUpdateResult) GetDefaultColumns

func (result *PolicyUpdateResult) GetDefaultColumns() []string

GetDefaultColumns returns default set of columns to be displayed

type ServerError

type ServerError struct {
	runtime.TypeKind `yaml:",inline"`
	Error            string
}

ServerError represents error that could be returned from the API

func NewServerError

func NewServerError(error string) *ServerError

NewServerError returns instance of the error based on the provided error

type Version

type Version struct {
	runtime.TypeKind  `yaml:",inline"`
	version.BuildInfo `yaml:",inline"`
}

Version represents build info in the API