search

package
v1.12.0-beta.7 Latest Latest
Warning

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

Go to latest
Published: Feb 10, 2022 License: Apache-2.0 Imports: 7 Imported by: 4

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Dataset

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

Dataset : A complete dataset as rendered in POST, PATCH responses.

func MakeDatasetFromFederatedDataset

func MakeDatasetFromFederatedDataset(f FederatedDataset) Dataset

MakeDatasetFromFederatedDataset creates a new Dataset from an instance of FederatedDataset

func MakeDatasetFromIndexDataset

func MakeDatasetFromIndexDataset(f IndexDataset) Dataset

MakeDatasetFromIndexDataset creates a new Dataset from an instance of IndexDataset

func MakeDatasetFromKvCollectionDataset

func MakeDatasetFromKvCollectionDataset(f KvCollectionDataset) Dataset

MakeDatasetFromKvCollectionDataset creates a new Dataset from an instance of KvCollectionDataset

func MakeDatasetFromLookupDataset

func MakeDatasetFromLookupDataset(f LookupDataset) Dataset

MakeDatasetFromLookupDataset creates a new Dataset from an instance of LookupDataset

func MakeDatasetFromMetricDataset

func MakeDatasetFromMetricDataset(f MetricDataset) Dataset

MakeDatasetFromMetricDataset creates a new Dataset from an instance of MetricDataset

func MakeDatasetFromRawInterface

func MakeDatasetFromRawInterface(f interface{}) Dataset

MakeDatasetFromRawInterface creates a new Dataset from a raw interface{}

func (Dataset) FederatedDataset

func (m Dataset) FederatedDataset() *FederatedDataset

FederatedDataset returns FederatedDataset if IsFederatedDataset() is true, nil otherwise

func (Dataset) IndexDataset

func (m Dataset) IndexDataset() *IndexDataset

IndexDataset returns IndexDataset if IsIndexDataset() is true, nil otherwise

func (Dataset) IsFederatedDataset

func (m Dataset) IsFederatedDataset() bool

IsFederatedDataset checks if the Dataset is a FederatedDataset

func (Dataset) IsIndexDataset

func (m Dataset) IsIndexDataset() bool

IsIndexDataset checks if the Dataset is a IndexDataset

func (Dataset) IsKvCollectionDataset

func (m Dataset) IsKvCollectionDataset() bool

IsKvCollectionDataset checks if the Dataset is a KvCollectionDataset

func (Dataset) IsLookupDataset

func (m Dataset) IsLookupDataset() bool

IsLookupDataset checks if the Dataset is a LookupDataset

func (Dataset) IsMetricDataset

func (m Dataset) IsMetricDataset() bool

IsMetricDataset checks if the Dataset is a MetricDataset

func (Dataset) IsRawInterface

func (m Dataset) IsRawInterface() bool

IsRawInterface checks if the Dataset is an interface{} (unknown type)

func (Dataset) KvCollectionDataset

func (m Dataset) KvCollectionDataset() *KvCollectionDataset

KvCollectionDataset returns KvCollectionDataset if IsKvCollectionDataset() is true, nil otherwise

func (Dataset) LookupDataset

func (m Dataset) LookupDataset() *LookupDataset

LookupDataset returns LookupDataset if IsLookupDataset() is true, nil otherwise

func (Dataset) MarshalJSON

func (m Dataset) MarshalJSON() ([]byte, error)

MarshalJSON marshals Dataset using the appropriate struct field

func (Dataset) MetricDataset

func (m Dataset) MetricDataset() *MetricDataset

MetricDataset returns MetricDataset if IsMetricDataset() is true, nil otherwise

func (Dataset) RawInterface

func (m Dataset) RawInterface() interface{}

RawInterface returns interface{} if IsRawInterface() is true (unknown type), nil otherwise

func (*Dataset) UnmarshalJSON

func (m *Dataset) UnmarshalJSON(b []byte) (err error)

UnmarshalJSON unmarshals Dataset using the "kind" property

type DatasetCommon

type DatasetCommon struct {
	// A unique dataset ID.
	Id string `json:"id"`
	// The dataset name. Dataset names must be unique within each module.
	Name string `json:"name"`
	// The dataset name qualified by the module name.
	Resourcename string `json:"resourcename"`
	// AppClinetId of the creator app of the dataset.
	Appclientidcreatedby *string `json:"appclientidcreatedby,omitempty"`
	// AppClinetId of the modifier app of the dataset.
	Appclientidmodifiedby *string `json:"appclientidmodifiedby,omitempty"`
	// Detailed description of the dataset.
	Description *string `json:"description,omitempty"`
	// The name of the namespace that contains the dataset.
	Namespace *string `json:"namespace,omitempty"`
	// Summary of the dataset's purpose.
	Summary *string `json:"summary,omitempty"`
	// The title of the dataset.  Does not have to be unique.
	Title *string `json:"title,omitempty"`
}

Properties that are common across all Dataset kinds rendered in POST, PATCH, and GET responses.

type DatasetPatch

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

DatasetPatch : Property values to be set in an existing dataset using a PATCH request. DatasetPatch is FederatedDatasetPatch, IndexDatasetPatch, KvCollectionDatasetPatch, LookupDatasetPatch, MetricDatasetPatch, (or interface{} if no matches are found)

func MakeDatasetPatchFromFederatedDatasetPatch

func MakeDatasetPatchFromFederatedDatasetPatch(f FederatedDatasetPatch) DatasetPatch

MakeDatasetPatchFromFederatedDatasetPatch creates a new DatasetPatch from an instance of FederatedDatasetPatch

func MakeDatasetPatchFromIndexDatasetPatch

func MakeDatasetPatchFromIndexDatasetPatch(f IndexDatasetPatch) DatasetPatch

MakeDatasetPatchFromIndexDatasetPatch creates a new DatasetPatch from an instance of IndexDatasetPatch

func MakeDatasetPatchFromKvCollectionDatasetPatch

func MakeDatasetPatchFromKvCollectionDatasetPatch(f KvCollectionDatasetPatch) DatasetPatch

MakeDatasetPatchFromKvCollectionDatasetPatch creates a new DatasetPatch from an instance of KvCollectionDatasetPatch

func MakeDatasetPatchFromLookupDatasetPatch

func MakeDatasetPatchFromLookupDatasetPatch(f LookupDatasetPatch) DatasetPatch

MakeDatasetPatchFromLookupDatasetPatch creates a new DatasetPatch from an instance of LookupDatasetPatch

func MakeDatasetPatchFromMetricDatasetPatch

func MakeDatasetPatchFromMetricDatasetPatch(f MetricDatasetPatch) DatasetPatch

MakeDatasetPatchFromMetricDatasetPatch creates a new DatasetPatch from an instance of MetricDatasetPatch

func MakeDatasetPatchFromRawInterface

func MakeDatasetPatchFromRawInterface(f interface{}) DatasetPatch

MakeDatasetPatchFromRawInterface creates a new DatasetPatch from a raw interface{}

func (DatasetPatch) FederatedDatasetPatch

func (m DatasetPatch) FederatedDatasetPatch() *FederatedDatasetPatch

FederatedDatasetPatch returns FederatedDatasetPatch if IsFederatedDatasetPatch() is true, nil otherwise

func (DatasetPatch) IndexDatasetPatch

func (m DatasetPatch) IndexDatasetPatch() *IndexDatasetPatch

IndexDatasetPatch returns IndexDatasetPatch if IsIndexDatasetPatch() is true, nil otherwise

func (DatasetPatch) IsFederatedDatasetPatch

func (m DatasetPatch) IsFederatedDatasetPatch() bool

IsFederatedDatasetPatch checks if the DatasetPatch is a FederatedDatasetPatch

func (DatasetPatch) IsIndexDatasetPatch

func (m DatasetPatch) IsIndexDatasetPatch() bool

IsIndexDatasetPatch checks if the DatasetPatch is a IndexDatasetPatch

func (DatasetPatch) IsKvCollectionDatasetPatch

func (m DatasetPatch) IsKvCollectionDatasetPatch() bool

IsKvCollectionDatasetPatch checks if the DatasetPatch is a KvCollectionDatasetPatch

func (DatasetPatch) IsLookupDatasetPatch

func (m DatasetPatch) IsLookupDatasetPatch() bool

IsLookupDatasetPatch checks if the DatasetPatch is a LookupDatasetPatch

func (DatasetPatch) IsMetricDatasetPatch

func (m DatasetPatch) IsMetricDatasetPatch() bool

IsMetricDatasetPatch checks if the DatasetPatch is a MetricDatasetPatch

func (DatasetPatch) IsRawInterface

func (m DatasetPatch) IsRawInterface() bool

IsRawInterface checks if the DatasetPatch is an interface{} (unknown type)

func (DatasetPatch) KvCollectionDatasetPatch

func (m DatasetPatch) KvCollectionDatasetPatch() *KvCollectionDatasetPatch

KvCollectionDatasetPatch returns KvCollectionDatasetPatch if IsKvCollectionDatasetPatch() is true, nil otherwise

func (DatasetPatch) LookupDatasetPatch

func (m DatasetPatch) LookupDatasetPatch() *LookupDatasetPatch

LookupDatasetPatch returns LookupDatasetPatch if IsLookupDatasetPatch() is true, nil otherwise

func (DatasetPatch) MarshalJSON

func (m DatasetPatch) MarshalJSON() ([]byte, error)

MarshalJSON marshals DatasetPatch using DatasetPatch.DatasetPatch

func (DatasetPatch) MetricDatasetPatch

func (m DatasetPatch) MetricDatasetPatch() *MetricDatasetPatch

MetricDatasetPatch returns MetricDatasetPatch if IsMetricDatasetPatch() is true, nil otherwise

func (DatasetPatch) RawInterface

func (m DatasetPatch) RawInterface() interface{}

RawInterface returns interface{} if IsRawInterface() is true (unknown type), nil otherwise

func (*DatasetPatch) UnmarshalJSON

func (m *DatasetPatch) UnmarshalJSON(b []byte) (err error)

UnmarshalJSON unmarshals DatasetPatch into FederatedDatasetPatch, IndexDatasetPatch, KvCollectionDatasetPatch, LookupDatasetPatch, MetricDatasetPatch, or interface{} if no matches are found

type DatasetPatchCommon

type DatasetPatchCommon struct {
	// The name of module to reassign dataset into.
	Module *string `json:"module,omitempty"`
	// The dataset name. Dataset names must be unique within each module.
	Name *string `json:"name,omitempty"`
	// The name of the dataset owner. This value is obtained from the bearer token.
	Owner *string `json:"owner,omitempty"`
}

Properties that are common across all Dataset kinds to be set in an existing dataset using a PATCH request.

type DatasetPost

type DatasetPost struct {
	// The dataset name. Dataset names must be unique within each module.
	Name string `json:"name"`
	// The fields to be associated with this dataset.
	Fields []FieldPost `json:"fields,omitempty"`
	// A unique dataset ID. Random ID used if not provided.
	Id *string `json:"id,omitempty"`
	// The name of the module to create the new dataset in.
	Module *string `json:"module,omitempty"`
}

Properties that are common across all Dataset kinds for creating a new dataset using a POST request.

type DateMetadataProperties

type DateMetadataProperties struct {
	// The date and time object was created.
	Created string `json:"created"`
	// The date and time object was modified.
	Modified string `json:"modified"`
}

Created and Modified date-time properties for inclusion in other objects.

type DeleteSearchJob added in v1.6.0

type DeleteSearchJob struct {
	// The index to delete the events from.
	Index string `json:"index"`
	// The module to run the delete search job in. The default module is used if the module field is empty.
	Module string `json:"module"`
	// The predicate expression that identifies the events to delete from the index. This expression must return true or false. To delete all events from the index, specify \"true\" instead of an expression.
	Predicate string `json:"predicate"`
	// Specifies that the delete search job contains side effects, with possible security risks.
	AllowSideEffects *bool `json:"allowSideEffects,omitempty"`
	// This property does not apply to delete search jobs endpoint and is set to false by default.
	CollectEventSummary *bool `json:"collectEventSummary,omitempty"`
	// This property does not apply to delete search jobs endpoint and is set to false by default.
	CollectFieldSummary *bool `json:"collectFieldSummary,omitempty"`
	// This property does not apply to delete search jobs endpoint and is set to false by default.
	CollectTimeBuckets *bool `json:"collectTimeBuckets,omitempty"`
	// The time, in GMT, that the search job is finished. Empty if the search job has not completed.
	CompletionTime *string `json:"completionTime,omitempty"`
	// The time, in GMT, that the search job is dispatched.
	DispatchTime *string `json:"dispatchTime,omitempty"`
	// This property does not apply to delete search jobs endpoint and is set to false by default.
	EnablePreview *bool `json:"enablePreview,omitempty"`
	// Specifies how the Search service should extract fields. Valid values include 'all', 'none', or 'indexed'. 'all' will extract all fields, 'indexed' will extract only indexed fields, and 'none' will extract only the default fields. This parameter overwrites the value of the 'extractAllFields' parameter. Set to 'none' for better search performance.
	ExtractFields *string `json:"extractFields,omitempty"`
	// The amount of time, in seconds, to run the delete search job before finalizing the search. The maximum value is 3600 seconds (1 hour).
	MaxTime  *int32    `json:"maxTime,omitempty"`
	Messages []Message `json:"messages,omitempty"`
	// The name of the search job.
	Name *string `json:"name,omitempty"`
	// An estimate of the percent of time remaining before the delete search job completes.
	PercentComplete *int32 `json:"percentComplete,omitempty"`
	// This property does not apply to delete search jobs endpoint and is set to false by default.
	PreviewAvailable *string `json:"previewAvailable,omitempty"`
	// The SPL search string that includes the index, module, and predicate that you specify.
	Query *string `json:"query,omitempty"`
	// Represents parameters on the search job such as 'earliest' and 'latest'.
	QueryParameters *QueryParameters `json:"queryParameters,omitempty"`
	// This property does not apply to delete search jobs endpoint and is set to 0 by default.
	RequiredFreshness *int32 `json:"requiredFreshness,omitempty"`
	// The earliest time specified as an absolute value in GMT. The time is computed based on the values you specify for the 'timezone' and 'earliest' queryParameters.
	ResolvedEarliest *string `json:"resolvedEarliest,omitempty"`
	// The latest time specified as an absolute value in GMT. The time is computed based on the values you specify for the 'timezone' and 'earliest' queryParameters.
	ResolvedLatest *string `json:"resolvedLatest,omitempty"`
	// The number of results produced so far by the delete search job that are going to be deleted.
	ResultsAvailable *int32 `json:"resultsAvailable,omitempty"`
	// This property does not apply to delete search jobs endpoint and is set to 0 by default.
	ResultsPreviewAvailable *int32 `json:"resultsPreviewAvailable,omitempty"`
	// The ID assigned to the delete search job.
	Sid    *string       `json:"sid,omitempty"`
	Status *SearchStatus `json:"status,omitempty"`
}

A delete search job, including read-only fields that includes the required properties.

type ExportResultsQueryParams

type ExportResultsQueryParams struct {
	// Count : The maximum number of jobs that you want to return the status entries for.
	Count *int32 `key:"count"`
	// Filename : The export results filename. Default: exportResults
	Filename string `key:"filename"`
	// OutputMode : Specifies the format for the returned output.
	OutputMode ExportResultsoutputMode `key:"outputMode"`
}

ExportResultsQueryParams represents valid query parameters for the ExportResults operation For convenience ExportResultsQueryParams can be formed in a single statement, for example:

`v := ExportResultsQueryParams{}.SetCount(...).SetFilename(...).SetOutputMode(...)`

func (ExportResultsQueryParams) SetCount

func (ExportResultsQueryParams) SetFilename

func (ExportResultsQueryParams) SetOutputMode

type ExportResultsoutputMode

type ExportResultsoutputMode string

ExportResultsoutputMode : Specifies the format for the returned output.

const (
	ExportResultsoutputModeCsv  ExportResultsoutputMode = "csv"
	ExportResultsoutputModeJson ExportResultsoutputMode = "json"
)

List of ExportResultsoutputMode values

type FederatedConnection

type FederatedConnection struct {
	// The timestamp when the federated connection was created.
	Created *string `json:"created,omitempty"`
	// The user who created the federated connection.
	Createdby *string `json:"createdby,omitempty"`
	// The remote hostname to connect yo.
	Hostnameip *string `json:"hostnameip,omitempty"`
	// The timestamp when the federated connection was modified.
	Modified *string `json:"modified,omitempty"`
	// The user who last modified the federated connection.
	Modifiedby *string `json:"modifiedby,omitempty"`
	// The name of the federated connection.
	Name *string `json:"name,omitempty"`
	// The remote port number.
	Port *float32 `json:"port,omitempty"`
	// The username on the service account.
	Serviceaccountuser *string `json:"serviceaccountuser,omitempty"`
}

A fully constructed federated connection object.

type FederatedConnectionInput

type FederatedConnectionInput struct {
	// The remote hostname to connect to.
	Hostnameip string `json:"hostnameip"`
	// The name of the federated connection.
	Name string `json:"name"`
	// The remote port number.
	Port float32 `json:"port"`
	// The password of the service account.
	Serviceaccountpassword string `json:"serviceaccountpassword"`
	// The username on the service account.
	Serviceaccountuser string `json:"serviceaccountuser"`
}

The property values for creating a new federated connection using a PUT or POST request.

type FederatedDataset

type FederatedDataset struct {
	// The date and time object was created.
	Created string `json:"created"`
	// The name of the user who created the object. This value is obtained from the bearer token and may not be changed.
	Createdby string `json:"createdby"`
	// Connection information to connect to remote federated connection.
	FederatedConnection string `json:"federatedConnection"`
	// Dataset information in the remote instance.
	FederatedDataset string `json:"federatedDataset"`
	// Dataset kind information in the remote instance.
	FederatedDatasetKind string `json:"federatedDatasetKind"`
	// A unique dataset ID.
	Id   string               `json:"id"`
	Kind FederatedDatasetKind `json:"kind"`
	// The date and time object was modified.
	Modified string `json:"modified"`
	// The name of the user who most recently modified the object.
	Modifiedby string `json:"modifiedby"`
	// The dataset name. Dataset names must be unique within each module.
	Name string `json:"name"`
	// The name of the object's owner.
	Owner string `json:"owner"`
	// The dataset name qualified by the module name.
	Resourcename string `json:"resourcename"`
	// AppClinetId of the creator app of the dataset.
	Appclientidcreatedby *string `json:"appclientidcreatedby,omitempty"`
	// AppClinetId of the modifier app of the dataset.
	Appclientidmodifiedby *string `json:"appclientidmodifiedby,omitempty"`
	// Detailed description of the dataset.
	Description *string `json:"description,omitempty"`
	// The name of the namespace that contains the dataset.
	Namespace *string `json:"namespace,omitempty"`
	// Summary of the dataset's purpose.
	Summary *string `json:"summary,omitempty"`
	// The title of the dataset.  Does not have to be unique.
	Title *string `json:"title,omitempty"`
}

A complete federated dataset as rendered in POST, PATCH, and GET responses.

type FederatedDatasetKind

type FederatedDatasetKind string

FederatedDatasetKind : The dataset kind.

const (
	FederatedDatasetKindFederated FederatedDatasetKind = "federated"
)

List of FederatedDatasetKind

type FederatedDatasetPatch

type FederatedDatasetPatch struct {
	// Connection information to connect to remote federated connection.
	FederatedConnection *string `json:"federatedConnection,omitempty"`
	// Dataset information in the remote instance.
	FederatedDataset *string `json:"federatedDataset,omitempty"`
	// Dataset kind information in the remote instance.
	FederatedDatasetKind *string               `json:"federatedDatasetKind,omitempty"`
	Kind                 *FederatedDatasetKind `json:"kind,omitempty"`
	// The name of module to reassign dataset into.
	Module *string `json:"module,omitempty"`
	// The dataset name. Dataset names must be unique within each module.
	Name *string `json:"name,omitempty"`
	// The name of the dataset owner. This value is obtained from the bearer token.
	Owner *string `json:"owner,omitempty"`
}

Property values to be set in an existing federated dataset using a PATCH request.

type FederatedDatasetProperties

type FederatedDatasetProperties struct {
	// Connection information to connect to remote federated connection.
	FederatedConnection *string `json:"federatedConnection,omitempty"`
	// Dataset information in the remote instance.
	FederatedDataset *string `json:"federatedDataset,omitempty"`
	// Dataset kind information in the remote instance.
	FederatedDatasetKind *string               `json:"federatedDatasetKind,omitempty"`
	Kind                 *FederatedDatasetKind `json:"kind,omitempty"`
}

Properties of job datasets which may be read, set, and changed through the API. Implementation detail of DatasetPOST, DatasetPATCH, and Dataset, do not use directly.

type FieldDataType

type FieldDataType string

FieldDataType : The type of data in the field. Must be one of the valid values.

const (
	FieldDataTypeDate     FieldDataType = "DATE"
	FieldDataTypeNumber   FieldDataType = "NUMBER"
	FieldDataTypeObjectId FieldDataType = "OBJECT_ID"
	FieldDataTypeString   FieldDataType = "STRING"
	FieldDataTypeUnknown  FieldDataType = "UNKNOWN"
)

List of FieldDataType

type FieldPost

type FieldPost struct {
	// The field name.
	Name     string         `json:"name"`
	Datatype *FieldDataType `json:"datatype,omitempty"`
	// The field description.
	Description *string    `json:"description,omitempty"`
	Fieldtype   *FieldType `json:"fieldtype,omitempty"`
	// Whether or not the field has been indexed.
	Indexed    *bool            `json:"indexed,omitempty"`
	Prevalence *FieldPrevalence `json:"prevalence,omitempty"`
	// The field summary.
	Summary *string `json:"summary,omitempty"`
	// The field title.
	Title *string `json:"title,omitempty"`
}

Initial property values for creating a new field using a POST request.

type FieldPrevalence

type FieldPrevalence string

FieldPrevalence : How frequent the field appears in the dataset. Must be one of the valid values.

const (
	FieldPrevalenceAll     FieldPrevalence = "ALL"
	FieldPrevalenceSome    FieldPrevalence = "SOME"
	FieldPrevalenceUnknown FieldPrevalence = "UNKNOWN"
)

List of FieldPrevalence

type FieldProperties

type FieldProperties struct {
	Datatype *FieldDataType `json:"datatype,omitempty"`
	// The field description.
	Description *string    `json:"description,omitempty"`
	Fieldtype   *FieldType `json:"fieldtype,omitempty"`
	// Whether or not the field has been indexed.
	Indexed *bool `json:"indexed,omitempty"`
	// The field name.
	Name       *string          `json:"name,omitempty"`
	Prevalence *FieldPrevalence `json:"prevalence,omitempty"`
	// The field summary.
	Summary *string `json:"summary,omitempty"`
	// The field title.
	Title *string `json:"title,omitempty"`
}

Properties of fields which can be read, set, and changed through the API. Implementation detail of FieldPOST, FieldPATCH, and Field, do not use directly.

type FieldType

type FieldType string

FieldType : The type of field. Must be one of the valid values.

const (
	FieldTypeDimension FieldType = "DIMENSION"
	FieldTypeMeasure   FieldType = "MEASURE"
	FieldTypeUnknown   FieldType = "UNKNOWN"
)

List of FieldType

type FieldsSummary

type FieldsSummary struct {
	// The amount of time, in seconds, that a time bucket spans from the earliest to the latest time.
	Duration *float64 `json:"duration,omitempty"`
	// The earliest timestamp, in UTC format, of the events to process.
	EarliestTime *string `json:"earliestTime,omitempty"`
	// The total number of events for all fields returned in the time range (earliestTime and latestTime) specified.
	EventCount *int32 `json:"eventCount,omitempty"`
	// A list of the fields in the time range specified.
	Fields map[string]SingleFieldSummary `json:"fields,omitempty"`
	// The latest timestamp, in UTC format, of the events to process.
	LatestTime *string `json:"latestTime,omitempty"`
}

A statistical summary of the fields in the events to date, for the search ID (SID).

type IndexDataset

type IndexDataset struct {
	// The date and time object was created.
	Created string `json:"created"`
	// The name of the user who created the object. This value is obtained from the bearer token and may not be changed.
	Createdby string `json:"createdby"`
	// Specifies whether or not the Splunk index is disabled.
	Disabled bool `json:"disabled"`
	// A unique dataset ID.
	Id   string           `json:"id"`
	Kind IndexDatasetKind `json:"kind"`
	// The date and time object was modified.
	Modified string `json:"modified"`
	// The name of the user who most recently modified the object.
	Modifiedby string `json:"modifiedby"`
	// The dataset name. Dataset names must be unique within each module.
	Name string `json:"name"`
	// The name of the object's owner.
	Owner string `json:"owner"`
	// The dataset name qualified by the module name.
	Resourcename string `json:"resourcename"`
	// AppClinetId of the creator app of the dataset.
	Appclientidcreatedby *string `json:"appclientidcreatedby,omitempty"`
	// AppClinetId of the modifier app of the dataset.
	Appclientidmodifiedby *string `json:"appclientidmodifiedby,omitempty"`
	// Detailed description of the dataset.
	Description *string `json:"description,omitempty"`
	// The timestamp, in seconds, of the earliest event. The timestamp is in UNIX time.
	EarliestEventTime *string `json:"earliestEventTime,omitempty"`
	// The earliest index time for any of the events in this index.
	EarliestIngestTime *string `json:"earliestIngestTime,omitempty"`
	// The frozenTimePeriodInSecs to use for the index
	FrozenTimePeriodInSecs *int32 `json:"frozenTimePeriodInSecs,omitempty"`
	// The timestamp, in seconds, of the latest event. The timestamp is in UNIX time.
	LatestEventTime *string `json:"latestEventTime,omitempty"`
	// The latest index time for any of the events in this index.
	LatestIngestTime *string `json:"latestIngestTime,omitempty"`
	// The latest time that the index metadata was refreshed.
	LatestMetadataUpdateTime *string `json:"latestMetadataUpdateTime,omitempty"`
	// The name of the namespace that contains the dataset.
	Namespace *string `json:"namespace,omitempty"`
	// Summary of the dataset's purpose.
	Summary *string `json:"summary,omitempty"`
	// The title of the dataset.  Does not have to be unique.
	Title *string `json:"title,omitempty"`
	// The number of events in the index.
	TotalEventCount *int64 `json:"totalEventCount,omitempty"`
	// The raw size, in bytes, of the uncompressed data in the indexers.
	TotalSize *int64 `json:"totalSize,omitempty"`
}

A complete index dataset as rendered in POST, PATCH, and GET responses.

type IndexDatasetKind

type IndexDatasetKind string

IndexDatasetKind : The dataset kind.

const (
	IndexDatasetKindIndex IndexDatasetKind = "index"
)

List of IndexDatasetKind

type IndexDatasetPatch

type IndexDatasetPatch struct {
	// Specifies whether or not the Splunk index is disabled.
	Disabled *bool `json:"disabled,omitempty"`
	// The frozenTimePeriodInSecs to use for the index
	FrozenTimePeriodInSecs *int32            `json:"frozenTimePeriodInSecs,omitempty"`
	Kind                   *IndexDatasetKind `json:"kind,omitempty"`
	// The name of module to reassign dataset into.
	Module *string `json:"module,omitempty"`
	// The dataset name. Dataset names must be unique within each module.
	Name *string `json:"name,omitempty"`
	// The name of the dataset owner. This value is obtained from the bearer token.
	Owner *string `json:"owner,omitempty"`
}

Property values to be set in an existing index dataset using a PATCH request.

type IndexDatasetProperties

type IndexDatasetProperties struct {
	// Specifies whether or not the Splunk index is disabled.
	Disabled *bool `json:"disabled,omitempty"`
	// The frozenTimePeriodInSecs to use for the index
	FrozenTimePeriodInSecs *int32            `json:"frozenTimePeriodInSecs,omitempty"`
	Kind                   *IndexDatasetKind `json:"kind,omitempty"`
}

Properties of job datasets which may be read, set, and changed through the API. Implementation detail of DatasetPOST, DatasetPATCH, and Dataset, do not use directly.

type IndexDatasetReadOnlyProperties

type IndexDatasetReadOnlyProperties struct {
	// The timestamp, in seconds, of the earliest event. The timestamp is in UNIX time.
	EarliestEventTime *string `json:"earliestEventTime,omitempty"`
	// The earliest index time for any of the events in this index.
	EarliestIngestTime *string           `json:"earliestIngestTime,omitempty"`
	Kind               *IndexDatasetKind `json:"kind,omitempty"`
	// The timestamp, in seconds, of the latest event. The timestamp is in UNIX time.
	LatestEventTime *string `json:"latestEventTime,omitempty"`
	// The latest index time for any of the events in this index.
	LatestIngestTime *string `json:"latestIngestTime,omitempty"`
	// The latest time that the index metadata was refreshed.
	LatestMetadataUpdateTime *string `json:"latestMetadataUpdateTime,omitempty"`
	// The number of events in the index.
	TotalEventCount *int64 `json:"totalEventCount,omitempty"`
	// The raw size, in bytes, of the uncompressed data in the indexers.
	TotalSize *int64 `json:"totalSize,omitempty"`
}

Properties of index datasets which can only be read through the API.

type Iterator

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

Iterator is the result of a search query. Its cursor starts at 0 index of the result set. Use Next() to advance through the rows:

 search, _ := client.SearchService.SubmitSearch(&PostJobsRequest{Search: "search index=main | head 5"})
	pages, _ := search.QueryResults(2, 0, &FetchResultsRequest{Count: 5})
	defer pages.Close()
	for pages.Next() {
		values, err := pages.Value()
     ...

	}
	err := pages.Err() // get any error encountered during iteration
 ...

func NewIterator

func NewIterator(batch, offset, max int, fn QueryFunc) *Iterator

NewIterator creates a new reference to the iterator object

func (*Iterator) Close

func (i *Iterator) Close()

Close checks the status and closes iterator if it's not already. After Close, no results can be retrieved

func (*Iterator) Err

func (i *Iterator) Err() error

Err returns error encountered during iteration

func (*Iterator) Next

func (i *Iterator) Next() bool

Next prepares the next result set for reading with the Value method. It returns true on success, or false if there is no next result row or an error occurred while preparing it.

Every call to Value, even the first one, must be preceded by a call to Next.

func (*Iterator) Value

func (i *Iterator) Value() (*ListSearchResultsResponse, error)

Value returns value in current iteration or error out if iterator is closed

type KvCollectionDataset

type KvCollectionDataset struct {
	// The date and time object was created.
	Created string `json:"created"`
	// The name of the user who created the object. This value is obtained from the bearer token and may not be changed.
	Createdby string `json:"createdby"`
	// A unique dataset ID.
	Id   string                  `json:"id"`
	Kind KvCollectionDatasetKind `json:"kind"`
	// The date and time object was modified.
	Modified string `json:"modified"`
	// The name of the user who most recently modified the object.
	Modifiedby string `json:"modifiedby"`
	// The dataset name. Dataset names must be unique within each module.
	Name string `json:"name"`
	// The name of the object's owner.
	Owner string `json:"owner"`
	// The dataset name qualified by the module name.
	Resourcename string `json:"resourcename"`
	// AppClinetId of the creator app of the dataset.
	Appclientidcreatedby *string `json:"appclientidcreatedby,omitempty"`
	// AppClinetId of the modifier app of the dataset.
	Appclientidmodifiedby *string `json:"appclientidmodifiedby,omitempty"`
	// Detailed description of the dataset.
	Description *string `json:"description,omitempty"`
	// The name of the namespace that contains the dataset.
	Namespace *string `json:"namespace,omitempty"`
	// Summary of the dataset's purpose.
	Summary *string `json:"summary,omitempty"`
	// The title of the dataset.  Does not have to be unique.
	Title *string `json:"title,omitempty"`
}

A complete kvcollection dataset as rendered in POST, PATCH, and GET responses.

type KvCollectionDatasetKind

type KvCollectionDatasetKind string

KvCollectionDatasetKind : The dataset kind.

const (
	KvCollectionDatasetKindKvcollection KvCollectionDatasetKind = "kvcollection"
)

List of KVCollectionDatasetKind

type KvCollectionDatasetPatch

type KvCollectionDatasetPatch struct {
	Kind *KvCollectionDatasetKind `json:"kind,omitempty"`
	// The name of module to reassign dataset into.
	Module *string `json:"module,omitempty"`
	// The dataset name. Dataset names must be unique within each module.
	Name *string `json:"name,omitempty"`
	// The name of the dataset owner. This value is obtained from the bearer token.
	Owner *string `json:"owner,omitempty"`
}

Property values to be set in an existing kvcollection dataset using a PATCH request.

type KvCollectionDatasetProperties

type KvCollectionDatasetProperties struct {
	Kind *KvCollectionDatasetKind `json:"kind,omitempty"`
}

Properties of kvcollection datasets which may be read, set, and changed through the API. Implementation detail of DatasetPOST, DatasetPATCH, and Dataset, do not use directly.

type ListDatasets

type ListDatasets struct {
	// List of all datasets
	Results []Dataset `json:"results,omitempty"`
}

A list of fully constructed datasets

type ListEventsSummaryQueryParams

type ListEventsSummaryQueryParams struct {
	// Count : The maximum number of jobs that you want to return the status entries for.
	Count *int32 `key:"count"`
	// Earliest : The earliest time filter, in absolute time. When specifying an absolute time specify either UNIX time, or UTC in seconds using the ISO-8601 (%FT%T.%Q) format. For example 2021-01-25T13:15:30Z. GMT is the default timezone. You must specify GMT when you specify UTC. Any offset specified is ignored.
	Earliest string `key:"earliest"`
	// Field : One or more fields to return for the result set. Use a comma-separated list of field names to specify multiple fields.
	Field string `key:"field"`
	// Latest : The latest time filter in absolute time. When specifying an absolute time specify either UNIX time, or UTC in seconds using the ISO-8601 (%FT%T.%Q) format. For example 2021-01-25T13:15:30Z. GMT is the default timezone. You must specify GMT when you specify UTC. Any offset specified is ignored. Latest time must be after Earliest time.
	Latest string `key:"latest"`
	// Offset : Index number identifying the location of the first item to return.
	Offset *int32 `key:"offset"`
}

ListEventsSummaryQueryParams represents valid query parameters for the ListEventsSummary operation For convenience ListEventsSummaryQueryParams can be formed in a single statement, for example:

`v := ListEventsSummaryQueryParams{}.SetCount(...).SetEarliest(...).SetField(...).SetLatest(...).SetOffset(...)`

func (ListEventsSummaryQueryParams) SetCount

func (ListEventsSummaryQueryParams) SetEarliest

func (ListEventsSummaryQueryParams) SetField

func (ListEventsSummaryQueryParams) SetLatest

func (ListEventsSummaryQueryParams) SetOffset

type ListFederatedConnections

type ListFederatedConnections []FederatedConnection

A list of federated connections

type ListFieldsSummaryQueryParams

type ListFieldsSummaryQueryParams struct {
	// Earliest : The earliest time filter, in absolute time. When specifying an absolute time specify either UNIX time, or UTC in seconds using the ISO-8601 (%FT%T.%Q) format. For example 2021-01-25T13:15:30Z. GMT is the default timezone. You must specify GMT when you specify UTC. Any offset specified is ignored.
	Earliest string `key:"earliest"`
	// Latest : The latest time filter in absolute time. When specifying an absolute time specify either UNIX time, or UTC in seconds using the ISO-8601 (%FT%T.%Q) format. For example 2021-01-25T13:15:30Z. GMT is the default timezone. You must specify GMT when you specify UTC. Any offset specified is ignored. Latest time must be after Earliest time.
	Latest string `key:"latest"`
}

ListFieldsSummaryQueryParams represents valid query parameters for the ListFieldsSummary operation For convenience ListFieldsSummaryQueryParams can be formed in a single statement, for example:

`v := ListFieldsSummaryQueryParams{}.SetEarliest(...).SetLatest(...)`

func (ListFieldsSummaryQueryParams) SetEarliest

func (ListFieldsSummaryQueryParams) SetLatest

type ListJobsQueryParams

type ListJobsQueryParams struct {
	// Count : The maximum number of jobs that you want to return the status entries for.
	Count *int32 `key:"count"`
	// Filter : Filter the list of jobs by 'sid'. Valid format is  `sid IN ({comma-separated list of SIDs. Each SID must be enclosed in double quotation marks.})`. A maximum of 30 SIDs can be specified in one query.
	Filter string `key:"filter"`
	// Status : Filter the list of jobs by status. Valid status values are 'running', 'done', 'canceled', or 'failed'.
	Status SearchStatus `key:"status"`
}

ListJobsQueryParams represents valid query parameters for the ListJobs operation For convenience ListJobsQueryParams can be formed in a single statement, for example:

`v := ListJobsQueryParams{}.SetCount(...).SetFilter(...).SetStatus(...)`

func (ListJobsQueryParams) SetCount

func (ListJobsQueryParams) SetFilter added in v1.2.1

func (ListJobsQueryParams) SetStatus

type ListPreviewResultsQueryParams

type ListPreviewResultsQueryParams struct {
	// Count : The maximum number of jobs that you want to return the status entries for.
	Count *int32 `key:"count"`
	// Offset : Index number identifying the location of the first item to return.
	Offset *int32 `key:"offset"`
}

ListPreviewResultsQueryParams represents valid query parameters for the ListPreviewResults operation For convenience ListPreviewResultsQueryParams can be formed in a single statement, for example:

`v := ListPreviewResultsQueryParams{}.SetCount(...).SetOffset(...)`

func (ListPreviewResultsQueryParams) SetCount

func (ListPreviewResultsQueryParams) SetOffset

type ListPreviewResultsResponse

type ListPreviewResultsResponse struct {
	IsPreviewStable bool                               `json:"isPreviewStable"`
	Results         []map[string]interface{}           `json:"results"`
	Fields          []ListPreviewResultsResponseFields `json:"fields,omitempty"`
	Messages        []Message                          `json:"messages,omitempty"`
	NextLink        *string                            `json:"nextLink,omitempty"`
	Wait            *string                            `json:"wait,omitempty"`
}

The structure of the response body for the preview search results that is returned for the job with the specified search ID (SID). When search is running, it might return incomplete or truncated search results. The isPreviewStable property indicates whether the returned preview results stucture is stable or not. Truncated preview results occur because the number of requested results exceeds the page limit. Use the 'nextLink' URL to retrieve the next page of results.

type ListPreviewResultsResponseFields added in v1.10.0

type ListPreviewResultsResponseFields struct {
	Name           string  `json:"name"`
	DataSource     *string `json:"dataSource,omitempty"`
	GroupbyRank    *string `json:"groupbyRank,omitempty"`
	SplitField     *string `json:"splitField,omitempty"`
	SplitValue     *string `json:"splitValue,omitempty"`
	SplitbySpecial *string `json:"splitbySpecial,omitempty"`
	TypeSpecial    *string `json:"typeSpecial,omitempty"`
}

type ListResultsQueryParams

type ListResultsQueryParams struct {
	// Count : The maximum number of jobs that you want to return the status entries for.
	Count *int32 `key:"count"`
	// Field : One or more fields to return for the result set. Use a comma-separated list of field names to specify multiple fields.
	Field string `key:"field"`
	// Offset : Index number identifying the location of the first item to return.
	Offset *int32 `key:"offset"`
}

ListResultsQueryParams represents valid query parameters for the ListResults operation For convenience ListResultsQueryParams can be formed in a single statement, for example:

`v := ListResultsQueryParams{}.SetCount(...).SetField(...).SetOffset(...)`

func (ListResultsQueryParams) SetCount

func (ListResultsQueryParams) SetField

func (ListResultsQueryParams) SetOffset

type ListSearchResultsResponse

type ListSearchResultsResponse struct {
	Results  []map[string]interface{}           `json:"results"`
	Fields   []ListPreviewResultsResponseFields `json:"fields,omitempty"`
	Messages []Message                          `json:"messages,omitempty"`
	NextLink *string                            `json:"nextLink,omitempty"`
	Wait     *string                            `json:"wait,omitempty"`
}

The structure of the search results or events metadata that is returned for the job with the specified search ID (SID). When search is running, it might return incomplete or truncated search results. Incomplete search results occur when a search has not completed. Wait until search completes for full result set. Truncated search results occur because the number of requested results exceeds the page limit. Use the 'nextLink' URL to retrieve the next page of results.

type LookupDataset

type LookupDataset struct {
	// The date and time object was created.
	Created string `json:"created"`
	// The name of the user who created the object. This value is obtained from the bearer token and may not be changed.
	Createdby    string                    `json:"createdby"`
	ExternalKind LookupDatasetExternalKind `json:"externalKind"`
	// The name of the external lookup.
	ExternalName string `json:"externalName"`
	// A unique dataset ID.
	Id   string            `json:"id"`
	Kind LookupDatasetKind `json:"kind"`
	// The date and time object was modified.
	Modified string `json:"modified"`
	// The name of the user who most recently modified the object.
	Modifiedby string `json:"modifiedby"`
	// The dataset name. Dataset names must be unique within each module.
	Name string `json:"name"`
	// The name of the object's owner.
	Owner string `json:"owner"`
	// The dataset name qualified by the module name.
	Resourcename string `json:"resourcename"`
	// AppClinetId of the creator app of the dataset.
	Appclientidcreatedby *string `json:"appclientidcreatedby,omitempty"`
	// AppClinetId of the modifier app of the dataset.
	Appclientidmodifiedby *string `json:"appclientidmodifiedby,omitempty"`
	// Match case-sensitively against the lookup.
	CaseSensitiveMatch *bool `json:"caseSensitiveMatch,omitempty"`
	// Detailed description of the dataset.
	Description *string `json:"description,omitempty"`
	// A query that filters results out of the lookup before those results are returned.
	Filter *string `json:"filter,omitempty"`
	// The name of the namespace that contains the dataset.
	Namespace *string `json:"namespace,omitempty"`
	// Summary of the dataset's purpose.
	Summary *string `json:"summary,omitempty"`
	// The title of the dataset.  Does not have to be unique.
	Title *string `json:"title,omitempty"`
}

A complete lookup dataset as rendered in POST, PATCH, and GET responses.

type LookupDatasetExternalKind

type LookupDatasetExternalKind string

LookupDatasetExternalKind : The type of the external lookup.

const (
	LookupDatasetExternalKindKvcollection LookupDatasetExternalKind = "kvcollection"
)

List of LookupDatasetExternalKind

type LookupDatasetKind

type LookupDatasetKind string

LookupDatasetKind : The dataset kind.

const (
	LookupDatasetKindLookup LookupDatasetKind = "lookup"
)

List of LookupDatasetKind

type LookupDatasetPatch

type LookupDatasetPatch struct {
	// Match case-sensitively against the lookup.
	CaseSensitiveMatch *bool                      `json:"caseSensitiveMatch,omitempty"`
	ExternalKind       *LookupDatasetExternalKind `json:"externalKind,omitempty"`
	// The name of the external lookup.
	ExternalName *string `json:"externalName,omitempty"`
	// A query that filters results out of the lookup before those results are returned.
	Filter *string            `json:"filter,omitempty"`
	Kind   *LookupDatasetKind `json:"kind,omitempty"`
	// The name of module to reassign dataset into.
	Module *string `json:"module,omitempty"`
	// The dataset name. Dataset names must be unique within each module.
	Name *string `json:"name,omitempty"`
	// The name of the dataset owner. This value is obtained from the bearer token.
	Owner *string `json:"owner,omitempty"`
}

Property values to be set in an existing lookup dataset using a PATCH request.

type LookupDatasetProperties

type LookupDatasetProperties struct {
	// Match case-sensitively against the lookup.
	CaseSensitiveMatch *bool                      `json:"caseSensitiveMatch,omitempty"`
	ExternalKind       *LookupDatasetExternalKind `json:"externalKind,omitempty"`
	// The name of the external lookup.
	ExternalName *string `json:"externalName,omitempty"`
	// A query that filters results out of the lookup before those results are returned.
	Filter *string            `json:"filter,omitempty"`
	Kind   *LookupDatasetKind `json:"kind,omitempty"`
}

Properties of lookup datasets which may be read, set, and changed through the API. Implementation detail of DatasetPOST, DatasetPATCH, and Dataset, do not use directly.

type Message

type Message struct {
	Text *string      `json:"text,omitempty"`
	Type *MessageType `json:"type,omitempty"`
}

The message field in search results or search jobs. The types of messages are INFO, DEBUG, FATAL, and ERROR.

type MessageType

type MessageType string
const (
	MessageTypeInfo  MessageType = "INFO"
	MessageTypeDebug MessageType = "DEBUG"
	MessageTypeFatal MessageType = "FATAL"
	MessageTypeError MessageType = "ERROR"
)

List of MessageType

type MetadataProperties

type MetadataProperties struct {
	// The date and time object was created.
	Created string `json:"created"`
	// The name of the user who created the object. This value is obtained from the bearer token and may not be changed.
	Createdby string `json:"createdby"`
	// The date and time object was modified.
	Modified string `json:"modified"`
	// The name of the user who most recently modified the object.
	Modifiedby string `json:"modifiedby"`
	// The name of the object's owner.
	Owner string `json:"owner"`
}

Created, createdby, modified, modifiedby, and owner properties for inclusion in other objects.

type MetricDataset

type MetricDataset struct {
	// The date and time object was created.
	Created string `json:"created"`
	// The name of the user who created the object. This value is obtained from the bearer token and may not be changed.
	Createdby string `json:"createdby"`
	// Specifies whether or not the Splunk index is disabled.
	Disabled bool `json:"disabled"`
	// A unique dataset ID.
	Id   string            `json:"id"`
	Kind MetricDatasetKind `json:"kind"`
	// The date and time object was modified.
	Modified string `json:"modified"`
	// The name of the user who most recently modified the object.
	Modifiedby string `json:"modifiedby"`
	// The dataset name. Dataset names must be unique within each module.
	Name string `json:"name"`
	// The name of the object's owner.
	Owner string `json:"owner"`
	// The dataset name qualified by the module name.
	Resourcename string `json:"resourcename"`
	// AppClinetId of the creator app of the dataset.
	Appclientidcreatedby *string `json:"appclientidcreatedby,omitempty"`
	// AppClinetId of the modifier app of the dataset.
	Appclientidmodifiedby *string `json:"appclientidmodifiedby,omitempty"`
	// Detailed description of the dataset.
	Description *string `json:"description,omitempty"`
	// The timestamp, in seconds, of the earliest measure. The timestamp is in UNIX time.
	EarliestEventTime *string `json:"earliestEventTime,omitempty"`
	// The earliest index time for any of the measures in this index.
	EarliestIngestTime *string `json:"earliestIngestTime,omitempty"`
	// The frozenTimePeriodInSecs to use for the index
	FrozenTimePeriodInSecs *int32 `json:"frozenTimePeriodInSecs,omitempty"`
	// The timestamp, in seconds, of the latest measure. The timestamp is in UNIX time.
	LatestEventTime *string `json:"latestEventTime,omitempty"`
	// The earliest index time for any of the measures in this index.
	LatestIngestTime *string `json:"latestIngestTime,omitempty"`
	// The latest time that the metric index metadata was refreshed.
	LatestMetadataUpdateTime *string `json:"latestMetadataUpdateTime,omitempty"`
	// The name of the namespace that contains the dataset.
	Namespace *string `json:"namespace,omitempty"`
	// Summary of the dataset's purpose.
	Summary *string `json:"summary,omitempty"`
	// The title of the dataset.  Does not have to be unique.
	Title *string `json:"title,omitempty"`
	// THe number of measures in the metric index.
	TotalEventCount *int32 `json:"totalEventCount,omitempty"`
	// For metrics indexes, the totalSize is set to 0.
	TotalSize *int32 `json:"totalSize,omitempty"`
}

A complete metric dataset as rendered in POST, PATCH, and GET responses.

type MetricDatasetKind

type MetricDatasetKind string

MetricDatasetKind : The dataset kind.

const (
	MetricDatasetKindMetric MetricDatasetKind = "metric"
)

List of MetricDatasetKind

type MetricDatasetPatch

type MetricDatasetPatch struct {
	// Specifies whether or not the Splunk index is disabled.
	Disabled *bool `json:"disabled,omitempty"`
	// The frozenTimePeriodInSecs to use for the index
	FrozenTimePeriodInSecs *int32             `json:"frozenTimePeriodInSecs,omitempty"`
	Kind                   *MetricDatasetKind `json:"kind,omitempty"`
	// The name of module to reassign dataset into.
	Module *string `json:"module,omitempty"`
	// The dataset name. Dataset names must be unique within each module.
	Name *string `json:"name,omitempty"`
	// The name of the dataset owner. This value is obtained from the bearer token.
	Owner *string `json:"owner,omitempty"`
}

Property values to be set in an existing metric dataset using a PATCH request.

type MetricDatasetProperties

type MetricDatasetProperties struct {
	// Specifies whether or not the Splunk index is disabled.
	Disabled *bool `json:"disabled,omitempty"`
	// The frozenTimePeriodInSecs to use for the index
	FrozenTimePeriodInSecs *int32             `json:"frozenTimePeriodInSecs,omitempty"`
	Kind                   *MetricDatasetKind `json:"kind,omitempty"`
}

Properties of metric datasets which may be read, set, and changed through the API. Implementation detail of DatasetPOST, DatasetPATCH, and Dataset, do not use directly.

type MetricDatasetReadOnlyProperties

type MetricDatasetReadOnlyProperties struct {
	// The timestamp, in seconds, of the earliest measure. The timestamp is in UNIX time.
	EarliestEventTime *string `json:"earliestEventTime,omitempty"`
	// The earliest index time for any of the measures in this index.
	EarliestIngestTime *string            `json:"earliestIngestTime,omitempty"`
	Kind               *MetricDatasetKind `json:"kind,omitempty"`
	// The timestamp, in seconds, of the latest measure. The timestamp is in UNIX time.
	LatestEventTime *string `json:"latestEventTime,omitempty"`
	// The earliest index time for any of the measures in this index.
	LatestIngestTime *string `json:"latestIngestTime,omitempty"`
	// The latest time that the metric index metadata was refreshed.
	LatestMetadataUpdateTime *string `json:"latestMetadataUpdateTime,omitempty"`
	// THe number of measures in the metric index.
	TotalEventCount *int32 `json:"totalEventCount,omitempty"`
	// For metrics indexes, the totalSize is set to 0.
	TotalSize *int32 `json:"totalSize,omitempty"`
}

Properties of metric datasets which can only be read through the API.

type QueryFunc

type QueryFunc func(step, start int) (*ListSearchResultsResponse, error)

QueryFunc is the function to be executed in each Next call of the iterator

type QueryParameters

type QueryParameters struct {
	// The earliest time, in absolute or relative format, to retrieve events. When specifying an absolute time specify either UNIX time, or UTC in seconds using the ISO-8601 (%FT%T.%Q) format. For example 2021-01-25T13:15:30Z. GMT is the default timezone. You must specify GMT when you specify UTC. Any offset specified is ignored. Latest time must be after Earliest time.
	Earliest *string `json:"earliest,omitempty"`
	// The latest time, in absolute or relative format, to retrieve events. When specifying an absolute time specify either UNIX time, or UTC in seconds using the ISO-8601 (%FT%T.%Q) format. For example 2021-01-25T13:15:30Z. GMT is the default timezone. You must specify GMT when you specify UTC. Any offset specified is ignored. Latest time must be after Earliest time.
	Latest *string `json:"latest,omitempty"`
	// Specify a time string to set the absolute time used for any relative time specifier in the search. Defaults to the current system time. You can specify a relative time modifier ('earliest' or 'latest') for this parameter.  For example, if 'earliest' is set to -d and  the 'relativeTimeAnchor' is set to '2021-01-05T13:15:30Z' then 'resolvedEarliest' is '2021-01-04T13:15:30Z'.
	RelativeTimeAnchor *string `json:"relativeTimeAnchor,omitempty"`
	// The timezone that relative time modifiers are based off of. Timezone only applies to relative time literals for 'earliest' and 'latest'. If UNIX time or UTC format is used for 'earliest' and 'latest', this field is ignored. For the list of supported timezone formats, see https://docs.splunk.com/Documentation/Splunk/latest/Data/Applytimezoneoffsetstotimestamps#zoneinfo_.28TZ.29_database type: string default: \"GMT\"
	Timezone interface{} `json:"timezone,omitempty"`
}

Represents parameters on the search job such as 'earliest' and 'latest'.

type SearchJob

type SearchJob struct {
	// The SPL search string.
	Query string `json:"query"`
	// Specifies whether a search that contains commands with side effects (with possible security risks) is allowed to run.
	AllowSideEffects *bool `json:"allowSideEffects,omitempty"`
	// Specifies whether a search is allowed to collect event summary information during the run time.
	CollectEventSummary *bool `json:"collectEventSummary,omitempty"`
	// Specifies whether a search is allowed to collect field summary information during the run time.
	CollectFieldSummary *bool `json:"collectFieldSummary,omitempty"`
	// Specifies whether a search is allowed to collect timeline bucket summary information during the run time.
	CollectTimeBuckets *bool `json:"collectTimeBuckets,omitempty"`
	// The time, in GMT, that the search job is finished. Empty if the search job has not completed.
	CompletionTime *string `json:"completionTime,omitempty"`
	// The time, in GMT, that the search job is dispatched.
	DispatchTime *string `json:"dispatchTime,omitempty"`
	// Specifies whether a search is allowed to collect preview results during the run time.
	EnablePreview *bool `json:"enablePreview,omitempty"`
	// Specifies whether the Search service should extract all of the available fields in the data, including fields not mentioned in the SPL, for the search job. Set to 'false' for better search performance. The 'extractAllFields' parameter is deprecated as of version v3alpha1. Although this parameter continues to function, it might be removed in a future version. Use the 'extractFields' parameter instead.
	ExtractAllFields *bool `json:"extractAllFields,omitempty"`
	// Specifies how the Search service should extract fields. Valid values include 'all', 'none', or 'indexed'.  Use 'all' to extract all fields. Use 'indexed' to extract only indexed fields. Use 'none' to extract only the default fields.
	ExtractFields *string `json:"extractFields,omitempty"`
	// The number of seconds to run the search before finalizing the search. The maximum value is 3600 seconds (1 hour).
	MaxTime  *int32    `json:"maxTime,omitempty"`
	Messages []Message `json:"messages,omitempty"`
	// The module to run the search in. The default module is used if a module is not specified.
	Module *string `json:"module,omitempty"`
	// The name of the search job.
	Name *string `json:"name,omitempty"`
	// An estimate of the percent of time remaining before the job completes.
	PercentComplete *int32 `json:"percentComplete,omitempty"`
	// Specifies if preview results for the search job are available. The valid status values are 'unknown', 'true', and 'false'. You must set the 'enablePreview=true' parameter to return preview search results.
	PreviewAvailable *string `json:"previewAvailable,omitempty"`
	// Represents parameters on the search job such as 'earliest' and 'latest'.
	QueryParameters *QueryParameters `json:"queryParameters,omitempty"`
	// Specifies a maximum time interval, in seconds, between identical existing searches. The 'requiredFreshness' parameter is used to determine if an existing search with the same query and the same time boundaries can be reused, instead of running the same search again. Freshness is applied to the 'resolvedEarliest' and 'resolvedLatest' parameters. If an existing search has the same exact criteria as this search and the 'resolvedEarliest' and 'resolvedLatest' values are within the freshness interval, the existing search metadata is returned instead of initiating a new search job. By default, the 'requiredFreshness' parameter is set to 0 which means that the platform does not attempt to use an existing search. The maximum value for the 'requiredFreshness' parameter is 259200 seconds (72 hours).
	RequiredFreshness *int32 `json:"requiredFreshness,omitempty"`
	// The earliest time specified as an absolute value in GMT. The time is computed based on the values you specify for the 'timezone' and 'earliest' queryParameters.
	ResolvedEarliest *string `json:"resolvedEarliest,omitempty"`
	// The latest time specified as an absolute value in GMT. The time is computed based on the values you specify for the 'timezone' and 'earliest' queryParameters.
	ResolvedLatest *string `json:"resolvedLatest,omitempty"`
	// The number of results produced so far for the search job.
	ResultsAvailable *int32 `json:"resultsAvailable,omitempty"`
	// The number of the preview search results for the job with the specified search ID (SID). You must set the 'enablePreview=true' parameter to return preview search results.
	ResultsPreviewAvailable *int32 `json:"resultsPreviewAvailable,omitempty"`
	// The ID assigned to the search job.
	Sid    *string       `json:"sid,omitempty"`
	Status *SearchStatus `json:"status,omitempty"`
}

A search job, including read-only fields that includes the required properties.

type SearchStatus

type SearchStatus string

SearchStatus : The current status of the search job. The valid status values are 'running', 'done', 'canceled', 'finalized' and 'failed'.

const (
	SearchStatusRunning   SearchStatus = "running"
	SearchStatusDone      SearchStatus = "done"
	SearchStatusCanceled  SearchStatus = "canceled"
	SearchStatusFailed    SearchStatus = "failed"
	SearchStatusFinalized SearchStatus = "finalized"
)

List of SearchStatus

type Service

type Service services.BaseService

func NewService

func NewService(iClient services.IClient) *Service

NewService creates a new search service client from the given Config

func (*Service) CreateDataset

func (s *Service) CreateDataset(datasetPost DatasetPost, resp ...*http.Response) (*Dataset, error)

CreateDataset - search service endpoint Creates a dataset. Parameters:

datasetPost
resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided

func (*Service) CreateFederatedConnection

func (s *Service) CreateFederatedConnection(federatedConnectionInput FederatedConnectionInput, resp ...*http.Response) (*FederatedConnection, error)

CreateFederatedConnection - search service endpoint Creates a new federated connection with information about how to connect to a remote index. Parameters:

federatedConnectionInput
resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided

func (*Service) CreateJob

func (s *Service) CreateJob(searchJob SearchJob, resp ...*http.Response) (*SearchJob, error)

CreateJob - search service endpoint Creates a search job. Parameters:

searchJob
resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided

func (*Service) DeleteDatasetById

func (s *Service) DeleteDatasetById(datasetid string, resp ...*http.Response) error

DeleteDatasetById - search service endpoint Deletes a dataset with a specified dataset ID (datasetid). Parameters:

datasetid: The dataset ID.
resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided

func (*Service) DeleteFederatedConnection

func (s *Service) DeleteFederatedConnection(connectionName string, resp ...*http.Response) error

DeleteFederatedConnection - search service endpoint Deletes a federated connection with the specified name (connectionName) Parameters:

connectionName: The name of the federated connection.
resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided

func (*Service) DeleteJob added in v1.6.0

func (s *Service) DeleteJob(deleteSearchJob DeleteSearchJob, resp ...*http.Response) (*DeleteSearchJob, error)

DeleteJob - search service endpoint Creates a search job that deletes events from an index. The events are deleted from the index in the specified module, based on the search criteria as specified by the predicate. Parameters:

deleteSearchJob
resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided

func (*Service) ExportResults

func (s *Service) ExportResults(sid string, query *ExportResultsQueryParams, resp ...*http.Response) (*map[string]interface{}, error)

ExportResults - search service endpoint Exports the search results for the job with the specified search ID (SID). Export the results as a CSV file or JSON file. Parameters:

sid: The search ID.
query: a struct pointer of valid query parameters for the endpoint, nil to send no query parameters
resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided

func (*Service) GetAllFederatedConnections

func (s *Service) GetAllFederatedConnections(resp ...*http.Response) (*ListFederatedConnections, error)

GetAllFederatedConnections - search service endpoint Returns all federated connections. Parameters:

resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided

func (*Service) GetDatasetById

func (s *Service) GetDatasetById(datasetid string, resp ...*http.Response) (*Dataset, error)

GetDatasetById - search service endpoint Returns a dataset with a specified dataset ID (datasetid). Parameters:

datasetid: The dataset ID.
resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided

func (*Service) GetFederatedConnectionByName

func (s *Service) GetFederatedConnectionByName(connectionName string, resp ...*http.Response) (*FederatedConnection, error)

GetFederatedConnectionByName - search service endpoint Returns the federated connection with the specified name (connectionName). Parameters:

connectionName: The name of the federated connection.
resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided

func (*Service) GetJob

func (s *Service) GetJob(sid string, resp ...*http.Response) (*SearchJob, error)

GetJob - search service endpoint Returns the search job with the specified search ID (SID). Parameters:

sid: The search ID.
resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided

func (*Service) ListDatasets

func (s *Service) ListDatasets(resp ...*http.Response) (*ListDatasets, error)

ListDatasets - search service endpoint Returns a list of all datasets. Parameters:

resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided

func (*Service) ListEventsSummary

func (s *Service) ListEventsSummary(sid string, query *ListEventsSummaryQueryParams, resp ...*http.Response) (*ListSearchResultsResponse, error)

ListEventsSummary - search service endpoint Returns an events summary for search ID (SID) search. Parameters:

sid: The search ID.
query: a struct pointer of valid query parameters for the endpoint, nil to send no query parameters
resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided

func (*Service) ListFieldsSummary

func (s *Service) ListFieldsSummary(sid string, query *ListFieldsSummaryQueryParams, resp ...*http.Response) (*FieldsSummary, error)

ListFieldsSummary - search service endpoint Returns a fields stats summary of the events to-date, for search ID (SID) search. Parameters:

sid: The search ID.
query: a struct pointer of valid query parameters for the endpoint, nil to send no query parameters
resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided

func (*Service) ListJobs

func (s *Service) ListJobs(query *ListJobsQueryParams, resp ...*http.Response) ([]SearchJob, error)

ListJobs - search service endpoint Returns the matching list of search jobs. Parameters:

query: a struct pointer of valid query parameters for the endpoint, nil to send no query parameters
resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided

func (*Service) ListPreviewResults

func (s *Service) ListPreviewResults(sid string, query *ListPreviewResultsQueryParams, resp ...*http.Response) (*ListPreviewResultsResponse, error)

ListPreviewResults - search service endpoint Returns the preview search results for the job with the specified search ID (SID). Can be used when a job is running to return interim results. Parameters:

sid: The search ID.
query: a struct pointer of valid query parameters for the endpoint, nil to send no query parameters
resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided

func (*Service) ListResults

func (s *Service) ListResults(sid string, query *ListResultsQueryParams, resp ...*http.Response) (*ListSearchResultsResponse, error)

ListResults - search service endpoint Returns the search results for the job with the specified search ID (SID). Parameters:

sid: The search ID.
query: a struct pointer of valid query parameters for the endpoint, nil to send no query parameters
resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided

func (*Service) ListTimeBuckets

func (s *Service) ListTimeBuckets(sid string, resp ...*http.Response) (*TimeBucketsSummary, error)

ListTimeBuckets - search service endpoint Returns the event distribution over time of the untransformed events read to-date, for search ID(SID) search. Parameters:

sid: The search ID.
resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided

func (*Service) PutFederatedConnectionByName

func (s *Service) PutFederatedConnectionByName(connectionName string, federatedConnectionInput FederatedConnectionInput, resp ...*http.Response) (*FederatedConnection, error)

PutFederatedConnectionByName - search service endpoint Creates or updates a federated connection with a specified name (connectionName). Parameters:

connectionName: The name of the federated connection.
federatedConnectionInput
resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided

func (*Service) RefreshFederatedConnection

func (s *Service) RefreshFederatedConnection(connectionName string, resp ...*http.Response) error

RefreshFederatedConnection - search service endpoint Refresh a federated connection to fetch new remote indexes and add/delete corresponding federated datasets. Parameters:

connectionName: The name of the federated connection.
resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided

func (*Service) TestFederatedConnection

func (s *Service) TestFederatedConnection(connectionName string, resp ...*http.Response) error

TestFederatedConnection - search service endpoint Test connection with remote EC instance using federated connection parameters. Parameters:

connectionName: The name of the federated connection.
resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided

func (*Service) UpdateDatasetById

func (s *Service) UpdateDatasetById(datasetid string, datasetPatch DatasetPatch, resp ...*http.Response) (*Dataset, error)

UpdateDatasetById - search service endpoint Modifies a dataset with a specified dataset ID (datasetid). Parameters:

datasetid: The dataset ID.
datasetPatch
resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided

func (*Service) UpdateJob

func (s *Service) UpdateJob(sid string, updateJob UpdateJob, resp ...*http.Response) (*SearchJob, error)

UpdateJob - search service endpoint Updates the search job with the specified search ID (SID) with an action. Parameters:

sid: The search ID.
updateJob
resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided

func (*Service) WaitForJob

func (s *Service) WaitForJob(jobID string, pollInterval time.Duration) (interface{}, error)

WaitForJob polls the job until it's completed or errors out

type Servicer

type Servicer interface {
	//interfaces that cannot be auto-generated from codegen
	// WaitForJob polls the job until it's completed or errors out
	WaitForJob(jobID string, pollInterval time.Duration) (interface{}, error)

	//interfaces that are auto-generated in interface_generated.go
	ServicerGenerated
}

Servicer represents the interface for implementing all endpoints for this service

type ServicerGenerated added in v1.10.0

type ServicerGenerated interface {
	/*
		CreateDataset - search service endpoint
		Creates a dataset.
		Parameters:
			datasetPost
			resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided
	*/
	CreateDataset(datasetPost DatasetPost, resp ...*http.Response) (*Dataset, error)
	/*
		CreateFederatedConnection - search service endpoint
		Creates a new federated connection with information about how to connect to a remote index.
		Parameters:
			federatedConnectionInput
			resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided
	*/
	CreateFederatedConnection(federatedConnectionInput FederatedConnectionInput, resp ...*http.Response) (*FederatedConnection, error)
	/*
		CreateJob - search service endpoint
		Creates a search job.
		Parameters:
			searchJob
			resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided
	*/
	CreateJob(searchJob SearchJob, resp ...*http.Response) (*SearchJob, error)
	/*
		DeleteDatasetById - search service endpoint
		Deletes a dataset with a specified dataset ID (datasetid).
		Parameters:
			datasetid: The dataset ID.
			resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided
	*/
	DeleteDatasetById(datasetid string, resp ...*http.Response) error
	/*
		DeleteFederatedConnection - search service endpoint
		Deletes a federated connection with the specified name (connectionName)
		Parameters:
			connectionName: The name of the federated connection.
			resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided
	*/
	DeleteFederatedConnection(connectionName string, resp ...*http.Response) error
	/*
		DeleteJob - search service endpoint
		Creates a search job that deletes events from an index. The events are deleted from the index in the specified module, based on the search criteria as specified by the predicate.
		Parameters:
			deleteSearchJob
			resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided
	*/
	DeleteJob(deleteSearchJob DeleteSearchJob, resp ...*http.Response) (*DeleteSearchJob, error)
	/*
		ExportResults - search service endpoint
		Exports the search results for the job with the specified search ID (SID). Export the results as a CSV file or JSON file.
		Parameters:
			sid: The search ID.
			query: a struct pointer of valid query parameters for the endpoint, nil to send no query parameters
			resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided
	*/
	ExportResults(sid string, query *ExportResultsQueryParams, resp ...*http.Response) (*map[string]interface{}, error)
	/*
		GetAllFederatedConnections - search service endpoint
		Returns all federated connections.
		Parameters:
			resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided
	*/
	GetAllFederatedConnections(resp ...*http.Response) (*ListFederatedConnections, error)
	/*
		GetDatasetById - search service endpoint
		Returns a dataset with a specified dataset ID (datasetid).
		Parameters:
			datasetid: The dataset ID.
			resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided
	*/
	GetDatasetById(datasetid string, resp ...*http.Response) (*Dataset, error)
	/*
		GetFederatedConnectionByName - search service endpoint
		Returns the federated connection with the specified name (connectionName).
		Parameters:
			connectionName: The name of the federated connection.
			resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided
	*/
	GetFederatedConnectionByName(connectionName string, resp ...*http.Response) (*FederatedConnection, error)
	/*
		GetJob - search service endpoint
		Returns the search job with the specified search ID (SID).
		Parameters:
			sid: The search ID.
			resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided
	*/
	GetJob(sid string, resp ...*http.Response) (*SearchJob, error)
	/*
		ListDatasets - search service endpoint
		Returns a list of all datasets.
		Parameters:
			resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided
	*/
	ListDatasets(resp ...*http.Response) (*ListDatasets, error)
	/*
		ListEventsSummary - search service endpoint
		Returns an events summary for search ID (SID) search.
		Parameters:
			sid: The search ID.
			query: a struct pointer of valid query parameters for the endpoint, nil to send no query parameters
			resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided
	*/
	ListEventsSummary(sid string, query *ListEventsSummaryQueryParams, resp ...*http.Response) (*ListSearchResultsResponse, error)
	/*
		ListFieldsSummary - search service endpoint
		Returns a fields stats summary of the events to-date, for search ID (SID) search.
		Parameters:
			sid: The search ID.
			query: a struct pointer of valid query parameters for the endpoint, nil to send no query parameters
			resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided
	*/
	ListFieldsSummary(sid string, query *ListFieldsSummaryQueryParams, resp ...*http.Response) (*FieldsSummary, error)
	/*
		ListJobs - search service endpoint
		Returns the matching list of search jobs.
		Parameters:
			query: a struct pointer of valid query parameters for the endpoint, nil to send no query parameters
			resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided
	*/
	ListJobs(query *ListJobsQueryParams, resp ...*http.Response) ([]SearchJob, error)
	/*
		ListPreviewResults - search service endpoint
		Returns the preview search results for the job with the specified search ID (SID). Can be used when a job is running to return interim results.
		Parameters:
			sid: The search ID.
			query: a struct pointer of valid query parameters for the endpoint, nil to send no query parameters
			resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided
	*/
	ListPreviewResults(sid string, query *ListPreviewResultsQueryParams, resp ...*http.Response) (*ListPreviewResultsResponse, error)
	/*
		ListResults - search service endpoint
		Returns the search results for the job with the specified search ID (SID).
		Parameters:
			sid: The search ID.
			query: a struct pointer of valid query parameters for the endpoint, nil to send no query parameters
			resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided
	*/
	ListResults(sid string, query *ListResultsQueryParams, resp ...*http.Response) (*ListSearchResultsResponse, error)
	/*
		ListTimeBuckets - search service endpoint
		Returns the event distribution over time of the untransformed events read to-date, for search ID(SID) search.
		Parameters:
			sid: The search ID.
			resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided
	*/
	ListTimeBuckets(sid string, resp ...*http.Response) (*TimeBucketsSummary, error)
	/*
		PutFederatedConnectionByName - search service endpoint
		Creates or updates a federated connection with a specified name (connectionName).
		Parameters:
			connectionName: The name of the federated connection.
			federatedConnectionInput
			resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided
	*/
	PutFederatedConnectionByName(connectionName string, federatedConnectionInput FederatedConnectionInput, resp ...*http.Response) (*FederatedConnection, error)
	/*
		RefreshFederatedConnection - search service endpoint
		Refresh a federated connection to fetch new remote indexes and add/delete corresponding federated datasets.
		Parameters:
			connectionName: The name of the federated connection.
			resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided
	*/
	RefreshFederatedConnection(connectionName string, resp ...*http.Response) error
	/*
		TestFederatedConnection - search service endpoint
		Test connection with remote EC instance using federated connection parameters.
		Parameters:
			connectionName: The name of the federated connection.
			resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided
	*/
	TestFederatedConnection(connectionName string, resp ...*http.Response) error
	/*
		UpdateDatasetById - search service endpoint
		Modifies a dataset with a specified dataset ID (datasetid).
		Parameters:
			datasetid: The dataset ID.
			datasetPatch
			resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided
	*/
	UpdateDatasetById(datasetid string, datasetPatch DatasetPatch, resp ...*http.Response) (*Dataset, error)
	/*
		UpdateJob - search service endpoint
		Updates the search job with the specified search ID (SID) with an action.
		Parameters:
			sid: The search ID.
			updateJob
			resp: an optional pointer to a http.Response to be populated by this method. NOTE: only the first resp pointer will be used if multiple are provided
	*/
	UpdateJob(sid string, updateJob UpdateJob, resp ...*http.Response) (*SearchJob, error)
}

ServicerGenerated represents the interface for implementing all endpoints for this service

type SingleFieldSummary

type SingleFieldSummary struct {
	// The total number of events that the field appears in.
	Count *int32 `json:"count,omitempty"`
	// The total number of unique values in the field.
	DistinctCount *int32 `json:"distinctCount,omitempty"`
	// Specifies if the 'distinctCount' is accurate. When the count exceeds the maximum count, an approximate count is computed instead and the 'isExact' property is FALSE.
	IsExact *bool `json:"isExact,omitempty"`
	// The maximum numeric value in the field.
	Max *string `json:"max,omitempty"`
	// The mean (average) for the numeric value in the field.
	Mean *float64 `json:"mean,omitempty"`
	// The minimum numeric value in the field.
	Min *string `json:"min,omitempty"`
	// An array of the values in the field.
	Modes []SingleValueMode `json:"modes,omitempty"`
	// The count of the numeric values in the field.
	NumericCount *int32 `json:"numericCount,omitempty"`
	// Specifies if the field was added or changed by the search.
	Relevant *bool `json:"relevant,omitempty"`
	// The standard deviation for the numeric values in the field.
	Stddev *float64 `json:"stddev,omitempty"`
}

Summary of each field.

type SingleTimeBucket

type SingleTimeBucket struct {
	// Count of available events. Not all events in a bucket are retrievable. Typically this count is capped at 10000.
	AvailableCount *int32   `json:"availableCount,omitempty"`
	Duration       *float64 `json:"duration,omitempty"`
	// The timestamp of the earliest event in the current bucket, in UNIX format. This is the same time as 'earliestTimeStrfTime' in UNIX format.
	EarliestTime *float64 `json:"earliestTime,omitempty"`
	// The timestamp of the earliest event in the current bucket, in UTC format with seconds. For example 2021-01-25T13:15:30Z, which follows the ISO-8601 (%FT%T.%Q) format.
	EarliestTimeStrfTime *string `json:"earliestTimeStrfTime,omitempty"`
	// Specifies if all of the events in the current bucket have been finalized.
	IsFinalized *bool `json:"isFinalized,omitempty"`
	// The total count of the events in the current bucket.
	TotalCount *int32 `json:"totalCount,omitempty"`
}

The summary of events for a single time bucket.

type SingleValueMode

type SingleValueMode struct {
	// The number of occurrences that the value appears in a field.
	Count *int32 `json:"count,omitempty"`
	// Specifies if the count is accurate. When the count exceeds the maximum count, an approximate count is computed instead and the 'isExact' property is FALSE.
	IsExact *bool `json:"isExact,omitempty"`
	// The value in the field.
	Value *string `json:"value,omitempty"`
}

Summary of the value in a field.

type TimeBucketsSummary

type TimeBucketsSummary struct {
	// Specifies if the events are returned in time order.
	IsTimeCursored *bool              `json:"IsTimeCursored,omitempty"`
	Buckets        []SingleTimeBucket `json:"buckets,omitempty"`
	// Identifies where the cursor is in processing the events. The 'cursorTime' is a timestamp specified in UNIX time.
	CursorTime *float32 `json:"cursorTime,omitempty"`
	// The number of events processed at the 'cursorTime'.
	EventCount *int32 `json:"eventCount,omitempty"`
}

A timeline metadata model of the event distribution. The model shows the untransformed events that are read to date for a specific for search ID (SID).

type UpdateJob

type UpdateJob struct {
	// Modify the status of an existing search job using PATCH. The only status values you can PATCH are 'canceled' and 'finalized'.  You can PATCH the 'canceled' status only to a search job that is running. 'finalize' means to terminate the search job, and the status will be set to 'failed'.
	Status UpdateJobStatus `json:"status"`
}

Updates a search job with a status.

type UpdateJobStatus

type UpdateJobStatus string

UpdateJobStatus : Modify the status of an existing search job using PATCH. The only status values you can PATCH are 'canceled' and 'finalized'. You can PATCH the 'canceled' status only to a search job that is running. 'finalize' means to terminate the search job, and the status will be set to 'failed'.

const (
	UpdateJobStatusCanceled  UpdateJobStatus = "canceled"
	UpdateJobStatusFinalized UpdateJobStatus = "finalized"
)

List of UpdateJobStatus

type UserMetadataProperties

type UserMetadataProperties struct {
	// The name of the user who created the object. This value is obtained from the bearer token and may not be changed.
	Createdby string `json:"createdby"`
	// The name of the user who most recently modified the object.
	Modifiedby string `json:"modifiedby"`
	// The name of the object's owner.
	Owner string `json:"owner"`
}

Owner, createdby, and modifiedby user name properties for inclusion in other objects.

Jump to

Keyboard shortcuts

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