:doc:`ChimeSDKVoice <../../chime-sdk-voice>` / Client / create_sip_media_application

****************************
create_sip_media_application
****************************



.. py:method:: ChimeSDKVoice.Client.create_sip_media_application(**kwargs)

  

  Creates a SIP media application. For more information about SIP media applications, see `Managing SIP media applications and rules <https://docs.aws.amazon.com/chime-sdk/latest/ag/manage-sip-applications.html>`__ in the *Amazon Chime SDK Administrator Guide*.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/chime-sdk-voice-2022-08-03/CreateSipMediaApplication>`_  


  **Request Syntax**
  ::

    response = client.create_sip_media_application(
        AwsRegion='string',
        Name='string',
        Endpoints=[
            {
                'LambdaArn': 'string'
            },
        ],
        Tags=[
            {
                'Key': 'string',
                'Value': 'string'
            },
        ]
    )
    
  :type AwsRegion: string
  :param AwsRegion: **[REQUIRED]** 

    The AWS Region assigned to the SIP media application.

    

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

    The SIP media application's name.

    

  
  :type Endpoints: list
  :param Endpoints: **[REQUIRED]** 

    List of endpoints (Lambda ARNs) specified for the SIP media application.

    

  
    - *(dict) --* 

      The endpoint assigned to a SIP media application.

      

    
      - **LambdaArn** *(string) --* 

        Valid Amazon Resource Name (ARN) of the Lambda function, version, or alias. The function must be created in the same AWS Region as the SIP media application.

        

      
    

  :type Tags: list
  :param Tags: 

    The tags assigned to the SIP media application.

    

  
    - *(dict) --* 

      Describes a tag applied to a resource.

      

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

        The tag's key.

        

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

        The tag's value.

        

      
    

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

    
    ::

      {
          'SipMediaApplication': {
              'SipMediaApplicationId': 'string',
              'AwsRegion': 'string',
              'Name': 'string',
              'Endpoints': [
                  {
                      'LambdaArn': 'string'
                  },
              ],
              'CreatedTimestamp': datetime(2015, 1, 1),
              'UpdatedTimestamp': datetime(2015, 1, 1),
              'SipMediaApplicationArn': 'string'
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **SipMediaApplication** *(dict) --* 

        The SIP media application details.

        
        

        - **SipMediaApplicationId** *(string) --* 

          A SIP media application's ID.

          
        

        - **AwsRegion** *(string) --* 

          The AWS Region in which the SIP media application is created.

          
        

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

          The SIP media application's name.

          
        

        - **Endpoints** *(list) --* 

          List of endpoints for a SIP media application. Currently, only one endpoint per SIP media application is permitted.

          
          

          - *(dict) --* 

            The endpoint assigned to a SIP media application.

            
            

            - **LambdaArn** *(string) --* 

              Valid Amazon Resource Name (ARN) of the Lambda function, version, or alias. The function must be created in the same AWS Region as the SIP media application.

              
        
      
        

        - **CreatedTimestamp** *(datetime) --* 

          The SIP media application creation timestamp, in ISO 8601 format.

          
        

        - **UpdatedTimestamp** *(datetime) --* 

          The time at which the SIP media application was updated.

          
        

        - **SipMediaApplicationArn** *(string) --* 

          The ARN of the SIP media application.

          
    
  
  **Exceptions**
  
  *   :py:class:`ChimeSDKVoice.Client.exceptions.BadRequestException`

  
  *   :py:class:`ChimeSDKVoice.Client.exceptions.ForbiddenException`

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

  
  *   :py:class:`ChimeSDKVoice.Client.exceptions.UnauthorizedClientException`

  
  *   :py:class:`ChimeSDKVoice.Client.exceptions.ThrottledClientException`

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

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

  
  *   :py:class:`ChimeSDKVoice.Client.exceptions.ServiceUnavailableException`

  
  *   :py:class:`ChimeSDKVoice.Client.exceptions.ServiceFailureException`

  