:doc:`Redshift <../../redshift>` / Client / modify_lakehouse_configuration

******************************
modify_lakehouse_configuration
******************************



.. py:method:: Redshift.Client.modify_lakehouse_configuration(**kwargs)

  

  Modifies the lakehouse configuration for a cluster. This operation allows you to manage Amazon Redshift federated permissions and Amazon Web Services IAM Identity Center trusted identity propagation.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/redshift-2012-12-01/ModifyLakehouseConfiguration>`_  


  **Request Syntax**
  ::

    response = client.modify_lakehouse_configuration(
        ClusterIdentifier='string',
        LakehouseRegistration='Register'|'Deregister',
        CatalogName='string',
        LakehouseIdcRegistration='Associate'|'Disassociate',
        LakehouseIdcApplicationArn='string',
        DryRun=True|False
    )
    
  :type ClusterIdentifier: string
  :param ClusterIdentifier: **[REQUIRED]** 

    The unique identifier of the cluster whose lakehouse configuration you want to modify.

    

  
  :type LakehouseRegistration: string
  :param LakehouseRegistration: 

    Specifies whether to register or deregister the cluster with Amazon Redshift federated permissions. Valid values are ``Register`` or ``Deregister``.

    

  
  :type CatalogName: string
  :param CatalogName: 

    The name of the Glue data catalog that will be associated with the cluster enabled with Amazon Redshift federated permissions.

     

    Constraints:

     

    
    * Must contain at least one lowercase letter.
     
    * Can only contain lowercase letters (a-z), numbers (0-9), underscores (_), and hyphens (-).
    

     

    Pattern: ``^[a-z0-9_-]*[a-z]+[a-z0-9_-]*$``

     

    Example: ``my-catalog_01``

    

  
  :type LakehouseIdcRegistration: string
  :param LakehouseIdcRegistration: 

    Modifies the Amazon Web Services IAM Identity Center trusted identity propagation on a cluster enabled with Amazon Redshift federated permissions. Valid values are ``Associate`` or ``Disassociate``.

    

  
  :type LakehouseIdcApplicationArn: string
  :param LakehouseIdcApplicationArn: 

    The Amazon Resource Name (ARN) of the IAM Identity Center application used for enabling Amazon Web Services IAM Identity Center trusted identity propagation on a cluster enabled with Amazon Redshift federated permissions.

    

  
  :type DryRun: boolean
  :param DryRun: 

    A boolean value that, if ``true``, validates the request without actually modifying the lakehouse configuration. Use this to check for errors before making changes.

    

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

    
    ::

      {
          'ClusterIdentifier': 'string',
          'LakehouseIdcApplicationArn': 'string',
          'LakehouseRegistrationStatus': 'string',
          'CatalogArn': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 

      Contains configuration information for lakehouse integration, including the cluster identifier, catalog ARN, and registration status.

      
      

      - **ClusterIdentifier** *(string) --* 

        The unique identifier of the cluster associated with this lakehouse configuration.

        
      

      - **LakehouseIdcApplicationArn** *(string) --* 

        The Amazon Resource Name (ARN) of the IAM Identity Center application used for enabling Amazon Web Services IAM Identity Center trusted identity propagation on a cluster enabled with Amazon Redshift federated permissions.

        
      

      - **LakehouseRegistrationStatus** *(string) --* 

        The current status of the lakehouse registration. Indicates whether the cluster is successfully registered with the lakehouse.

        
      

      - **CatalogArn** *(string) --* 

        The Amazon Resource Name (ARN) of the Glue data catalog associated with the lakehouse configuration.

        
  
  **Exceptions**
  
  *   :py:class:`Redshift.Client.exceptions.ClusterNotFoundFault`

  
  *   :py:class:`Redshift.Client.exceptions.InvalidClusterStateFault`

  
  *   :py:class:`Redshift.Client.exceptions.UnsupportedOperationFault`

  
  *   :py:class:`Redshift.Client.exceptions.UnauthorizedOperation`

  
  *   :py:class:`Redshift.Client.exceptions.RedshiftIdcApplicationNotExistsFault`

  
  *   :py:class:`Redshift.Client.exceptions.DependentServiceUnavailableFault`

  
  *   :py:class:`Redshift.Client.exceptions.DependentServiceAccessDeniedFault`

  