GuardDuty / Client / get_remaining_free_trial_days

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