:doc:`SSOAdmin <../../sso-admin>` / Client / update_instance

***************
update_instance
***************



.. py:method:: SSOAdmin.Client.update_instance(**kwargs)

  

  Update the details for the instance of IAM Identity Center that is owned by the Amazon Web Services account.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/sso-admin-2020-07-20/UpdateInstance>`_  


  **Request Syntax**
  ::

    response = client.update_instance(
        Name='string',
        InstanceArn='string',
        EncryptionConfiguration={
            'KeyType': 'AWS_OWNED_KMS_KEY'|'CUSTOMER_MANAGED_KEY',
            'KmsKeyArn': 'string'
        }
    )
    
  :type Name: string
  :param Name: 

    Updates the instance name.

    

  
  :type InstanceArn: string
  :param InstanceArn: **[REQUIRED]** 

    The ARN of the instance of IAM Identity Center under which the operation will run. For more information about ARNs, see `Amazon Resource Names (ARNs) and Amazon Web Services Service Namespaces </general/latest/gr/aws-arns-and-namespaces.html>`__ in the *Amazon Web Services General Reference*.

    

  
  :type EncryptionConfiguration: dict
  :param EncryptionConfiguration: 

    Specifies the encryption configuration for your IAM Identity Center instance. You can use this to configure customer managed KMS keys or Amazon Web Services owned KMS keys for encrypting your instance data.

    

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

      The type of KMS key used for encryption.

      

    
    - **KmsKeyArn** *(string) --* 

      The ARN of the KMS key used to encrypt data. Required when KeyType is CUSTOMER_MANAGED_KEY. Cannot be specified when KeyType is AWS_OWNED_KMS_KEY.

      

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

    
    ::

      {}
      
    **Response Structure**

    

    - *(dict) --* 
  
  **Exceptions**
  
  *   :py:class:`SSOAdmin.Client.exceptions.ThrottlingException`

  
  *   :py:class:`SSOAdmin.Client.exceptions.InternalServerException`

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

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

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

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

  