mirror of
https://github.com/Luzifer/cloudkeys-go.git
synced 2024-11-14 17:02:43 +00:00
1431 lines
53 KiB
Go
1431 lines
53 KiB
Go
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
|
|
|
|
package cloudsearchdomain
|
|
|
|
import (
|
|
"io"
|
|
|
|
"github.com/aws/aws-sdk-go/aws"
|
|
"github.com/aws/aws-sdk-go/aws/awsutil"
|
|
"github.com/aws/aws-sdk-go/aws/request"
|
|
)
|
|
|
|
const opSearch = "Search"
|
|
|
|
// SearchRequest generates a "aws/request.Request" representing the
|
|
// client's request for the Search operation. The "output" return
|
|
// value will be populated with the request's response once the request complets
|
|
// successfuly.
|
|
//
|
|
// Use "Send" method on the returned Request to send the API call to the service.
|
|
// the "output" return value is not valid until after Send returns without error.
|
|
//
|
|
// See Search for more information on using the Search
|
|
// API call, and error handling.
|
|
//
|
|
// This method is useful when you want to inject custom logic or configuration
|
|
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
|
|
//
|
|
//
|
|
// // Example sending a request using the SearchRequest method.
|
|
// req, resp := client.SearchRequest(params)
|
|
//
|
|
// err := req.Send()
|
|
// if err == nil { // resp is now filled
|
|
// fmt.Println(resp)
|
|
// }
|
|
func (c *CloudSearchDomain) SearchRequest(input *SearchInput) (req *request.Request, output *SearchOutput) {
|
|
op := &request.Operation{
|
|
Name: opSearch,
|
|
HTTPMethod: "GET",
|
|
HTTPPath: "/2013-01-01/search?format=sdk&pretty=true",
|
|
}
|
|
|
|
if input == nil {
|
|
input = &SearchInput{}
|
|
}
|
|
|
|
output = &SearchOutput{}
|
|
req = c.newRequest(op, input, output)
|
|
return
|
|
}
|
|
|
|
// Search API operation for Amazon CloudSearch Domain.
|
|
//
|
|
// Retrieves a list of documents that match the specified search criteria. How
|
|
// you specify the search criteria depends on which query parser you use. Amazon
|
|
// CloudSearch supports four query parsers:
|
|
//
|
|
// * simple: search all text and text-array fields for the specified string.
|
|
// Search for phrases, individual terms, and prefixes.
|
|
// * structured: search specific fields, construct compound queries using
|
|
// Boolean operators, and use advanced features such as term boosting and
|
|
// proximity searching.
|
|
// * lucene: specify search criteria using the Apache Lucene query parser
|
|
// syntax.
|
|
// * dismax: specify search criteria using the simplified subset of the Apache
|
|
// Lucene query parser syntax defined by the DisMax query parser.
|
|
// For more information, see Searching Your Data (http://docs.aws.amazon.com/cloudsearch/latest/developerguide/searching.html)
|
|
// in the Amazon CloudSearch Developer Guide.
|
|
//
|
|
// The endpoint for submitting Search requests is domain-specific. You submit
|
|
// search requests to a domain's search endpoint. To get the search endpoint
|
|
// for your domain, use the Amazon CloudSearch configuration service DescribeDomains
|
|
// action. A domain's endpoints are also displayed on the domain dashboard in
|
|
// the Amazon CloudSearch console.
|
|
//
|
|
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
|
|
// with awserr.Error's Code and Message methods to get detailed information about
|
|
// the error.
|
|
//
|
|
// See the AWS API reference guide for Amazon CloudSearch Domain's
|
|
// API operation Search for usage and error information.
|
|
//
|
|
// Returned Error Codes:
|
|
// * ErrCodeSearchException "SearchException"
|
|
// Information about any problems encountered while processing a search request.
|
|
//
|
|
func (c *CloudSearchDomain) Search(input *SearchInput) (*SearchOutput, error) {
|
|
req, out := c.SearchRequest(input)
|
|
return out, req.Send()
|
|
}
|
|
|
|
// SearchWithContext is the same as Search with the addition of
|
|
// the ability to pass a context and additional request options.
|
|
//
|
|
// See Search for details on how to use this API operation.
|
|
//
|
|
// The context must be non-nil and will be used for request cancellation. If
|
|
// the context is nil a panic will occur. In the future the SDK may create
|
|
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
|
|
// for more information on using Contexts.
|
|
func (c *CloudSearchDomain) SearchWithContext(ctx aws.Context, input *SearchInput, opts ...request.Option) (*SearchOutput, error) {
|
|
req, out := c.SearchRequest(input)
|
|
req.SetContext(ctx)
|
|
req.ApplyOptions(opts...)
|
|
return out, req.Send()
|
|
}
|
|
|
|
const opSuggest = "Suggest"
|
|
|
|
// SuggestRequest generates a "aws/request.Request" representing the
|
|
// client's request for the Suggest operation. The "output" return
|
|
// value will be populated with the request's response once the request complets
|
|
// successfuly.
|
|
//
|
|
// Use "Send" method on the returned Request to send the API call to the service.
|
|
// the "output" return value is not valid until after Send returns without error.
|
|
//
|
|
// See Suggest for more information on using the Suggest
|
|
// API call, and error handling.
|
|
//
|
|
// This method is useful when you want to inject custom logic or configuration
|
|
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
|
|
//
|
|
//
|
|
// // Example sending a request using the SuggestRequest method.
|
|
// req, resp := client.SuggestRequest(params)
|
|
//
|
|
// err := req.Send()
|
|
// if err == nil { // resp is now filled
|
|
// fmt.Println(resp)
|
|
// }
|
|
func (c *CloudSearchDomain) SuggestRequest(input *SuggestInput) (req *request.Request, output *SuggestOutput) {
|
|
op := &request.Operation{
|
|
Name: opSuggest,
|
|
HTTPMethod: "GET",
|
|
HTTPPath: "/2013-01-01/suggest?format=sdk&pretty=true",
|
|
}
|
|
|
|
if input == nil {
|
|
input = &SuggestInput{}
|
|
}
|
|
|
|
output = &SuggestOutput{}
|
|
req = c.newRequest(op, input, output)
|
|
return
|
|
}
|
|
|
|
// Suggest API operation for Amazon CloudSearch Domain.
|
|
//
|
|
// Retrieves autocomplete suggestions for a partial query string. You can use
|
|
// suggestions enable you to display likely matches before users finish typing.
|
|
// In Amazon CloudSearch, suggestions are based on the contents of a particular
|
|
// text field. When you request suggestions, Amazon CloudSearch finds all of
|
|
// the documents whose values in the suggester field start with the specified
|
|
// query string. The beginning of the field must match the query string to be
|
|
// considered a match.
|
|
//
|
|
// For more information about configuring suggesters and retrieving suggestions,
|
|
// see Getting Suggestions (http://docs.aws.amazon.com/cloudsearch/latest/developerguide/getting-suggestions.html)
|
|
// in the Amazon CloudSearch Developer Guide.
|
|
//
|
|
// The endpoint for submitting Suggest requests is domain-specific. You submit
|
|
// suggest requests to a domain's search endpoint. To get the search endpoint
|
|
// for your domain, use the Amazon CloudSearch configuration service DescribeDomains
|
|
// action. A domain's endpoints are also displayed on the domain dashboard in
|
|
// the Amazon CloudSearch console.
|
|
//
|
|
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
|
|
// with awserr.Error's Code and Message methods to get detailed information about
|
|
// the error.
|
|
//
|
|
// See the AWS API reference guide for Amazon CloudSearch Domain's
|
|
// API operation Suggest for usage and error information.
|
|
//
|
|
// Returned Error Codes:
|
|
// * ErrCodeSearchException "SearchException"
|
|
// Information about any problems encountered while processing a search request.
|
|
//
|
|
func (c *CloudSearchDomain) Suggest(input *SuggestInput) (*SuggestOutput, error) {
|
|
req, out := c.SuggestRequest(input)
|
|
return out, req.Send()
|
|
}
|
|
|
|
// SuggestWithContext is the same as Suggest with the addition of
|
|
// the ability to pass a context and additional request options.
|
|
//
|
|
// See Suggest for details on how to use this API operation.
|
|
//
|
|
// The context must be non-nil and will be used for request cancellation. If
|
|
// the context is nil a panic will occur. In the future the SDK may create
|
|
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
|
|
// for more information on using Contexts.
|
|
func (c *CloudSearchDomain) SuggestWithContext(ctx aws.Context, input *SuggestInput, opts ...request.Option) (*SuggestOutput, error) {
|
|
req, out := c.SuggestRequest(input)
|
|
req.SetContext(ctx)
|
|
req.ApplyOptions(opts...)
|
|
return out, req.Send()
|
|
}
|
|
|
|
const opUploadDocuments = "UploadDocuments"
|
|
|
|
// UploadDocumentsRequest generates a "aws/request.Request" representing the
|
|
// client's request for the UploadDocuments operation. The "output" return
|
|
// value will be populated with the request's response once the request complets
|
|
// successfuly.
|
|
//
|
|
// Use "Send" method on the returned Request to send the API call to the service.
|
|
// the "output" return value is not valid until after Send returns without error.
|
|
//
|
|
// See UploadDocuments for more information on using the UploadDocuments
|
|
// API call, and error handling.
|
|
//
|
|
// This method is useful when you want to inject custom logic or configuration
|
|
// into the SDK's request lifecycle. Such as custom headers, or retry logic.
|
|
//
|
|
//
|
|
// // Example sending a request using the UploadDocumentsRequest method.
|
|
// req, resp := client.UploadDocumentsRequest(params)
|
|
//
|
|
// err := req.Send()
|
|
// if err == nil { // resp is now filled
|
|
// fmt.Println(resp)
|
|
// }
|
|
func (c *CloudSearchDomain) UploadDocumentsRequest(input *UploadDocumentsInput) (req *request.Request, output *UploadDocumentsOutput) {
|
|
op := &request.Operation{
|
|
Name: opUploadDocuments,
|
|
HTTPMethod: "POST",
|
|
HTTPPath: "/2013-01-01/documents/batch?format=sdk",
|
|
}
|
|
|
|
if input == nil {
|
|
input = &UploadDocumentsInput{}
|
|
}
|
|
|
|
output = &UploadDocumentsOutput{}
|
|
req = c.newRequest(op, input, output)
|
|
return
|
|
}
|
|
|
|
// UploadDocuments API operation for Amazon CloudSearch Domain.
|
|
//
|
|
// Posts a batch of documents to a search domain for indexing. A document batch
|
|
// is a collection of add and delete operations that represent the documents
|
|
// you want to add, update, or delete from your domain. Batches can be described
|
|
// in either JSON or XML. Each item that you want Amazon CloudSearch to return
|
|
// as a search result (such as a product) is represented as a document. Every
|
|
// document has a unique ID and one or more fields that contain the data that
|
|
// you want to search and return in results. Individual documents cannot contain
|
|
// more than 1 MB of data. The entire batch cannot exceed 5 MB. To get the best
|
|
// possible upload performance, group add and delete operations in batches that
|
|
// are close the 5 MB limit. Submitting a large volume of single-document batches
|
|
// can overload a domain's document service.
|
|
//
|
|
// The endpoint for submitting UploadDocuments requests is domain-specific.
|
|
// To get the document endpoint for your domain, use the Amazon CloudSearch
|
|
// configuration service DescribeDomains action. A domain's endpoints are also
|
|
// displayed on the domain dashboard in the Amazon CloudSearch console.
|
|
//
|
|
// For more information about formatting your data for Amazon CloudSearch, see
|
|
// Preparing Your Data (http://docs.aws.amazon.com/cloudsearch/latest/developerguide/preparing-data.html)
|
|
// in the Amazon CloudSearch Developer Guide. For more information about uploading
|
|
// data for indexing, see Uploading Data (http://docs.aws.amazon.com/cloudsearch/latest/developerguide/uploading-data.html)
|
|
// in the Amazon CloudSearch Developer Guide.
|
|
//
|
|
// Returns awserr.Error for service API and SDK errors. Use runtime type assertions
|
|
// with awserr.Error's Code and Message methods to get detailed information about
|
|
// the error.
|
|
//
|
|
// See the AWS API reference guide for Amazon CloudSearch Domain's
|
|
// API operation UploadDocuments for usage and error information.
|
|
//
|
|
// Returned Error Codes:
|
|
// * ErrCodeDocumentServiceException "DocumentServiceException"
|
|
// Information about any problems encountered while processing an upload request.
|
|
//
|
|
func (c *CloudSearchDomain) UploadDocuments(input *UploadDocumentsInput) (*UploadDocumentsOutput, error) {
|
|
req, out := c.UploadDocumentsRequest(input)
|
|
return out, req.Send()
|
|
}
|
|
|
|
// UploadDocumentsWithContext is the same as UploadDocuments with the addition of
|
|
// the ability to pass a context and additional request options.
|
|
//
|
|
// See UploadDocuments for details on how to use this API operation.
|
|
//
|
|
// The context must be non-nil and will be used for request cancellation. If
|
|
// the context is nil a panic will occur. In the future the SDK may create
|
|
// sub-contexts for http.Requests. See https://golang.org/pkg/context/
|
|
// for more information on using Contexts.
|
|
func (c *CloudSearchDomain) UploadDocumentsWithContext(ctx aws.Context, input *UploadDocumentsInput, opts ...request.Option) (*UploadDocumentsOutput, error) {
|
|
req, out := c.UploadDocumentsRequest(input)
|
|
req.SetContext(ctx)
|
|
req.ApplyOptions(opts...)
|
|
return out, req.Send()
|
|
}
|
|
|
|
// A container for facet information.
|
|
type Bucket struct {
|
|
_ struct{} `type:"structure"`
|
|
|
|
// The number of hits that contain the facet value in the specified facet field.
|
|
Count *int64 `locationName:"count" type:"long"`
|
|
|
|
// The facet value being counted.
|
|
Value *string `locationName:"value" type:"string"`
|
|
}
|
|
|
|
// String returns the string representation
|
|
func (s Bucket) String() string {
|
|
return awsutil.Prettify(s)
|
|
}
|
|
|
|
// GoString returns the string representation
|
|
func (s Bucket) GoString() string {
|
|
return s.String()
|
|
}
|
|
|
|
// SetCount sets the Count field's value.
|
|
func (s *Bucket) SetCount(v int64) *Bucket {
|
|
s.Count = &v
|
|
return s
|
|
}
|
|
|
|
// SetValue sets the Value field's value.
|
|
func (s *Bucket) SetValue(v string) *Bucket {
|
|
s.Value = &v
|
|
return s
|
|
}
|
|
|
|
// A container for the calculated facet values and counts.
|
|
type BucketInfo struct {
|
|
_ struct{} `type:"structure"`
|
|
|
|
// A list of the calculated facet values and counts.
|
|
Buckets []*Bucket `locationName:"buckets" type:"list"`
|
|
}
|
|
|
|
// String returns the string representation
|
|
func (s BucketInfo) String() string {
|
|
return awsutil.Prettify(s)
|
|
}
|
|
|
|
// GoString returns the string representation
|
|
func (s BucketInfo) GoString() string {
|
|
return s.String()
|
|
}
|
|
|
|
// SetBuckets sets the Buckets field's value.
|
|
func (s *BucketInfo) SetBuckets(v []*Bucket) *BucketInfo {
|
|
s.Buckets = v
|
|
return s
|
|
}
|
|
|
|
// A warning returned by the document service when an issue is discovered while
|
|
// processing an upload request.
|
|
type DocumentServiceWarning struct {
|
|
_ struct{} `type:"structure"`
|
|
|
|
// The description for a warning returned by the document service.
|
|
Message *string `locationName:"message" type:"string"`
|
|
}
|
|
|
|
// String returns the string representation
|
|
func (s DocumentServiceWarning) String() string {
|
|
return awsutil.Prettify(s)
|
|
}
|
|
|
|
// GoString returns the string representation
|
|
func (s DocumentServiceWarning) GoString() string {
|
|
return s.String()
|
|
}
|
|
|
|
// SetMessage sets the Message field's value.
|
|
func (s *DocumentServiceWarning) SetMessage(v string) *DocumentServiceWarning {
|
|
s.Message = &v
|
|
return s
|
|
}
|
|
|
|
// The statistics for a field calculated in the request.
|
|
type FieldStats struct {
|
|
_ struct{} `type:"structure"`
|
|
|
|
// The number of documents that contain a value in the specified field in the
|
|
// result set.
|
|
Count *int64 `locationName:"count" type:"long"`
|
|
|
|
// The maximum value found in the specified field in the result set.
|
|
//
|
|
// If the field is numeric (int, int-array, double, or double-array), max is
|
|
// the string representation of a double-precision 64-bit floating point value.
|
|
// If the field is date or date-array, max is the string representation of a
|
|
// date with the format specified in IETF RFC3339 (http://tools.ietf.org/html/rfc3339):
|
|
// yyyy-mm-ddTHH:mm:ss.SSSZ.
|
|
Max *string `locationName:"max" type:"string"`
|
|
|
|
// The average of the values found in the specified field in the result set.
|
|
//
|
|
// If the field is numeric (int, int-array, double, or double-array), mean is
|
|
// the string representation of a double-precision 64-bit floating point value.
|
|
// If the field is date or date-array, mean is the string representation of
|
|
// a date with the format specified in IETF RFC3339 (http://tools.ietf.org/html/rfc3339):
|
|
// yyyy-mm-ddTHH:mm:ss.SSSZ.
|
|
Mean *string `locationName:"mean" type:"string"`
|
|
|
|
// The minimum value found in the specified field in the result set.
|
|
//
|
|
// If the field is numeric (int, int-array, double, or double-array), min is
|
|
// the string representation of a double-precision 64-bit floating point value.
|
|
// If the field is date or date-array, min is the string representation of a
|
|
// date with the format specified in IETF RFC3339 (http://tools.ietf.org/html/rfc3339):
|
|
// yyyy-mm-ddTHH:mm:ss.SSSZ.
|
|
Min *string `locationName:"min" type:"string"`
|
|
|
|
// The number of documents that do not contain a value in the specified field
|
|
// in the result set.
|
|
Missing *int64 `locationName:"missing" type:"long"`
|
|
|
|
// The standard deviation of the values in the specified field in the result
|
|
// set.
|
|
Stddev *float64 `locationName:"stddev" type:"double"`
|
|
|
|
// The sum of the field values across the documents in the result set. null
|
|
// for date fields.
|
|
Sum *float64 `locationName:"sum" type:"double"`
|
|
|
|
// The sum of all field values in the result set squared.
|
|
SumOfSquares *float64 `locationName:"sumOfSquares" type:"double"`
|
|
}
|
|
|
|
// String returns the string representation
|
|
func (s FieldStats) String() string {
|
|
return awsutil.Prettify(s)
|
|
}
|
|
|
|
// GoString returns the string representation
|
|
func (s FieldStats) GoString() string {
|
|
return s.String()
|
|
}
|
|
|
|
// SetCount sets the Count field's value.
|
|
func (s *FieldStats) SetCount(v int64) *FieldStats {
|
|
s.Count = &v
|
|
return s
|
|
}
|
|
|
|
// SetMax sets the Max field's value.
|
|
func (s *FieldStats) SetMax(v string) *FieldStats {
|
|
s.Max = &v
|
|
return s
|
|
}
|
|
|
|
// SetMean sets the Mean field's value.
|
|
func (s *FieldStats) SetMean(v string) *FieldStats {
|
|
s.Mean = &v
|
|
return s
|
|
}
|
|
|
|
// SetMin sets the Min field's value.
|
|
func (s *FieldStats) SetMin(v string) *FieldStats {
|
|
s.Min = &v
|
|
return s
|
|
}
|
|
|
|
// SetMissing sets the Missing field's value.
|
|
func (s *FieldStats) SetMissing(v int64) *FieldStats {
|
|
s.Missing = &v
|
|
return s
|
|
}
|
|
|
|
// SetStddev sets the Stddev field's value.
|
|
func (s *FieldStats) SetStddev(v float64) *FieldStats {
|
|
s.Stddev = &v
|
|
return s
|
|
}
|
|
|
|
// SetSum sets the Sum field's value.
|
|
func (s *FieldStats) SetSum(v float64) *FieldStats {
|
|
s.Sum = &v
|
|
return s
|
|
}
|
|
|
|
// SetSumOfSquares sets the SumOfSquares field's value.
|
|
func (s *FieldStats) SetSumOfSquares(v float64) *FieldStats {
|
|
s.SumOfSquares = &v
|
|
return s
|
|
}
|
|
|
|
// Information about a document that matches the search request.
|
|
type Hit struct {
|
|
_ struct{} `type:"structure"`
|
|
|
|
// The expressions returned from a document that matches the search request.
|
|
Exprs map[string]*string `locationName:"exprs" type:"map"`
|
|
|
|
// The fields returned from a document that matches the search request.
|
|
Fields map[string][]*string `locationName:"fields" type:"map"`
|
|
|
|
// The highlights returned from a document that matches the search request.
|
|
Highlights map[string]*string `locationName:"highlights" type:"map"`
|
|
|
|
// The document ID of a document that matches the search request.
|
|
Id *string `locationName:"id" type:"string"`
|
|
}
|
|
|
|
// String returns the string representation
|
|
func (s Hit) String() string {
|
|
return awsutil.Prettify(s)
|
|
}
|
|
|
|
// GoString returns the string representation
|
|
func (s Hit) GoString() string {
|
|
return s.String()
|
|
}
|
|
|
|
// SetExprs sets the Exprs field's value.
|
|
func (s *Hit) SetExprs(v map[string]*string) *Hit {
|
|
s.Exprs = v
|
|
return s
|
|
}
|
|
|
|
// SetFields sets the Fields field's value.
|
|
func (s *Hit) SetFields(v map[string][]*string) *Hit {
|
|
s.Fields = v
|
|
return s
|
|
}
|
|
|
|
// SetHighlights sets the Highlights field's value.
|
|
func (s *Hit) SetHighlights(v map[string]*string) *Hit {
|
|
s.Highlights = v
|
|
return s
|
|
}
|
|
|
|
// SetId sets the Id field's value.
|
|
func (s *Hit) SetId(v string) *Hit {
|
|
s.Id = &v
|
|
return s
|
|
}
|
|
|
|
// The collection of documents that match the search request.
|
|
type Hits struct {
|
|
_ struct{} `type:"structure"`
|
|
|
|
// A cursor that can be used to retrieve the next set of matching documents
|
|
// when you want to page through a large result set.
|
|
Cursor *string `locationName:"cursor" type:"string"`
|
|
|
|
// The total number of documents that match the search request.
|
|
Found *int64 `locationName:"found" type:"long"`
|
|
|
|
// A document that matches the search request.
|
|
Hit []*Hit `locationName:"hit" type:"list"`
|
|
|
|
// The index of the first matching document.
|
|
Start *int64 `locationName:"start" type:"long"`
|
|
}
|
|
|
|
// String returns the string representation
|
|
func (s Hits) String() string {
|
|
return awsutil.Prettify(s)
|
|
}
|
|
|
|
// GoString returns the string representation
|
|
func (s Hits) GoString() string {
|
|
return s.String()
|
|
}
|
|
|
|
// SetCursor sets the Cursor field's value.
|
|
func (s *Hits) SetCursor(v string) *Hits {
|
|
s.Cursor = &v
|
|
return s
|
|
}
|
|
|
|
// SetFound sets the Found field's value.
|
|
func (s *Hits) SetFound(v int64) *Hits {
|
|
s.Found = &v
|
|
return s
|
|
}
|
|
|
|
// SetHit sets the Hit field's value.
|
|
func (s *Hits) SetHit(v []*Hit) *Hits {
|
|
s.Hit = v
|
|
return s
|
|
}
|
|
|
|
// SetStart sets the Start field's value.
|
|
func (s *Hits) SetStart(v int64) *Hits {
|
|
s.Start = &v
|
|
return s
|
|
}
|
|
|
|
// Container for the parameters to the Search request.
|
|
type SearchInput struct {
|
|
_ struct{} `type:"structure"`
|
|
|
|
// Retrieves a cursor value you can use to page through large result sets. Use
|
|
// the size parameter to control the number of hits to include in each response.
|
|
// You can specify either the cursor or start parameter in a request; they are
|
|
// mutually exclusive. To get the first cursor, set the cursor value to initial.
|
|
// In subsequent requests, specify the cursor value returned in the hits section
|
|
// of the response.
|
|
//
|
|
// For more information, see Paginating Results (http://docs.aws.amazon.com/cloudsearch/latest/developerguide/paginating-results.html)
|
|
// in the Amazon CloudSearch Developer Guide.
|
|
Cursor *string `location:"querystring" locationName:"cursor" type:"string"`
|
|
|
|
// Defines one or more numeric expressions that can be used to sort results
|
|
// or specify search or filter criteria. You can also specify expressions as
|
|
// return fields.
|
|
//
|
|
// You specify the expressions in JSON using the form {"EXPRESSIONNAME":"EXPRESSION"}.
|
|
// You can define and use multiple expressions in a search request. For example:
|
|
//
|
|
// {"expression1":"_score*rating", "expression2":"(1/rank)*year"}
|
|
//
|
|
// For information about the variables, operators, and functions you can use
|
|
// in expressions, see Writing Expressions (http://docs.aws.amazon.com/cloudsearch/latest/developerguide/configuring-expressions.html#writing-expressions)
|
|
// in the Amazon CloudSearch Developer Guide.
|
|
Expr *string `location:"querystring" locationName:"expr" type:"string"`
|
|
|
|
// Specifies one or more fields for which to get facet information, and options
|
|
// that control how the facet information is returned. Each specified field
|
|
// must be facet-enabled in the domain configuration. The fields and options
|
|
// are specified in JSON using the form {"FIELD":{"OPTION":VALUE,"OPTION:"STRING"},"FIELD":{"OPTION":VALUE,"OPTION":"STRING"}}.
|
|
//
|
|
// You can specify the following faceting options:
|
|
//
|
|
// * buckets specifies an array of the facet values or ranges to count. Ranges
|
|
// are specified using the same syntax that you use to search for a range
|
|
// of values. For more information, see Searching for a Range of Values
|
|
// (http://docs.aws.amazon.com/cloudsearch/latest/developerguide/searching-ranges.html)
|
|
// in the Amazon CloudSearch Developer Guide. Buckets are returned in the
|
|
// order they are specified in the request. The sort and size options are
|
|
// not valid if you specify buckets.
|
|
//
|
|
// * size specifies the maximum number of facets to include in the results.
|
|
// By default, Amazon CloudSearch returns counts for the top 10. The size
|
|
// parameter is only valid when you specify the sort option; it cannot be
|
|
// used in conjunction with buckets.
|
|
//
|
|
// * sort specifies how you want to sort the facets in the results: bucket
|
|
// or count. Specify bucket to sort alphabetically or numerically by facet
|
|
// value (in ascending order). Specify count to sort by the facet counts
|
|
// computed for each facet value (in descending order). To retrieve facet
|
|
// counts for particular values or ranges of values, use the buckets option
|
|
// instead of sort.
|
|
//
|
|
// If no facet options are specified, facet counts are computed for all field
|
|
// values, the facets are sorted by facet count, and the top 10 facets are returned
|
|
// in the results.
|
|
//
|
|
// To count particular buckets of values, use the buckets option. For example,
|
|
// the following request uses the buckets option to calculate and return facet
|
|
// counts by decade.
|
|
//
|
|
// {"year":{"buckets":["[1970,1979]","[1980,1989]","[1990,1999]","[2000,2009]","[2010,}"]}}
|
|
//
|
|
// To sort facets by facet count, use the count option. For example, the following
|
|
// request sets the sort option to count to sort the facet values by facet count,
|
|
// with the facet values that have the most matching documents listed first.
|
|
// Setting the size option to 3 returns only the top three facet values.
|
|
//
|
|
// {"year":{"sort":"count","size":3}}
|
|
//
|
|
// To sort the facets by value, use the bucket option. For example, the following
|
|
// request sets the sort option to bucket to sort the facet values numerically
|
|
// by year, with earliest year listed first.
|
|
//
|
|
// {"year":{"sort":"bucket"}}
|
|
//
|
|
// For more information, see Getting and Using Facet Information (http://docs.aws.amazon.com/cloudsearch/latest/developerguide/faceting.html)
|
|
// in the Amazon CloudSearch Developer Guide.
|
|
Facet *string `location:"querystring" locationName:"facet" type:"string"`
|
|
|
|
// Specifies a structured query that filters the results of a search without
|
|
// affecting how the results are scored and sorted. You use filterQuery in conjunction
|
|
// with the query parameter to filter the documents that match the constraints
|
|
// specified in the query parameter. Specifying a filter controls only which
|
|
// matching documents are included in the results, it has no effect on how they
|
|
// are scored and sorted. The filterQuery parameter supports the full structured
|
|
// query syntax.
|
|
//
|
|
// For more information about using filters, see Filtering Matching Documents
|
|
// (http://docs.aws.amazon.com/cloudsearch/latest/developerguide/filtering-results.html)
|
|
// in the Amazon CloudSearch Developer Guide.
|
|
FilterQuery *string `location:"querystring" locationName:"fq" type:"string"`
|
|
|
|
// Retrieves highlights for matches in the specified text or text-array fields.
|
|
// Each specified field must be highlight enabled in the domain configuration.
|
|
// The fields and options are specified in JSON using the form {"FIELD":{"OPTION":VALUE,"OPTION:"STRING"},"FIELD":{"OPTION":VALUE,"OPTION":"STRING"}}.
|
|
//
|
|
// You can specify the following highlight options:
|
|
//
|
|
// * format: specifies the format of the data in the text field: text or
|
|
// html. When data is returned as HTML, all non-alphanumeric characters are
|
|
// encoded. The default is html.
|
|
// * max_phrases: specifies the maximum number of occurrences of the search
|
|
// term(s) you want to highlight. By default, the first occurrence is highlighted.
|
|
//
|
|
// * pre_tag: specifies the string to prepend to an occurrence of a search
|
|
// term. The default for HTML highlights is <em>. The default for text
|
|
// highlights is *.
|
|
// * post_tag: specifies the string to append to an occurrence of a search
|
|
// term. The default for HTML highlights is </em>. The default for
|
|
// text highlights is *.
|
|
// If no highlight options are specified for a field, the returned field text
|
|
// is treated as HTML and the first match is highlighted with emphasis tags:
|
|
// <em>search-term</em>.
|
|
//
|
|
// For example, the following request retrieves highlights for the actors and
|
|
// title fields.
|
|
//
|
|
// { "actors": {}, "title": {"format": "text","max_phrases": 2,"pre_tag": "","post_tag":
|
|
// ""} }
|
|
Highlight *string `location:"querystring" locationName:"highlight" type:"string"`
|
|
|
|
// Enables partial results to be returned if one or more index partitions are
|
|
// unavailable. When your search index is partitioned across multiple search
|
|
// instances, by default Amazon CloudSearch only returns results if every partition
|
|
// can be queried. This means that the failure of a single search instance can
|
|
// result in 5xx (internal server) errors. When you enable partial results,
|
|
// Amazon CloudSearch returns whatever results are available and includes the
|
|
// percentage of documents searched in the search results (percent-searched).
|
|
// This enables you to more gracefully degrade your users' search experience.
|
|
// For example, rather than displaying no results, you could display the partial
|
|
// results and a message indicating that the results might be incomplete due
|
|
// to a temporary system outage.
|
|
Partial *bool `location:"querystring" locationName:"partial" type:"boolean"`
|
|
|
|
// Specifies the search criteria for the request. How you specify the search
|
|
// criteria depends on the query parser used for the request and the parser
|
|
// options specified in the queryOptions parameter. By default, the simple query
|
|
// parser is used to process requests. To use the structured, lucene, or dismax
|
|
// query parser, you must also specify the queryParser parameter.
|
|
//
|
|
// For more information about specifying search criteria, see Searching Your
|
|
// Data (http://docs.aws.amazon.com/cloudsearch/latest/developerguide/searching.html)
|
|
// in the Amazon CloudSearch Developer Guide.
|
|
//
|
|
// Query is a required field
|
|
Query *string `location:"querystring" locationName:"q" type:"string" required:"true"`
|
|
|
|
// Configures options for the query parser specified in the queryParser parameter.
|
|
// You specify the options in JSON using the following form {"OPTION1":"VALUE1","OPTION2":VALUE2"..."OPTIONN":"VALUEN"}.
|
|
//
|
|
// The options you can configure vary according to which parser you use:
|
|
//
|
|
// * defaultOperator: The default operator used to combine individual terms
|
|
// in the search string. For example: defaultOperator: 'or'. For the dismax
|
|
// parser, you specify a percentage that represents the percentage of terms
|
|
// in the search string (rounded down) that must match, rather than a default
|
|
// operator. A value of 0% is the equivalent to OR, and a value of 100% is
|
|
// equivalent to AND. The percentage must be specified as a value in the
|
|
// range 0-100 followed by the percent (%) symbol. For example, defaultOperator:
|
|
// 50%. Valid values: and, or, a percentage in the range 0%-100% (dismax).
|
|
// Default: and (simple, structured, lucene) or 100 (dismax). Valid for:
|
|
// simple, structured, lucene, and dismax.
|
|
// * fields: An array of the fields to search when no fields are specified
|
|
// in a search. If no fields are specified in a search and this option is
|
|
// not specified, all text and text-array fields are searched. You can specify
|
|
// a weight for each field to control the relative importance of each field
|
|
// when Amazon CloudSearch calculates relevance scores. To specify a field
|
|
// weight, append a caret (^) symbol and the weight to the field name. For
|
|
// example, to boost the importance of the title field over the description
|
|
// field you could specify: "fields":["title^5","description"]. Valid values:
|
|
// The name of any configured field and an optional numeric value greater
|
|
// than zero. Default: All text and text-array fields. Valid for: simple,
|
|
// structured, lucene, and dismax.
|
|
// * operators: An array of the operators or special characters you want
|
|
// to disable for the simple query parser. If you disable the and, or, or
|
|
// not operators, the corresponding operators (+, |, -) have no special meaning
|
|
// and are dropped from the search string. Similarly, disabling prefix disables
|
|
// the wildcard operator (*) and disabling phrase disables the ability to
|
|
// search for phrases by enclosing phrases in double quotes. Disabling precedence
|
|
// disables the ability to control order of precedence using parentheses.
|
|
// Disabling near disables the ability to use the ~ operator to perform a
|
|
// sloppy phrase search. Disabling the fuzzy operator disables the ability
|
|
// to use the ~ operator to perform a fuzzy search. escape disables the ability
|
|
// to use a backslash (\) to escape special characters within the search
|
|
// string. Disabling whitespace is an advanced option that prevents the parser
|
|
// from tokenizing on whitespace, which can be useful for Vietnamese. (It
|
|
// prevents Vietnamese words from being split incorrectly.) For example,
|
|
// you could disable all operators other than the phrase operator to support
|
|
// just simple term and phrase queries: "operators":["and","not","or", "prefix"].
|
|
// Valid values: and, escape, fuzzy, near, not, or, phrase, precedence, prefix,
|
|
// whitespace. Default: All operators and special characters are enabled.
|
|
// Valid for: simple.
|
|
// * phraseFields: An array of the text or text-array fields you want to
|
|
// use for phrase searches. When the terms in the search string appear in
|
|
// close proximity within a field, the field scores higher. You can specify
|
|
// a weight for each field to boost that score. The phraseSlop option controls
|
|
// how much the matches can deviate from the search string and still be boosted.
|
|
// To specify a field weight, append a caret (^) symbol and the weight to
|
|
// the field name. For example, to boost phrase matches in the title field
|
|
// over the abstract field, you could specify: "phraseFields":["title^3",
|
|
// "plot"] Valid values: The name of any text or text-array field and an
|
|
// optional numeric value greater than zero. Default: No fields. If you don't
|
|
// specify any fields with phraseFields, proximity scoring is disabled even
|
|
// if phraseSlop is specified. Valid for: dismax.
|
|
// * phraseSlop: An integer value that specifies how much matches can deviate
|
|
// from the search phrase and still be boosted according to the weights specified
|
|
// in the phraseFields option; for example, phraseSlop: 2. You must also
|
|
// specify phraseFields to enable proximity scoring. Valid values: positive
|
|
// integers. Default: 0. Valid for: dismax.
|
|
// * explicitPhraseSlop: An integer value that specifies how much a match
|
|
// can deviate from the search phrase when the phrase is enclosed in double
|
|
// quotes in the search string. (Phrases that exceed this proximity distance
|
|
// are not considered a match.) For example, to specify a slop of three for
|
|
// dismax phrase queries, you would specify "explicitPhraseSlop":3. Valid
|
|
// values: positive integers. Default: 0. Valid for: dismax.
|
|
// * tieBreaker: When a term in the search string is found in a document's
|
|
// field, a score is calculated for that field based on how common the word
|
|
// is in that field compared to other documents. If the term occurs in multiple
|
|
// fields within a document, by default only the highest scoring field contributes
|
|
// to the document's overall score. You can specify a tieBreaker value to
|
|
// enable the matches in lower-scoring fields to contribute to the document's
|
|
// score. That way, if two documents have the same max field score for a
|
|
// particular term, the score for the document that has matches in more fields
|
|
// will be higher. The formula for calculating the score with a tieBreaker
|
|
// is (max field score) + (tieBreaker) * (sum of the scores for the rest
|
|
// of the matching fields). Set tieBreaker to 0 to disregard all but the
|
|
// highest scoring field (pure max): "tieBreaker":0. Set to 1 to sum the
|
|
// scores from all fields (pure sum): "tieBreaker":1. Valid values: 0.0 to
|
|
// 1.0. Default: 0.0. Valid for: dismax.
|
|
QueryOptions *string `location:"querystring" locationName:"q.options" type:"string"`
|
|
|
|
// Specifies which query parser to use to process the request. If queryParser
|
|
// is not specified, Amazon CloudSearch uses the simple query parser.
|
|
//
|
|
// Amazon CloudSearch supports four query parsers:
|
|
//
|
|
// * simple: perform simple searches of text and text-array fields. By default,
|
|
// the simple query parser searches all text and text-array fields. You can
|
|
// specify which fields to search by with the queryOptions parameter. If
|
|
// you prefix a search term with a plus sign (+) documents must contain the
|
|
// term to be considered a match. (This is the default, unless you configure
|
|
// the default operator with the queryOptions parameter.) You can use the
|
|
// - (NOT), | (OR), and * (wildcard) operators to exclude particular terms,
|
|
// find results that match any of the specified terms, or search for a prefix.
|
|
// To search for a phrase rather than individual terms, enclose the phrase
|
|
// in double quotes. For more information, see Searching for Text (http://docs.aws.amazon.com/cloudsearch/latest/developerguide/searching-text.html)
|
|
// in the Amazon CloudSearch Developer Guide.
|
|
// * structured: perform advanced searches by combining multiple expressions
|
|
// to define the search criteria. You can also search within particular fields,
|
|
// search for values and ranges of values, and use advanced options such
|
|
// as term boosting, matchall, and near. For more information, see Constructing
|
|
// Compound Queries (http://docs.aws.amazon.com/cloudsearch/latest/developerguide/searching-compound-queries.html)
|
|
// in the Amazon CloudSearch Developer Guide.
|
|
// * lucene: search using the Apache Lucene query parser syntax. For more
|
|
// information, see Apache Lucene Query Parser Syntax (http://lucene.apache.org/core/4_6_0/queryparser/org/apache/lucene/queryparser/classic/package-summary.html#package_description).
|
|
//
|
|
// * dismax: search using the simplified subset of the Apache Lucene query
|
|
// parser syntax defined by the DisMax query parser. For more information,
|
|
// see DisMax Query Parser Syntax (http://wiki.apache.org/solr/DisMaxQParserPlugin#Query_Syntax).
|
|
QueryParser *string `location:"querystring" locationName:"q.parser" type:"string" enum:"QueryParser"`
|
|
|
|
// Specifies the field and expression values to include in the response. Multiple
|
|
// fields or expressions are specified as a comma-separated list. By default,
|
|
// a search response includes all return enabled fields (_all_fields). To return
|
|
// only the document IDs for the matching documents, specify _no_fields. To
|
|
// retrieve the relevance score calculated for each document, specify _score.
|
|
Return *string `location:"querystring" locationName:"return" type:"string"`
|
|
|
|
// Specifies the maximum number of search hits to include in the response.
|
|
Size *int64 `location:"querystring" locationName:"size" type:"long"`
|
|
|
|
// Specifies the fields or custom expressions to use to sort the search results.
|
|
// Multiple fields or expressions are specified as a comma-separated list. You
|
|
// must specify the sort direction (asc or desc) for each field; for example,
|
|
// year desc,title asc. To use a field to sort results, the field must be sort-enabled
|
|
// in the domain configuration. Array type fields cannot be used for sorting.
|
|
// If no sort parameter is specified, results are sorted by their default relevance
|
|
// scores in descending order: _score desc. You can also sort by document ID
|
|
// (_id asc) and version (_version desc).
|
|
//
|
|
// For more information, see Sorting Results (http://docs.aws.amazon.com/cloudsearch/latest/developerguide/sorting-results.html)
|
|
// in the Amazon CloudSearch Developer Guide.
|
|
Sort *string `location:"querystring" locationName:"sort" type:"string"`
|
|
|
|
// Specifies the offset of the first search hit you want to return. Note that
|
|
// the result set is zero-based; the first result is at index 0. You can specify
|
|
// either the start or cursor parameter in a request, they are mutually exclusive.
|
|
//
|
|
// For more information, see Paginating Results (http://docs.aws.amazon.com/cloudsearch/latest/developerguide/paginating-results.html)
|
|
// in the Amazon CloudSearch Developer Guide.
|
|
Start *int64 `location:"querystring" locationName:"start" type:"long"`
|
|
|
|
// Specifies one or more fields for which to get statistics information. Each
|
|
// specified field must be facet-enabled in the domain configuration. The fields
|
|
// are specified in JSON using the form:
|
|
//
|
|
// {"FIELD-A":{},"FIELD-B":{}}There are currently no options supported for statistics.
|
|
Stats *string `location:"querystring" locationName:"stats" type:"string"`
|
|
}
|
|
|
|
// String returns the string representation
|
|
func (s SearchInput) String() string {
|
|
return awsutil.Prettify(s)
|
|
}
|
|
|
|
// GoString returns the string representation
|
|
func (s SearchInput) GoString() string {
|
|
return s.String()
|
|
}
|
|
|
|
// Validate inspects the fields of the type to determine if they are valid.
|
|
func (s *SearchInput) Validate() error {
|
|
invalidParams := request.ErrInvalidParams{Context: "SearchInput"}
|
|
if s.Query == nil {
|
|
invalidParams.Add(request.NewErrParamRequired("Query"))
|
|
}
|
|
|
|
if invalidParams.Len() > 0 {
|
|
return invalidParams
|
|
}
|
|
return nil
|
|
}
|
|
|
|
// SetCursor sets the Cursor field's value.
|
|
func (s *SearchInput) SetCursor(v string) *SearchInput {
|
|
s.Cursor = &v
|
|
return s
|
|
}
|
|
|
|
// SetExpr sets the Expr field's value.
|
|
func (s *SearchInput) SetExpr(v string) *SearchInput {
|
|
s.Expr = &v
|
|
return s
|
|
}
|
|
|
|
// SetFacet sets the Facet field's value.
|
|
func (s *SearchInput) SetFacet(v string) *SearchInput {
|
|
s.Facet = &v
|
|
return s
|
|
}
|
|
|
|
// SetFilterQuery sets the FilterQuery field's value.
|
|
func (s *SearchInput) SetFilterQuery(v string) *SearchInput {
|
|
s.FilterQuery = &v
|
|
return s
|
|
}
|
|
|
|
// SetHighlight sets the Highlight field's value.
|
|
func (s *SearchInput) SetHighlight(v string) *SearchInput {
|
|
s.Highlight = &v
|
|
return s
|
|
}
|
|
|
|
// SetPartial sets the Partial field's value.
|
|
func (s *SearchInput) SetPartial(v bool) *SearchInput {
|
|
s.Partial = &v
|
|
return s
|
|
}
|
|
|
|
// SetQuery sets the Query field's value.
|
|
func (s *SearchInput) SetQuery(v string) *SearchInput {
|
|
s.Query = &v
|
|
return s
|
|
}
|
|
|
|
// SetQueryOptions sets the QueryOptions field's value.
|
|
func (s *SearchInput) SetQueryOptions(v string) *SearchInput {
|
|
s.QueryOptions = &v
|
|
return s
|
|
}
|
|
|
|
// SetQueryParser sets the QueryParser field's value.
|
|
func (s *SearchInput) SetQueryParser(v string) *SearchInput {
|
|
s.QueryParser = &v
|
|
return s
|
|
}
|
|
|
|
// SetReturn sets the Return field's value.
|
|
func (s *SearchInput) SetReturn(v string) *SearchInput {
|
|
s.Return = &v
|
|
return s
|
|
}
|
|
|
|
// SetSize sets the Size field's value.
|
|
func (s *SearchInput) SetSize(v int64) *SearchInput {
|
|
s.Size = &v
|
|
return s
|
|
}
|
|
|
|
// SetSort sets the Sort field's value.
|
|
func (s *SearchInput) SetSort(v string) *SearchInput {
|
|
s.Sort = &v
|
|
return s
|
|
}
|
|
|
|
// SetStart sets the Start field's value.
|
|
func (s *SearchInput) SetStart(v int64) *SearchInput {
|
|
s.Start = &v
|
|
return s
|
|
}
|
|
|
|
// SetStats sets the Stats field's value.
|
|
func (s *SearchInput) SetStats(v string) *SearchInput {
|
|
s.Stats = &v
|
|
return s
|
|
}
|
|
|
|
// The result of a Search request. Contains the documents that match the specified
|
|
// search criteria and any requested fields, highlights, and facet information.
|
|
type SearchOutput struct {
|
|
_ struct{} `type:"structure"`
|
|
|
|
// The requested facet information.
|
|
Facets map[string]*BucketInfo `locationName:"facets" type:"map"`
|
|
|
|
// The documents that match the search criteria.
|
|
Hits *Hits `locationName:"hits" type:"structure"`
|
|
|
|
// The requested field statistics information.
|
|
Stats map[string]*FieldStats `locationName:"stats" type:"map"`
|
|
|
|
// The status information returned for the search request.
|
|
Status *SearchStatus `locationName:"status" type:"structure"`
|
|
}
|
|
|
|
// String returns the string representation
|
|
func (s SearchOutput) String() string {
|
|
return awsutil.Prettify(s)
|
|
}
|
|
|
|
// GoString returns the string representation
|
|
func (s SearchOutput) GoString() string {
|
|
return s.String()
|
|
}
|
|
|
|
// SetFacets sets the Facets field's value.
|
|
func (s *SearchOutput) SetFacets(v map[string]*BucketInfo) *SearchOutput {
|
|
s.Facets = v
|
|
return s
|
|
}
|
|
|
|
// SetHits sets the Hits field's value.
|
|
func (s *SearchOutput) SetHits(v *Hits) *SearchOutput {
|
|
s.Hits = v
|
|
return s
|
|
}
|
|
|
|
// SetStats sets the Stats field's value.
|
|
func (s *SearchOutput) SetStats(v map[string]*FieldStats) *SearchOutput {
|
|
s.Stats = v
|
|
return s
|
|
}
|
|
|
|
// SetStatus sets the Status field's value.
|
|
func (s *SearchOutput) SetStatus(v *SearchStatus) *SearchOutput {
|
|
s.Status = v
|
|
return s
|
|
}
|
|
|
|
// Contains the resource id (rid) and the time it took to process the request
|
|
// (timems).
|
|
type SearchStatus struct {
|
|
_ struct{} `type:"structure"`
|
|
|
|
// The encrypted resource ID for the request.
|
|
Rid *string `locationName:"rid" type:"string"`
|
|
|
|
// How long it took to process the request, in milliseconds.
|
|
Timems *int64 `locationName:"timems" type:"long"`
|
|
}
|
|
|
|
// String returns the string representation
|
|
func (s SearchStatus) String() string {
|
|
return awsutil.Prettify(s)
|
|
}
|
|
|
|
// GoString returns the string representation
|
|
func (s SearchStatus) GoString() string {
|
|
return s.String()
|
|
}
|
|
|
|
// SetRid sets the Rid field's value.
|
|
func (s *SearchStatus) SetRid(v string) *SearchStatus {
|
|
s.Rid = &v
|
|
return s
|
|
}
|
|
|
|
// SetTimems sets the Timems field's value.
|
|
func (s *SearchStatus) SetTimems(v int64) *SearchStatus {
|
|
s.Timems = &v
|
|
return s
|
|
}
|
|
|
|
// Container for the parameters to the Suggest request.
|
|
type SuggestInput struct {
|
|
_ struct{} `type:"structure"`
|
|
|
|
// Specifies the string for which you want to get suggestions.
|
|
//
|
|
// Query is a required field
|
|
Query *string `location:"querystring" locationName:"q" type:"string" required:"true"`
|
|
|
|
// Specifies the maximum number of suggestions to return.
|
|
Size *int64 `location:"querystring" locationName:"size" type:"long"`
|
|
|
|
// Specifies the name of the suggester to use to find suggested matches.
|
|
//
|
|
// Suggester is a required field
|
|
Suggester *string `location:"querystring" locationName:"suggester" type:"string" required:"true"`
|
|
}
|
|
|
|
// String returns the string representation
|
|
func (s SuggestInput) String() string {
|
|
return awsutil.Prettify(s)
|
|
}
|
|
|
|
// GoString returns the string representation
|
|
func (s SuggestInput) GoString() string {
|
|
return s.String()
|
|
}
|
|
|
|
// Validate inspects the fields of the type to determine if they are valid.
|
|
func (s *SuggestInput) Validate() error {
|
|
invalidParams := request.ErrInvalidParams{Context: "SuggestInput"}
|
|
if s.Query == nil {
|
|
invalidParams.Add(request.NewErrParamRequired("Query"))
|
|
}
|
|
if s.Suggester == nil {
|
|
invalidParams.Add(request.NewErrParamRequired("Suggester"))
|
|
}
|
|
|
|
if invalidParams.Len() > 0 {
|
|
return invalidParams
|
|
}
|
|
return nil
|
|
}
|
|
|
|
// SetQuery sets the Query field's value.
|
|
func (s *SuggestInput) SetQuery(v string) *SuggestInput {
|
|
s.Query = &v
|
|
return s
|
|
}
|
|
|
|
// SetSize sets the Size field's value.
|
|
func (s *SuggestInput) SetSize(v int64) *SuggestInput {
|
|
s.Size = &v
|
|
return s
|
|
}
|
|
|
|
// SetSuggester sets the Suggester field's value.
|
|
func (s *SuggestInput) SetSuggester(v string) *SuggestInput {
|
|
s.Suggester = &v
|
|
return s
|
|
}
|
|
|
|
// Container for the suggestion information returned in a SuggestResponse.
|
|
type SuggestModel struct {
|
|
_ struct{} `type:"structure"`
|
|
|
|
// The number of documents that were found to match the query string.
|
|
Found *int64 `locationName:"found" type:"long"`
|
|
|
|
// The query string specified in the suggest request.
|
|
Query *string `locationName:"query" type:"string"`
|
|
|
|
// The documents that match the query string.
|
|
Suggestions []*SuggestionMatch `locationName:"suggestions" type:"list"`
|
|
}
|
|
|
|
// String returns the string representation
|
|
func (s SuggestModel) String() string {
|
|
return awsutil.Prettify(s)
|
|
}
|
|
|
|
// GoString returns the string representation
|
|
func (s SuggestModel) GoString() string {
|
|
return s.String()
|
|
}
|
|
|
|
// SetFound sets the Found field's value.
|
|
func (s *SuggestModel) SetFound(v int64) *SuggestModel {
|
|
s.Found = &v
|
|
return s
|
|
}
|
|
|
|
// SetQuery sets the Query field's value.
|
|
func (s *SuggestModel) SetQuery(v string) *SuggestModel {
|
|
s.Query = &v
|
|
return s
|
|
}
|
|
|
|
// SetSuggestions sets the Suggestions field's value.
|
|
func (s *SuggestModel) SetSuggestions(v []*SuggestionMatch) *SuggestModel {
|
|
s.Suggestions = v
|
|
return s
|
|
}
|
|
|
|
// Contains the response to a Suggest request.
|
|
type SuggestOutput struct {
|
|
_ struct{} `type:"structure"`
|
|
|
|
// The status of a SuggestRequest. Contains the resource ID (rid) and how long
|
|
// it took to process the request (timems).
|
|
Status *SuggestStatus `locationName:"status" type:"structure"`
|
|
|
|
// Container for the matching search suggestion information.
|
|
Suggest *SuggestModel `locationName:"suggest" type:"structure"`
|
|
}
|
|
|
|
// String returns the string representation
|
|
func (s SuggestOutput) String() string {
|
|
return awsutil.Prettify(s)
|
|
}
|
|
|
|
// GoString returns the string representation
|
|
func (s SuggestOutput) GoString() string {
|
|
return s.String()
|
|
}
|
|
|
|
// SetStatus sets the Status field's value.
|
|
func (s *SuggestOutput) SetStatus(v *SuggestStatus) *SuggestOutput {
|
|
s.Status = v
|
|
return s
|
|
}
|
|
|
|
// SetSuggest sets the Suggest field's value.
|
|
func (s *SuggestOutput) SetSuggest(v *SuggestModel) *SuggestOutput {
|
|
s.Suggest = v
|
|
return s
|
|
}
|
|
|
|
// Contains the resource id (rid) and the time it took to process the request
|
|
// (timems).
|
|
type SuggestStatus struct {
|
|
_ struct{} `type:"structure"`
|
|
|
|
// The encrypted resource ID for the request.
|
|
Rid *string `locationName:"rid" type:"string"`
|
|
|
|
// How long it took to process the request, in milliseconds.
|
|
Timems *int64 `locationName:"timems" type:"long"`
|
|
}
|
|
|
|
// String returns the string representation
|
|
func (s SuggestStatus) String() string {
|
|
return awsutil.Prettify(s)
|
|
}
|
|
|
|
// GoString returns the string representation
|
|
func (s SuggestStatus) GoString() string {
|
|
return s.String()
|
|
}
|
|
|
|
// SetRid sets the Rid field's value.
|
|
func (s *SuggestStatus) SetRid(v string) *SuggestStatus {
|
|
s.Rid = &v
|
|
return s
|
|
}
|
|
|
|
// SetTimems sets the Timems field's value.
|
|
func (s *SuggestStatus) SetTimems(v int64) *SuggestStatus {
|
|
s.Timems = &v
|
|
return s
|
|
}
|
|
|
|
// An autocomplete suggestion that matches the query string specified in a SuggestRequest.
|
|
type SuggestionMatch struct {
|
|
_ struct{} `type:"structure"`
|
|
|
|
// The document ID of the suggested document.
|
|
Id *string `locationName:"id" type:"string"`
|
|
|
|
// The relevance score of a suggested match.
|
|
Score *int64 `locationName:"score" type:"long"`
|
|
|
|
// The string that matches the query string specified in the SuggestRequest.
|
|
Suggestion *string `locationName:"suggestion" type:"string"`
|
|
}
|
|
|
|
// String returns the string representation
|
|
func (s SuggestionMatch) String() string {
|
|
return awsutil.Prettify(s)
|
|
}
|
|
|
|
// GoString returns the string representation
|
|
func (s SuggestionMatch) GoString() string {
|
|
return s.String()
|
|
}
|
|
|
|
// SetId sets the Id field's value.
|
|
func (s *SuggestionMatch) SetId(v string) *SuggestionMatch {
|
|
s.Id = &v
|
|
return s
|
|
}
|
|
|
|
// SetScore sets the Score field's value.
|
|
func (s *SuggestionMatch) SetScore(v int64) *SuggestionMatch {
|
|
s.Score = &v
|
|
return s
|
|
}
|
|
|
|
// SetSuggestion sets the Suggestion field's value.
|
|
func (s *SuggestionMatch) SetSuggestion(v string) *SuggestionMatch {
|
|
s.Suggestion = &v
|
|
return s
|
|
}
|
|
|
|
// Container for the parameters to the UploadDocuments request.
|
|
type UploadDocumentsInput struct {
|
|
_ struct{} `type:"structure" payload:"Documents"`
|
|
|
|
// The format of the batch you are uploading. Amazon CloudSearch supports two
|
|
// document batch formats:
|
|
//
|
|
// * application/json
|
|
// * application/xml
|
|
//
|
|
// ContentType is a required field
|
|
ContentType *string `location:"header" locationName:"Content-Type" type:"string" required:"true" enum:"ContentType"`
|
|
|
|
// A batch of documents formatted in JSON or HTML.
|
|
//
|
|
// Documents is a required field
|
|
Documents io.ReadSeeker `locationName:"documents" type:"blob" required:"true"`
|
|
}
|
|
|
|
// String returns the string representation
|
|
func (s UploadDocumentsInput) String() string {
|
|
return awsutil.Prettify(s)
|
|
}
|
|
|
|
// GoString returns the string representation
|
|
func (s UploadDocumentsInput) GoString() string {
|
|
return s.String()
|
|
}
|
|
|
|
// Validate inspects the fields of the type to determine if they are valid.
|
|
func (s *UploadDocumentsInput) Validate() error {
|
|
invalidParams := request.ErrInvalidParams{Context: "UploadDocumentsInput"}
|
|
if s.ContentType == nil {
|
|
invalidParams.Add(request.NewErrParamRequired("ContentType"))
|
|
}
|
|
if s.Documents == nil {
|
|
invalidParams.Add(request.NewErrParamRequired("Documents"))
|
|
}
|
|
|
|
if invalidParams.Len() > 0 {
|
|
return invalidParams
|
|
}
|
|
return nil
|
|
}
|
|
|
|
// SetContentType sets the ContentType field's value.
|
|
func (s *UploadDocumentsInput) SetContentType(v string) *UploadDocumentsInput {
|
|
s.ContentType = &v
|
|
return s
|
|
}
|
|
|
|
// SetDocuments sets the Documents field's value.
|
|
func (s *UploadDocumentsInput) SetDocuments(v io.ReadSeeker) *UploadDocumentsInput {
|
|
s.Documents = v
|
|
return s
|
|
}
|
|
|
|
// Contains the response to an UploadDocuments request.
|
|
type UploadDocumentsOutput struct {
|
|
_ struct{} `type:"structure"`
|
|
|
|
// The number of documents that were added to the search domain.
|
|
Adds *int64 `locationName:"adds" type:"long"`
|
|
|
|
// The number of documents that were deleted from the search domain.
|
|
Deletes *int64 `locationName:"deletes" type:"long"`
|
|
|
|
// The status of an UploadDocumentsRequest.
|
|
Status *string `locationName:"status" type:"string"`
|
|
|
|
// Any warnings returned by the document service about the documents being uploaded.
|
|
Warnings []*DocumentServiceWarning `locationName:"warnings" type:"list"`
|
|
}
|
|
|
|
// String returns the string representation
|
|
func (s UploadDocumentsOutput) String() string {
|
|
return awsutil.Prettify(s)
|
|
}
|
|
|
|
// GoString returns the string representation
|
|
func (s UploadDocumentsOutput) GoString() string {
|
|
return s.String()
|
|
}
|
|
|
|
// SetAdds sets the Adds field's value.
|
|
func (s *UploadDocumentsOutput) SetAdds(v int64) *UploadDocumentsOutput {
|
|
s.Adds = &v
|
|
return s
|
|
}
|
|
|
|
// SetDeletes sets the Deletes field's value.
|
|
func (s *UploadDocumentsOutput) SetDeletes(v int64) *UploadDocumentsOutput {
|
|
s.Deletes = &v
|
|
return s
|
|
}
|
|
|
|
// SetStatus sets the Status field's value.
|
|
func (s *UploadDocumentsOutput) SetStatus(v string) *UploadDocumentsOutput {
|
|
s.Status = &v
|
|
return s
|
|
}
|
|
|
|
// SetWarnings sets the Warnings field's value.
|
|
func (s *UploadDocumentsOutput) SetWarnings(v []*DocumentServiceWarning) *UploadDocumentsOutput {
|
|
s.Warnings = v
|
|
return s
|
|
}
|
|
|
|
const (
|
|
// ContentTypeApplicationJson is a ContentType enum value
|
|
ContentTypeApplicationJson = "application/json"
|
|
|
|
// ContentTypeApplicationXml is a ContentType enum value
|
|
ContentTypeApplicationXml = "application/xml"
|
|
)
|
|
|
|
const (
|
|
// QueryParserSimple is a QueryParser enum value
|
|
QueryParserSimple = "simple"
|
|
|
|
// QueryParserStructured is a QueryParser enum value
|
|
QueryParserStructured = "structured"
|
|
|
|
// QueryParserLucene is a QueryParser enum value
|
|
QueryParserLucene = "lucene"
|
|
|
|
// QueryParserDismax is a QueryParser enum value
|
|
QueryParserDismax = "dismax"
|
|
)
|