Select your cookie preferences

We use cookies and similar tools to enhance your experience, provide our services, deliver relevant advertising, and make improvements. Approved third parties also use these tools to help us deliver advertising and provide certain site features.

get_remaining_free_trial_days

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

Request Syntax

response = client.get_remaining_free_trial_days(
    DetectorId='string',
    AccountIds=[
        'string',
    ]
)
Parameters
  • DetectorId (string) --

    [REQUIRED]

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

  • AccountIds (list) --

    A list of account identifiers of the GuardDuty member account.

    • (string) --
Return type

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',
                    '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

  • GuardDuty.Client.exceptions.BadRequestException
  • GuardDuty.Client.exceptions.InternalServerErrorException