Class CloudSearchClient
Client to interact with Amazon CloudSearch
- Guzzle\Common\AbstractHasDispatcher implements Guzzle\Common\HasDispatcherInterface
- Guzzle\Http\Client implements Guzzle\Http\ClientInterface
- Guzzle\Service\Client implements Guzzle\Service\ClientInterface
- Aws\Common\Client\AbstractClient implements Aws\Common\Client\AwsClientInterface
- Aws\CloudSearch_2011_02_01\CloudSearchClient
Link: User guide
Link: API docs
Located at Aws/CloudSearch_2011_02_01/CloudSearchClient.php
Methods summary
-
public static
factory ( array|Collection $config = array() )
Factory method to create a new Amazon CloudSearch client using an array of configuration options.
-
public
createDomain ( array $args = array() )
Executes the CreateDomain operation.
-
public
defineIndexField ( array $args = array() )
Executes the DefineIndexField operation.
-
public
defineRankExpression ( array $args = array() )
Executes the DefineRankExpression operation.
-
public
deleteDomain ( array $args = array() )
Executes the DeleteDomain operation.
-
public
deleteIndexField ( array $args = array() )
Executes the DeleteIndexField operation.
-
public
deleteRankExpression ( array $args = array() )
Executes the DeleteRankExpression operation.
-
public
describeAvailabilityOptions ( array $args = array() )
Executes the DescribeAvailabilityOptions operation.
-
public
describeDefaultSearchField ( array $args = array() )
Executes the DescribeDefaultSearchField operation.
-
public
describeDomains ( array $args = array() )
Executes the DescribeDomains operation.
-
public
describeIndexFields ( array $args = array() )
Executes the DescribeIndexFields operation.
-
public
describeRankExpressions ( array $args = array() )
Executes the DescribeRankExpressions operation.
-
public
describeServiceAccessPolicies ( array $args = array() )
Executes the DescribeServiceAccessPolicies operation.
-
public
describeStemmingOptions ( array $args = array() )
Executes the DescribeStemmingOptions operation.
-
public
describeStopwordOptions ( array $args = array() )
Executes the DescribeStopwordOptions operation.
-
public
describeSynonymOptions ( array $args = array() )
Executes the DescribeSynonymOptions operation.
-
public
indexDocuments ( array $args = array() )
Executes the IndexDocuments operation.
-
public
updateAvailabilityOptions ( array $args = array() )
Executes the UpdateAvailabilityOptions operation.
-
public
updateDefaultSearchField ( array $args = array() )
Executes the UpdateDefaultSearchField operation.
-
public
updateServiceAccessPolicies ( array $args = array() )
Executes the UpdateServiceAccessPolicies operation.
-
public
updateStemmingOptions ( array $args = array() )
Executes the UpdateStemmingOptions operation.
-
public
updateStopwordOptions ( array $args = array() )
Executes the UpdateStopwordOptions operation.
-
public
updateSynonymOptions ( array $args = array() )
Executes the UpdateSynonymOptions operation.
-
public
getDescribeDomainsIterator ( array $args = array() )
The input array uses the parameters of the DescribeDomains operation
-
public
getDescribeIndexFieldsIterator ( array $args = array() )
The input array uses the parameters of the DescribeIndexFields operation
-
public
getDescribeRankExpressionsIterator ( array $args = array() )
The input array uses the parameters of the DescribeRankExpressions operation
Methods detail
public static
Aws\CloudSearch_2011_02_01\CloudSearchClient
factory( array|Guzzle\Common\Collection
$config = array() )
Factory method to create a new Amazon CloudSearch client using an array of configuration options.
See http://docs.aws.amazon.com/aws-sdk-php/v2/guide/configuration.html#client-configuration-options
Parameters
- $config
array|
Guzzle\Common\Collection
$config Client configuration data
Returns
Link
Overrides
Executes the CreateDomain operation.
Creates a new search domain.
Examples
- Basic formatting example
$result = $client->createDomain(array( // DomainName is required 'DomainName' => 'string', ));
Parameters
- $args
array
$arg Associative array containing the following keys (required keys are bold):-
DomainName => (string)A string that represents the name of a domain. Domain names must be unique across the domains owned by an account within an AWS region. Domain names must start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen). Uppercase letters and underscores are not allowed.
-
Returns
Guzzle\Service\Resource\Model
Returns a response Model object
-
DomainStatus => (associative-array)The current status of the search domain.
-
DomainId => (string)An internally generated unique identifier for a domain.
-
DomainName => (string)A string that represents the name of a domain. Domain names must be unique across the domains owned by an account within an AWS region. Domain names must start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen). Uppercase letters and underscores are not allowed.
-
Created => (bool)True if the search domain is created. It can take several minutes to initialize a domain when CreateDomain is called. Newly created search domains are returned from DescribeDomains with a false value for Created until domain creation is complete.
-
Deleted => (bool)True if the search domain has been deleted. The system must clean up resources dedicated to the search domain when DeleteDomain is called. Newly deleted search domains are returned from DescribeDomains with a true value for IsDeleted for several minutes until resource cleanup is complete.
-
NumSearchableDocs => (int)The number of documents that have been submitted to the domain and indexed.
-
DocService => (associative-array)The service endpoint for updating documents in a search domain.
-
Arn => (string)An Amazon Resource Name (ARN). See Identifiers for IAM Entities in Using AWS Identity and Access Management for more information.
-
Endpoint => (string)The URL (including /version/pathPrefix) to which service requests can be submitted.
-
-
SearchService => (associative-array)The service endpoint for requesting search results from a search domain.
-
Arn => (string)An Amazon Resource Name (ARN). See Identifiers for IAM Entities in Using AWS Identity and Access Management for more information.
-
Endpoint => (string)The URL (including /version/pathPrefix) to which service requests can be submitted.
-
-
RequiresIndexDocuments => (bool)True if IndexDocuments needs to be called to activate the current domain configuration.
-
Processing => (bool)True if processing is being done to activate the current domain configuration.
-
SearchInstanceType => (string)The instance type (such as search.m1.small) that is being used to process search requests.
-
SearchPartitionCount => (int)The number of partitions across which the search index is spread.
-
SearchInstanceCount => (int)The number of search instances that are available to process search requests.
-
Executes the DefineIndexField operation.
Configures an
Examples
- Basic formatting example
$result = $client->defineIndexField(array( // DomainName is required 'DomainName' => 'string', // IndexField is required 'IndexField' => array( // IndexFieldName is required 'IndexFieldName' => 'string', // IndexFieldType is required 'IndexFieldType' => 'string', 'IntOptions' => array( 'DefaultValue' => integer, 'SourceField' => 'string', 'FacetEnabled' => true || false, 'SearchEnabled' => true || false, 'ReturnEnabled' => true || false, 'SortEnabled' => true || false, ), 'DoubleOptions' => array( 'DefaultValue' => integer, 'SourceField' => 'string', 'FacetEnabled' => true || false, 'SearchEnabled' => true || false, 'ReturnEnabled' => true || false, 'SortEnabled' => true || false, ), 'LiteralOptions' => array( 'DefaultValue' => 'string', 'SourceField' => 'string', 'FacetEnabled' => true || false, 'SearchEnabled' => true || false, 'ReturnEnabled' => true || false, 'SortEnabled' => true || false, ), 'TextOptions' => array( 'DefaultValue' => 'string', 'SourceField' => 'string', 'ReturnEnabled' => true || false, 'SortEnabled' => true || false, 'HighlightEnabled' => true || false, 'AnalysisScheme' => 'string', ), 'DateOptions' => array( 'DefaultValue' => 'string', 'SourceField' => 'string', 'FacetEnabled' => true || false, 'SearchEnabled' => true || false, 'ReturnEnabled' => true || false, 'SortEnabled' => true || false, ), 'LatLonOptions' => array( 'DefaultValue' => 'string', 'SourceField' => 'string', 'FacetEnabled' => true || false, 'SearchEnabled' => true || false, 'ReturnEnabled' => true || false, 'SortEnabled' => true || false, ), 'IntArrayOptions' => array( 'DefaultValue' => integer, 'SourceFields' => 'string', 'FacetEnabled' => true || false, 'SearchEnabled' => true || false, 'ReturnEnabled' => true || false, ), 'DoubleArrayOptions' => array( 'DefaultValue' => integer, 'SourceFields' => 'string', 'FacetEnabled' => true || false, 'SearchEnabled' => true || false, 'ReturnEnabled' => true || false, ), 'LiteralArrayOptions' => array( 'DefaultValue' => 'string', 'SourceFields' => 'string', 'FacetEnabled' => true || false, 'SearchEnabled' => true || false, 'ReturnEnabled' => true || false, ), 'TextArrayOptions' => array( 'DefaultValue' => 'string', 'SourceFields' => 'string', 'ReturnEnabled' => true || false, 'HighlightEnabled' => true || false, 'AnalysisScheme' => 'string', ), 'DateArrayOptions' => array( 'DefaultValue' => 'string', 'SourceFields' => 'string', 'FacetEnabled' => true || false, 'SearchEnabled' => true || false, 'ReturnEnabled' => true || false, ), ), ));
Parameters
- $args
array
$arg Associative array containing the following keys (required keys are bold):-
DomainName => (string)A string that represents the name of a domain. Domain names must be unique across the domains owned by an account within an AWS region. Domain names must start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen). Uppercase letters and underscores are not allowed.
-
IndexField => (associative-array)Defines a field in the index, including its name, type, and the source of its data. The IndexFieldType indicates which of the options will be present. It is invalid to specify options for a type other than the IndexFieldType.
-
IndexFieldName => (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.
-
IndexFieldType => (string:uint |literal |text )The type of field. Based on this type, exactly one of the UIntOptions, LiteralOptions or TextOptions must be present.
-
UIntOptions => (associative-array)Options for an unsigned integer field. Present if IndexFieldType specifies the field is of type unsigned integer.
-
DefaultValue => (int)The default value for an unsigned integer field. Optional.
-
-
LiteralOptions => (associative-array)Options for literal field. Present if IndexFieldType specifies the field is of type literal.
-
DefaultValue => (string)The default value for a literal field. Optional.
-
SearchEnabled => (bool)Specifies whether search is enabled for this field. Default: False.
-
FacetEnabled => (bool)Specifies whether facets are enabled for this field. Default: False.
-
ResultEnabled => (bool)Specifies whether values of this field can be returned in search results and used for ranking. Default: False.
-
-
TextOptions => (associative-array)Options for text field. Present if IndexFieldType specifies the field is of type text.
-
DefaultValue => (string)The default value for a text field. Optional.
-
FacetEnabled => (bool)Specifies whether facets are enabled for this field. Default: False.
-
ResultEnabled => (bool)Specifies whether values of this field can be returned in search results and used for ranking. Default: False.
-
TextProcessor => (string)The text processor to apply to this field. Optional. Possible values:
- cs_text_no_stemming: turns off stemming for the field.
Default: none
-
-
SourceAttributes => (array<associative-array>)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.
- (associative-array)
Identifies the source data for an index field. An optional data transformation can be applied to the source data when populating the index field. By default, the value of the source attribute is copied to the index field.
-
SourceDataFunction => (string:Copy |TrimTitle |Map )Identifies the transformation to apply when copying data from a source attribute.
-
SourceDataCopy => (associative-array)Copies data from a source document attribute to an IndexField.
-
SourceName => (string)The name of the document source field to add to this IndexField.
-
DefaultValue => (string)The default value to use if the source attribute is not specified in a document. Optional.
-
-
SourceDataTrimTitle => (associative-array)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.
-
SourceName => (string)The name of the document source field to add to this IndexField.
-
DefaultValue => (string)The default value to use if the source attribute is not specified in a document. Optional.
-
Separator => (string)The separator that follows the text to trim.
-
Language => (string)
-
-
SourceDataMap => (associative-array)Maps source document attribute values to new values when populating the IndexField.
-
SourceName => (string)The name of the document source field to add to this IndexField.
-
DefaultValue => (string)The default value to use if the source attribute is not specified in a document. Optional.
-
Cases => (associative-array<string>)Associative array of <FieldValue> keys mapping to (string) values. Each array key should be changed to an appropriate <FieldValue>.
A map that translates source field values to custom values.
-
<FieldValue> => (string)The value of a field or source document attribute.
-
-
-
- (associative-array)
-
-
Returns
Guzzle\Service\Resource\Model
Returns a response Model object
-
IndexField => (associative-array)The value of an IndexField and its current status.
-
Options => (associative-array)Defines a field in the index, including its name, type, and the source of its data. The IndexFieldType indicates which of the options will be present. It is invalid to specify options for a type other than the IndexFieldType.
-
IndexFieldName => (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.
-
IndexFieldType => (string)The type of field. Based on this type, exactly one of the UIntOptions, LiteralOptions or TextOptions must be present.
-
UIntOptions => (associative-array)Options for an unsigned integer field. Present if IndexFieldType specifies the field is of type unsigned integer.
-
DefaultValue => (int)The default value for an unsigned integer field. Optional.
-
-
LiteralOptions => (associative-array)Options for literal field. Present if IndexFieldType specifies the field is of type literal.
-
DefaultValue => (string)The default value for a literal field. Optional.
-
SearchEnabled => (bool)Specifies whether search is enabled for this field. Default: False.
-
FacetEnabled => (bool)Specifies whether facets are enabled for this field. Default: False.
-
ResultEnabled => (bool)Specifies whether values of this field can be returned in search results and used for ranking. Default: False.
-
-
TextOptions => (associative-array)Options for text field. Present if IndexFieldType specifies the field is of type text.
-
DefaultValue => (string)The default value for a text field. Optional.
-
FacetEnabled => (bool)Specifies whether facets are enabled for this field. Default: False.
-
ResultEnabled => (bool)Specifies whether values of this field can be returned in search results and used for ranking. Default: False.
-
TextProcessor => (string)The text processor to apply to this field. Optional. Possible values:
- cs_text_no_stemming: turns off stemming for the field.
Default: none
-
-
SourceAttributes => (array<associative-array>)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.
- (associative-array)
Identifies the source data for an index field. An optional data transformation can be applied to the source data when populating the index field. By default, the value of the source attribute is copied to the index field.
-
SourceDataFunction => (string)Identifies the transformation to apply when copying data from a source attribute.
-
SourceDataCopy => (associative-array)Copies data from a source document attribute to an IndexField.
-
SourceName => (string)The name of the document source field to add to this IndexField.
-
DefaultValue => (string)The default value to use if the source attribute is not specified in a document. Optional.
-
-
SourceDataTrimTitle => (associative-array)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.
-
SourceName => (string)The name of the document source field to add to this IndexField.
-
DefaultValue => (string)The default value to use if the source attribute is not specified in a document. Optional.
-
Separator => (string)The separator that follows the text to trim.
-
Language => (string)
-
-
SourceDataMap => (associative-array)Maps source document attribute values to new values when populating the IndexField.
-
SourceName => (string)The name of the document source field to add to this IndexField.
-
DefaultValue => (string)The default value to use if the source attribute is not specified in a document. Optional.
-
Cases => (array<associative-array>)A map that translates source field values to custom values.
- (associative-array)
-
key => (string) -
value => (string)The value of a field or source document attribute.
-
- (associative-array)
-
-
- (associative-array)
-
-
Status => (associative-array)The status of an option, including when it was last updated and whether it is actively in use for searches.
-
CreationDate => (string)A timestamp for when this option was created.
-
UpdateDate => (string)A timestamp for when this option was last updated.
-
UpdateVersion => (int)A unique integer that indicates when this option was last updated.
-
State => (string)The state of processing a change to an option. Possible values:
- RequiresIndexDocuments: the option's latest value will not be visible in searches until IndexDocuments has been called and indexing is complete.
- Processing: the option's latest value is not yet visible in all searches but is in the process of being activated.
- Active: the option's latest value is completely visible. Any warnings or messages generated during processing are provided in Diagnostics.
-
PendingDeletion => (bool)Indicates that the option will be deleted once processing is complete.
-
-
Executes the DefineRankExpression operation.
Configures a
Parameters
- $args
array
$arg Associative array containing the following keys (required keys are bold):-
DomainName => (string)A string that represents the name of a domain. Domain names must be unique across the domains owned by an account within an AWS region. Domain names must start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen). Uppercase letters and underscores are not allowed.
-
RankExpression => (associative-array)A named expression that can be evaluated at search time and used for ranking or thresholding in a search query.
-
RankName => (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.
-
RankExpression => (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 evaluating b at all
- JavaScript order of precedence 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), 4294967295. 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
Guzzle\Service\Resource\Model
Returns a response Model object
-
RankExpression => (associative-array)The value of a RankExpression and its current status.
-
Options => (associative-array)The expression that is evaluated for ranking or thresholding while processing a search request.
-
RankName => (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.
-
RankExpression => (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 evaluating b at all
- JavaScript order of precedence 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), 4294967295. 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.
-
-
Status => (associative-array)The status of an option, including when it was last updated and whether it is actively in use for searches.
-
CreationDate => (string)A timestamp for when this option was created.
-
UpdateDate => (string)A timestamp for when this option was last updated.
-
UpdateVersion => (int)A unique integer that indicates when this option was last updated.
-
State => (string)The state of processing a change to an option. Possible values:
- RequiresIndexDocuments: the option's latest value will not be visible in searches until IndexDocuments has been called and indexing is complete.
- Processing: the option's latest value is not yet visible in all searches but is in the process of being activated.
- Active: the option's latest value is completely visible. Any warnings or messages generated during processing are provided in Diagnostics.
-
PendingDeletion => (bool)Indicates that the option will be deleted once processing is complete.
-
-
Executes the DeleteDomain operation.
Permanently deletes a search domain and all of its data.
Examples
- Basic formatting example
$result = $client->deleteDomain(array( // DomainName is required 'DomainName' => 'string', ));
Parameters
- $args
array
$arg Associative array containing the following keys (required keys are bold):-
DomainName => (string)A string that represents the name of a domain. Domain names must be unique across the domains owned by an account within an AWS region. Domain names must start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen). Uppercase letters and underscores are not allowed.
-
Returns
Guzzle\Service\Resource\Model
Returns a response Model object
-
DomainStatus => (associative-array)The current status of the search domain.
-
DomainId => (string)An internally generated unique identifier for a domain.
-
DomainName => (string)A string that represents the name of a domain. Domain names must be unique across the domains owned by an account within an AWS region. Domain names must start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen). Uppercase letters and underscores are not allowed.
-
Created => (bool)True if the search domain is created. It can take several minutes to initialize a domain when CreateDomain is called. Newly created search domains are returned from DescribeDomains with a false value for Created until domain creation is complete.
-
Deleted => (bool)True if the search domain has been deleted. The system must clean up resources dedicated to the search domain when DeleteDomain is called. Newly deleted search domains are returned from DescribeDomains with a true value for IsDeleted for several minutes until resource cleanup is complete.
-
NumSearchableDocs => (int)The number of documents that have been submitted to the domain and indexed.
-
DocService => (associative-array)The service endpoint for updating documents in a search domain.
-
Arn => (string)An Amazon Resource Name (ARN). See Identifiers for IAM Entities in Using AWS Identity and Access Management for more information.
-
Endpoint => (string)The URL (including /version/pathPrefix) to which service requests can be submitted.
-
-
SearchService => (associative-array)The service endpoint for requesting search results from a search domain.
-
Arn => (string)An Amazon Resource Name (ARN). See Identifiers for IAM Entities in Using AWS Identity and Access Management for more information.
-
Endpoint => (string)The URL (including /version/pathPrefix) to which service requests can be submitted.
-
-
RequiresIndexDocuments => (bool)True if IndexDocuments needs to be called to activate the current domain configuration.
-
Processing => (bool)True if processing is being done to activate the current domain configuration.
-
SearchInstanceType => (string)The instance type (such as search.m1.small) that is being used to process search requests.
-
SearchPartitionCount => (int)The number of partitions across which the search index is spread.
-
SearchInstanceCount => (int)The number of search instances that are available to process search requests.
-
Executes the DeleteIndexField operation.
Removes an
Examples
- Basic formatting example
$result = $client->deleteIndexField(array( // DomainName is required 'DomainName' => 'string', // IndexFieldName is required 'IndexFieldName' => 'string', ));
Parameters
- $args
array
$arg Associative array containing the following keys (required keys are bold):-
DomainName => (string)A string that represents the name of a domain. Domain names must be unique across the domains owned by an account within an AWS region. Domain names must start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen). Uppercase letters and underscores are not allowed.
-
IndexFieldName => (string)A string that represents the name of an index field. 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.
-
Returns
Guzzle\Service\Resource\Model
Returns a response Model object
-
IndexField => (associative-array)The value of an IndexField and its current status.
-
Options => (associative-array)Defines a field in the index, including its name, type, and the source of its data. The IndexFieldType indicates which of the options will be present. It is invalid to specify options for a type other than the IndexFieldType.
-
IndexFieldName => (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.
-
IndexFieldType => (string)The type of field. Based on this type, exactly one of the UIntOptions, LiteralOptions or TextOptions must be present.
-
UIntOptions => (associative-array)Options for an unsigned integer field. Present if IndexFieldType specifies the field is of type unsigned integer.
-
DefaultValue => (int)The default value for an unsigned integer field. Optional.
-
-
LiteralOptions => (associative-array)Options for literal field. Present if IndexFieldType specifies the field is of type literal.
-
DefaultValue => (string)The default value for a literal field. Optional.
-
SearchEnabled => (bool)Specifies whether search is enabled for this field. Default: False.
-
FacetEnabled => (bool)Specifies whether facets are enabled for this field. Default: False.
-
ResultEnabled => (bool)Specifies whether values of this field can be returned in search results and used for ranking. Default: False.
-
-
TextOptions => (associative-array)Options for text field. Present if IndexFieldType specifies the field is of type text.
-
DefaultValue => (string)The default value for a text field. Optional.
-
FacetEnabled => (bool)Specifies whether facets are enabled for this field. Default: False.
-
ResultEnabled => (bool)Specifies whether values of this field can be returned in search results and used for ranking. Default: False.
-
TextProcessor => (string)The text processor to apply to this field. Optional. Possible values:
- cs_text_no_stemming: turns off stemming for the field.
Default: none
-
-
SourceAttributes => (array<associative-array>)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.
- (associative-array)
Identifies the source data for an index field. An optional data transformation can be applied to the source data when populating the index field. By default, the value of the source attribute is copied to the index field.
-
SourceDataFunction => (string)Identifies the transformation to apply when copying data from a source attribute.
-
SourceDataCopy => (associative-array)Copies data from a source document attribute to an IndexField.
-
SourceName => (string)The name of the document source field to add to this IndexField.
-
DefaultValue => (string)The default value to use if the source attribute is not specified in a document. Optional.
-
-
SourceDataTrimTitle => (associative-array)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.
-
SourceName => (string)The name of the document source field to add to this IndexField.
-
DefaultValue => (string)The default value to use if the source attribute is not specified in a document. Optional.
-
Separator => (string)The separator that follows the text to trim.
-
Language => (string)
-
-
SourceDataMap => (associative-array)Maps source document attribute values to new values when populating the IndexField.
-
SourceName => (string)The name of the document source field to add to this IndexField.
-
DefaultValue => (string)The default value to use if the source attribute is not specified in a document. Optional.
-
Cases => (array<associative-array>)A map that translates source field values to custom values.
- (associative-array)
-
key => (string) -
value => (string)The value of a field or source document attribute.
-
- (associative-array)
-
-
- (associative-array)
-
-
Status => (associative-array)The status of an option, including when it was last updated and whether it is actively in use for searches.
-
CreationDate => (string)A timestamp for when this option was created.
-
UpdateDate => (string)A timestamp for when this option was last updated.
-
UpdateVersion => (int)A unique integer that indicates when this option was last updated.
-
State => (string)The state of processing a change to an option. Possible values:
- RequiresIndexDocuments: the option's latest value will not be visible in searches until IndexDocuments has been called and indexing is complete.
- Processing: the option's latest value is not yet visible in all searches but is in the process of being activated.
- Active: the option's latest value is completely visible. Any warnings or messages generated during processing are provided in Diagnostics.
-
PendingDeletion => (bool)Indicates that the option will be deleted once processing is complete.
-
-
Executes the DeleteRankExpression operation.
Removes a
Parameters
- $args
array
$arg Associative array containing the following keys (required keys are bold):-
DomainName => (string)A string that represents the name of a domain. Domain names must be unique across the domains owned by an account within an AWS region. Domain names must start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen). Uppercase letters and underscores are not allowed.
-
RankName => (string)The name of the RankExpression to delete.
-
Returns
Guzzle\Service\Resource\Model
Returns a response Model object
-
RankExpression => (associative-array)The value of a RankExpression and its current status.
-
Options => (associative-array)The expression that is evaluated for ranking or thresholding while processing a search request.
-
RankName => (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.
-
RankExpression => (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 evaluating b at all
- JavaScript order of precedence 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), 4294967295. 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.
-
-
Status => (associative-array)The status of an option, including when it was last updated and whether it is actively in use for searches.
-
CreationDate => (string)A timestamp for when this option was created.
-
UpdateDate => (string)A timestamp for when this option was last updated.
-
UpdateVersion => (int)A unique integer that indicates when this option was last updated.
-
State => (string)The state of processing a change to an option. Possible values:
- RequiresIndexDocuments: the option's latest value will not be visible in searches until IndexDocuments has been called and indexing is complete.
- Processing: the option's latest value is not yet visible in all searches but is in the process of being activated.
- Active: the option's latest value is completely visible. Any warnings or messages generated during processing are provided in Diagnostics.
-
PendingDeletion => (bool)Indicates that the option will be deleted once processing is complete.
-
-
Executes the DescribeAvailabilityOptions operation.
Gets the availability options configured for a domain. By default, shows the
configuration with any pending changes. Set the
Examples
- Basic formatting example
$result = $client->describeAvailabilityOptions(array( // DomainName is required 'DomainName' => 'string', 'Deployed' => true || false, ));
Parameters
- $args
array
$arg Associative array containing the following keys (required keys are bold):-
DomainName => (string)The name of the domain you want to describe.
-
Returns
Guzzle\Service\Resource\Model
Returns a response Model object
-
AvailabilityOptions => (associative-array)The availability options configured for the domain. Indicates whether Multi-AZ is enabled for the domain.
-
Options => (bool)The availability options configured for the domain.
-
Status => (associative-array)The status of an option, including when it was last updated and whether it is actively in use for searches.
-
CreationDate => (string)A timestamp for when this option was created.
-
UpdateDate => (string)A timestamp for when this option was last updated.
-
UpdateVersion => (int)A unique integer that indicates when this option was last updated.
-
State => (string)The state of processing a change to an option. Possible values:
- RequiresIndexDocuments: the option's latest value will not be visible in searches until IndexDocuments has been called and indexing is complete.
- Processing: the option's latest value is not yet visible in all searches but is in the process of being activated.
- Active: the option's latest value is completely visible. Any warnings or messages generated during processing are provided in Diagnostics.
-
PendingDeletion => (bool)Indicates that the option will be deleted once processing is complete.
-
-
Executes the DescribeDefaultSearchField operation.
Gets the default search field configured for the search domain.
Parameters
- $args
array
$arg Associative array containing the following keys (required keys are bold):-
DomainName => (string)A string that represents the name of a domain. Domain names must be unique across the domains owned by an account within an AWS region. Domain names must start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen). Uppercase letters and underscores are not allowed.
-
Returns
Guzzle\Service\Resource\Model
Returns a response Model object
-
DefaultSearchField => (associative-array)The name of the IndexField to use for search requests issued with the q parameter. The default is the empty string, which automatically searches all text fields.
-
Options => (string)The name of the IndexField to use as the default search field. The default is an empty string, which automatically searches all text fields.
-
Status => (associative-array)The status of an option, including when it was last updated and whether it is actively in use for searches.
-
CreationDate => (string)A timestamp for when this option was created.
-
UpdateDate => (string)A timestamp for when this option was last updated.
-
UpdateVersion => (int)A unique integer that indicates when this option was last updated.
-
State => (string)The state of processing a change to an option. Possible values:
- RequiresIndexDocuments: the option's latest value will not be visible in searches until IndexDocuments has been called and indexing is complete.
- Processing: the option's latest value is not yet visible in all searches but is in the process of being activated.
- Active: the option's latest value is completely visible. Any warnings or messages generated during processing are provided in Diagnostics.
-
PendingDeletion => (bool)Indicates that the option will be deleted once processing is complete.
-
-
Executes the DescribeDomains operation.
Gets information about the search domains owned by this account. Can be limited to specific domains. Shows all domains by default.
Examples
- Basic formatting example
$result = $client->describeDomains(array( 'DomainNames' => array('string', ... ), ));
Parameters
- $args
array
$arg Associative array containing the following keys (required keys are bold):-
DomainNames => (array<string>)Limits the DescribeDomains response to the specified search domains.
A string that represents the name of a domain. Domain names must be unique across the domains owned by an account within an AWS region. Domain names must start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen). Uppercase letters and underscores are not allowed.
-
Returns
Guzzle\Service\Resource\Model
Returns a response Model object
-
DomainStatusList => (array<associative-array>)The current status of all of your search domains.
- (associative-array)
The current status of the search domain.
-
DomainId => (string)An internally generated unique identifier for a domain.
-
DomainName => (string)A string that represents the name of a domain. Domain names must be unique across the domains owned by an account within an AWS region. Domain names must start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen). Uppercase letters and underscores are not allowed.
-
Created => (bool)True if the search domain is created. It can take several minutes to initialize a domain when CreateDomain is called. Newly created search domains are returned from DescribeDomains with a false value for Created until domain creation is complete.
-
Deleted => (bool)True if the search domain has been deleted. The system must clean up resources dedicated to the search domain when DeleteDomain is called. Newly deleted search domains are returned from DescribeDomains with a true value for IsDeleted for several minutes until resource cleanup is complete.
-
NumSearchableDocs => (int)The number of documents that have been submitted to the domain and indexed.
-
DocService => (associative-array)The service endpoint for updating documents in a search domain.
-
Arn => (string)An Amazon Resource Name (ARN). See Identifiers for IAM Entities in Using AWS Identity and Access Management for more information.
-
Endpoint => (string)The URL (including /version/pathPrefix) to which service requests can be submitted.
-
-
SearchService => (associative-array)The service endpoint for requesting search results from a search domain.
-
Arn => (string)An Amazon Resource Name (ARN). See Identifiers for IAM Entities in Using AWS Identity and Access Management for more information.
-
Endpoint => (string)The URL (including /version/pathPrefix) to which service requests can be submitted.
-
-
RequiresIndexDocuments => (bool)True if IndexDocuments needs to be called to activate the current domain configuration.
-
Processing => (bool)True if processing is being done to activate the current domain configuration.
-
SearchInstanceType => (string)The instance type (such as search.m1.small) that is being used to process search requests.
-
SearchPartitionCount => (int)The number of partitions across which the search index is spread.
-
SearchInstanceCount => (int)The number of search instances that are available to process search requests.
-
- (associative-array)
Executes the DescribeIndexFields operation.
Gets information about the index fields configured for the search domain. Can be limited to specific fields by name. Shows all fields by default.
Examples
- Basic formatting example
$result = $client->describeIndexFields(array( // DomainName is required 'DomainName' => 'string', 'FieldNames' => array('string', ... ), 'Deployed' => true || false, ));
Parameters
- $args
array
$arg Associative array containing the following keys (required keys are bold):-
DomainName => (string)A string that represents the name of a domain. Domain names must be unique across the domains owned by an account within an AWS region. Domain names must start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen). Uppercase letters and underscores are not allowed.
-
FieldNames => (array<string>)Limits the DescribeIndexFields response to the specified fields.
A string that represents the name of an index field. 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.
-
Returns
Guzzle\Service\Resource\Model
Returns a response Model object
-
IndexFields => (array<associative-array>)The index fields configured for the domain.
- (associative-array)
The value of an IndexField and its current status.
-
Options => (associative-array)Defines a field in the index, including its name, type, and the source of its data. The IndexFieldType indicates which of the options will be present. It is invalid to specify options for a type other than the IndexFieldType.
-
IndexFieldName => (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.
-
IndexFieldType => (string)The type of field. Based on this type, exactly one of the UIntOptions, LiteralOptions or TextOptions must be present.
-
UIntOptions => (associative-array)Options for an unsigned integer field. Present if IndexFieldType specifies the field is of type unsigned integer.
-
DefaultValue => (int)The default value for an unsigned integer field. Optional.
-
-
LiteralOptions => (associative-array)Options for literal field. Present if IndexFieldType specifies the field is of type literal.
-
DefaultValue => (string)The default value for a literal field. Optional.
-
SearchEnabled => (bool)Specifies whether search is enabled for this field. Default: False.
-
FacetEnabled => (bool)Specifies whether facets are enabled for this field. Default: False.
-
ResultEnabled => (bool)Specifies whether values of this field can be returned in search results and used for ranking. Default: False.
-
-
TextOptions => (associative-array)Options for text field. Present if IndexFieldType specifies the field is of type text.
-
DefaultValue => (string)The default value for a text field. Optional.
-
FacetEnabled => (bool)Specifies whether facets are enabled for this field. Default: False.
-
ResultEnabled => (bool)Specifies whether values of this field can be returned in search results and used for ranking. Default: False.
-
TextProcessor => (string)The text processor to apply to this field. Optional. Possible values:
- cs_text_no_stemming: turns off stemming for the field.
Default: none
-
-
SourceAttributes => (array<associative-array>)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.
- (associative-array)
Identifies the source data for an index field. An optional data transformation can be applied to the source data when populating the index field. By default, the value of the source attribute is copied to the index field.
-
SourceDataFunction => (string)Identifies the transformation to apply when copying data from a source attribute.
-
SourceDataCopy => (associative-array)Copies data from a source document attribute to an IndexField.
-
SourceName => (string)The name of the document source field to add to this IndexField.
-
DefaultValue => (string)The default value to use if the source attribute is not specified in a document. Optional.
-
-
SourceDataTrimTitle => (associative-array)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.
-
SourceName => (string)The name of the document source field to add to this IndexField.
-
DefaultValue => (string)The default value to use if the source attribute is not specified in a document. Optional.
-
Separator => (string)The separator that follows the text to trim.
-
Language => (string)
-
-
SourceDataMap => (associative-array)Maps source document attribute values to new values when populating the IndexField.
-
SourceName => (string)The name of the document source field to add to this IndexField.
-
DefaultValue => (string)The default value to use if the source attribute is not specified in a document. Optional.
-
Cases => (array<associative-array>)A map that translates source field values to custom values.
- (associative-array)
-
key => (string) -
value => (string)The value of a field or source document attribute.
-
- (associative-array)
-
-
- (associative-array)
-
-
Status => (associative-array)The status of an option, including when it was last updated and whether it is actively in use for searches.
-
CreationDate => (string)A timestamp for when this option was created.
-
UpdateDate => (string)A timestamp for when this option was last updated.
-
UpdateVersion => (int)A unique integer that indicates when this option was last updated.
-
State => (string)The state of processing a change to an option. Possible values:
- RequiresIndexDocuments: the option's latest value will not be visible in searches until IndexDocuments has been called and indexing is complete.
- Processing: the option's latest value is not yet visible in all searches but is in the process of being activated.
- Active: the option's latest value is completely visible. Any warnings or messages generated during processing are provided in Diagnostics.
-
PendingDeletion => (bool)Indicates that the option will be deleted once processing is complete.
-
-
- (associative-array)
Executes the DescribeRankExpressions operation.
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
- $args
array
$arg Associative array containing the following keys (required keys are bold):-
DomainName => (string)A string that represents the name of a domain. Domain names must be unique across the domains owned by an account within an AWS region. Domain names must start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen). Uppercase letters and underscores are not allowed.
-
RankNames => (array<string>)Limits the DescribeRankExpressions response to the specified fields.
A string that represents the name of an index field. 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.
-
Returns
Guzzle\Service\Resource\Model
Returns a response Model object
-
RankExpressions => (array<associative-array>)The rank expressions configured for the domain.
- (associative-array)
The value of a RankExpression and its current status.
-
Options => (associative-array)The expression that is evaluated for ranking or thresholding while processing a search request.
-
RankName => (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.
-
RankExpression => (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 evaluating b at all
- JavaScript order of precedence 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), 4294967295. 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.
-
-
Status => (associative-array)The status of an option, including when it was last updated and whether it is actively in use for searches.
-
CreationDate => (string)A timestamp for when this option was created.
-
UpdateDate => (string)A timestamp for when this option was last updated.
-
UpdateVersion => (int)A unique integer that indicates when this option was last updated.
-
State => (string)The state of processing a change to an option. Possible values:
- RequiresIndexDocuments: the option's latest value will not be visible in searches until IndexDocuments has been called and indexing is complete.
- Processing: the option's latest value is not yet visible in all searches but is in the process of being activated.
- Active: the option's latest value is completely visible. Any warnings or messages generated during processing are provided in Diagnostics.
-
PendingDeletion => (bool)Indicates that the option will be deleted once processing is complete.
-
-
- (associative-array)
Executes the DescribeServiceAccessPolicies operation.
Gets information about the resource-based policies that control access to the domain's document and search services.
Examples
- Basic formatting example
$result = $client->describeServiceAccessPolicies(array( // DomainName is required 'DomainName' => 'string', 'Deployed' => true || false, ));
Parameters
- $args
array
$arg Associative array containing the following keys (required keys are bold):-
DomainName => (string)A string that represents the name of a domain. Domain names must be unique across the domains owned by an account within an AWS region. Domain names must start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen). Uppercase letters and underscores are not allowed.
-
Returns
Guzzle\Service\Resource\Model
Returns a response Model object
-
AccessPolicies => (associative-array)A PolicyDocument that specifies access policies for the search domain's services, and the current status of those policies.
-
Options => (string)An IAM access policy as described in The Access Policy Language in Using AWS Identity and Access Management. The maximum size of an access policy document is 100 KB.
-
Status => (associative-array)The status of an option, including when it was last updated and whether it is actively in use for searches.
-
CreationDate => (string)A timestamp for when this option was created.
-
UpdateDate => (string)A timestamp for when this option was last updated.
-
UpdateVersion => (int)A unique integer that indicates when this option was last updated.
-
State => (string)The state of processing a change to an option. Possible values:
- RequiresIndexDocuments: the option's latest value will not be visible in searches until IndexDocuments has been called and indexing is complete.
- Processing: the option's latest value is not yet visible in all searches but is in the process of being activated.
- Active: the option's latest value is completely visible. Any warnings or messages generated during processing are provided in Diagnostics.
-
PendingDeletion => (bool)Indicates that the option will be deleted once processing is complete.
-
-
Executes the DescribeStemmingOptions operation.
Gets the stemming dictionary configured for the search domain.
Parameters
- $args
array
$arg Associative array containing the following keys (required keys are bold):-
DomainName => (string)A string that represents the name of a domain. Domain names must be unique across the domains owned by an account within an AWS region. Domain names must start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen). Uppercase letters and underscores are not allowed.
-
Returns
Guzzle\Service\Resource\Model
Returns a response Model object
-
Stems => (associative-array)The stemming options configured for this search domain and the current status of those options.
-
Options => (string)Maps terms to their stems, serialized as a JSON document. The document has a single object with one property "stems" whose value is an object mapping terms to their stems. The maximum size of a stemming document is 500 KB. Example: { "stems": {"people": "person", "walking": "walk"} }
-
Status => (associative-array)The status of an option, including when it was last updated and whether it is actively in use for searches.
-
CreationDate => (string)A timestamp for when this option was created.
-
UpdateDate => (string)A timestamp for when this option was last updated.
-
UpdateVersion => (int)A unique integer that indicates when this option was last updated.
-
State => (string)The state of processing a change to an option. Possible values:
- RequiresIndexDocuments: the option's latest value will not be visible in searches until IndexDocuments has been called and indexing is complete.
- Processing: the option's latest value is not yet visible in all searches but is in the process of being activated.
- Active: the option's latest value is completely visible. Any warnings or messages generated during processing are provided in Diagnostics.
-
PendingDeletion => (bool)Indicates that the option will be deleted once processing is complete.
-
-
Executes the DescribeStopwordOptions operation.
Gets the stopwords configured for the search domain.
Parameters
- $args
array
$arg Associative array containing the following keys (required keys are bold):-
DomainName => (string)A string that represents the name of a domain. Domain names must be unique across the domains owned by an account within an AWS region. Domain names must start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen). Uppercase letters and underscores are not allowed.
-
Returns
Guzzle\Service\Resource\Model
Returns a response Model object
-
Stopwords => (associative-array)The stopword options configured for this search domain and the current status of those options.
-
Options => (string)Lists stopwords serialized as a JSON document. The document has a single object with one property "stopwords" whose value is an array of strings. The maximum size of a stopwords document is 10 KB. Example: { "stopwords": ["a", "an", "the", "of"] }
-
Status => (associative-array)The status of an option, including when it was last updated and whether it is actively in use for searches.
-
CreationDate => (string)A timestamp for when this option was created.
-
UpdateDate => (string)A timestamp for when this option was last updated.
-
UpdateVersion => (int)A unique integer that indicates when this option was last updated.
-
State => (string)The state of processing a change to an option. Possible values:
- RequiresIndexDocuments: the option's latest value will not be visible in searches until IndexDocuments has been called and indexing is complete.
- Processing: the option's latest value is not yet visible in all searches but is in the process of being activated.
- Active: the option's latest value is completely visible. Any warnings or messages generated during processing are provided in Diagnostics.
-
PendingDeletion => (bool)Indicates that the option will be deleted once processing is complete.
-
-
Executes the DescribeSynonymOptions operation.
Gets the synonym dictionary configured for the search domain.
Parameters
- $args
array
$arg Associative array containing the following keys (required keys are bold):-
DomainName => (string)A string that represents the name of a domain. Domain names must be unique across the domains owned by an account within an AWS region. Domain names must start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen). Uppercase letters and underscores are not allowed.
-
Returns
Guzzle\Service\Resource\Model
Returns a response Model object
-
Synonyms => (associative-array)The synonym options configured for this search domain and the current status of those options.
-
Options => (string)Maps terms to their synonyms, serialized as a JSON document. The document has a single object with one property "synonyms" whose value is an object mapping terms to their synonyms. Each synonym is a simple string or an array of strings. The maximum size of a stopwords document is 100 KB. Example: { "synonyms": {"cat": ["feline", "kitten"], "puppy": "dog"} }
-
Status => (associative-array)The status of an option, including when it was last updated and whether it is actively in use for searches.
-
CreationDate => (string)A timestamp for when this option was created.
-
UpdateDate => (string)A timestamp for when this option was last updated.
-
UpdateVersion => (int)A unique integer that indicates when this option was last updated.
-
State => (string)The state of processing a change to an option. Possible values:
- RequiresIndexDocuments: the option's latest value will not be visible in searches until IndexDocuments has been called and indexing is complete.
- Processing: the option's latest value is not yet visible in all searches but is in the process of being activated.
- Active: the option's latest value is completely visible. Any warnings or messages generated during processing are provided in Diagnostics.
-
PendingDeletion => (bool)Indicates that the option will be deleted once processing is complete.
-
-
Executes the IndexDocuments operation.
Tells the search domain to start indexing its documents using the latest text
processing options and
Examples
- Basic formatting example
$result = $client->indexDocuments(array( // DomainName is required 'DomainName' => 'string', ));
Parameters
- $args
array
$arg Associative array containing the following keys (required keys are bold):-
DomainName => (string)A string that represents the name of a domain. Domain names must be unique across the domains owned by an account within an AWS region. Domain names must start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen). Uppercase letters and underscores are not allowed.
-
Returns
Guzzle\Service\Resource\Model
Returns a response Model object
-
FieldNames => (array<string>)The names of the fields that are currently being processed due to an IndexDocuments action.
A string that represents the name of an index field. 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.
Executes the UpdateAvailabilityOptions operation.
Configures the availability options for a domain. Enabling the Multi-AZ option expands an Amazon CloudSearch domain to an additional Availability Zone in the same Region to increase fault tolerance in the event of a service disruption. Changes to the Multi-AZ option can take about half an hour to become active. For more information, see Configuring Availability Options in the Amazon CloudSearch Developer Guide.
Examples
- Basic formatting example
$result = $client->updateAvailabilityOptions(array( // DomainName is required 'DomainName' => 'string', // MultiAZ is required 'MultiAZ' => true || false, ));
Parameters
- $args
array
$arg Associative array containing the following keys (required keys are bold):-
DomainName => (string)A string that represents the name of a domain. Domain names must be unique across the domains owned by an account within an AWS region. Domain names must start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen). Uppercase letters and underscores are not allowed.
-
MultiAZ => (bool)You expand an existing search domain to a second Availability Zone by setting the Multi-AZ option to true. Similarly, you can turn off the Multi-AZ option to downgrade the domain to a single Availability Zone by setting the Multi-AZ option to false.
-
Returns
Guzzle\Service\Resource\Model
Returns a response Model object
-
AvailabilityOptions => (associative-array)The newly-configured availability options. Indicates whether Multi-AZ is enabled for the domain.
-
Options => (bool)The availability options configured for the domain.
-
Status => (associative-array)The status of an option, including when it was last updated and whether it is actively in use for searches.
-
CreationDate => (string)A timestamp for when this option was created.
-
UpdateDate => (string)A timestamp for when this option was last updated.
-
UpdateVersion => (int)A unique integer that indicates when this option was last updated.
-
State => (string)The state of processing a change to an option. Possible values:
- RequiresIndexDocuments: the option's latest value will not be visible in searches until IndexDocuments has been called and indexing is complete.
- Processing: the option's latest value is not yet visible in all searches but is in the process of being activated.
- Active: the option's latest value is completely visible. Any warnings or messages generated during processing are provided in Diagnostics.
-
PendingDeletion => (bool)Indicates that the option will be deleted once processing is complete.
-
-
Executes the UpdateDefaultSearchField operation.
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.
Parameters
- $args
array
$arg Associative array containing the following keys (required keys are bold):-
DomainName => (string)A string that represents the name of a domain. Domain names must be unique across the domains owned by an account within an AWS region. Domain names must start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen). Uppercase letters and underscores are not allowed.
-
DefaultSearchField => (string)The text field to search if the search request does not specify which field to search. The default search field is used when search terms are specified with the q parameter, or if a match expression specified with the bq parameter does not constrain the search to a particular field. The default is an empty string, which automatically searches all text fields.
-
Returns
Guzzle\Service\Resource\Model
Returns a response Model object
-
DefaultSearchField => (associative-array)The value of the DefaultSearchField configured for this search domain and its current status.
-
Options => (string)The name of the IndexField to use as the default search field. The default is an empty string, which automatically searches all text fields.
-
Status => (associative-array)The status of an option, including when it was last updated and whether it is actively in use for searches.
-
CreationDate => (string)A timestamp for when this option was created.
-
UpdateDate => (string)A timestamp for when this option was last updated.
-
UpdateVersion => (int)A unique integer that indicates when this option was last updated.
-
State => (string)The state of processing a change to an option. Possible values:
- RequiresIndexDocuments: the option's latest value will not be visible in searches until IndexDocuments has been called and indexing is complete.
- Processing: the option's latest value is not yet visible in all searches but is in the process of being activated.
- Active: the option's latest value is completely visible. Any warnings or messages generated during processing are provided in Diagnostics.
-
PendingDeletion => (bool)Indicates that the option will be deleted once processing is complete.
-
-
Executes the UpdateServiceAccessPolicies operation.
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.
Examples
- Basic formatting example
$result = $client->updateServiceAccessPolicies(array( // DomainName is required 'DomainName' => 'string', // AccessPolicies is required 'AccessPolicies' => 'string', ));
Parameters
- $args
array
$arg Associative array containing the following keys (required keys are bold):-
DomainName => (string)A string that represents the name of a domain. Domain names must be unique across the domains owned by an account within an AWS region. Domain names must start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen). Uppercase letters and underscores are not allowed.
-
AccessPolicies => (string)An IAM access policy as described in The Access Policy Language in Using AWS Identity and Access Management. The maximum size of an access policy document is 100 KB.
-
Returns
Guzzle\Service\Resource\Model
Returns a response Model object
-
AccessPolicies => (associative-array)A PolicyDocument that specifies access policies for the search domain's services, and the current status of those policies.
-
Options => (string)An IAM access policy as described in The Access Policy Language in Using AWS Identity and Access Management. The maximum size of an access policy document is 100 KB.
-
Status => (associative-array)The status of an option, including when it was last updated and whether it is actively in use for searches.
-
CreationDate => (string)A timestamp for when this option was created.
-
UpdateDate => (string)A timestamp for when this option was last updated.
-
UpdateVersion => (int)A unique integer that indicates when this option was last updated.
-
State => (string)The state of processing a change to an option. Possible values:
- RequiresIndexDocuments: the option's latest value will not be visible in searches until IndexDocuments has been called and indexing is complete.
- Processing: the option's latest value is not yet visible in all searches but is in the process of being activated.
- Active: the option's latest value is completely visible. Any warnings or messages generated during processing are provided in Diagnostics.
-
PendingDeletion => (bool)Indicates that the option will be deleted once processing is complete.
-
-
Executes the UpdateStemmingOptions operation.
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.
Parameters
- $args
array
$arg Associative array containing the following keys (required keys are bold):-
DomainName => (string)A string that represents the name of a domain. Domain names must be unique across the domains owned by an account within an AWS region. Domain names must start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen). Uppercase letters and underscores are not allowed.
-
Stems => (string)Maps terms to their stems, serialized as a JSON document. The document has a single object with one property "stems" whose value is an object mapping terms to their stems. The maximum size of a stemming document is 500 KB. Example: { "stems": {"people": "person", "walking": "walk"} }
-
Returns
Guzzle\Service\Resource\Model
Returns a response Model object
-
Stems => (associative-array)The stemming options configured for this search domain and the current status of those options.
-
Options => (string)Maps terms to their stems, serialized as a JSON document. The document has a single object with one property "stems" whose value is an object mapping terms to their stems. The maximum size of a stemming document is 500 KB. Example: { "stems": {"people": "person", "walking": "walk"} }
-
Status => (associative-array)The status of an option, including when it was last updated and whether it is actively in use for searches.
-
CreationDate => (string)A timestamp for when this option was created.
-
UpdateDate => (string)A timestamp for when this option was last updated.
-
UpdateVersion => (int)A unique integer that indicates when this option was last updated.
-
State => (string)The state of processing a change to an option. Possible values:
- RequiresIndexDocuments: the option's latest value will not be visible in searches until IndexDocuments has been called and indexing is complete.
- Processing: the option's latest value is not yet visible in all searches but is in the process of being activated.
- Active: the option's latest value is completely visible. Any warnings or messages generated during processing are provided in Diagnostics.
-
PendingDeletion => (bool)Indicates that the option will be deleted once processing is complete.
-
-
Executes the UpdateStopwordOptions operation.
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.
Parameters
- $args
array
$arg Associative array containing the following keys (required keys are bold):-
DomainName => (string)A string that represents the name of a domain. Domain names must be unique across the domains owned by an account within an AWS region. Domain names must start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen). Uppercase letters and underscores are not allowed.
-
Stopwords => (string)Lists stopwords serialized as a JSON document. The document has a single object with one property "stopwords" whose value is an array of strings. The maximum size of a stopwords document is 10 KB. Example: { "stopwords": ["a", "an", "the", "of"] }
-
Returns
Guzzle\Service\Resource\Model
Returns a response Model object
-
Stopwords => (associative-array)The stopword options configured for this search domain and the current status of those options.
-
Options => (string)Lists stopwords serialized as a JSON document. The document has a single object with one property "stopwords" whose value is an array of strings. The maximum size of a stopwords document is 10 KB. Example: { "stopwords": ["a", "an", "the", "of"] }
-
Status => (associative-array)The status of an option, including when it was last updated and whether it is actively in use for searches.
-
CreationDate => (string)A timestamp for when this option was created.
-
UpdateDate => (string)A timestamp for when this option was last updated.
-
UpdateVersion => (int)A unique integer that indicates when this option was last updated.
-
State => (string)The state of processing a change to an option. Possible values:
- RequiresIndexDocuments: the option's latest value will not be visible in searches until IndexDocuments has been called and indexing is complete.
- Processing: the option's latest value is not yet visible in all searches but is in the process of being activated.
- Active: the option's latest value is completely visible. Any warnings or messages generated during processing are provided in Diagnostics.
-
PendingDeletion => (bool)Indicates that the option will be deleted once processing is complete.
-
-
Executes the UpdateSynonymOptions operation.
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.
Parameters
- $args
array
$arg Associative array containing the following keys (required keys are bold):-
DomainName => (string)A string that represents the name of a domain. Domain names must be unique across the domains owned by an account within an AWS region. Domain names must start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen). Uppercase letters and underscores are not allowed.
-
Synonyms => (string)Maps terms to their synonyms, serialized as a JSON document. The document has a single object with one property "synonyms" whose value is an object mapping terms to their synonyms. Each synonym is a simple string or an array of strings. The maximum size of a stopwords document is 100 KB. Example: { "synonyms": {"cat": ["feline", "kitten"], "puppy": "dog"} }
-
Returns
Guzzle\Service\Resource\Model
Returns a response Model object
-
Synonyms => (associative-array)The synonym options configured for this search domain and the current status of those options.
-
Options => (string)Maps terms to their synonyms, serialized as a JSON document. The document has a single object with one property "synonyms" whose value is an object mapping terms to their synonyms. Each synonym is a simple string or an array of strings. The maximum size of a stopwords document is 100 KB. Example: { "synonyms": {"cat": ["feline", "kitten"], "puppy": "dog"} }
-
Status => (associative-array)The status of an option, including when it was last updated and whether it is actively in use for searches.
-
CreationDate => (string)A timestamp for when this option was created.
-
UpdateDate => (string)A timestamp for when this option was last updated.
-
UpdateVersion => (int)A unique integer that indicates when this option was last updated.
-
State => (string)The state of processing a change to an option. Possible values:
- RequiresIndexDocuments: the option's latest value will not be visible in searches until IndexDocuments has been called and indexing is complete.
- Processing: the option's latest value is not yet visible in all searches but is in the process of being activated.
- Active: the option's latest value is completely visible. Any warnings or messages generated during processing are provided in Diagnostics.
-
PendingDeletion => (bool)Indicates that the option will be deleted once processing is complete.
-
-
The input array uses the parameters of the DescribeDomains operation
Parameters
- $args
array
$args
Returns
ResourceIteratorInterface
The input array uses the parameters of the DescribeIndexFields operation
Parameters
- $args
array
$args
Returns
ResourceIteratorInterface
The input array uses the parameters of the DescribeRankExpressions operation
Parameters
- $args
array
$args
Returns
ResourceIteratorInterface
Methods inherited from Aws\Common\Client\AbstractClient
__call()
,
__construct()
,
createRequest()
,
getAllEvents()
,
getApiVersion()
,
getCredentials()
,
getRegion()
,
getRegions()
,
getSignature()
,
getWaiter()
,
getWaiterFactory()
,
send()
,
setCredentials()
,
setRegion()
,
setWaiterFactory()
,
waitUntil()
Methods inherited from Guzzle\Service\Client
execute()
,
executeMultiple()
,
getCommand()
,
getCommandFactory()
,
getDescription()
,
getInflector()
,
getIterator()
,
getResourceIteratorFactory()
,
prepareCommand()
,
setCommandFactory()
,
setDescription()
,
setInflector()
,
setResourceIteratorFactory()
Methods inherited from Guzzle\Http\Client
delete()
,
expandTemplate()
,
extractPharCacert()
,
get()
,
getBaseUrl()
,
getConfig()
,
getCurlMulti()
,
getDefaultOption()
,
getDefaultUserAgent()
,
getUriTemplate()
,
head()
,
initSsl()
,
options()
,
patch()
,
post()
,
prepareRequest()
,
put()
,
sendMultiple()
,
setBaseUrl()
,
setConfig()
,
setCurlMulti()
,
setDefaultOption()
,
setRequestFactory()
,
setSslVerification()
,
setUriTemplate()
,
setUserAgent()
Methods inherited from Guzzle\Common\AbstractHasDispatcher
addSubscriber()
,
dispatch()
,
getEventDispatcher()
,
setEventDispatcher()
Magic methods summary
Constants summary
string |
LATEST_API_VERSION |
'2011-02-01' |
Constants inherited from Guzzle\Service\Client
Constants inherited from Guzzle\Http\Client
CURL_OPTIONS
,
DEFAULT_SELECT_TIMEOUT
,
DISABLE_REDIRECTS
,
MAX_HANDLES
,
REQUEST_OPTIONS
,
SSL_CERT_AUTHORITY
Constants inherited from Guzzle\Http\ClientInterface
Properties summary
Properties inherited from Aws\Common\Client\AbstractClient
$aggregator
,
$credentials
,
$signature
,
$waiterFactory
Properties inherited from Guzzle\Service\Client
$commandFactory
,
$inflector
,
$resourceIteratorFactory
,
$serviceDescription
Properties inherited from Guzzle\Http\Client
$defaultHeaders
,
$requestFactory
,
$userAgent