GuardDuty / Client / update_organization_configuration

update_organization_configuration#

GuardDuty.Client.update_organization_configuration(**kwargs)#

Configures the delegated administrator account with the provided values. You must provide the value for either autoEnableOrganizationMembers or autoEnable.

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'|'EKS_RUNTIME_MONITORING',
            'AutoEnable': 'NEW'|'NONE',
            'AdditionalConfiguration': [
                {
                    'Name': 'EKS_ADDON_MANAGEMENT',
                    'AutoEnable': 'NEW'|'NONE'
                },
            ]
        },
    ],
    AutoEnableOrganizationMembers='NEW'|'ALL'|'NONE'
)

Parameters:

DetectorId (string) –
[REQUIRED]

The ID of the detector that configures the delegated administrator.
AutoEnable (boolean) –
Indicates whether to automatically enable member accounts in the organization.

Even though this is still supported, we recommend using AutoEnableOrganizationMembers to achieve the similar results.
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.
  - AdditionalConfiguration (list) –
    
    The additional information that will be configured for the organization.
    - (dict) –
      
      A list of additional configurations which will be configured for the organization.
      - Name (string) –
        
        The name of the additional configuration that will be configured for the organization.
      - AutoEnable (string) –
        
        The status of the additional configuration that will be configured for the organization.
AutoEnableOrganizationMembers (string) –
Indicates the auto-enablement configuration of GuardDuty for the member accounts in the organization.
- NEW: Indicates that when a new account joins the organization, they will have GuardDuty enabled automatically.
- ALL: Indicates that all accounts in the Amazon Web Services Organization have GuardDuty enabled automatically. This includes NEW accounts that join the organization and accounts that may have been suspended or removed from the organization in GuardDuty.
- NONE: Indicates that GuardDuty will not be automatically enabled for any accounts in the organization. GuardDuty must be managed for each account individually by the administrator.

Return type:

dict

Returns:

Response Syntax

{}

Response Structure

(dict) –

Exceptions

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