Class: AWS::CloudSearch::Client

Inherits:
AWS::Core::QueryClient show all
Defined in:
lib/aws/cloud_search/client.rb

Overview

Client class for Amazon Cloud Search.

Instance Attribute Summary

Attributes inherited from AWS::Core::Client

#config, #http_read_timeout

Instance Method Summary collapse

Methods inherited from AWS::Core::Client

#initialize, #log_warning, #operations, operations, #with_http_handler, #with_options

Constructor Details

This class inherits a constructor from AWS::Core::Client

Instance Method Details

#create_domain(options = {}) ⇒ Core::Response

Calls the CreateDomain API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :domain_name - required - (String)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :domain_status - (Hash)

      • :domain_id - (String)

      • :domain_name - (String)

      • :created - (Boolean)

      • :deleted - (Boolean)

      • :num_searchable_docs - (Integer)

      • :doc_service - (Hash)

        • :arn - (String)

        • :endpoint - (String)

      • :search_service - (Hash)

        • :arn - (String)

        • :endpoint - (String)

      • :requires_index_documents - (Boolean)

      • :processing - (Boolean)

      • :search_instance_type - (String)

      • :search_partition_count - (Integer)

      • :search_instance_count - (Integer)




# File 'lib/aws/cloud_search/client.rb', line 27

#define_index_field(options = {}) ⇒ Core::Response

Calls the DefineIndexField API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :domain_name - required - (String)

    • :index_field - required - (Hash)

      • :index_field_name - required - (String) The name of a field in the search index. Field names must begin with a letter and can contain the following characters: a-z (lowercase), 0-9, and _ (underscore). Uppercase letters and hyphens are not allowed. The names “body”, “docid”, and “text_relevance” are reserved and cannot be specified as field or rank expression names.

      • :index_field_type - required - (String) The type of field. Based on this type, exactly one of the UIntOptions, LiteralOptions or TextOptions must be present.

      • :u_int_options - (Hash) Options for an unsigned integer field. Present if IndexFieldType specifies the field is of type unsigned integer.

        • :default_value - (Integer) The default value for an unsigned integer field.

      • :literal_options - (Hash) Options for literal field. Present if IndexFieldType specifies the field is of type literal.

        • :default_value - (String) The default value for a literal field.

        • :search_enabled - (Boolean) Specifies whether search is enabled for this field.

        • :facet_enabled - (Boolean) Specifies whether facets are enabled for this field.

        • :result_enabled - (Boolean) Specifies whether values of this field can be returned in search results and used for ranking.

      • :text_options - (Hash) Options for text field. Present if IndexFieldType specifies the field is of type text.

        • :default_value - (String) The default value for a text field.

        • :facet_enabled - (Boolean) Specifies whether facets are enabled for this field.

        • :result_enabled - (Boolean) Specifies whether values of this field can be returned in search results and used for ranking.

      • :source_attributes - (Array<Hash>) An optional list of source attributes that provide data for this index field. If not specified, the data is pulled from a source attribute with the same name as this IndexField. When one or more source attributes are specified, an optional data transformation can be applied to the source data when populating the index field. You can configure a maximum of 20 sources for an IndexField.

        • :source_data_function - required - (String) Identifies the transformation to apply when copying data from a source attribute.

        • :source_data_copy - (Hash) Copies data from a source document attribute to an IndexField.

          • :source_name - required - (String) The name of the document source field to add to this IndexField.

          • :default_value - (String)

        • :source_data_trim_title - (Hash) Trims common title words from a source document attribute when populating an IndexField. This can be used to create an IndexField you can use for sorting.

          • :source_name - required - (String) The name of the document source field to add to this IndexField.

          • :default_value - (String)

          • :separator - (String) The separator that follows the text to trim.

          • :language - (String)

        • :source_data_map - (Hash) Maps source document attribute values to new values when populating the IndexField.

          • :source_name - required - (String) The name of the document source field to add to this IndexField.

          • :default_value - (String)

          • :cases - (Hash<String,String>) A map that translates source field values to custom values.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :index_field - (Hash)

      • :options - (Hash)

        • :index_field_name - (String)

        • :index_field_type - (String)

        • :u_int_options - (Hash)

          • :default_value - (Integer)

        • :literal_options - (Hash)

          • :default_value - (String)

          • :search_enabled - (Boolean)

          • :facet_enabled - (Boolean)

          • :result_enabled - (Boolean)

        • :text_options - (Hash)

          • :default_value - (String)

          • :facet_enabled - (Boolean)

          • :result_enabled - (Boolean)

        • :source_attributes - (Array<Hash>)

          • :source_data_function - (String)

          • :source_data_copy - (Hash)

            • :source_name - (String)

            • :default_value - (String)

          • :source_data_trim_title - (Hash)

            • :source_name - (String)

            • :default_value - (String)

            • :separator - (String)

            • :language - (String)

          • :source_data_map - (Hash)

            • :source_name - (String)

            • :default_value - (String)

            • :cases - (Hash<String,String>)

      • :status - (Hash)

        • :creation_date - (Time)

        • :update_date - (Time)

        • :update_version - (Integer)

        • :state - (String)




# File 'lib/aws/cloud_search/client.rb', line 52

#define_rank_expression(options = {}) ⇒ Core::Response

Calls the DefineRankExpression API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :domain_name - required - (String)

    • :rank_expression - required - (Hash)

      • :rank_name - required - (String) The name of a rank expression. Rank expression names must begin with a letter and can contain the following characters: a-z (lowercase), 0-9, and _ (underscore). Uppercase letters and hyphens are not allowed. The names “body”, “docid”, and “text_relevance” are reserved and cannot be specified as field or rank expression names.

      • :rank_expression - required - (String) The expression to evaluate for ranking or thresholding while processing a search request. The RankExpression syntax is based on JavaScript expressions and supports: Integer, floating point, hex and octal literals Shortcut evaluation of logical operators such that an expression a || b evaluates to the value a if a is true without evaluting b at all JavaScript order of precendence for operators Arithmetic operators: + - * / % Boolean operators (including the ternary operator) Bitwise operators Comparison operators Common mathematic functions: abs ceil erf exp floor lgamma ln log2 log10 max min sqrt pow Trigonometric library functions: acosh acos asinh asin atanh atan cosh cos sinh sin tanh tan Random generation of a number between 0 and 1: rand Current time in epoch: time The min max functions that operate on a variable argument list Intermediate results are calculated as double precision floating point values. The final return value of a RankExpression is automatically converted from floating point to a 32-bit unsigned integer by rounding to the nearest integer, with a natural floor of 0 and a ceiling of max(uint32_t),

        1. Mathematical errors such as dividing by 0 will fail

        during evaluation and return a value of 0. The source data for a RankExpression can be the name of an IndexField of type uint, another RankExpression or the reserved name text_relevance. The text_relevance source is defined to return an integer from 0 to 1000 (inclusive) to indicate how relevant a document is to the search request, taking into account repetition of search terms in the document and proximity of search terms to each other in each matching IndexField in the document. For more information about using rank expressions to customize ranking, see the Amazon CloudSearch Developer Guide.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :rank_expression - (Hash)

      • :options - (Hash)

        • :rank_name - (String)

        • :rank_expression - (String)

      • :status - (Hash)

        • :creation_date - (Time)

        • :update_date - (Time)

        • :update_version - (Integer)

        • :state - (String)




# File 'lib/aws/cloud_search/client.rb', line 158

#delete_domain(options = {}) ⇒ Core::Response

Calls the DeleteDomain API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :domain_name - required - (String)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :domain_status - (Hash)

      • :domain_id - (String)

      • :domain_name - (String)

      • :created - (Boolean)

      • :deleted - (Boolean)

      • :num_searchable_docs - (Integer)

      • :doc_service - (Hash)

        • :arn - (String)

        • :endpoint - (String)

      • :search_service - (Hash)

        • :arn - (String)

        • :endpoint - (String)

      • :requires_index_documents - (Boolean)

      • :processing - (Boolean)

      • :search_instance_type - (String)

      • :search_partition_count - (Integer)

      • :search_instance_count - (Integer)




# File 'lib/aws/cloud_search/client.rb', line 212

#delete_index_field(options = {}) ⇒ Core::Response

Calls the DeleteIndexField API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :domain_name - required - (String)

    • :index_field_name - required - (String)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :index_field - (Hash)

      • :options - (Hash)

        • :index_field_name - (String)

        • :index_field_type - (String)

        • :u_int_options - (Hash)

          • :default_value - (Integer)

        • :literal_options - (Hash)

          • :default_value - (String)

          • :search_enabled - (Boolean)

          • :facet_enabled - (Boolean)

          • :result_enabled - (Boolean)

        • :text_options - (Hash)

          • :default_value - (String)

          • :facet_enabled - (Boolean)

          • :result_enabled - (Boolean)

        • :source_attributes - (Array<Hash>)

          • :source_data_function - (String)

          • :source_data_copy - (Hash)

            • :source_name - (String)

            • :default_value - (String)

          • :source_data_trim_title - (Hash)

            • :source_name - (String)

            • :default_value - (String)

            • :separator - (String)

            • :language - (String)

          • :source_data_map - (Hash)

            • :source_name - (String)

            • :default_value - (String)

            • :cases - (Hash<String,String>)

      • :status - (Hash)

        • :creation_date - (Time)

        • :update_date - (Time)

        • :update_version - (Integer)

        • :state - (String)




# File 'lib/aws/cloud_search/client.rb', line 237

#delete_rank_expression(options = {}) ⇒ Core::Response

Calls the DeleteRankExpression API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :domain_name - required - (String)

    • :rank_name - required - (String) The name of the RankExpression to delete.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :rank_expression - (Hash)

      • :options - (Hash)

        • :rank_name - (String)

        • :rank_expression - (String)

      • :status - (Hash)

        • :creation_date - (Time)

        • :update_date - (Time)

        • :update_version - (Integer)

        • :state - (String)




# File 'lib/aws/cloud_search/client.rb', line 280

#describe_default_search_field(options = {}) ⇒ Core::Response

Calls the DescribeDefaultSearchField API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :domain_name - required - (String)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :default_search_field - (Hash)

      • :options - (String)

      • :status - (Hash)

        • :creation_date - (Time)

        • :update_date - (Time)

        • :update_version - (Integer)

        • :state - (String)




# File 'lib/aws/cloud_search/client.rb', line 299

#describe_domains(options = {}) ⇒ Core::Response

Calls the DescribeDomains API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :domain_names - (Array<String>) Limits the DescribeDomains response to the specified search domains.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :domain_status_list - (Array<Hash>)

      • :domain_id - (String)

      • :domain_name - (String)

      • :created - (Boolean)

      • :deleted - (Boolean)

      • :num_searchable_docs - (Integer)

      • :doc_service - (Hash)

        • :arn - (String)

        • :endpoint - (String)

      • :search_service - (Hash)

        • :arn - (String)

        • :endpoint - (String)

      • :requires_index_documents - (Boolean)

      • :processing - (Boolean)

      • :search_instance_type - (String)

      • :search_partition_count - (Integer)

      • :search_instance_count - (Integer)




# File 'lib/aws/cloud_search/client.rb', line 314

#describe_index_fields(options = {}) ⇒ Core::Response

Calls the DescribeIndexFields API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :domain_name - required - (String)

    • :field_names - (Array<String>) Limits the DescribeIndexFields response to the specified fields.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :index_fields - (Array<Hash>)

      • :options - (Hash)

        • :index_field_name - (String)

        • :index_field_type - (String)

        • :u_int_options - (Hash)

          • :default_value - (Integer)

        • :literal_options - (Hash)

          • :default_value - (String)

          • :search_enabled - (Boolean)

          • :facet_enabled - (Boolean)

          • :result_enabled - (Boolean)

        • :text_options - (Hash)

          • :default_value - (String)

          • :facet_enabled - (Boolean)

          • :result_enabled - (Boolean)

        • :source_attributes - (Array<Hash>)

          • :source_data_function - (String)

          • :source_data_copy - (Hash)

            • :source_name - (String)

            • :default_value - (String)

          • :source_data_trim_title - (Hash)

            • :source_name - (String)

            • :default_value - (String)

            • :separator - (String)

            • :language - (String)

          • :source_data_map - (Hash)

            • :source_name - (String)

            • :default_value - (String)

            • :cases - (Hash<String,String>)

      • :status - (Hash)

        • :creation_date - (Time)

        • :update_date - (Time)

        • :update_version - (Integer)

        • :state - (String)




# File 'lib/aws/cloud_search/client.rb', line 340

#describe_rank_expressions(options = {}) ⇒ Core::Response

Calls the DescribeRankExpressions API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :domain_name - required - (String)

    • :rank_names - (Array<String>) Limits the DescribeRankExpressions response to the specified fields.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :rank_expressions - (Array<Hash>)

      • :options - (Hash)

        • :rank_name - (String)

        • :rank_expression - (String)

      • :status - (Hash)

        • :creation_date - (Time)

        • :update_date - (Time)

        • :update_version - (Integer)

        • :state - (String)




# File 'lib/aws/cloud_search/client.rb', line 384

#describe_service_access_policies(options = {}) ⇒ Core::Response

Calls the DescribeServiceAccessPolicies API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :domain_name - required - (String)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :access_policies - (Hash)

      • :options - (String)

      • :status - (Hash)

        • :creation_date - (Time)

        • :update_date - (Time)

        • :update_version - (Integer)

        • :state - (String)




# File 'lib/aws/cloud_search/client.rb', line 403

#describe_stemming_options(options = {}) ⇒ Core::Response

Calls the DescribeStemmingOptions API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :domain_name - required - (String)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :stems - (Hash)

      • :options - (String)

      • :status - (Hash)

        • :creation_date - (Time)

        • :update_date - (Time)

        • :update_version - (Integer)

        • :state - (String)




# File 'lib/aws/cloud_search/client.rb', line 418

#describe_stopword_options(options = {}) ⇒ Core::Response

Calls the DescribeStopwordOptions API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :domain_name - required - (String)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :stopwords - (Hash)

      • :options - (String)

      • :status - (Hash)

        • :creation_date - (Time)

        • :update_date - (Time)

        • :update_version - (Integer)

        • :state - (String)




# File 'lib/aws/cloud_search/client.rb', line 433

#describe_synonym_options(options = {}) ⇒ Core::Response

Calls the DescribeSynonymOptions API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :domain_name - required - (String)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :synonyms - (Hash)

      • :options - (String)

      • :status - (Hash)

        • :creation_date - (Time)

        • :update_date - (Time)

        • :update_version - (Integer)

        • :state - (String)




# File 'lib/aws/cloud_search/client.rb', line 448

#index_documents(options = {}) ⇒ Core::Response

Calls the IndexDocuments API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :domain_name - required - (String)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :field_names - (Array<String>)




# File 'lib/aws/cloud_search/client.rb', line 463

#update_default_search_field(options = {}) ⇒ Core::Response

Calls the UpdateDefaultSearchField API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :domain_name - required - (String)

    • :default_search_field - required - (String) The IndexField to use for search requests issued with the q parameter. The default is an empty string, which automatically searches all text fields.

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :default_search_field - (Hash)

      • :options - (String)

      • :status - (Hash)

        • :creation_date - (Time)

        • :update_date - (Time)

        • :update_version - (Integer)

        • :state - (String)




# File 'lib/aws/cloud_search/client.rb', line 472

#update_service_access_policies(options = {}) ⇒ Core::Response

Calls the UpdateServiceAccessPolicies API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :domain_name - required - (String)

    • :access_policies - required - (String)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :access_policies - (Hash)

      • :options - (String)

      • :status - (Hash)

        • :creation_date - (Time)

        • :update_date - (Time)

        • :update_version - (Integer)

        • :state - (String)




# File 'lib/aws/cloud_search/client.rb', line 490

#update_stemming_options(options = {}) ⇒ Core::Response

Calls the UpdateStemmingOptions API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :domain_name - required - (String)

    • :stems - required - (String)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :stems - (Hash)

      • :options - (String)

      • :status - (Hash)

        • :creation_date - (Time)

        • :update_date - (Time)

        • :update_version - (Integer)

        • :state - (String)




# File 'lib/aws/cloud_search/client.rb', line 506

#update_stopword_options(options = {}) ⇒ Core::Response

Calls the UpdateStopwordOptions API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :domain_name - required - (String)

    • :stopwords - required - (String)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :stopwords - (Hash)

      • :options - (String)

      • :status - (Hash)

        • :creation_date - (Time)

        • :update_date - (Time)

        • :update_version - (Integer)

        • :state - (String)




# File 'lib/aws/cloud_search/client.rb', line 522

#update_synonym_options(options = {}) ⇒ Core::Response

Calls the UpdateSynonymOptions API operation.

Parameters:

  • options (Hash) (defaults to: {}) —

    • :domain_name - required - (String)

    • :synonyms - required - (String)

Returns:

  • (Core::Response) —

    The #data method of the response object returns a hash with the following structure:

    • :synonyms - (Hash)

      • :options - (String)

      • :status - (Hash)

        • :creation_date - (Time)

        • :update_date - (Time)

        • :update_version - (Integer)

        • :state - (String)




# File 'lib/aws/cloud_search/client.rb', line 538