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

**************************
describe_signaling_channel
**************************



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

  

  Returns the most current information about the signaling channel. You must specify either the name or the Amazon Resource Name (ARN) of the channel that you want to describe.

  

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


  **Request Syntax**
  ::

    response = client.describe_signaling_channel(
        ChannelName='string',
        ChannelARN='string'
    )
    
  :type ChannelName: string
  :param ChannelName: 

    The name of the signaling channel that you want to describe.

    

  
  :type ChannelARN: string
  :param ChannelARN: 

    The ARN of the signaling channel that you want to describe.

    

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

    
    ::

      {
          'ChannelInfo': {
              'ChannelName': 'string',
              'ChannelARN': 'string',
              'ChannelType': 'SINGLE_MASTER'|'FULL_MESH',
              'ChannelStatus': 'CREATING'|'ACTIVE'|'UPDATING'|'DELETING',
              'CreationTime': datetime(2015, 1, 1),
              'SingleMasterConfiguration': {
                  'MessageTtlSeconds': 123
              },
              'Version': 'string'
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **ChannelInfo** *(dict) --* 

        A structure that encapsulates the specified signaling channel's metadata and properties.

        
        

        - **ChannelName** *(string) --* 

          The name of the signaling channel.

          
        

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

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

          
        

        - **ChannelType** *(string) --* 

          The type of the signaling channel.

          
        

        - **ChannelStatus** *(string) --* 

          Current status of the signaling channel.

          
        

        - **CreationTime** *(datetime) --* 

          The time at which the signaling channel was created.

          
        

        - **SingleMasterConfiguration** *(dict) --* 

          A structure that contains the configuration for the ``SINGLE_MASTER`` channel type.

          
          

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

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

            
      
        

        - **Version** *(string) --* 

          The current version of the signaling channel.

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

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

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

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

  