:doc:`ConfigService <../../config>` / Client / describe_delivery_channel_status

********************************
describe_delivery_channel_status
********************************



.. py:method:: ConfigService.Client.describe_delivery_channel_status(**kwargs)

  

  Returns the current status of the specified delivery channel. If a delivery channel is not specified, this operation returns the current status of all delivery channels associated with the account.

   

  .. note::

    

    Currently, you can specify only one delivery channel per region in your account.

    

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/DescribeDeliveryChannelStatus>`_  


  **Request Syntax**
  ::

    response = client.describe_delivery_channel_status(
        DeliveryChannelNames=[
            'string',
        ]
    )
    
  :type DeliveryChannelNames: list
  :param DeliveryChannelNames: 

    A list of delivery channel names.

    

  
    - *(string) --* 

    

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

    
    ::

      {
          'DeliveryChannelsStatus': [
              {
                  'name': 'string',
                  'configSnapshotDeliveryInfo': {
                      'lastStatus': 'Success'|'Failure'|'Not_Applicable',
                      'lastErrorCode': 'string',
                      'lastErrorMessage': 'string',
                      'lastAttemptTime': datetime(2015, 1, 1),
                      'lastSuccessfulTime': datetime(2015, 1, 1),
                      'nextDeliveryTime': datetime(2015, 1, 1)
                  },
                  'configHistoryDeliveryInfo': {
                      'lastStatus': 'Success'|'Failure'|'Not_Applicable',
                      'lastErrorCode': 'string',
                      'lastErrorMessage': 'string',
                      'lastAttemptTime': datetime(2015, 1, 1),
                      'lastSuccessfulTime': datetime(2015, 1, 1),
                      'nextDeliveryTime': datetime(2015, 1, 1)
                  },
                  'configStreamDeliveryInfo': {
                      'lastStatus': 'Success'|'Failure'|'Not_Applicable',
                      'lastErrorCode': 'string',
                      'lastErrorMessage': 'string',
                      'lastStatusChangeTime': datetime(2015, 1, 1)
                  }
              },
          ]
      }
      
    **Response Structure**

    

    - *(dict) --* 

      The output for the  DescribeDeliveryChannelStatus action.

      
      

      - **DeliveryChannelsStatus** *(list) --* 

        A list that contains the status of a specified delivery channel.

        
        

        - *(dict) --* 

          The status of a specified delivery channel.

           

          Valid values: ``Success`` | ``Failure``

          
          

          - **name** *(string) --* 

            The name of the delivery channel.

            
          

          - **configSnapshotDeliveryInfo** *(dict) --* 

            A list containing the status of the delivery of the snapshot to the specified Amazon S3 bucket.

            
            

            - **lastStatus** *(string) --* 

              Status of the last attempted delivery.

              
            

            - **lastErrorCode** *(string) --* 

              The error code from the last attempted delivery.

              
            

            - **lastErrorMessage** *(string) --* 

              The error message from the last attempted delivery.

              
            

            - **lastAttemptTime** *(datetime) --* 

              The time of the last attempted delivery.

              
            

            - **lastSuccessfulTime** *(datetime) --* 

              The time of the last successful delivery.

              
            

            - **nextDeliveryTime** *(datetime) --* 

              The time that the next delivery occurs.

              
        
          

          - **configHistoryDeliveryInfo** *(dict) --* 

            A list that contains the status of the delivery of the configuration history to the specified Amazon S3 bucket.

            
            

            - **lastStatus** *(string) --* 

              Status of the last attempted delivery.

              
            

            - **lastErrorCode** *(string) --* 

              The error code from the last attempted delivery.

              
            

            - **lastErrorMessage** *(string) --* 

              The error message from the last attempted delivery.

              
            

            - **lastAttemptTime** *(datetime) --* 

              The time of the last attempted delivery.

              
            

            - **lastSuccessfulTime** *(datetime) --* 

              The time of the last successful delivery.

              
            

            - **nextDeliveryTime** *(datetime) --* 

              The time that the next delivery occurs.

              
        
          

          - **configStreamDeliveryInfo** *(dict) --* 

            A list containing the status of the delivery of the configuration stream notification to the specified Amazon SNS topic.

            
            

            - **lastStatus** *(string) --* 

              Status of the last attempted delivery.

               

              **Note** Providing an SNS topic on a `DeliveryChannel <https://docs.aws.amazon.com/config/latest/APIReference/API_DeliveryChannel.html>`__ for Config is optional. If the SNS delivery is turned off, the last status will be **Not_Applicable**.

              
            

            - **lastErrorCode** *(string) --* 

              The error code from the last attempted delivery.

              
            

            - **lastErrorMessage** *(string) --* 

              The error message from the last attempted delivery.

              
            

            - **lastStatusChangeTime** *(datetime) --* 

              The time from the last status change.

              
        
      
    
  
  **Exceptions**
  
  *   :py:class:`ConfigService.Client.exceptions.NoSuchDeliveryChannelException`

  