:doc:`WorkSpaces <../../workspaces>` / Client / create_connection_alias

***********************
create_connection_alias
***********************



.. py:method:: WorkSpaces.Client.create_connection_alias(**kwargs)

  

  Creates the specified connection alias for use with cross-Region redirection. For more information, see `Cross-Region Redirection for Amazon WorkSpaces <https://docs.aws.amazon.com/workspaces/latest/adminguide/cross-region-redirection.html>`__.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/workspaces-2015-04-08/CreateConnectionAlias>`_  


  **Request Syntax**
  ::

    response = client.create_connection_alias(
        ConnectionString='string',
        Tags=[
            {
                'Key': 'string',
                'Value': 'string'
            },
        ]
    )
    
  :type ConnectionString: string
  :param ConnectionString: **[REQUIRED]** 

    A connection string in the form of a fully qualified domain name (FQDN), such as ``www.example.com``.

     

    .. warning::

       

      After you create a connection string, it is always associated to your Amazon Web Services account. You cannot recreate the same connection string with a different account, even if you delete all instances of it from the original account. The connection string is globally reserved for your account.

      

    

  
  :type Tags: list
  :param Tags: 

    The tags to associate with the connection alias.

    

  
    - *(dict) --* 

      Describes a tag.

      

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

        The key of the tag.

        

      
      - **Value** *(string) --* 

        The value of the tag.

        

      
    

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

    
    ::

      {
          'AliasId': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **AliasId** *(string) --* 

        The identifier of the connection alias.

        
  
  **Exceptions**
  
  *   :py:class:`WorkSpaces.Client.exceptions.ResourceAlreadyExistsException`

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

  
  *   :py:class:`WorkSpaces.Client.exceptions.InvalidParameterValuesException`

  
  *   :py:class:`WorkSpaces.Client.exceptions.ResourceLimitExceededException`

  
  *   :py:class:`WorkSpaces.Client.exceptions.InvalidResourceStateException`

  
  *   :py:class:`WorkSpaces.Client.exceptions.OperationNotSupportedException`

  