sessions

package
v0.0.58 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 3, 2025 License: MPL-2.0 Imports: 11 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Client

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

Client is a client for this collection

func NewClient

func NewClient(c *api.Client) *Client

Creates a new client for this collection. The submitted API client is cloned; modifications to it after generating this client will not have effect. If you need to make changes to the underlying API client, use ApiClient() to access it.

func (*Client) ApiClient

func (c *Client) ApiClient() *api.Client

ApiClient returns the underlying API client

func (*Client) Cancel

func (c *Client) Cancel(ctx context.Context, sessionId string, version uint32, opt ...Option) (*SessionUpdateResult, error)

func (*Client) List

func (c *Client) List(ctx context.Context, scopeId string, opt ...Option) (*SessionListResult, error)

func (*Client) ListNextPage added in v0.0.53

func (c *Client) ListNextPage(ctx context.Context, currentPage *SessionListResult, opt ...Option) (*SessionListResult, error)

func (*Client) Read

func (c *Client) Read(ctx context.Context, id string, opt ...Option) (*SessionReadResult, error)

type Connection added in v0.0.21

type Connection struct {
	ClientTcpAddress   string `json:"client_tcp_address,omitempty"`
	ClientTcpPort      uint32 `json:"client_tcp_port,omitempty"`
	EndpointTcpAddress string `json:"endpoint_tcp_address,omitempty"`
	EndpointTcpPort    uint32 `json:"endpoint_tcp_port,omitempty"`
	BytesUp            int64  `json:"bytes_up,string,omitempty"`
	BytesDown          int64  `json:"bytes_down,string,omitempty"`
	ClosedReason       string `json:"closed_reason,omitempty"`
}

type Option

type Option func(*options)

Option is a func that sets optional attributes for a call. This does not need to be used directly, but instead option arguments are built from the functions in this package. WithX options set a value to that given in the argument; DefaultX options indicate that the value should be set to its default. When an API call is made options are processed in the order they appear in the function call, so for a given argument X, a succession of WithX or DefaultX calls will result in the last call taking effect.

func DefaultIncludeTerminated added in v0.0.25

func DefaultIncludeTerminated() Option

func WithAutomaticVersioning

func WithAutomaticVersioning(enable bool) Option

If set, and if the version is zero during an update, the API will perform a fetch to get the current version of the resource and populate it during the update call. This is convenient but opens up the possibility for subtle order-of-modification issues, so use carefully.

func WithClientDirectedPagination added in v0.0.53

func WithClientDirectedPagination(with bool) Option

WithClientDirectedPagination tells the List function to return only the first page, if more pages are available

func WithFilter added in v0.0.6

func WithFilter(filter string) Option

WithFilter tells the API to filter the items returned using the provided filter term. The filter should be in a format supported by hashicorp/go-bexpr.

func WithIncludeTerminated added in v0.0.25

func WithIncludeTerminated(inIncludeTerminated bool) Option

func WithListToken added in v0.0.44

func WithListToken(listToken string) Option

WithListToken tells the API to use the provided list token for listing operations on this resource.

func WithPageSize added in v0.0.53

func WithPageSize(with uint32) Option

WithPageSize controls the size of pages used during List

func WithRecursive added in v0.0.4

func WithRecursive(recurse bool) Option

WithRecursive tells the API to use recursion for listing operations on this resource

func WithResourcePathOverride added in v0.0.53

func WithResourcePathOverride(path string) Option

WithResourcePathOverride tells the API to use the provided resource path

func WithSkipCurlOutput added in v0.0.4

func WithSkipCurlOutput(skip bool) Option

WithSkipCurlOutput tells the API to not use the current call for cURL output. Useful for when we need to look up versions.

type Session

type Session struct {
	Id                string            `json:"id,omitempty"`
	TargetId          string            `json:"target_id,omitempty"`
	Scope             *scopes.ScopeInfo `json:"scope,omitempty"`
	CreatedTime       time.Time         `json:"created_time,omitempty"`
	UpdatedTime       time.Time         `json:"updated_time,omitempty"`
	Version           uint32            `json:"version,omitempty"`
	Type              string            `json:"type,omitempty"`
	ExpirationTime    time.Time         `json:"expiration_time,omitempty"`
	AuthTokenId       string            `json:"auth_token_id,omitempty"`
	UserId            string            `json:"user_id,omitempty"`
	HostSetId         string            `json:"host_set_id,omitempty"`
	HostId            string            `json:"host_id,omitempty"`
	ScopeId           string            `json:"scope_id,omitempty"`
	Endpoint          string            `json:"endpoint,omitempty"`
	States            []*SessionState   `json:"states,omitempty"`
	Status            string            `json:"status,omitempty"`
	Certificate       []byte            `json:"certificate,omitempty"`
	TerminationReason string            `json:"termination_reason,omitempty"`
	AuthorizedActions []string          `json:"authorized_actions,omitempty"`
	Connections       []*Connection     `json:"connections,omitempty"`
}

type SessionCreateResult

type SessionCreateResult = SessionReadResult

type SessionDeleteResult

type SessionDeleteResult struct {
	Response *api.Response
}

func (SessionDeleteResult) GetItem added in v0.0.10

func (n SessionDeleteResult) GetItem() any

GetItem will always be nil for SessionDeleteResult

func (SessionDeleteResult) GetResponse added in v0.0.7

func (n SessionDeleteResult) GetResponse() *api.Response

type SessionListResult

type SessionListResult struct {
	Items        []*Session `json:"items,omitempty"`
	EstItemCount uint       `json:"est_item_count,omitempty"`
	RemovedIds   []string   `json:"removed_ids,omitempty"`
	ListToken    string     `json:"list_token,omitempty"`
	ResponseType string     `json:"response_type,omitempty"`
	Response     *api.Response
	// contains filtered or unexported fields
}

func (SessionListResult) GetEstItemCount added in v0.0.44

func (n SessionListResult) GetEstItemCount() uint

func (SessionListResult) GetItems

func (n SessionListResult) GetItems() []*Session

func (SessionListResult) GetListToken added in v0.0.44

func (n SessionListResult) GetListToken() string

func (SessionListResult) GetRemovedIds added in v0.0.44

func (n SessionListResult) GetRemovedIds() []string

func (SessionListResult) GetResponse added in v0.0.7

func (n SessionListResult) GetResponse() *api.Response

func (SessionListResult) GetResponseType added in v0.0.44

func (n SessionListResult) GetResponseType() string

type SessionReadResult

type SessionReadResult struct {
	Item     *Session
	Response *api.Response
}

func (SessionReadResult) GetItem

func (n SessionReadResult) GetItem() *Session

func (SessionReadResult) GetResponse added in v0.0.7

func (n SessionReadResult) GetResponse() *api.Response

type SessionState

type SessionState struct {
	Status    string    `json:"status,omitempty"`
	StartTime time.Time `json:"start_time,omitempty"`
	EndTime   time.Time `json:"end_time,omitempty"`
}

type SessionUpdateResult

type SessionUpdateResult = SessionReadResult

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL