update_organization_configuration

GuardDuty.Client.update_organization_configuration(**kwargs)

Updates the delegated administrator account with the values provided.

There might be regional differences because some data sources might not be available in all the Amazon Web Services Regions where GuardDuty is presently supported. For more information, see Regions and endpoints.

See also: AWS API Documentation

Request Syntax

response = client.update_organization_configuration(
    DetectorId='string',
    AutoEnable=True|False,
    DataSources={
        'S3Logs': {
            'AutoEnable': True|False
        },
        'Kubernetes': {
            'AuditLogs': {
                'AutoEnable': True|False
            }
        },
        'MalwareProtection': {
            'ScanEc2InstanceWithFindings': {
                'EbsVolumes': {
                    'AutoEnable': True|False
                }
            }
        }
    },
    Features=[
        {
            'Name': 'S3_DATA_EVENTS'|'EKS_AUDIT_LOGS'|'EBS_MALWARE_PROTECTION'|'RDS_LOGIN_EVENTS',
            'AutoEnable': 'NEW'|'NONE'
        },
    ]
)
Parameters
  • DetectorId (string) --

    [REQUIRED]

    The ID of the detector to update the delegated administrator for.

  • AutoEnable (boolean) --

    [REQUIRED]

    Indicates whether to automatically enable member accounts in the organization.

  • DataSources (dict) --

    Describes which data sources will be updated.

    • S3Logs (dict) --

      Describes whether S3 data event logs are enabled for new members of the organization.

      • AutoEnable (boolean) -- [REQUIRED]

        A value that contains information on whether S3 data event logs will be enabled automatically as a data source for the organization.

    • Kubernetes (dict) --

      Describes the configuration of Kubernetes data sources for new members of the organization.

      • AuditLogs (dict) -- [REQUIRED]

        Whether Kubernetes audit logs data source should be auto-enabled for new members joining the organization.

        • AutoEnable (boolean) -- [REQUIRED]

          A value that contains information on whether Kubernetes audit logs should be enabled automatically as a data source for the organization.

    • MalwareProtection (dict) --

      Describes the configuration of Malware Protection for new members of the organization.

      • ScanEc2InstanceWithFindings (dict) --

        Whether Malware Protection for EC2 instances with findings should be auto-enabled for new members joining the organization.

        • EbsVolumes (dict) --

          Whether scanning EBS volumes should be auto-enabled for new members joining the organization.

          • AutoEnable (boolean) --

            Whether scanning EBS volumes should be auto-enabled for new members joining the organization.

  • Features (list) --

    A list of features that will be configured for the organization.

    • (dict) --

      A list of features which will be configured for the organization.

      • Name (string) --

        The name of the feature that will be configured for the organization.

      • AutoEnable (string) --

        The status of the feature that will be configured for the organization.

Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

Exceptions

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