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

***********************
put_group_configuration
***********************



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

  

  Attaches a service configuration to the specified group. This occurs asynchronously, and can take time to complete. You can use  GetGroupConfiguration to check the status of the update.

   

  **Minimum permissions**

   

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

   

  
  * ``resource-groups:PutGroupConfiguration``
  

  

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


  **Request Syntax**
  ::

    response = client.put_group_configuration(
        Group='string',
        Configuration=[
            {
                'Type': 'string',
                'Parameters': [
                    {
                        'Name': 'string',
                        'Values': [
                            'string',
                        ]
                    },
                ]
            },
        ]
    )
    
  :type Group: string
  :param Group: 

    The name or Amazon resource name (ARN) of the resource group with the configuration that you want to update.

    

  
  :type Configuration: list
  :param Configuration: 

    The new configuration to associate with the specified group. A configuration associates the resource group with an Amazon Web Services service and specifies how the service can interact with the resources in the group. A configuration is an array of  GroupConfigurationItem elements.

     

    For information about the syntax of a service configuration, see `Service configurations for Resource Groups <https://docs.aws.amazon.com/ARG/latest/APIReference/about-slg.html>`__.

     

    .. note::

      

      A resource group can contain either a ``Configuration`` or a ``ResourceQuery``, but not both.

      

    

  
    - *(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) --* **[REQUIRED]** 

        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) --* **[REQUIRED]** 

            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) --* 

            
        
        
    
    

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

    
    ::

      {}
      
    **Response Structure**

    

    - *(dict) --* 
  
  **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`

  