types

package
v0.5.10 Latest Latest
Warning

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

 Go to latest Published: Oct 30, 2017 License: Apache-2.0 Imports: 8 Imported by: 0

Documentation

Overview

Package types contains request/response types and codes for the server.

Index

Constants

View Source 
const (
	CodeInternal          = "internal_error"
	CodeEvaluation        = "evaluation_error"
	CodeUnauthorized      = "unauthorized"
	CodeInvalidParameter  = "invalid_parameter"
	CodeInvalidOperation  = "invalid_operation"
	CodeResourceNotFound  = "resource_not_found"
	CodeResourceConflict  = "resource_conflict"
	CodeUndefinedDocument = "undefined_document"
)

Error codes returned by OPA's REST API.

View Source 
const (
	MsgCompileModuleError         = "error(s) occurred while compiling module(s)"
	MsgCompileQueryError          = "error(s) occurred while compiling query"
	MsgEvaluationError            = "error(s) occurred while evaluating query"
	MsgUnauthorizedUndefinedError = "authorization policy missing or undefined"
	MsgUnauthorizedError          = "request rejected by administrative policy"
	MsgUndefinedError             = "document missing or undefined"
	MsgDiagnosticsDisabled        = "diagnostics are not enabled"
)

Messages included in error responses.

View Source 
const (
	// ParamQueryV1 defines the name of the HTTP URL parameter that specifies
	// values for the request query.
	ParamQueryV1 = "q"

	// ParamInputV1 defines the name of the HTTP URL parameter that specifies
	// values for the "input" document.
	ParamInputV1 = "input"

	// ParamPrettyV1 defines the name of the HTTP URL parameter that indicates
	// the client wants to receive a pretty-printed version of the response.
	ParamPrettyV1 = "pretty"

	// ParamExplainV1 defines the name of the HTTP URL parameter that indicates the
	// client wants to receive explanations in addition to the result.
	ParamExplainV1 = "explain"

	// ParamMetricsV1 defines the name of the HTTP URL parameter that indicates
	// the client wants to receive performance metrics in addition to the
	// result.
	ParamMetricsV1 = "metrics"

	// ParamWatchV1 defines the name of the HTTP URL parameter that indicates
	// the client wants to set a watch on the current query or data reference.
	ParamWatchV1 = "watch"
)

Variables

This section is empty.

Functions

func BadPatchOperationErr 

func BadPatchOperationErr(op string) error

BadPatchOperationErr returns BadRequestErr indicating the patch operation was invalid.

func BadPatchPathErr 

func BadPatchPathErr(path string) error

BadPatchPathErr returns BadRequestErr indicating the patch path was invalid.

func IsBadRequest 

func IsBadRequest(err error) bool

IsBadRequest returns true if err is a BadRequestErr.

func IsWriteConflict 

func IsWriteConflict(err error) bool

IsWriteConflict returns true if err is a WriteConflictErr.

Types

type AdhocQueryResultSetV1 

type AdhocQueryResultSetV1 []map[string]interface{}

AdhocQueryResultSetV1 models the result of a Query API query.

type BadRequestErr 

type BadRequestErr string

BadRequestErr represents an error condition raised if the caller passes invalid parameters.

func (BadRequestErr) Error 

func (err BadRequestErr) Error() string

type BindingV1 

type BindingV1 struct {
	Key   *ast.Term `json:"key"`
	Value *ast.Term `json:"value"`
}

BindingV1 represents a single term binding.

func NewBindingsV1 

func NewBindingsV1(locals *ast.ValueMap) (result []*BindingV1)

NewBindingsV1 returns a new BindingsV1 object.

type BindingsV1 

type BindingsV1 []*BindingV1

BindingsV1 represents a set of term bindings.

type DataRequestV1 

type DataRequestV1 struct {
	Input *interface{} `json:"input"`
}

DataRequestV1 models the request message for Data API POST operations.

type DataResponseV1 

type DataResponseV1 struct {
	DecisionID  string       `json:"decision_id,omitempty"`
	Explanation TraceV1      `json:"explanation,omitempty"`
	Metrics     MetricsV1    `json:"metrics,omitempty"`
	Result      *interface{} `json:"result,omitempty"`
}

DataResponseV1 models the response message for Data API read operations.

type DiagnosticsResponseElementV1 added in v0.5.5 

type DiagnosticsResponseElementV1 struct {
	DecisionID  string       `json:"decision_id,omitempty"`
	RemoteAddr  string       `json:"remote_addr"`
	Query       string       `json:"query"`
	Timestamp   string       `json:"timestamp"`
	Input       interface{}  `json:"input,omitempty"`
	Result      *interface{} `json:"result,omitempty"`
	Error       *ErrorV1     `json:"error,omitempty"`
	Explanation TraceV1      `json:"explanation,omitempty"`
	Metrics     MetricsV1    `json:"metrics,omitempty"`
}

DiagnosticsResponseElementV1 models an element in the response message for the Diagnostics API.

type DiagnosticsResponseV1 added in v0.5.9 

type DiagnosticsResponseV1 struct {
	Result []DiagnosticsResponseElementV1 `json:"result"`
}

DiagnosticsResponseV1 models the response message for diagnostics reads.

type ErrorV1 

type ErrorV1 struct {
	Code    string  `json:"code"`
	Message string  `json:"message"`
	Errors  []error `json:"errors,omitempty"`
}

ErrorV1 models an error response sent to the client.

func NewErrorV1 

func NewErrorV1(code, f string, a ...interface{}) *ErrorV1

NewErrorV1 returns a new ErrorV1 object.

func (*ErrorV1) Bytes 

func (e *ErrorV1) Bytes() []byte

Bytes marshals e with indentation for readability.

func (*ErrorV1) WithASTErrors 

func (e *ErrorV1) WithASTErrors(errors []*ast.Error) *ErrorV1

WithASTErrors updates e to include detailed AST errors.

func (*ErrorV1) WithError 

func (e *ErrorV1) WithError(err error) *ErrorV1

WithError updates e to include a detailed error.

type ExplainModeV1 

type ExplainModeV1 string

ExplainModeV1 defines supported values for the "explain" query parameter. 

const (
	ExplainOffV1   ExplainModeV1 = "off"
	ExplainFullV1  ExplainModeV1 = "full"
	ExplainTruthV1 ExplainModeV1 = "truth"
)

Explanation mode enumeration.

type MetricsV1 added in v0.4.9 

type MetricsV1 map[string]interface{}

MetricsV1 models a collection of performance metrics.

type PatchV1 

type PatchV1 struct {
	Op    string      `json:"op"`
	Path  string      `json:"path"`
	Value interface{} `json:"value"`
}

PatchV1 models a single patch operation against a document.

type PolicyDeleteResponseV1 added in v0.5.6 

type PolicyDeleteResponseV1 struct {
	Metrics MetricsV1 `json:"metrics,omitempty"`
}

PolicyDeleteResponseV1 models the response message for the Policy API delete operation.

type PolicyGetResponseV1 

type PolicyGetResponseV1 struct {
	Result PolicyV1 `json:"result"`
}

PolicyGetResponseV1 models the response message for the Policy API get operation.

type PolicyListResponseV1 

type PolicyListResponseV1 struct {
	Result []PolicyV1 `json:"result"`
}

PolicyListResponseV1 models the response mesasge for the Policy API list operation.

type PolicyPutResponseV1 

type PolicyPutResponseV1 struct {
	Metrics MetricsV1 `json:"metrics,omitempty"`
}

PolicyPutResponseV1 models the response message for the Policy API put operation.

type PolicyV1 

type PolicyV1 struct {
	ID  string      `json:"id"`
	Raw string      `json:"raw"`
	AST *ast.Module `json:"ast"`
}

PolicyV1 models a policy module in OPA.

func (PolicyV1) Equal 

func (p PolicyV1) Equal(other PolicyV1) bool

Equal returns true if p is equal to other.

type QueryResponseV1 

type QueryResponseV1 struct {
	Explanation TraceV1               `json:"explanation,omitempty"`
	Metrics     MetricsV1             `json:"metrics,omitempty"`
	Result      AdhocQueryResultSetV1 `json:"result"`
}

QueryResponseV1 models the response message for Query API operations.

type QueryResultSetV1 

type QueryResultSetV1 []*QueryResultV1

QueryResultSetV1 models the result of a Data API query when the query would return multiple values for the document.

func NewQueryResultSetV1 

func NewQueryResultSetV1(qrs topdown.QueryResultSet) *QueryResultSetV1

NewQueryResultSetV1 returns a new QueryResultSetV1 object.

type QueryResultV1 

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

QueryResultV1 models a single result of a Data API query that would return multiple values for the document. The bindings can be used to differentiate between results.

func (*QueryResultV1) MarshalJSON 

func (qr *QueryResultV1) MarshalJSON() ([]byte, error)

MarshalJSON serializes the QueryResultV1 object as an array.

type TraceEventV1 

type TraceEventV1 struct {
	Op       string      `json:"op"`
	QueryID  uint64      `json:"query_id"`
	ParentID uint64      `json:"parent_id"`
	Type     string      `json:"type"`
	Node     interface{} `json:"node"`
	Locals   BindingsV1  `json:"locals"`
}

TraceEventV1 represents a step in the query evaluation process.

func (*TraceEventV1) UnmarshalJSON 

func (te *TraceEventV1) UnmarshalJSON(bs []byte) error

UnmarshalJSON deserializes a TraceEventV1 object. The Node field is deserialized based on the type hint from the type property in the JSON object.

type TraceV1 

type TraceV1 json.RawMessage

TraceV1 models the trace result returned for queries that include the "explain" parameter.

func NewTraceV1 

func NewTraceV1(trace []*topdown.Event, pretty bool) (result TraceV1, err error)

NewTraceV1 returns a new TraceV1 object.

func (TraceV1) MarshalJSON added in v0.5.5 

func (t TraceV1) MarshalJSON() ([]byte, error)

MarshalJSON unmarshals the TraceV1 to a JSON representation.

func (*TraceV1) UnmarshalJSON added in v0.5.5 

func (t *TraceV1) UnmarshalJSON(b []byte) error

UnmarshalJSON unmarshals the TraceV1 from a JSON representation.

type TraceV1Pretty added in v0.5.5 

type TraceV1Pretty []string

TraceV1Pretty models the trace result returned for queries that include the "explain" parameter. The trace is modelled as a human readable array of strings representing the evaluation of the query.

func (*TraceV1Pretty) UnmarshalJSON added in v0.5.5 

func (t *TraceV1Pretty) UnmarshalJSON(b []byte) error

UnmarshalJSON unmarshals the TraceV1Pretty from a JSON representation.

type TraceV1Raw added in v0.5.5 

type TraceV1Raw []TraceEventV1

TraceV1Raw models the trace result returned for queries that include the "explain" parameter. The trace is modelled as series of trace events that identify the expression, local term bindings, query hierarchy, etc.

func (*TraceV1Raw) UnmarshalJSON added in v0.5.5 

func (t *TraceV1Raw) UnmarshalJSON(b []byte) error

UnmarshalJSON unmarshals the TraceV1Raw from a JSON representation.

type WatchResponseV1 added in v0.5.3 

type WatchResponseV1 struct {
	Explanation TraceV1     `json:"explanation,omitempty"`
	Metrics     MetricsV1   `json:"metrics,omitempty"`
	Result      interface{} `json:"result"`

	// The Error needs to be in the response since we've hijacked the connection
	// when writing WatchResponseV1 streams.
	Error *ErrorV1 `json:"error,omitempty"`
}

WatchResponseV1 models a message in the response stream for a watch.

type WriteConflictErr 

type WriteConflictErr struct {
	Path storage.Path
}

WriteConflictErr represents an error condition raised if the caller attempts to modify a virtual document or create a document at a path that conflicts with an existing document.

func (WriteConflictErr) Error 

func (err WriteConflictErr) Error() string

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.