putruleset
packageThis package is not in the latest version of its module.
Details
Validgo.mod file
The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license
Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version
Modules with tagged versions give importers more predictable builds.
Stable version
When a project reaches major version v1 it is considered stable.
- Learn more about best practices
Repository
Links
Documentation¶
Overview¶
Create or update a query ruleset.There is a limit of 100 rules per ruleset.This limit can be increased by using the`xpack.applications.rules.max_rules_per_ruleset` cluster setting.
IMPORTANT: Due to limitations within pinned queries, you can only selectdocuments using `ids` or `docs`, but cannot use both in single rule.It is advised to use one or the other in query rulesets, to avoid errors.Additionally, pinned queries have a maximum limit of 100 pinned hits.If multiple matching rules pin more than 100 documents, only the first 100documents are pinned in the order they are specified in the ruleset.
Index¶
- Variables
- type NewPutRuleset
- type PutRuleset
- func (r PutRuleset) Do(providedCtx context.Context) (*Response, error)
- func (r *PutRuleset) ErrorTrace(errortrace bool) *PutRuleset
- func (r *PutRuleset) FilterPath(filterpaths ...string) *PutRuleset
- func (r *PutRuleset) Header(key, value string) *PutRuleset
- func (r *PutRuleset) HttpRequest(ctx context.Context) (*http.Request, error)
- func (r *PutRuleset) Human(human bool) *PutRuleset
- func (r PutRuleset) Perform(providedCtx context.Context) (*http.Response, error)
- func (r *PutRuleset) Pretty(pretty bool) *PutRuleset
- func (r *PutRuleset) Raw(raw io.Reader) *PutRuleset
- func (r *PutRuleset) Request(req *Request) *PutRuleset
- func (r *PutRuleset) Rules(rules ...types.QueryRule) *PutRuleset
- type Request
- type Response
Constants¶
This section is empty.
Variables¶
var ErrBuildPath =errors.New("cannot build path, check for missing path parameters")ErrBuildPath is returned in case of missing parameters within the build of the request.
Functions¶
This section is empty.
Types¶
typeNewPutRuleset¶
type NewPutRuleset func(rulesetidstring) *PutRuleset
NewPutRuleset type alias for index.
funcNewPutRulesetFunc¶
func NewPutRulesetFunc(tpelastictransport.Interface)NewPutRuleset
NewPutRulesetFunc returns a new instance of PutRuleset with the provided transport.Used in the index of the library this allows to retrieve every apis in once place.
typePutRuleset¶
type PutRuleset struct {// contains filtered or unexported fields}funcNew¶
func New(tpelastictransport.Interface) *PutRuleset
Create or update a query ruleset.There is a limit of 100 rules per ruleset.This limit can be increased by using the`xpack.applications.rules.max_rules_per_ruleset` cluster setting.
IMPORTANT: Due to limitations within pinned queries, you can only selectdocuments using `ids` or `docs`, but cannot use both in single rule.It is advised to use one or the other in query rulesets, to avoid errors.Additionally, pinned queries have a maximum limit of 100 pinned hits.If multiple matching rules pin more than 100 documents, only the first 100documents are pinned in the order they are specified in the ruleset.
https://www.elastic.co/guide/en/elasticsearch/reference/current/put-query-ruleset.html
func (PutRuleset)Do¶
func (rPutRuleset) Do(providedCtxcontext.Context) (*Response,error)
Do runs the request through the transport, handle the response and returns a putruleset.Response
func (*PutRuleset)ErrorTrace¶
func (r *PutRuleset) ErrorTrace(errortracebool) *PutRuleset
ErrorTrace When set to `true` Elasticsearch will include the full stack trace of errorswhen they occur.API name: error_trace
func (*PutRuleset)FilterPath¶
func (r *PutRuleset) FilterPath(filterpaths ...string) *PutRuleset
FilterPath Comma-separated list of filters in dot notation which reduce the responsereturned by Elasticsearch.API name: filter_path
func (*PutRuleset)Header¶
func (r *PutRuleset) Header(key, valuestring) *PutRuleset
Header set a key, value pair in the PutRuleset headers map.
func (*PutRuleset)HttpRequest¶
HttpRequest returns the http.Request object built from thegiven parameters.
func (*PutRuleset)Human¶
func (r *PutRuleset) Human(humanbool) *PutRuleset
Human When set to `true` will return statistics in a format suitable for humans.For example `"exists_time": "1h"` for humans and`"eixsts_time_in_millis": 3600000` for computers. When disabled the humanreadable values will be omitted. This makes sense for responses beingconsumedonly by machines.API name: human
func (PutRuleset)Perform¶
Perform runs the http.Request through the provided transport and returns an http.Response.
func (*PutRuleset)Pretty¶
func (r *PutRuleset) Pretty(prettybool) *PutRuleset
Pretty If set to `true` the returned JSON will be "pretty-formatted". Only usethis option for debugging only.API name: pretty
func (*PutRuleset)Raw¶
func (r *PutRuleset) Raw(rawio.Reader) *PutRuleset
Raw takes a json payload as input which is then passed to the http.RequestIf specified Raw takes precedence on Request method.
func (*PutRuleset)Request¶
func (r *PutRuleset) Request(req *Request) *PutRuleset
Request allows to set the request property with the appropriate payload.
func (*PutRuleset)Rules¶
func (r *PutRuleset) Rules(rules ...types.QueryRule) *PutRuleset
API name: rules
typeRequest¶
Request holds the request body struct for the package putruleset