com.amazonaws.services.cloudsearch
Interface AmazonCloudSearch

All Known Subinterfaces:

AmazonCloudSearchAsync

All Known Implementing Classes:

AmazonCloudSearchAsyncClient, AmazonCloudSearchClient

public interface AmazonCloudSearch

Interface for accessing AmazonCloudSearch. Amazon CloudSearch Configuration Service

You use the Configuration Service to create, configure, and manage search domains. Amazon CloudSearch configuration requests are submitted to cloudsearch.us-east-1.amazonaws.com using the AWS Query protocol.

Method Summary

CreateDomainResult	createDomain(CreateDomainRequest createDomainRequest) Creates a new search domain.
DefineIndexFieldResult	defineIndexField(DefineIndexFieldRequest defineIndexFieldRequest) Configures an IndexField for the search domain.
DefineRankExpressionResult	defineRankExpression(DefineRankExpressionRequest defineRankExpressionRequest) Configures a RankExpression for the search domain.
DeleteDomainResult	deleteDomain(DeleteDomainRequest deleteDomainRequest) Permanently deletes a search domain and all of its data.
DeleteIndexFieldResult	deleteIndexField(DeleteIndexFieldRequest deleteIndexFieldRequest) Removes an IndexField from the search domain.
DeleteRankExpressionResult	deleteRankExpression(DeleteRankExpressionRequest deleteRankExpressionRequest) Removes a RankExpression from the search domain.
DescribeDefaultSearchFieldResult	describeDefaultSearchField(DescribeDefaultSearchFieldRequest describeDefaultSearchFieldRequest) Gets the default search field configured for the search domain.
DescribeDomainsResult	describeDomains() Gets information about the search domains owned by this account.
DescribeDomainsResult	describeDomains(DescribeDomainsRequest describeDomainsRequest) Gets information about the search domains owned by this account.
DescribeIndexFieldsResult	describeIndexFields(DescribeIndexFieldsRequest describeIndexFieldsRequest) Gets information about the index fields configured for the search domain.
DescribeRankExpressionsResult	describeRankExpressions(DescribeRankExpressionsRequest describeRankExpressionsRequest) Gets the rank expressions configured for the search domain.
DescribeServiceAccessPoliciesResult	describeServiceAccessPolicies(DescribeServiceAccessPoliciesRequest describeServiceAccessPoliciesRequest) Gets information about the resource-based policies that control access to the domain's document and search services.
DescribeStemmingOptionsResult	describeStemmingOptions(DescribeStemmingOptionsRequest describeStemmingOptionsRequest) Gets the stemming dictionary configured for the search domain.
DescribeStopwordOptionsResult	describeStopwordOptions(DescribeStopwordOptionsRequest describeStopwordOptionsRequest) Gets the stopwords configured for the search domain.
DescribeSynonymOptionsResult	describeSynonymOptions(DescribeSynonymOptionsRequest describeSynonymOptionsRequest) Gets the synonym dictionary configured for the search domain.
ResponseMetadata	getCachedResponseMetadata(AmazonWebServiceRequest request) Returns additional metadata for a previously executed successful request, typically used for debugging issues where a service isn't acting as expected.
IndexDocumentsResult	indexDocuments(IndexDocumentsRequest indexDocumentsRequest) Tells the search domain to start indexing its documents using the latest text processing options and IndexFields .
void	setEndpoint(String endpoint) Overrides the default endpoint for this client ("https://cloudsearch.us-east-1.amazonaws.com/").
void	shutdown() Shuts down this client object, releasing any resources that might be held open.
UpdateDefaultSearchFieldResult	updateDefaultSearchField(UpdateDefaultSearchFieldRequest updateDefaultSearchFieldRequest) Configures the default search field for the search domain.
UpdateServiceAccessPoliciesResult	updateServiceAccessPolicies(UpdateServiceAccessPoliciesRequest updateServiceAccessPoliciesRequest) Configures the policies that control access to the domain's document and search services.
UpdateStemmingOptionsResult	updateStemmingOptions(UpdateStemmingOptionsRequest updateStemmingOptionsRequest) Configures a stemming dictionary for the search domain.
UpdateStopwordOptionsResult	updateStopwordOptions(UpdateStopwordOptionsRequest updateStopwordOptionsRequest) Configures stopwords for the search domain.
UpdateSynonymOptionsResult	updateSynonymOptions(UpdateSynonymOptionsRequest updateSynonymOptionsRequest) Configures a synonym dictionary for the search domain.

Method Detail

setEndpoint

void setEndpoint(String endpoint)
                 throws IllegalArgumentException

Overrides the default endpoint for this client ("https://cloudsearch.us-east-1.amazonaws.com/"). Callers can use this method to control which AWS region they want to work with.

Callers can pass in just the endpoint (ex: "cloudsearch.us-east-1.amazonaws.com/") or a full URL, including the protocol (ex: "https://cloudsearch.us-east-1.amazonaws.com/"). If the protocol is not specified here, the default protocol from this client's ClientConfiguration will be used, which by default is HTTPS.

For more information on using AWS regions with the AWS SDK for Java, and a complete list of all available endpoints for all AWS services, see: http://developer.amazonwebservices.com/connect/entry.jspa?externalID=3912

Parameters:

endpoint - The endpoint (ex: "cloudsearch.us-east-1.amazonaws.com/") or a full URL, including the protocol (ex: "https://cloudsearch.us-east-1.amazonaws.com/") of the region specific AWS endpoint this client will communicate with.

Throws:

IllegalArgumentException - If any problems are detected with the specified endpoint.

updateDefaultSearchField

UpdateDefaultSearchFieldResult updateDefaultSearchField(UpdateDefaultSearchFieldRequest updateDefaultSearchFieldRequest)
                                                        throws AmazonServiceException,
                                                               AmazonClientException

Configures the default search field for the search domain. The default search field is used when a search request does not specify which fields to search. By default, it is configured to include the contents of all of the domain's text fields.

Parameters:

updateDefaultSearchFieldRequest - Container for the necessary parameters to execute the UpdateDefaultSearchField service method on AmazonCloudSearch.

Returns:

The response from the UpdateDefaultSearchField service method, as returned by AmazonCloudSearch.

Throws:

BaseException

ResourceNotFoundException

InternalException

InvalidTypeException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCloudSearch indicating either a problem with the data in the request, or a server side issue.

deleteRankExpression

DeleteRankExpressionResult deleteRankExpression(DeleteRankExpressionRequest deleteRankExpressionRequest)
                                                throws AmazonServiceException,
                                                       AmazonClientException

Removes a RankExpression from the search domain.

Parameters:

deleteRankExpressionRequest - Container for the necessary parameters to execute the DeleteRankExpression service method on AmazonCloudSearch.

Returns:

The response from the DeleteRankExpression service method, as returned by AmazonCloudSearch.

Throws:

BaseException

ResourceNotFoundException

InternalException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCloudSearch indicating either a problem with the data in the request, or a server side issue.

describeRankExpressions

DescribeRankExpressionsResult describeRankExpressions(DescribeRankExpressionsRequest describeRankExpressionsRequest)
                                                      throws AmazonServiceException,
                                                             AmazonClientException

Gets the rank expressions configured for the search domain. Can be limited to specific rank expressions by name. Shows all rank expressions by default.

Parameters:

describeRankExpressionsRequest - Container for the necessary parameters to execute the DescribeRankExpressions service method on AmazonCloudSearch.

Returns:

The response from the DescribeRankExpressions service method, as returned by AmazonCloudSearch.

Throws:

BaseException

ResourceNotFoundException

InternalException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCloudSearch indicating either a problem with the data in the request, or a server side issue.

createDomain

CreateDomainResult createDomain(CreateDomainRequest createDomainRequest)
                                throws AmazonServiceException,
                                       AmazonClientException

Creates a new search domain.

Parameters:

createDomainRequest - Container for the necessary parameters to execute the CreateDomain service method on AmazonCloudSearch.

Returns:

The response from the CreateDomain service method, as returned by AmazonCloudSearch.

Throws:

BaseException

LimitExceededException

InternalException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCloudSearch indicating either a problem with the data in the request, or a server side issue.

updateServiceAccessPolicies

UpdateServiceAccessPoliciesResult updateServiceAccessPolicies(UpdateServiceAccessPoliciesRequest updateServiceAccessPoliciesRequest)
                                                              throws AmazonServiceException,
                                                                     AmazonClientException

Configures the policies that control access to the domain's document and search services. The maximum size of an access policy document is 100KB.

Parameters:

updateServiceAccessPoliciesRequest - Container for the necessary parameters to execute the UpdateServiceAccessPolicies service method on AmazonCloudSearch.

Returns:

The response from the UpdateServiceAccessPolicies service method, as returned by AmazonCloudSearch.

Throws:

BaseException

ResourceNotFoundException

LimitExceededException

InternalException

InvalidTypeException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCloudSearch indicating either a problem with the data in the request, or a server side issue.

defineIndexField

DefineIndexFieldResult defineIndexField(DefineIndexFieldRequest defineIndexFieldRequest)
                                        throws AmazonServiceException,
                                               AmazonClientException

Configures an IndexField for the search domain. Used to create new fields and modify existing ones. If the field exists, the new configuration replaces the old one. You can configure a maximum of 200 index fields.

Parameters:

defineIndexFieldRequest - Container for the necessary parameters to execute the DefineIndexField service method on AmazonCloudSearch.

Returns:

The response from the DefineIndexField service method, as returned by AmazonCloudSearch.

Throws:

BaseException

ResourceNotFoundException

LimitExceededException

InternalException

InvalidTypeException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCloudSearch indicating either a problem with the data in the request, or a server side issue.

defineRankExpression

DefineRankExpressionResult defineRankExpression(DefineRankExpressionRequest defineRankExpressionRequest)
                                                throws AmazonServiceException,
                                                       AmazonClientException

Configures a RankExpression for the search domain. Used to create new rank expressions and modify existing ones. If the expression exists, the new configuration replaces the old one. You can configure a maximum of 50 rank expressions.

Parameters:

defineRankExpressionRequest - Container for the necessary parameters to execute the DefineRankExpression service method on AmazonCloudSearch.

Returns:

The response from the DefineRankExpression service method, as returned by AmazonCloudSearch.

Throws:

BaseException

ResourceNotFoundException

LimitExceededException

InternalException

InvalidTypeException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCloudSearch indicating either a problem with the data in the request, or a server side issue.

describeSynonymOptions

DescribeSynonymOptionsResult describeSynonymOptions(DescribeSynonymOptionsRequest describeSynonymOptionsRequest)
                                                    throws AmazonServiceException,
                                                           AmazonClientException

Gets the synonym dictionary configured for the search domain.

Parameters:

describeSynonymOptionsRequest - Container for the necessary parameters to execute the DescribeSynonymOptions service method on AmazonCloudSearch.

Returns:

The response from the DescribeSynonymOptions service method, as returned by AmazonCloudSearch.

Throws:

BaseException

ResourceNotFoundException

InternalException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCloudSearch indicating either a problem with the data in the request, or a server side issue.

describeStopwordOptions

DescribeStopwordOptionsResult describeStopwordOptions(DescribeStopwordOptionsRequest describeStopwordOptionsRequest)
                                                      throws AmazonServiceException,
                                                             AmazonClientException

Gets the stopwords configured for the search domain.

Parameters:

describeStopwordOptionsRequest - Container for the necessary parameters to execute the DescribeStopwordOptions service method on AmazonCloudSearch.

Returns:

The response from the DescribeStopwordOptions service method, as returned by AmazonCloudSearch.

Throws:

BaseException

ResourceNotFoundException

InternalException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCloudSearch indicating either a problem with the data in the request, or a server side issue.

deleteDomain

DeleteDomainResult deleteDomain(DeleteDomainRequest deleteDomainRequest)
                                throws AmazonServiceException,
                                       AmazonClientException

Permanently deletes a search domain and all of its data.

Parameters:

deleteDomainRequest - Container for the necessary parameters to execute the DeleteDomain service method on AmazonCloudSearch.

Returns:

The response from the DeleteDomain service method, as returned by AmazonCloudSearch.

Throws:

BaseException

InternalException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCloudSearch indicating either a problem with the data in the request, or a server side issue.

describeServiceAccessPolicies

DescribeServiceAccessPoliciesResult describeServiceAccessPolicies(DescribeServiceAccessPoliciesRequest describeServiceAccessPoliciesRequest)
                                                                  throws AmazonServiceException,
                                                                         AmazonClientException

Gets information about the resource-based policies that control access to the domain's document and search services.

Parameters:

describeServiceAccessPoliciesRequest - Container for the necessary parameters to execute the DescribeServiceAccessPolicies service method on AmazonCloudSearch.

Returns:

The response from the DescribeServiceAccessPolicies service method, as returned by AmazonCloudSearch.

Throws:

BaseException

ResourceNotFoundException

InternalException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCloudSearch indicating either a problem with the data in the request, or a server side issue.

describeDefaultSearchField

DescribeDefaultSearchFieldResult describeDefaultSearchField(DescribeDefaultSearchFieldRequest describeDefaultSearchFieldRequest)
                                                            throws AmazonServiceException,
                                                                   AmazonClientException

Gets the default search field configured for the search domain.

Parameters:

describeDefaultSearchFieldRequest - Container for the necessary parameters to execute the DescribeDefaultSearchField service method on AmazonCloudSearch.

Returns:

The response from the DescribeDefaultSearchField service method, as returned by AmazonCloudSearch.

Throws:

BaseException

ResourceNotFoundException

InternalException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCloudSearch indicating either a problem with the data in the request, or a server side issue.

updateStopwordOptions

UpdateStopwordOptionsResult updateStopwordOptions(UpdateStopwordOptionsRequest updateStopwordOptionsRequest)
                                                  throws AmazonServiceException,
                                                         AmazonClientException

Configures stopwords for the search domain. Stopwords are used during indexing and when processing search requests. The maximum size of the stopwords dictionary is 10KB.

Parameters:

updateStopwordOptionsRequest - Container for the necessary parameters to execute the UpdateStopwordOptions service method on AmazonCloudSearch.

Returns:

The response from the UpdateStopwordOptions service method, as returned by AmazonCloudSearch.

Throws:

BaseException

ResourceNotFoundException

LimitExceededException

InternalException

InvalidTypeException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCloudSearch indicating either a problem with the data in the request, or a server side issue.

updateSynonymOptions

UpdateSynonymOptionsResult updateSynonymOptions(UpdateSynonymOptionsRequest updateSynonymOptionsRequest)
                                                throws AmazonServiceException,
                                                       AmazonClientException

Configures a synonym dictionary for the search domain. The synonym dictionary is used during indexing to configure mappings for terms that occur in text fields. The maximum size of the synonym dictionary is 100KB.

Parameters:

updateSynonymOptionsRequest - Container for the necessary parameters to execute the UpdateSynonymOptions service method on AmazonCloudSearch.

Returns:

The response from the UpdateSynonymOptions service method, as returned by AmazonCloudSearch.

Throws:

BaseException

ResourceNotFoundException

LimitExceededException

InternalException

InvalidTypeException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCloudSearch indicating either a problem with the data in the request, or a server side issue.

updateStemmingOptions

UpdateStemmingOptionsResult updateStemmingOptions(UpdateStemmingOptionsRequest updateStemmingOptionsRequest)
                                                  throws AmazonServiceException,
                                                         AmazonClientException

Configures a stemming dictionary for the search domain. The stemming dictionary is used during indexing and when processing search requests. The maximum size of the stemming dictionary is 500KB.

Parameters:

updateStemmingOptionsRequest - Container for the necessary parameters to execute the UpdateStemmingOptions service method on AmazonCloudSearch.

Returns:

The response from the UpdateStemmingOptions service method, as returned by AmazonCloudSearch.

Throws:

BaseException

ResourceNotFoundException

LimitExceededException

InternalException

InvalidTypeException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCloudSearch indicating either a problem with the data in the request, or a server side issue.

describeStemmingOptions

DescribeStemmingOptionsResult describeStemmingOptions(DescribeStemmingOptionsRequest describeStemmingOptionsRequest)
                                                      throws AmazonServiceException,
                                                             AmazonClientException

Gets the stemming dictionary configured for the search domain.

Parameters:

describeStemmingOptionsRequest - Container for the necessary parameters to execute the DescribeStemmingOptions service method on AmazonCloudSearch.

Returns:

The response from the DescribeStemmingOptions service method, as returned by AmazonCloudSearch.

Throws:

BaseException

ResourceNotFoundException

InternalException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCloudSearch indicating either a problem with the data in the request, or a server side issue.

describeDomains

DescribeDomainsResult describeDomains(DescribeDomainsRequest describeDomainsRequest)
                                      throws AmazonServiceException,
                                             AmazonClientException

Gets information about the search domains owned by this account. Can be limited to specific domains. Shows all domains by default.

Parameters:

describeDomainsRequest - Container for the necessary parameters to execute the DescribeDomains service method on AmazonCloudSearch.

Returns:

The response from the DescribeDomains service method, as returned by AmazonCloudSearch.

Throws:

BaseException

InternalException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCloudSearch indicating either a problem with the data in the request, or a server side issue.

indexDocuments

IndexDocumentsResult indexDocuments(IndexDocumentsRequest indexDocumentsRequest)
                                    throws AmazonServiceException,
                                           AmazonClientException

Tells the search domain to start indexing its documents using the latest text processing options and IndexFields . This operation must be invoked to make options whose OptionStatus has OptionState of RequiresIndexDocuments visible in search results.

Parameters:

indexDocumentsRequest - Container for the necessary parameters to execute the IndexDocuments service method on AmazonCloudSearch.

Returns:

The response from the IndexDocuments service method, as returned by AmazonCloudSearch.

Throws:

BaseException

ResourceNotFoundException

InternalException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCloudSearch indicating either a problem with the data in the request, or a server side issue.

describeIndexFields

DescribeIndexFieldsResult describeIndexFields(DescribeIndexFieldsRequest describeIndexFieldsRequest)
                                              throws AmazonServiceException,
                                                     AmazonClientException

Gets information about the index fields configured for the search domain. Can be limited to specific fields by name. Shows all fields by default.

Parameters:

describeIndexFieldsRequest - Container for the necessary parameters to execute the DescribeIndexFields service method on AmazonCloudSearch.

Returns:

The response from the DescribeIndexFields service method, as returned by AmazonCloudSearch.

Throws:

BaseException

ResourceNotFoundException

InternalException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCloudSearch indicating either a problem with the data in the request, or a server side issue.

deleteIndexField

DeleteIndexFieldResult deleteIndexField(DeleteIndexFieldRequest deleteIndexFieldRequest)
                                        throws AmazonServiceException,
                                               AmazonClientException

Removes an IndexField from the search domain.

Parameters:

deleteIndexFieldRequest - Container for the necessary parameters to execute the DeleteIndexField service method on AmazonCloudSearch.

Returns:

The response from the DeleteIndexField service method, as returned by AmazonCloudSearch.

Throws:

BaseException

ResourceNotFoundException

InternalException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCloudSearch indicating either a problem with the data in the request, or a server side issue.

describeDomains

DescribeDomainsResult describeDomains()
                                      throws AmazonServiceException,
                                             AmazonClientException

Gets information about the search domains owned by this account. Can be limited to specific domains. Shows all domains by default.

Returns:

The response from the DescribeDomains service method, as returned by AmazonCloudSearch.

Throws:

BaseException

InternalException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by AmazonCloudSearch indicating either a problem with the data in the request, or a server side issue.

shutdown

void shutdown()

Shuts down this client object, releasing any resources that might be held open. This is an optional method, and callers are not expected to call it, but can if they want to explicitly release any open resources. Once a client has been shutdown, it should not be used to make any more requests.

getCachedResponseMetadata

ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)

Returns additional metadata for a previously executed successful request, typically used for debugging issues where a service isn't acting as expected. This data isn't considered part of the result data returned by an operation, so it's available through this separate, diagnostic interface.

Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing a request.

Parameters:

request - The originally executed request.

Returns:

The response metadata for the specified request, or null if none is available.