public class AmazonCloudSearchClient extends AmazonWebServiceClient implements AmazonCloudSearch
Amazon CloudSearch Configuration Service
You use the configuration service to create, configure, and manage search domains. Configuration service requests are submitted using the AWS Query protocol. AWS Query requests are HTTP or HTTPS requests submitted via HTTP GET or POST with a query parameter named Action.
The endpoint for configuration service requests is region-specific: cloudsearch. region .amazonaws.com. For example, cloudsearch.us-east-1.amazonaws.com. For a current list of supported regions and endpoints, see Regions and Endpoints .
Constructor and Description |
---|
AmazonCloudSearchClient()
Constructs a new client to invoke service methods on
AmazonCloudSearch.
|
AmazonCloudSearchClient(AWSCredentials awsCredentials)
Constructs a new client to invoke service methods on
AmazonCloudSearch using the specified AWS account credentials.
|
AmazonCloudSearchClient(AWSCredentials awsCredentials,
ClientConfiguration clientConfiguration)
Constructs a new client to invoke service methods on
AmazonCloudSearch using the specified AWS account credentials
and client configuration options.
|
AmazonCloudSearchClient(AWSCredentialsProvider awsCredentialsProvider)
Constructs a new client to invoke service methods on
AmazonCloudSearch using the specified AWS account credentials provider.
|
AmazonCloudSearchClient(AWSCredentialsProvider awsCredentialsProvider,
ClientConfiguration clientConfiguration)
Constructs a new client to invoke service methods on
AmazonCloudSearch using the specified AWS account credentials
provider and client configuration options.
|
AmazonCloudSearchClient(AWSCredentialsProvider awsCredentialsProvider,
ClientConfiguration clientConfiguration,
RequestMetricCollector requestMetricCollector)
Constructs a new client to invoke service methods on
AmazonCloudSearch using the specified AWS account credentials
provider, client configuration options, and request metric collector.
|
AmazonCloudSearchClient(ClientConfiguration clientConfiguration)
Constructs a new client to invoke service methods on
AmazonCloudSearch.
|
Modifier and Type | Method and Description |
---|---|
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 . |
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.
|
addRequestHandler, addRequestHandler, getRequestMetricsCollector, getServiceName, getTimeOffset, removeRequestHandler, removeRequestHandler, setConfiguration, setEndpoint, setEndpoint, setRegion, setTimeOffset, shutdown, withTimeOffset
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
setEndpoint, setRegion, shutdown
public AmazonCloudSearchClient()
All service calls made using this new client object are blocking, and will not return until the service call completes.
DefaultAWSCredentialsProviderChain
public AmazonCloudSearchClient(ClientConfiguration clientConfiguration)
All service calls made using this new client object are blocking, and will not return until the service call completes.
clientConfiguration
- The client configuration options controlling how this
client connects to AmazonCloudSearch
(ex: proxy settings, retry counts, etc.).DefaultAWSCredentialsProviderChain
public AmazonCloudSearchClient(AWSCredentials awsCredentials)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentials
- The AWS credentials (access key ID and secret key) to use
when authenticating with AWS services.public AmazonCloudSearchClient(AWSCredentials awsCredentials, ClientConfiguration clientConfiguration)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentials
- The AWS credentials (access key ID and secret key) to use
when authenticating with AWS services.clientConfiguration
- The client configuration options controlling how this
client connects to AmazonCloudSearch
(ex: proxy settings, retry counts, etc.).public AmazonCloudSearchClient(AWSCredentialsProvider awsCredentialsProvider)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentialsProvider
- The AWS credentials provider which will provide credentials
to authenticate requests with AWS services.public AmazonCloudSearchClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentialsProvider
- The AWS credentials provider which will provide credentials
to authenticate requests with AWS services.clientConfiguration
- The client configuration options controlling how this
client connects to AmazonCloudSearch
(ex: proxy settings, retry counts, etc.).public AmazonCloudSearchClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration, RequestMetricCollector requestMetricCollector)
All service calls made using this new client object are blocking, and will not return until the service call completes.
awsCredentialsProvider
- The AWS credentials provider which will provide credentials
to authenticate requests with AWS services.clientConfiguration
- The client configuration options controlling how this
client connects to AmazonCloudSearch
(ex: proxy settings, retry counts, etc.).requestMetricCollector
- optional request metric collectorpublic UpdateDefaultSearchFieldResult updateDefaultSearchField(UpdateDefaultSearchFieldRequest updateDefaultSearchFieldRequest)
Configures the default search field for the search domain. The default search field is the text field that is searched 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.
updateDefaultSearchField
in interface AmazonCloudSearch
updateDefaultSearchFieldRequest
- Container for the necessary
parameters to execute the UpdateDefaultSearchField service method on
AmazonCloudSearch.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.public DeleteRankExpressionResult deleteRankExpression(DeleteRankExpressionRequest deleteRankExpressionRequest)
Removes a RankExpression
from the search domain.
deleteRankExpression
in interface AmazonCloudSearch
deleteRankExpressionRequest
- Container for the necessary
parameters to execute the DeleteRankExpression service method on
AmazonCloudSearch.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.public DescribeRankExpressionsResult describeRankExpressions(DescribeRankExpressionsRequest describeRankExpressionsRequest)
Gets the rank expressions configured for the search domain. Can be limited to specific rank expressions by name. Shows all rank expressions by default.
describeRankExpressions
in interface AmazonCloudSearch
describeRankExpressionsRequest
- Container for the necessary
parameters to execute the DescribeRankExpressions service method on
AmazonCloudSearch.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.public CreateDomainResult createDomain(CreateDomainRequest createDomainRequest)
Creates a new search domain.
createDomain
in interface AmazonCloudSearch
createDomainRequest
- Container for the necessary parameters to
execute the CreateDomain service method on AmazonCloudSearch.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.public UpdateServiceAccessPoliciesResult updateServiceAccessPolicies(UpdateServiceAccessPoliciesRequest updateServiceAccessPoliciesRequest)
Configures the policies that control access to the domain's document and search services. The maximum size of an access policy document is 100 KB.
updateServiceAccessPolicies
in interface AmazonCloudSearch
updateServiceAccessPoliciesRequest
- Container for the necessary
parameters to execute the UpdateServiceAccessPolicies service method
on AmazonCloudSearch.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.public DefineIndexFieldResult defineIndexField(DefineIndexFieldRequest defineIndexFieldRequest)
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.
defineIndexField
in interface AmazonCloudSearch
defineIndexFieldRequest
- Container for the necessary parameters
to execute the DefineIndexField service method on AmazonCloudSearch.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.public DefineRankExpressionResult defineRankExpression(DefineRankExpressionRequest defineRankExpressionRequest)
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.
defineRankExpression
in interface AmazonCloudSearch
defineRankExpressionRequest
- Container for the necessary
parameters to execute the DefineRankExpression service method on
AmazonCloudSearch.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.public DescribeSynonymOptionsResult describeSynonymOptions(DescribeSynonymOptionsRequest describeSynonymOptionsRequest)
Gets the synonym dictionary configured for the search domain.
describeSynonymOptions
in interface AmazonCloudSearch
describeSynonymOptionsRequest
- Container for the necessary
parameters to execute the DescribeSynonymOptions service method on
AmazonCloudSearch.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.public DescribeStopwordOptionsResult describeStopwordOptions(DescribeStopwordOptionsRequest describeStopwordOptionsRequest)
Gets the stopwords configured for the search domain.
describeStopwordOptions
in interface AmazonCloudSearch
describeStopwordOptionsRequest
- Container for the necessary
parameters to execute the DescribeStopwordOptions service method on
AmazonCloudSearch.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.public DeleteDomainResult deleteDomain(DeleteDomainRequest deleteDomainRequest)
Permanently deletes a search domain and all of its data.
deleteDomain
in interface AmazonCloudSearch
deleteDomainRequest
- Container for the necessary parameters to
execute the DeleteDomain service method on AmazonCloudSearch.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.public DescribeServiceAccessPoliciesResult describeServiceAccessPolicies(DescribeServiceAccessPoliciesRequest describeServiceAccessPoliciesRequest)
Gets information about the resource-based policies that control access to the domain's document and search services.
describeServiceAccessPolicies
in interface AmazonCloudSearch
describeServiceAccessPoliciesRequest
- Container for the
necessary parameters to execute the DescribeServiceAccessPolicies
service method on AmazonCloudSearch.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.public DescribeDefaultSearchFieldResult describeDefaultSearchField(DescribeDefaultSearchFieldRequest describeDefaultSearchFieldRequest)
Gets the default search field configured for the search domain.
describeDefaultSearchField
in interface AmazonCloudSearch
describeDefaultSearchFieldRequest
- Container for the necessary
parameters to execute the DescribeDefaultSearchField service method on
AmazonCloudSearch.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.public UpdateStopwordOptionsResult updateStopwordOptions(UpdateStopwordOptionsRequest updateStopwordOptionsRequest)
Configures stopwords for the search domain. Stopwords are used during indexing and when processing search requests. The maximum size of the stopwords dictionary is 10 KB.
updateStopwordOptions
in interface AmazonCloudSearch
updateStopwordOptionsRequest
- Container for the necessary
parameters to execute the UpdateStopwordOptions service method on
AmazonCloudSearch.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.public UpdateSynonymOptionsResult updateSynonymOptions(UpdateSynonymOptionsRequest updateSynonymOptionsRequest)
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 100 KB.
updateSynonymOptions
in interface AmazonCloudSearch
updateSynonymOptionsRequest
- Container for the necessary
parameters to execute the UpdateSynonymOptions service method on
AmazonCloudSearch.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.public UpdateStemmingOptionsResult updateStemmingOptions(UpdateStemmingOptionsRequest updateStemmingOptionsRequest)
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 500 KB.
updateStemmingOptions
in interface AmazonCloudSearch
updateStemmingOptionsRequest
- Container for the necessary
parameters to execute the UpdateStemmingOptions service method on
AmazonCloudSearch.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.public DescribeStemmingOptionsResult describeStemmingOptions(DescribeStemmingOptionsRequest describeStemmingOptionsRequest)
Gets the stemming dictionary configured for the search domain.
describeStemmingOptions
in interface AmazonCloudSearch
describeStemmingOptionsRequest
- Container for the necessary
parameters to execute the DescribeStemmingOptions service method on
AmazonCloudSearch.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.public DescribeDomainsResult describeDomains(DescribeDomainsRequest describeDomainsRequest)
Gets information about the search domains owned by this account. Can be limited to specific domains. Shows all domains by default.
describeDomains
in interface AmazonCloudSearch
describeDomainsRequest
- Container for the necessary parameters
to execute the DescribeDomains service method on AmazonCloudSearch.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.public IndexDocumentsResult indexDocuments(IndexDocumentsRequest indexDocumentsRequest)
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.
indexDocuments
in interface AmazonCloudSearch
indexDocumentsRequest
- Container for the necessary parameters to
execute the IndexDocuments service method on AmazonCloudSearch.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.public DescribeIndexFieldsResult describeIndexFields(DescribeIndexFieldsRequest describeIndexFieldsRequest)
Gets information about the index fields configured for the search domain. Can be limited to specific fields by name. Shows all fields by default.
describeIndexFields
in interface AmazonCloudSearch
describeIndexFieldsRequest
- Container for the necessary
parameters to execute the DescribeIndexFields service method on
AmazonCloudSearch.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.public DeleteIndexFieldResult deleteIndexField(DeleteIndexFieldRequest deleteIndexFieldRequest)
Removes an IndexField
from the search domain.
deleteIndexField
in interface AmazonCloudSearch
deleteIndexFieldRequest
- Container for the necessary parameters
to execute the DeleteIndexField service method on AmazonCloudSearch.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.public 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.
describeDomains
in interface AmazonCloudSearch
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.public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
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 the request.
getCachedResponseMetadata
in interface AmazonCloudSearch
request
- The originally executed requestCopyright © 2013 Amazon Web Services, Inc. All Rights Reserved.