importapi

Documentation

Index

• type Client
  • func New(importAPIURL string) *Client
  • func (c *Client) Checker(ctx context.Context, check *health.CheckState) error
  • func (c *Client) GetImportJob(ctx context.Context, importJobID, serviceToken string) (ImportJob, bool, error)
  • func (c *Client) UpdateImportJobState(ctx context.Context, jobID, serviceToken string, newState string) error
• type ErrInvalidAPIResponse
  • func NewAPIResponse(resp *http.Response, uri string) (e *ErrInvalidAPIResponse)
  • func (e ErrInvalidAPIResponse) Code() int
  • func (e ErrInvalidAPIResponse) Error() string
• type ImportJob
• type InstanceLink
• type LinkMap

Types

type Client

type Client struct {
	// contains filtered or unexported fields
}

Client is an import api client which can be used to make requests to the API

func New

func New(importAPIURL string) *Client

New creates new instance of Client with a give import api url

func (*Client) Checker

func (c *Client) Checker(ctx context.Context, check *health.CheckState) error

Checker calls import api health endpoint and returns a check object to the caller.

func (*Client) GetImportJob

func (c *Client) GetImportJob(ctx context.Context, importJobID, serviceToken string) (ImportJob, bool, error)

GetImportJob asks the Import API for the details for an Import job

func (*Client) UpdateImportJobState

func (c *Client) UpdateImportJobState(ctx context.Context, jobID, serviceToken string, newState string) error

UpdateImportJobState tells the Import API that the state has changed of an Import job

type ErrInvalidAPIResponse

type ErrInvalidAPIResponse struct {
	// contains filtered or unexported fields
}

ErrInvalidAPIResponse is returned when the api does not respond with a valid status

func NewAPIResponse

func NewAPIResponse(resp *http.Response, uri string) (e *ErrInvalidAPIResponse)

NewAPIResponse creates an error response, optionally adding body to e when status is 404

func (ErrInvalidAPIResponse) Code

func (e ErrInvalidAPIResponse) Code() int

Code returns the status code received from the api if an error is returned

func (ErrInvalidAPIResponse) Error

func (e ErrInvalidAPIResponse) Error() string

Error should be called by the user to print out the stringified version of the error

type ImportJob

type ImportJob struct {
	JobID string  `json:"id"`
	Links LinkMap `json:"links,omitempty"`
}

ImportJob comes from the Import API and links an import job to its (other) instances

type InstanceLink

type InstanceLink struct {
	ID   string `json:"id"`
	Link string `json:"href"`
}

InstanceLink identifies an (instance or import-job) by id and url (from Import API)

type LinkMap

type LinkMap struct {
	Instances []InstanceLink `json:"instances"`
}

LinkMap is an array of instance links associated with am import job