Documentation
¶
Index ¶
- type Dataset
- func MakeDatasetFromFederatedDataset(f FederatedDataset) Dataset
- func MakeDatasetFromIndexDataset(f IndexDataset) Dataset
- func MakeDatasetFromKvCollectionDataset(f KvCollectionDataset) Dataset
- func MakeDatasetFromLookupDataset(f LookupDataset) Dataset
- func MakeDatasetFromMetricDataset(f MetricDataset) Dataset
- func MakeDatasetFromRawInterface(f interface{}) Dataset
- func (m Dataset) FederatedDataset() *FederatedDataset
- func (m Dataset) IndexDataset() *IndexDataset
- func (m Dataset) IsFederatedDataset() bool
- func (m Dataset) IsIndexDataset() bool
- func (m Dataset) IsKvCollectionDataset() bool
- func (m Dataset) IsLookupDataset() bool
- func (m Dataset) IsMetricDataset() bool
- func (m Dataset) IsRawInterface() bool
- func (m Dataset) KvCollectionDataset() *KvCollectionDataset
- func (m Dataset) LookupDataset() *LookupDataset
- func (m Dataset) MarshalJSON() ([]byte, error)
- func (m Dataset) MetricDataset() *MetricDataset
- func (m Dataset) RawInterface() interface{}
- func (m *Dataset) UnmarshalJSON(b []byte) (err error)
- type DatasetCommon
- type DatasetPatch
- func MakeDatasetPatchFromFederatedDatasetPatch(f FederatedDatasetPatch) DatasetPatch
- func MakeDatasetPatchFromIndexDatasetPatch(f IndexDatasetPatch) DatasetPatch
- func MakeDatasetPatchFromKvCollectionDatasetPatch(f KvCollectionDatasetPatch) DatasetPatch
- func MakeDatasetPatchFromLookupDatasetPatch(f LookupDatasetPatch) DatasetPatch
- func MakeDatasetPatchFromMetricDatasetPatch(f MetricDatasetPatch) DatasetPatch
- func MakeDatasetPatchFromRawInterface(f interface{}) DatasetPatch
- func (m DatasetPatch) FederatedDatasetPatch() *FederatedDatasetPatch
- func (m DatasetPatch) IndexDatasetPatch() *IndexDatasetPatch
- func (m DatasetPatch) IsFederatedDatasetPatch() bool
- func (m DatasetPatch) IsIndexDatasetPatch() bool
- func (m DatasetPatch) IsKvCollectionDatasetPatch() bool
- func (m DatasetPatch) IsLookupDatasetPatch() bool
- func (m DatasetPatch) IsMetricDatasetPatch() bool
- func (m DatasetPatch) IsRawInterface() bool
- func (m DatasetPatch) KvCollectionDatasetPatch() *KvCollectionDatasetPatch
- func (m DatasetPatch) LookupDatasetPatch() *LookupDatasetPatch
- func (m DatasetPatch) MarshalJSON() ([]byte, error)
- func (m DatasetPatch) MetricDatasetPatch() *MetricDatasetPatch
- func (m DatasetPatch) RawInterface() interface{}
- func (m *DatasetPatch) UnmarshalJSON(b []byte) (err error)
- type DatasetPatchCommon
- type DatasetPost
- type DateMetadataProperties
- type DeleteSearchJob
- type ExportResultsQueryParams
- type ExportResultsoutputMode
- type FederatedConnection
- type FederatedConnectionInput
- type FederatedDataset
- type FederatedDatasetKind
- type FederatedDatasetPatch
- type FederatedDatasetProperties
- type FieldDataType
- type FieldPost
- type FieldPrevalence
- type FieldProperties
- type FieldType
- type FieldsSummary
- type IndexDataset
- type IndexDatasetKind
- type IndexDatasetPatch
- type IndexDatasetProperties
- type IndexDatasetReadOnlyProperties
- type Iterator
- type KvCollectionDataset
- type KvCollectionDatasetKind
- type KvCollectionDatasetPatch
- type KvCollectionDatasetProperties
- type ListDatasets
- type ListEventsSummaryQueryParams
- func (q ListEventsSummaryQueryParams) SetCount(v int32) ListEventsSummaryQueryParams
- func (q ListEventsSummaryQueryParams) SetEarliest(v string) ListEventsSummaryQueryParams
- func (q ListEventsSummaryQueryParams) SetField(v string) ListEventsSummaryQueryParams
- func (q ListEventsSummaryQueryParams) SetLatest(v string) ListEventsSummaryQueryParams
- func (q ListEventsSummaryQueryParams) SetOffset(v int32) ListEventsSummaryQueryParams
- type ListFederatedConnections
- type ListFieldsSummaryQueryParams
- type ListJobsQueryParams
- type ListPreviewResultsQueryParams
- type ListPreviewResultsResponse
- type ListPreviewResultsResponseFields
- type ListResultsQueryParams
- type ListSearchResultsResponse
- type LookupDataset
- type LookupDatasetExternalKind
- type LookupDatasetKind
- type LookupDatasetPatch
- type LookupDatasetProperties
- type Message
- type MessageType
- type MetadataProperties
- type MetricDataset
- type MetricDatasetKind
- type MetricDatasetPatch
- type MetricDatasetProperties
- type MetricDatasetReadOnlyProperties
- type QueryFunc
- type QueryParameters
- type SearchJob
- type SearchStatus
- type Service
- func (s *Service) CreateDataset(datasetPost DatasetPost, resp ...*http.Response) (*Dataset, error)
- func (s *Service) CreateFederatedConnection(federatedConnectionInput FederatedConnectionInput, resp ...*http.Response) (*FederatedConnection, error)
- func (s *Service) CreateJob(searchJob SearchJob, resp ...*http.Response) (*SearchJob, error)
- func (s *Service) DeleteDatasetById(datasetid string, resp ...*http.Response) error
- func (s *Service) DeleteFederatedConnection(connectionName string, resp ...*http.Response) error
- func (s *Service) DeleteJob(deleteSearchJob DeleteSearchJob, resp ...*http.Response) (*DeleteSearchJob, error)
- func (s *Service) ExportResults(sid string, query *ExportResultsQueryParams, resp ...*http.Response) (*map[string]interface{}, error)
- func (s *Service) GetAllFederatedConnections(resp ...*http.Response) (*ListFederatedConnections, error)
- func (s *Service) GetDatasetById(datasetid string, resp ...*http.Response) (*Dataset, error)
- func (s *Service) GetFederatedConnectionByName(connectionName string, resp ...*http.Response) (*FederatedConnection, error)
- func (s *Service) GetJob(sid string, resp ...*http.Response) (*SearchJob, error)
- func (s *Service) ListDatasets(resp ...*http.Response) (*ListDatasets, error)
- func (s *Service) ListEventsSummary(sid string, query *ListEventsSummaryQueryParams, resp ...*http.Response) (*ListSearchResultsResponse, error)
- func (s *Service) ListFieldsSummary(sid string, query *ListFieldsSummaryQueryParams, resp ...*http.Response) (*FieldsSummary, error)
- func (s *Service) ListJobs(query *ListJobsQueryParams, resp ...*http.Response) ([]SearchJob, error)
- func (s *Service) ListPreviewResults(sid string, query *ListPreviewResultsQueryParams, resp ...*http.Response) (*ListPreviewResultsResponse, error)
- func (s *Service) ListResults(sid string, query *ListResultsQueryParams, resp ...*http.Response) (*ListSearchResultsResponse, error)
- func (s *Service) ListTimeBuckets(sid string, resp ...*http.Response) (*TimeBucketsSummary, error)
- func (s *Service) PutFederatedConnectionByName(connectionName string, federatedConnectionInput FederatedConnectionInput, ...) (*FederatedConnection, error)
- func (s *Service) RefreshFederatedConnection(connectionName string, resp ...*http.Response) error
- func (s *Service) TestFederatedConnection(connectionName string, resp ...*http.Response) error
- func (s *Service) UpdateDatasetById(datasetid string, datasetPatch DatasetPatch, resp ...*http.Response) (*Dataset, error)
- func (s *Service) UpdateJob(sid string, updateJob UpdateJob, resp ...*http.Response) (*SearchJob, error)
- func (s *Service) WaitForJob(jobID string, pollInterval time.Duration) (interface{}, error)
- type Servicer
- type ServicerGenerated
- type SingleFieldSummary
- type SingleTimeBucket
- type SingleValueMode
- type TimeBucketsSummary
- type UpdateJob
- type UpdateJobStatus
- type UserMetadataProperties
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 ¶
IsFederatedDataset checks if the Dataset is a FederatedDataset
func (Dataset) IsIndexDataset ¶
IsIndexDataset checks if the Dataset is a IndexDataset
func (Dataset) IsKvCollectionDataset ¶
IsKvCollectionDataset checks if the Dataset is a KvCollectionDataset
func (Dataset) IsLookupDataset ¶
IsLookupDataset checks if the Dataset is a LookupDataset
func (Dataset) IsMetricDataset ¶
IsMetricDataset checks if the Dataset is a MetricDataset
func (Dataset) IsRawInterface ¶
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 ¶
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 ¶
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 (q ExportResultsQueryParams) SetCount(v int32) ExportResultsQueryParams
func (ExportResultsQueryParams) SetFilename ¶
func (q ExportResultsQueryParams) SetFilename(v string) ExportResultsQueryParams
func (ExportResultsQueryParams) SetOutputMode ¶
func (q ExportResultsQueryParams) SetOutputMode(v ExportResultsoutputMode) ExportResultsQueryParams
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.
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 ¶
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) Next ¶
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 (q ListEventsSummaryQueryParams) SetCount(v int32) ListEventsSummaryQueryParams
func (ListEventsSummaryQueryParams) SetEarliest ¶
func (q ListEventsSummaryQueryParams) SetEarliest(v string) ListEventsSummaryQueryParams
func (ListEventsSummaryQueryParams) SetField ¶
func (q ListEventsSummaryQueryParams) SetField(v string) ListEventsSummaryQueryParams
func (ListEventsSummaryQueryParams) SetLatest ¶
func (q ListEventsSummaryQueryParams) SetLatest(v string) ListEventsSummaryQueryParams
func (ListEventsSummaryQueryParams) SetOffset ¶
func (q ListEventsSummaryQueryParams) SetOffset(v int32) ListEventsSummaryQueryParams
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 (q ListFieldsSummaryQueryParams) SetEarliest(v string) ListFieldsSummaryQueryParams
func (ListFieldsSummaryQueryParams) SetLatest ¶
func (q ListFieldsSummaryQueryParams) SetLatest(v string) ListFieldsSummaryQueryParams
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 (q ListJobsQueryParams) SetCount(v int32) ListJobsQueryParams
func (ListJobsQueryParams) SetFilter ¶ added in v1.2.1
func (q ListJobsQueryParams) SetFilter(v string) ListJobsQueryParams
func (ListJobsQueryParams) SetStatus ¶
func (q ListJobsQueryParams) SetStatus(v SearchStatus) ListJobsQueryParams
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 (q ListPreviewResultsQueryParams) SetCount(v int32) ListPreviewResultsQueryParams
func (ListPreviewResultsQueryParams) SetOffset ¶
func (q ListPreviewResultsQueryParams) SetOffset(v int32) ListPreviewResultsQueryParams
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 (q ListResultsQueryParams) SetCount(v int32) ListResultsQueryParams
func (ListResultsQueryParams) SetField ¶
func (q ListResultsQueryParams) SetField(v string) ListResultsQueryParams
func (ListResultsQueryParams) SetOffset ¶
func (q ListResultsQueryParams) SetOffset(v int32) ListResultsQueryParams
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 ¶
NewService creates a new search service client from the given Config
func (*Service) CreateDataset ¶
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 ¶
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 ¶
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 ¶
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 ¶
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 ¶
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 ¶
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 ¶
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 ¶
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 ¶
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
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.