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

********************************
create_custom_domain_association
********************************



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

  

  Used to create a custom domain name for a cluster. Properties include the custom domain name, the cluster the custom domain is associated with, and the certificate Amazon Resource Name (ARN).

  

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


  **Request Syntax**
  ::

    response = client.create_custom_domain_association(
        CustomDomainName='string',
        CustomDomainCertificateArn='string',
        ClusterIdentifier='string'
    )
    
  :type CustomDomainName: string
  :param CustomDomainName: **[REQUIRED]** 

    The custom domain name for a custom domain association.

    

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

    The certificate Amazon Resource Name (ARN) for the custom domain name association.

    

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

    The cluster identifier that the custom domain is associated with.

    

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

    
    ::

      {
          'CustomDomainName': 'string',
          'CustomDomainCertificateArn': 'string',
          'ClusterIdentifier': 'string',
          'CustomDomainCertExpiryTime': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **CustomDomainName** *(string) --* 

        The custom domain name for the association result.

        
      

      - **CustomDomainCertificateArn** *(string) --* 

        The Amazon Resource Name (ARN) for the certificate associated with the custom domain name.

        
      

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

        The identifier of the cluster that the custom domain is associated with.

        
      

      - **CustomDomainCertExpiryTime** *(string) --* 

        The expiration time for the certificate for the custom domain.

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

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

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

  