U W+d5@sXddlZddlmZddlmZddlmZddlmZddl m Z GdddeZ dS) N)json)AWSQueryConnection) RegionInfo)JSONResponseError) exceptionscs4eZdZdZdZdZdZeZe j e j e j e j e je jdZfddZdd Zd d Zd d ZddZddZddZddZddZddZddZddZddZd?d!d"Zd@d#d$ZdAd%d&Z dBd'd(Z!dCd)d*Z"d+d,Z#dDd-d.Z$dEd/d0Z%d1d2Z&d3d4Z'd5d6Z(d7d8Z)d9d:Z*d;d<Z+d=d>Z,Z-S)FCloudSearchConnectionaj Amazon CloudSearch Configuration Service You use the Amazon CloudSearch 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`_. z 2013-01-01z us-east-1z#cloudsearch.us-east-1.amazonaws.com)InvalidTypeExceptionLimitExceededExceptionInternalExceptionDisabledOperationExceptionResourceNotFoundException BaseExceptionc sl|dd}|s t||j|j}d|ks4|ddkr>|j|d<|dd}||_tt|jf|||_ dS)Nregionhost sign_requestF) poprDefaultRegionNameDefaultRegionEndpointZendpointrsuperr__init__r)selfkwargsrr __class__rrr describe_service_access_policies's z6CloudSearchConnection.describe_service_access_policiescCsHd|i}|dk r|||d|dk r6t||d<|jddd|dS) a Gets the suggesters configured for a domain. A suggester enables you to display possible matches before users finish typing their queries. Can be limited to specific suggesters by name. By default, shows all suggesters and includes any pending changes to the configuration. Set the `Deployed` option to `True` to show the active configuration and exclude pending changes. For more information, see `Getting Search Suggestions`_ in the Amazon CloudSearch Developer Guide . :type domain_name: string :param domain_name: The name of the domain you want to describe. :type suggester_names: list :param suggester_names: The suggesters you want to describe. :type deployed: boolean :param deployed: Whether to display the deployed configuration ( `True`) or include any pending changes ( `False`). Defaults to `False`. rNzSuggesterNames.memberr6ZDescribeSuggestersrrr r7)rr(Zsuggester_namesr;r$rrrdescribe_suggestersCs  z)CloudSearchConnection.describe_suggesterscCsd|i}|jddd|dS)aV Tells the search domain to start indexing its documents using the latest indexing options. This operation must be invoked to activate options whose OptionStatus is `RequiresIndexDocuments`. :type domain_name: string :param domain_name: A string that represents the name of a domain. Domain names are unique across the domains owned by an account within an AWS region. Domain names start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen). rZIndexDocumentsrrr r%r'rrrindex_documentshsz%CloudSearchConnection.index_documentscCsi}|jddd|dS)z? Lists all search domains owned by an account. ZListDomainNamesrrr r%)rr$rrrlist_domain_names}sz'CloudSearchConnection.list_domain_namescCs||d}|jddd|dS)a 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 . :type domain_name: string :param domain_name: A string that represents the name of a domain. Domain names are unique across the domains owned by an account within an AWS region. Domain names start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen). :type multi_az: boolean :param multi_az: 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`. )rZMultiAZZUpdateAvailabilityOptionsrrr r%)rr(Zmulti_azr$rrrupdate_availability_optionss z1CloudSearchConnection.update_availability_optionscCs(d|i}||d||jddd|dS)a` Configures scaling parameters for a domain. A domain's scaling parameters specify the desired search instance type and replication count. Amazon CloudSearch will still automatically scale your domain based on the volume of data and traffic, but not below the desired instance type and replication count. If the Multi-AZ option is enabled, these values control the resources used per Availability Zone. For more information, see `Configuring Scaling Options`_ in the Amazon CloudSearch Developer Guide . :type domain_name: string :param domain_name: A string that represents the name of a domain. Domain names are unique across the domains owned by an account within an AWS region. Domain names start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen). :type scaling_parameters: dict :param scaling_parameters: The desired instance type and desired number of replicas of each index partition. rZScalingParametersZUpdateScalingParametersrrr r+)rr(Zscaling_parametersr$rrrupdate_scaling_parameterssz/CloudSearchConnection.update_scaling_parameterscCs||d}|jddd|dS)a Configures the access rules that control access to the domain's document and search endpoints. For more information, see ` Configuring Access for an Amazon CloudSearch Domain`_. :type domain_name: string :param domain_name: A string that represents the name of a domain. Domain names are unique across the domains owned by an account within an AWS region. Domain names start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen). :type access_policies: string :param access_policies: The access rules you want to configure. These rules replace any existing rules. )rZAccessPoliciesZUpdateServiceAccessPoliciesrrr r%)rr(Zaccess_policiesr$rrrupdate_service_access_policiessz4CloudSearchConnection.update_service_access_policiescCs~|D]p\}}t|trD|D]\}}|||d||q"qt|trh|rVdpXd|d||f<q||d||f<qdS)aSerialize a structure. For example:: param_type = 'structure' label = 'IndexField' value = {'IndexFieldName': 'a', 'IntOptions': {'DefaultValue': 5}} would result in the params dict being updated with these params:: IndexField.IndexFieldName = a IndexField.IntOptions.DefaultValue = 5 :type params: dict :param params: The params dict. The complex list params will be added to this dict. :type label: str :param label: String label for param key :type value: any :param value: The value to serialize .truefalsez%s.%sN)items isinstancedictr,bool)rr$labelvaluekvZk2Zv2rrrr,s  z)CloudSearchConnection.build_complex_paramc Csd|d<|j|dd|d}|d}tj||jdkrHt|St|}| di d d}|j ||j } | |j|j |d dS) NZJSONZ ContentTyperrr zutf-8ErrorZCode)body) Z make_requestreaddecodebotologdebugstatusrloadsget_faults ResponseErrorreason) rr!r"r#r$responserYZ json_bodyZ fault_nameZexception_classrrrr&s     z#CloudSearchConnection._make_request)NN)N)N)NN)NN)N)NN).__name__ __module__ __qualname____doc__Z APIVersionrrrrcrrr r r r r rbrrr)r*r-r.r/r0r1r2r3r4r5r<r?r@rArCrDrErFrGrHrIrJrKr,r& __classcell__rrrrrs`  !  &   & &  %  !r) r\Z boto.compatrZboto.connectionrZboto.regioninforZboto.exceptionrZboto.cloudsearch2rrrrrrs