:doc:`Lambda <../../lambda>` / Client / get_alias

*********
get_alias
*********



.. py:method:: Lambda.Client.get_alias(**kwargs)

  

  Returns details about a Lambda function `alias <https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html>`__.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/GetAlias>`_  


  **Request Syntax**
  ::

    response = client.get_alias(
        FunctionName='string',
        Name='string'
    )
    
  :type FunctionName: string
  :param FunctionName: **[REQUIRED]** 

    The name or ARN of the Lambda function.

     

    **Name formats**

     

    
    * **Function name** - ``MyFunction``.
     
    * **Function ARN** - ``arn:aws:lambda:us-west-2:123456789012:function:MyFunction``.
     
    * **Partial ARN** - ``123456789012:function:MyFunction``.
    

     

    The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length.

    

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

    The name of the alias.

    

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

    
    ::

      {
          'AliasArn': 'string',
          'Name': 'string',
          'FunctionVersion': 'string',
          'Description': 'string',
          'RoutingConfig': {
              'AdditionalVersionWeights': {
                  'string': 123.0
              }
          },
          'RevisionId': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 

      Provides configuration information about a Lambda function `alias <https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html>`__.

      
      

      - **AliasArn** *(string) --* 

        The Amazon Resource Name (ARN) of the alias.

        
      

      - **Name** *(string) --* 

        The name of the alias.

        
      

      - **FunctionVersion** *(string) --* 

        The function version that the alias invokes.

        
      

      - **Description** *(string) --* 

        A description of the alias.

        
      

      - **RoutingConfig** *(dict) --* 

        The `routing configuration <https://docs.aws.amazon.com/lambda/latest/dg/lambda-traffic-shifting-using-aliases.html>`__ of the alias.

        
        

        - **AdditionalVersionWeights** *(dict) --* 

          The second version, and the percentage of traffic that's routed to it.

          
          

          - *(string) --* 
            

            - *(float) --* 
      
    
    
      

      - **RevisionId** *(string) --* 

        A unique identifier that changes when you update the alias.

        
  
  **Exceptions**
  
  *   :py:class:`Lambda.Client.exceptions.InvalidParameterValueException`

  
  *   :py:class:`Lambda.Client.exceptions.ServiceException`

  
  *   :py:class:`Lambda.Client.exceptions.TooManyRequestsException`

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

  

  **Examples**

  The following example returns details about an alias named BLUE for a function named my-function
  ::

    response = client.get_alias(
        FunctionName='my-function',
        Name='BLUE',
    )
    
    print(response)

  
  Expected Output:
  ::

    {
        'AliasArn': 'arn:aws:lambda:us-west-2:123456789012:function:my-function:BLUE',
        'Description': 'Production environment BLUE.',
        'FunctionVersion': '3',
        'Name': 'BLUE',
        'RevisionId': '594f41fb-xmpl-4c20-95c7-6ca5f2a92c93',
        'ResponseMetadata': {
            '...': '...',
        },
    }

  