rest

Documentation

Index

• Constants
• type Client
  • func NewClient(c *vim25.Client) *Client
  • func (c *Client) Do(ctx context.Context, req *http.Request, resBody interface{}) error
  • func (c *Client) Login(ctx context.Context, user *url.Userinfo) error
  • func (c *Client) LoginByToken(ctx context.Context) error
  • func (c *Client) Logout(ctx context.Context) error
  • func (c *Client) Resource(path string) *Resource
  • func (c *Client) Session(ctx context.Context) (*Session, error)
  • func (c *Client) WithSigner(ctx context.Context, s Signer) context.Context
• type LocalizableMessage
  • func (m *LocalizableMessage) Error() string
• type Resource
  • func (r *Resource) Request(method string, body ...interface{}) *http.Request
  • func (r *Resource) String() string
  • func (r *Resource) WithAction(action string) *Resource
  • func (r *Resource) WithID(id string) *Resource
  • func (r *Resource) WithParam(name string, value string) *Resource
• type Session
• type Signer

Constants

const (
	Path = "/rest"
)

Types

type Client

type Client struct {
	*soap.Client
}

Client extends soap.Client to support JSON encoding, while inheriting security features, debug tracing and session persistence.

func NewClient

func NewClient(c *vim25.Client) *Client

NewClient creates a new Client instance.

func (*Client) Do

func (c *Client) Do(ctx context.Context, req *http.Request, resBody interface{}) error

Do sends the http.Request, decoding resBody if provided.

func (*Client) Login

func (c *Client) Login(ctx context.Context, user *url.Userinfo) error

Login creates a new session via Basic Authentication with the given url.Userinfo.

func (*Client) LoginByToken

func (c *Client) LoginByToken(ctx context.Context) error

func (*Client) Logout

func (c *Client) Logout(ctx context.Context) error

Logout deletes the current session.

func (*Client) Resource

func (c *Client) Resource(path string) *Resource

Resource helper for the given path.

func (*Client) Session

func (c *Client) Session(ctx context.Context) (*Session, error)

Session returns the user's current session. Nil is returned if the session is not authenticated.

func (*Client) WithSigner

func (c *Client) WithSigner(ctx context.Context, s Signer) context.Context

type LocalizableMessage

type LocalizableMessage struct {
	Args           []string `json:"args,omitempty"`
	DefaultMessage string   `json:"default_message,omitempty"`
	ID             string   `json:"id,omitempty"`
}

LocalizableMessage represents a localizable error

func (*LocalizableMessage) Error

func (m *LocalizableMessage) Error() string

type Resource

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

Resource wraps url.URL with helpers

func (*Resource) Request

func (r *Resource) Request(method string, body ...interface{}) *http.Request

Request returns a new http.Request for the given method. An optional body can be provided for POST and PATCH methods.

func (*Resource) String

func (r *Resource) String() string

func (*Resource) WithAction

func (r *Resource) WithAction(action string) *Resource

WithAction sets adds action to the URL.RawQuery

func (*Resource) WithID

func (r *Resource) WithID(id string) *Resource

WithID appends id to the URL.Path

func (*Resource) WithParam

func (r *Resource) WithParam(name string, value string) *Resource

WithParam sets adds a parameter to the URL.RawQuery

type Session

type Session struct {
	User         string    `json:"user"`
	Created      time.Time `json:"created_time"`
	LastAccessed time.Time `json:"last_accessed_time"`
}

Session information

type Signer

type Signer interface {
	SignRequest(*http.Request) error
}