gs

Documentation

Index

• Constants
• Variables
• func AwaitCompletion(ctx context.Context, a types.API, o objectWithStateRetriever) error
• type GenericService
  • func (gs *GenericService) FilterAPIResponse(ctx context.Context, res *http.Response) (*http.Response, error)
• type HasState
  • func (hs HasState) StateError() bool
  • func (hs HasState) StateOK() bool
  • func (hs HasState) StatePending() bool
• type State
  • func (s State) MarshalJSON() ([]byte, error)
  • func (s State) StateError() bool
  • func (s State) StateOK() bool
  • func (s State) StatePending() bool
• type StateRetriever

Constants

const (
	// StateTypeError is used for states of type error
	StateTypeError = 0
	// StateTypeOK is used for states of type OK
	StateTypeOK = 1
	// StateTypePending is used for states of type Pending
	StateTypePending = 2
)

State types defined for GS resources by the Engine

Variables

var (
	// ErrStateError is returned if a resource could not be provisioned (state "Error")
	ErrStateError = errors.New("resource is in an error state")

	// ErrStateUnknown is returned if a resource has an unknown state
	ErrStateUnknown = errors.New("resource is in an unknown state")
)

Functions

func AwaitCompletion

func AwaitCompletion(ctx context.Context, a types.API, o objectWithStateRetriever) error

AwaitCompletion blocks until an object is no longer pending

Types

type GenericService

type GenericService struct{}

GenericService has methods overridden for all GS objects in the same way

func (*GenericService) FilterAPIResponse

func (gs *GenericService) FilterAPIResponse(ctx context.Context, res *http.Response) (*http.Response, error)

FilterAPIResponse replaces the API response with an empty json object

type HasState

type HasState struct {
	State State `json:"state"`
}

func (HasState) StateError

func (hs HasState) StateError() bool

StateError checks if the state is marking any failure

func (HasState) StateOK

func (hs HasState) StateOK() bool

StateOK checks if the state is one of the successful ones

func (HasState) StatePending

func (hs HasState) StatePending() bool

StatePending checks if the state is marking any change currently being applied

type State

type State struct {
	// programatically usable enum value
	ID string `json:"id"`

	// human readable status text
	Text string `json:"text"`

	Type int `json:"type"`
}

State represents the state object available on GS resources

func (State) MarshalJSON

func (s State) MarshalJSON() ([]byte, error)

func (State) StateError

func (s State) StateError() bool

StateError checks if the state is marking any failure

func (State) StateOK

func (s State) StateOK() bool

StateOK checks if the state is one of the successful ones

func (State) StatePending

func (s State) StatePending() bool

StatePending checks if the state is marking any change currently being applied

type StateRetriever

type StateRetriever interface {
	StateOK() bool
	StatePending() bool
	StateError() bool
}

StateRetriever is an interface Objects can implement to provide unified state information