:doc:`KinesisVideo <../../kinesisvideo>` / Client / create_signaling_channel

************************
create_signaling_channel
************************



.. py:method:: KinesisVideo.Client.create_signaling_channel(**kwargs)

  

  Creates a signaling channel.

   

  ``CreateSignalingChannel`` is an asynchronous operation.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/kinesisvideo-2017-09-30/CreateSignalingChannel>`_  


  **Request Syntax**
  ::

    response = client.create_signaling_channel(
        ChannelName='string',
        ChannelType='SINGLE_MASTER'|'FULL_MESH',
        SingleMasterConfiguration={
            'MessageTtlSeconds': 123
        },
        Tags=[
            {
                'Key': 'string',
                'Value': 'string'
            },
        ]
    )
    
  :type ChannelName: string
  :param ChannelName: **[REQUIRED]** 

    A name for the signaling channel that you are creating. It must be unique for each Amazon Web Services account and Amazon Web Services Region.

    

  
  :type ChannelType: string
  :param ChannelType: 

    A type of the signaling channel that you are creating. Currently, ``SINGLE_MASTER`` is the only supported channel type.

    

  
  :type SingleMasterConfiguration: dict
  :param SingleMasterConfiguration: 

    A structure containing the configuration for the ``SINGLE_MASTER`` channel type. The default configuration for the channel message's time to live is 60 seconds (1 minute).

    

  
    - **MessageTtlSeconds** *(integer) --* 

      The period of time (in seconds) a signaling channel retains undelivered messages before they are discarded. Use to update this value.

      

    
  
  :type Tags: list
  :param Tags: 

    A set of tags (key-value pairs) that you want to associate with this channel.

    

  
    - *(dict) --* 

      A key and value pair that is associated with the specified signaling channel.

      

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

        The key of the tag that is associated with the specified signaling channel.

        

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

        The value of the tag that is associated with the specified signaling channel.

        

      
    

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

    
    ::

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

    

    - *(dict) --* 
      

      - **ChannelARN** *(string) --* 

        The Amazon Resource Name (ARN) of the created channel.

        
  
  **Exceptions**
  
  *   :py:class:`KinesisVideo.Client.exceptions.InvalidArgumentException`

  
  *   :py:class:`KinesisVideo.Client.exceptions.ClientLimitExceededException`

  
  *   :py:class:`KinesisVideo.Client.exceptions.AccountChannelLimitExceededException`

  
  *   :py:class:`KinesisVideo.Client.exceptions.ResourceInUseException`

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

  
  *   :py:class:`KinesisVideo.Client.exceptions.TagsPerResourceExceededLimitException`

  