putpipeline

package
v9.1.0 Latest Latest
Warning

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

 Go to latest Published: Jul 31, 2025 License: Apache-2.0 Imports: 12 Imported by: 0

Documentation

Overview

Create or update a pipeline. Changes made using this API take effect immediately.

Index

Constants

This section is empty.

Variables

View Source 
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

type NewPutPipeline 

type NewPutPipeline func(id string) *PutPipeline

NewPutPipeline type alias for index.

func NewPutPipelineFunc 

func NewPutPipelineFunc(tp elastictransport.Interface) NewPutPipeline

NewPutPipelineFunc returns a new instance of PutPipeline with the provided transport. Used in the index of the library this allows to retrieve every apis in once place.

type PutPipeline 

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

func New 

func New(tp elastictransport.Interface) *PutPipeline

Create or update a pipeline. Changes made using this API take effect immediately.

https://www.elastic.co/docs/manage-data/ingest/transform-enrich/ingest-pipelines

func (*PutPipeline) Deprecated 

func (r *PutPipeline) Deprecated(deprecated bool) *PutPipeline

Marks this ingest pipeline as deprecated. When a deprecated ingest pipeline is referenced as the default or final pipeline when creating or updating a non-deprecated index template, Elasticsearch will emit a deprecation warning. API name: deprecated

func (*PutPipeline) Description 

func (r *PutPipeline) Description(description string) *PutPipeline

Description of the ingest pipeline. API name: description

func (PutPipeline) Do 

func (r PutPipeline) Do(providedCtx context.Context) (*Response, error)

Do runs the request through the transport, handle the response and returns a putpipeline.Response

func (*PutPipeline) ErrorTrace 

func (r *PutPipeline) ErrorTrace(errortrace bool) *PutPipeline

ErrorTrace When set to `true` Elasticsearch will include the full stack trace of errors when they occur. API name: error_trace

func (*PutPipeline) FilterPath 

func (r *PutPipeline) FilterPath(filterpaths ...string) *PutPipeline

FilterPath Comma-separated list of filters in dot notation which reduce the response returned by Elasticsearch. API name: filter_path

func (*PutPipeline) Header 

func (r *PutPipeline) Header(key, value string) *PutPipeline

Header set a key, value pair in the PutPipeline headers map.

func (*PutPipeline) HttpRequest 

func (r *PutPipeline) HttpRequest(ctx context.Context) (*http.Request, error)

HttpRequest returns the http.Request object built from the given parameters.

func (*PutPipeline) Human 

func (r *PutPipeline) Human(human bool) *PutPipeline

Human When set to `true` will return statistics in a format suitable for humans. For example `"exists_time": "1h"` for humans and `"exists_time_in_millis": 3600000` for computers. When disabled the human readable values will be omitted. This makes sense for responses being consumed only by machines. API name: human

func (*PutPipeline) IfVersion 

func (r *PutPipeline) IfVersion(versionnumber string) *PutPipeline

IfVersion Required version for optimistic concurrency control for pipeline updates API name: if_version

func (*PutPipeline) MasterTimeout 

func (r *PutPipeline) MasterTimeout(duration string) *PutPipeline

MasterTimeout Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. API name: master_timeout

func (*PutPipeline) Meta_ 

func (r *PutPipeline) Meta_(metadata types.MetadataVariant) *PutPipeline

Optional metadata about the ingest pipeline. May have any contents. This map is not automatically generated by Elasticsearch. API name: _meta

func (*PutPipeline) OnFailure 

func (r *PutPipeline) OnFailure(onfailures ...types.ProcessorContainerVariant) *PutPipeline

Processors to run immediately after a processor failure. Each processor supports a processor-level `on_failure` value. If a processor without an `on_failure` value fails, Elasticsearch uses this pipeline-level parameter as a fallback. The processors in this parameter run sequentially in the order specified. Elasticsearch will not attempt to run the pipeline's remaining processors. API name: on_failure

func (PutPipeline) Perform 

func (r PutPipeline) Perform(providedCtx context.Context) (*http.Response, error)

Perform runs the http.Request through the provided transport and returns an http.Response.

func (*PutPipeline) Pretty 

func (r *PutPipeline) Pretty(pretty bool) *PutPipeline

Pretty If set to `true` the returned JSON will be "pretty-formatted". Only use this option for debugging only. API name: pretty

func (*PutPipeline) Processors 

func (r *PutPipeline) Processors(processors ...types.ProcessorContainerVariant) *PutPipeline

Processors used to perform transformations on documents before indexing. Processors run sequentially in the order specified. API name: processors

func (*PutPipeline) Raw 

func (r *PutPipeline) Raw(raw io.Reader) *PutPipeline

Raw takes a json payload as input which is then passed to the http.Request If specified Raw takes precedence on Request method.

func (*PutPipeline) Request 

func (r *PutPipeline) Request(req *Request) *PutPipeline

Request allows to set the request property with the appropriate payload.

func (*PutPipeline) Timeout 

func (r *PutPipeline) Timeout(duration string) *PutPipeline

Timeout Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. API name: timeout

func (*PutPipeline) Version 

func (r *PutPipeline) Version(versionnumber int64) *PutPipeline

Version number used by external systems to track ingest pipelines. This parameter is intended for external systems only. Elasticsearch does not use or validate pipeline version numbers. API name: version

type Request 

type Request struct {

	// Deprecated Marks this ingest pipeline as deprecated.
	// When a deprecated ingest pipeline is referenced as the default or final
	// pipeline when creating or updating a non-deprecated index template,
	// Elasticsearch will emit a deprecation warning.
	Deprecated *bool `json:"deprecated,omitempty"`
	// Description Description of the ingest pipeline.
	Description *string `json:"description,omitempty"`
	// Meta_ Optional metadata about the ingest pipeline. May have any contents. This map
	// is not automatically generated by Elasticsearch.
	Meta_ types.Metadata `json:"_meta,omitempty"`
	// OnFailure Processors to run immediately after a processor failure. Each processor
	// supports a processor-level `on_failure` value. If a processor without an
	// `on_failure` value fails, Elasticsearch uses this pipeline-level parameter as
	// a fallback. The processors in this parameter run sequentially in the order
	// specified. Elasticsearch will not attempt to run the pipeline's remaining
	// processors.
	OnFailure []types.ProcessorContainer `json:"on_failure,omitempty"`
	// Processors Processors used to perform transformations on documents before indexing.
	// Processors run sequentially in the order specified.
	Processors []types.ProcessorContainer `json:"processors,omitempty"`
	// Version Version number used by external systems to track ingest pipelines. This
	// parameter is intended for external systems only. Elasticsearch does not use
	// or validate pipeline version numbers.
	Version *int64 `json:"version,omitempty"`
}

Request holds the request body struct for the package putpipeline

https://github.com/elastic/elasticsearch-specification/blob/907d11a72a6bfd37b777d526880c56202889609e/specification/ingest/put_pipeline/PutPipelineRequest.ts#L25-L90

func NewRequest 

func NewRequest() *Request

NewRequest returns a Request

func (*Request) FromJSON 

func (r *Request) FromJSON(data string) (*Request, error)

FromJSON allows to load an arbitrary json into the request structure

func (*Request) UnmarshalJSON 

func (s *Request) UnmarshalJSON(data []byte) error

type Response 

type Response struct {

	// Acknowledged For a successful response, this value is always true. On failure, an
	// exception is returned instead.
	Acknowledged bool `json:"acknowledged"`
}

Response holds the response body struct for the package putpipeline

https://github.com/elastic/elasticsearch-specification/blob/907d11a72a6bfd37b777d526880c56202889609e/specification/ingest/put_pipeline/PutPipelineResponse.ts#L22-L25

func NewResponse 

func NewResponse() *Response

NewResponse returns a Response

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.