:doc:`DirectoryService <../../ds>` / Client / describe_settings

*****************
describe_settings
*****************



.. py:method:: DirectoryService.Client.describe_settings(**kwargs)

  

  Retrieves information about the configurable settings for the specified directory.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/ds-2015-04-16/DescribeSettings>`_  


  **Request Syntax**
  ::

    response = client.describe_settings(
        DirectoryId='string',
        Status='Requested'|'Updating'|'Updated'|'Failed'|'Default',
        NextToken='string'
    )
    
  :type DirectoryId: string
  :param DirectoryId: **[REQUIRED]** 

    The identifier of the directory for which to retrieve information.

    

  
  :type Status: string
  :param Status: 

    The status of the directory settings for which to retrieve information.

    

  
  :type NextToken: string
  :param NextToken: 

    The ``DescribeSettingsResult.NextToken`` value from a previous call to  DescribeSettings. Pass null if this is the first call.

    

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

    
    ::

      {
          'DirectoryId': 'string',
          'SettingEntries': [
              {
                  'Type': 'string',
                  'Name': 'string',
                  'AllowedValues': 'string',
                  'AppliedValue': 'string',
                  'RequestedValue': 'string',
                  'RequestStatus': 'Requested'|'Updating'|'Updated'|'Failed'|'Default',
                  'RequestDetailedStatus': {
                      'string': 'Requested'|'Updating'|'Updated'|'Failed'|'Default'
                  },
                  'RequestStatusMessage': 'string',
                  'LastUpdatedDateTime': datetime(2015, 1, 1),
                  'LastRequestedDateTime': datetime(2015, 1, 1),
                  'DataType': 'string'
              },
          ],
          'NextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **DirectoryId** *(string) --* 

        The identifier of the directory.

        
      

      - **SettingEntries** *(list) --* 

        The list of  SettingEntry objects that were retrieved.

         

        It is possible that this list contains less than the number of items specified in the ``Limit`` member of the request. This occurs if there are less than the requested number of items left to retrieve, or if the limitations of the operation have been exceeded.

        
        

        - *(dict) --* 

          Contains information about the specified configurable setting for a directory.

          
          

          - **Type** *(string) --* 

            The type, or category, of a directory setting. Similar settings have the same type. For example, ``Protocol``, ``Cipher``, or ``Certificate-Based Authentication``.

            
          

          - **Name** *(string) --* 

            The name of the directory setting. For example:

             

            ``TLS_1_0``

            
          

          - **AllowedValues** *(string) --* 

            The valid range of values for the directory setting. These values depend on the ``DataType`` of your directory.

            
          

          - **AppliedValue** *(string) --* 

            The value of the directory setting that is applied to the directory.

            
          

          - **RequestedValue** *(string) --* 

            The value that was last requested for the directory setting.

            
          

          - **RequestStatus** *(string) --* 

            The overall status of the request to update the directory setting request. If the directory setting is deployed in more than one region, and the request fails in any region, the overall status is ``Failed``.

            
          

          - **RequestDetailedStatus** *(dict) --* 

            Details about the status of the request to update the directory setting. If the directory setting is deployed in more than one region, status is returned for the request in each region where the setting is deployed.

            
            

            - *(string) --* 
              

              - *(string) --* 
        
      
          

          - **RequestStatusMessage** *(string) --* 

            The last status message for the directory status request.

            
          

          - **LastUpdatedDateTime** *(datetime) --* 

            The date and time when the directory setting was last updated.

            
          

          - **LastRequestedDateTime** *(datetime) --* 

            The date and time when the request to update a directory setting was last submitted.

            
          

          - **DataType** *(string) --* 

            The data type of a directory setting. This is used to define the ``AllowedValues`` of a setting. For example a data type can be ``Boolean``, ``DurationInSeconds``, or ``Enum``.

            
      
    
      

      - **NextToken** *(string) --* 

        If not null, token that indicates that more results are available. Pass this value for the ``NextToken`` parameter in a subsequent call to ``DescribeSettings`` to retrieve the next set of items.

        
  
  **Exceptions**
  
  *   :py:class:`DirectoryService.Client.exceptions.DirectoryDoesNotExistException`

  
  *   :py:class:`DirectoryService.Client.exceptions.UnsupportedOperationException`

  
  *   :py:class:`DirectoryService.Client.exceptions.InvalidParameterException`

  
  *   :py:class:`DirectoryService.Client.exceptions.InvalidNextTokenException`

  
  *   :py:class:`DirectoryService.Client.exceptions.ClientException`

  
  *   :py:class:`DirectoryService.Client.exceptions.ServiceException`

  