:doc:`QBusiness <../../qbusiness>` / Client / update_application

******************
update_application
******************



.. py:method:: QBusiness.Client.update_application(**kwargs)

  

  Updates an existing Amazon Q Business application.

   

  .. note::

    

    Amazon Q Business applications may securely transmit data for processing across Amazon Web Services Regions within your geography. For more information, see `Cross region inference in Amazon Q Business <https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/cross-region-inference.html>`__.

    

   

  .. note::

    

    An Amazon Q Apps service-linked role will be created if it's absent in the Amazon Web Services account when ``QAppsConfiguration`` is enabled in the request. For more information, see `Using service-linked roles for Q Apps <https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/using-service-linked-roles-qapps.html>`__.

    

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/qbusiness-2023-11-27/UpdateApplication>`_  


  **Request Syntax**
  ::

    response = client.update_application(
        applicationId='string',
        identityCenterInstanceArn='string',
        displayName='string',
        description='string',
        roleArn='string',
        attachmentsConfiguration={
            'attachmentsControlMode': 'ENABLED'|'DISABLED'
        },
        qAppsConfiguration={
            'qAppsControlMode': 'ENABLED'|'DISABLED'
        },
        personalizationConfiguration={
            'personalizationControlMode': 'ENABLED'|'DISABLED'
        },
        autoSubscriptionConfiguration={
            'autoSubscribe': 'ENABLED'|'DISABLED',
            'defaultSubscriptionType': 'Q_LITE'|'Q_BUSINESS'
        }
    )
    
  :type applicationId: string
  :param applicationId: **[REQUIRED]** 

    The identifier of the Amazon Q Business application.

    

  
  :type identityCenterInstanceArn: string
  :param identityCenterInstanceArn: 

    The Amazon Resource Name (ARN) of the IAM Identity Center instance you are either creating for—or connecting to—your Amazon Q Business application.

    

  
  :type displayName: string
  :param displayName: 

    A name for the Amazon Q Business application.

    

  
  :type description: string
  :param description: 

    A description for the Amazon Q Business application.

    

  
  :type roleArn: string
  :param roleArn: 

    An Amazon Web Services Identity and Access Management (IAM) role that gives Amazon Q Business permission to access Amazon CloudWatch logs and metrics.

    

  
  :type attachmentsConfiguration: dict
  :param attachmentsConfiguration: 

    An option to allow end users to upload files directly during chat.

    

  
    - **attachmentsControlMode** *(string) --* **[REQUIRED]** 

      Status information about whether file upload functionality is activated or deactivated for your end user.

      

    
  
  :type qAppsConfiguration: dict
  :param qAppsConfiguration: 

    An option to allow end users to create and use Amazon Q Apps in the web experience.

    

  
    - **qAppsControlMode** *(string) --* **[REQUIRED]** 

      Status information about whether end users can create and use Amazon Q Apps in the web experience.

      

    
  
  :type personalizationConfiguration: dict
  :param personalizationConfiguration: 

    Configuration information about chat response personalization. For more information, see `Personalizing chat responses <https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/personalizing-chat-responses.html>`__.

    

  
    - **personalizationControlMode** *(string) --* **[REQUIRED]** 

      An option to allow Amazon Q Business to customize chat responses using user specific metadata—specifically, location and job information—in your IAM Identity Center instance.

      

    
  
  :type autoSubscriptionConfiguration: dict
  :param autoSubscriptionConfiguration: 

    An option to enable updating the default subscription type assigned to an Amazon Q Business application using IAM identity federation for user management.

    

  
    - **autoSubscribe** *(string) --* **[REQUIRED]** 

      Describes whether automatic subscriptions are enabled for an Amazon Q Business application using IAM identity federation for user management.

      

    
    - **defaultSubscriptionType** *(string) --* 

      Describes the default subscription type assigned to an Amazon Q Business application using IAM identity federation for user management. If the value for ``autoSubscribe`` is set to ``ENABLED`` you must select a value for this field.

      

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

    
    ::

      {}
      
    **Response Structure**

    

    - *(dict) --* 
  
  **Exceptions**
  
  *   :py:class:`QBusiness.Client.exceptions.InternalServerException`

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

  
  *   :py:class:`QBusiness.Client.exceptions.ConflictException`

  
  *   :py:class:`QBusiness.Client.exceptions.ThrottlingException`

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

  
  *   :py:class:`QBusiness.Client.exceptions.AccessDeniedException`

  