:doc:`GuardDuty <../../guardduty>` / Client / get_remaining_free_trial_days

*****************************
get_remaining_free_trial_days
*****************************



.. py:method:: GuardDuty.Client.get_remaining_free_trial_days(**kwargs)

  

  Provides the number of days left for each data source used in the free trial period.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/GetRemainingFreeTrialDays>`_  


  **Request Syntax**
  ::

    response = client.get_remaining_free_trial_days(
        DetectorId='string',
        AccountIds=[
            'string',
        ]
    )
    
  :type DetectorId: string
  :param DetectorId: **[REQUIRED]** 

    The unique ID of the detector of the GuardDuty member account.

     

    To find the ``detectorId`` in the current Region, see the Settings page in the GuardDuty console, or run the `ListDetectors <https://docs.aws.amazon.com/guardduty/latest/APIReference/API_ListDetectors.html>`__ API.

    

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

    A list of account identifiers of the GuardDuty member account.

    

  
    - *(string) --* 

    

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

    
    ::

      {
          'Accounts': [
              {
                  'AccountId': 'string',
                  'DataSources': {
                      'CloudTrail': {
                          'FreeTrialDaysRemaining': 123
                      },
                      'DnsLogs': {
                          'FreeTrialDaysRemaining': 123
                      },
                      'FlowLogs': {
                          'FreeTrialDaysRemaining': 123
                      },
                      'S3Logs': {
                          'FreeTrialDaysRemaining': 123
                      },
                      'Kubernetes': {
                          'AuditLogs': {
                              'FreeTrialDaysRemaining': 123
                          }
                      },
                      'MalwareProtection': {
                          'ScanEc2InstanceWithFindings': {
                              'FreeTrialDaysRemaining': 123
                          }
                      }
                  },
                  'Features': [
                      {
                          'Name': 'FLOW_LOGS'|'CLOUD_TRAIL'|'DNS_LOGS'|'S3_DATA_EVENTS'|'EKS_AUDIT_LOGS'|'EBS_MALWARE_PROTECTION'|'RDS_LOGIN_EVENTS'|'EKS_RUNTIME_MONITORING'|'LAMBDA_NETWORK_LOGS'|'FARGATE_RUNTIME_MONITORING'|'EC2_RUNTIME_MONITORING',
                          'FreeTrialDaysRemaining': 123
                      },
                  ]
              },
          ],
          'UnprocessedAccounts': [
              {
                  'AccountId': 'string',
                  'Result': 'string'
              },
          ]
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **Accounts** *(list) --* 

        The member accounts which were included in a request and were processed successfully.

        
        

        - *(dict) --* 

          Provides details of the GuardDuty member account that uses a free trial service.

          
          

          - **AccountId** *(string) --* 

            The account identifier of the GuardDuty member account.

            
          

          - **DataSources** *(dict) --* 

            Describes the data source enabled for the GuardDuty member account.

            
            

            - **CloudTrail** *(dict) --* 

              Describes whether any Amazon Web Services CloudTrail management event logs are enabled as data sources.

              
              

              - **FreeTrialDaysRemaining** *(integer) --* 

                A value that specifies the number of days left to use each enabled data source.

                
          
            

            - **DnsLogs** *(dict) --* 

              Describes whether any DNS logs are enabled as data sources.

              
              

              - **FreeTrialDaysRemaining** *(integer) --* 

                A value that specifies the number of days left to use each enabled data source.

                
          
            

            - **FlowLogs** *(dict) --* 

              Describes whether any VPC Flow logs are enabled as data sources.

              
              

              - **FreeTrialDaysRemaining** *(integer) --* 

                A value that specifies the number of days left to use each enabled data source.

                
          
            

            - **S3Logs** *(dict) --* 

              Describes whether any S3 data event logs are enabled as data sources.

              
              

              - **FreeTrialDaysRemaining** *(integer) --* 

                A value that specifies the number of days left to use each enabled data source.

                
          
            

            - **Kubernetes** *(dict) --* 

              Describes whether any Kubernetes logs are enabled as data sources.

              
              

              - **AuditLogs** *(dict) --* 

                Describes whether Kubernetes audit logs are enabled as a data source.

                
                

                - **FreeTrialDaysRemaining** *(integer) --* 

                  A value that specifies the number of days left to use each enabled data source.

                  
            
          
            

            - **MalwareProtection** *(dict) --* 

              Describes whether Malware Protection is enabled as a data source.

              
              

              - **ScanEc2InstanceWithFindings** *(dict) --* 

                Describes whether Malware Protection for EC2 instances with findings is enabled as a data source.

                
                

                - **FreeTrialDaysRemaining** *(integer) --* 

                  A value that specifies the number of days left to use each enabled data source.

                  
            
          
        
          

          - **Features** *(list) --* 

            A list of features enabled for the GuardDuty account.

            
            

            - *(dict) --* 

              Contains information about the free trial period for a feature.

              
              

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

                The name of the feature for which the free trial is configured.

                
              

              - **FreeTrialDaysRemaining** *(integer) --* 

                The number of the remaining free trial days for the feature.

                
          
        
      
    
      

      - **UnprocessedAccounts** *(list) --* 

        The member account that was included in a request but for which the request could not be processed.

        
        

        - *(dict) --* 

          Contains information about the accounts that weren't processed.

          
          

          - **AccountId** *(string) --* 

            The Amazon Web Services account ID.

            
          

          - **Result** *(string) --* 

            A reason why the account hasn't been processed.

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

  
  *   :py:class:`GuardDuty.Client.exceptions.InternalServerErrorException`

  