:doc:`CloudSearch <../../cloudsearch>` / Client / update_service_access_policies

******************************
update_service_access_policies
******************************



.. py:method:: CloudSearch.Client.update_service_access_policies(**kwargs)

  

  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 <http://docs.aws.amazon.com/cloudsearch/latest/developerguide/configuring-access.html>`__.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/cloudsearch-2013-01-01/UpdateServiceAccessPolicies>`_  


  **Request Syntax**
  ::

    response = client.update_service_access_policies(
        DomainName='string',
        AccessPolicies='string'
    )
    
  :type DomainName: string
  :param DomainName: **[REQUIRED]** 

    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 AccessPolicies: string
  :param AccessPolicies: **[REQUIRED]** 

    The access rules you want to configure. These rules replace any existing rules.

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'AccessPolicies': {
              'Options': 'string',
              'Status': {
                  'CreationDate': datetime(2015, 1, 1),
                  'UpdateDate': datetime(2015, 1, 1),
                  'UpdateVersion': 123,
                  'State': 'RequiresIndexDocuments'|'Processing'|'Active'|'FailedToValidate',
                  'PendingDeletion': True|False
              }
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 

      The result of an ``UpdateServiceAccessPolicies`` request. Contains the new access policies.

      
      

      - **AccessPolicies** *(dict) --* 

        The access rules configured for the domain.

        
        

        - **Options** *(string) --* 

          Access rules for a domain's document or search service endpoints. For more information, see `Configuring Access for a Search Domain <http://docs.aws.amazon.com/cloudsearch/latest/developerguide/configuring-access.html>`__ in the *Amazon CloudSearch Developer Guide*. The maximum size of a policy document is 100 KB.

          
        

        - **Status** *(dict) --* 

          The status of domain configuration option.

          
          

          - **CreationDate** *(datetime) --* 

            A timestamp for when this option was created.

            
          

          - **UpdateDate** *(datetime) --* 

            A timestamp for when this option was last updated.

            
          

          - **UpdateVersion** *(integer) --* 

            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 deployed until  IndexDocuments has been called and indexing is complete.
             
            * ``Processing``: the option's latest value is in the process of being activated.
             
            * ``Active``: the option's latest value is completely deployed.
             
            * ``FailedToValidate``: the option value is not compatible with the domain's data and cannot be used to index the data. You must either modify the option value or update or remove the incompatible documents.
            

            
          

          - **PendingDeletion** *(boolean) --* 

            Indicates that the option will be deleted once processing is complete.

            
      
    
  
  **Exceptions**
  
  *   :py:class:`CloudSearch.Client.exceptions.BaseException`

  
  *   :py:class:`CloudSearch.Client.exceptions.InternalException`

  
  *   :py:class:`CloudSearch.Client.exceptions.LimitExceededException`

  
  *   :py:class:`CloudSearch.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`CloudSearch.Client.exceptions.InvalidTypeException`

  
  *   :py:class:`CloudSearch.Client.exceptions.ValidationException`

  