:doc:`RedshiftServerless <../../redshift-serverless>` / Client / delete_namespace

****************
delete_namespace
****************



.. py:method:: RedshiftServerless.Client.delete_namespace(**kwargs)

  

  Deletes a namespace from Amazon Redshift Serverless. Before you delete the namespace, you can create a final snapshot that has all of the data within the namespace.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/redshift-serverless-2021-04-21/DeleteNamespace>`_  


  **Request Syntax**
  ::

    response = client.delete_namespace(
        finalSnapshotName='string',
        finalSnapshotRetentionPeriod=123,
        namespaceName='string'
    )
    
  :type finalSnapshotName: string
  :param finalSnapshotName: 

    The name of the snapshot to be created before the namespace is deleted.

    

  
  :type finalSnapshotRetentionPeriod: integer
  :param finalSnapshotRetentionPeriod: 

    How long to retain the final snapshot.

    

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

    The name of the namespace to delete.

    

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

    
    ::

      {
          'namespace': {
              'adminPasswordSecretArn': 'string',
              'adminPasswordSecretKmsKeyId': 'string',
              'adminUsername': 'string',
              'catalogArn': 'string',
              'creationDate': datetime(2015, 1, 1),
              'dbName': 'string',
              'defaultIamRoleArn': 'string',
              'iamRoles': [
                  'string',
              ],
              'kmsKeyId': 'string',
              'lakehouseRegistrationStatus': 'string',
              'logExports': [
                  'useractivitylog'|'userlog'|'connectionlog',
              ],
              'namespaceArn': 'string',
              'namespaceId': 'string',
              'namespaceName': 'string',
              'status': 'AVAILABLE'|'MODIFYING'|'DELETING'
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **namespace** *(dict) --* 

        The deleted namespace object.

        
        

        - **adminPasswordSecretArn** *(string) --* 

          The Amazon Resource Name (ARN) for the namespace's admin user credentials secret.

          
        

        - **adminPasswordSecretKmsKeyId** *(string) --* 

          The ID of the Key Management Service (KMS) key used to encrypt and store the namespace's admin credentials secret.

          
        

        - **adminUsername** *(string) --* 

          The username of the administrator for the first database created in the namespace.

          
        

        - **catalogArn** *(string) --* 

          The Amazon Resource Name (ARN) of the Glue Data Catalog associated with the namespace enabled with Amazon Redshift federated permissions.

          
        

        - **creationDate** *(datetime) --* 

          The date of when the namespace was created.

          
        

        - **dbName** *(string) --* 

          The name of the first database created in the namespace.

          
        

        - **defaultIamRoleArn** *(string) --* 

          The Amazon Resource Name (ARN) of the IAM role to set as a default in the namespace.

          
        

        - **iamRoles** *(list) --* 

          A list of IAM roles to associate with the namespace.

          
          

          - *(string) --* 
      
        

        - **kmsKeyId** *(string) --* 

          The ID of the Amazon Web Services Key Management Service key used to encrypt your data.

          
        

        - **lakehouseRegistrationStatus** *(string) --* 

          The status of the lakehouse registration for the namespace. Indicates whether the namespace is successfully registered with Amazon Redshift federated permissions.

          
        

        - **logExports** *(list) --* 

          The types of logs the namespace can export. Available export types are User log, Connection log, and User activity log.

          
          

          - *(string) --* 
      
        

        - **namespaceArn** *(string) --* 

          The Amazon Resource Name (ARN) associated with a namespace.

          
        

        - **namespaceId** *(string) --* 

          The unique identifier of a namespace.

          
        

        - **namespaceName** *(string) --* 

          The name of the namespace. Must be between 3-64 alphanumeric characters in lowercase, and it cannot be a reserved word. A list of reserved words can be found in `Reserved Words <https://docs.aws.amazon.com/redshift/latest/dg/r_pg_keywords.html>`__ in the Amazon Redshift Database Developer Guide.

          
        

        - **status** *(string) --* 

          The status of the namespace.

          
    
  
  **Exceptions**
  
  *   :py:class:`RedshiftServerless.Client.exceptions.InternalServerException`

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

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

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

  