:doc:`ResourceGroups <../../resource-groups>` / Client / get_group_configuration

***********************
get_group_configuration
***********************



.. py:method:: ResourceGroups.Client.get_group_configuration(**kwargs)

  

  Retrieves the service configuration associated with the specified resource group. For details about the service configuration syntax, see `Service configurations for Resource Groups <https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html>`__.

   

  **Minimum permissions**

   

  To run this command, you must have the following permissions:

   

  
  * ``resource-groups:GetGroupConfiguration``
  

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/GetGroupConfiguration>`_  


  **Request Syntax**
  ::

    response = client.get_group_configuration(
        Group='string'
    )
    
  :type Group: string
  :param Group: 

    The name or the Amazon resource name (ARN) of the resource group for which you want to retrive the service configuration.

    

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

    
    ::

      {
          'GroupConfiguration': {
              'Configuration': [
                  {
                      'Type': 'string',
                      'Parameters': [
                          {
                              'Name': 'string',
                              'Values': [
                                  'string',
                              ]
                          },
                      ]
                  },
              ],
              'ProposedConfiguration': [
                  {
                      'Type': 'string',
                      'Parameters': [
                          {
                              'Name': 'string',
                              'Values': [
                                  'string',
                              ]
                          },
                      ]
                  },
              ],
              'Status': 'UPDATING'|'UPDATE_COMPLETE'|'UPDATE_FAILED',
              'FailureReason': 'string'
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **GroupConfiguration** *(dict) --* 

        A structure that describes the service configuration attached with the specified group. For details about the service configuration syntax, see `Service configurations for Resource Groups <https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html>`__.

        
        

        - **Configuration** *(list) --* 

          The configuration currently associated with the group and in effect.

          
          

          - *(dict) --* 

            An item in a group configuration. A group service configuration can have one or more items. For details about group service configuration syntax, see `Service configurations for resource groups <https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html>`__.

            
            

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

              Specifies the type of group configuration item. Each item must have a unique value for ``type``. For the list of types that you can specify for a configuration item, see `Supported resource types and parameters <https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html#about-slg-types>`__.

              
            

            - **Parameters** *(list) --* 

              A collection of parameters for this group configuration item. For the list of parameters that you can use with each configuration item type, see `Supported resource types and parameters <https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html#about-slg-types>`__.

              
              

              - *(dict) --* 

                A parameter for a group configuration item. For details about group service configuration syntax, see `Service configurations for resource groups <https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html>`__.

                
                

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

                  The name of the group configuration parameter. For the list of parameters that you can use with each configuration item type, see `Supported resource types and parameters <https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html#about-slg-types>`__.

                  
                

                - **Values** *(list) --* 

                  The value or values to be used for the specified parameter. For the list of values you can use with each parameter, see `Supported resource types and parameters <https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html#about-slg-types>`__.

                  
                  

                  - *(string) --* 
              
            
          
        
      
        

        - **ProposedConfiguration** *(list) --* 

          If present, the new configuration that is in the process of being applied to the group.

          
          

          - *(dict) --* 

            An item in a group configuration. A group service configuration can have one or more items. For details about group service configuration syntax, see `Service configurations for resource groups <https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html>`__.

            
            

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

              Specifies the type of group configuration item. Each item must have a unique value for ``type``. For the list of types that you can specify for a configuration item, see `Supported resource types and parameters <https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html#about-slg-types>`__.

              
            

            - **Parameters** *(list) --* 

              A collection of parameters for this group configuration item. For the list of parameters that you can use with each configuration item type, see `Supported resource types and parameters <https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html#about-slg-types>`__.

              
              

              - *(dict) --* 

                A parameter for a group configuration item. For details about group service configuration syntax, see `Service configurations for resource groups <https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html>`__.

                
                

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

                  The name of the group configuration parameter. For the list of parameters that you can use with each configuration item type, see `Supported resource types and parameters <https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html#about-slg-types>`__.

                  
                

                - **Values** *(list) --* 

                  The value or values to be used for the specified parameter. For the list of values you can use with each parameter, see `Supported resource types and parameters <https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html#about-slg-types>`__.

                  
                  

                  - *(string) --* 
              
            
          
        
      
        

        - **Status** *(string) --* 

          The current status of an attempt to update the group configuration.

          
        

        - **FailureReason** *(string) --* 

          If present, the reason why a request to update the group configuration failed.

          
    
  
  **Exceptions**
  
  *   :py:class:`ResourceGroups.Client.exceptions.BadRequestException`

  
  *   :py:class:`ResourceGroups.Client.exceptions.ForbiddenException`

  
  *   :py:class:`ResourceGroups.Client.exceptions.NotFoundException`

  
  *   :py:class:`ResourceGroups.Client.exceptions.MethodNotAllowedException`

  
  *   :py:class:`ResourceGroups.Client.exceptions.TooManyRequestsException`

  
  *   :py:class:`ResourceGroups.Client.exceptions.InternalServerErrorException`

  