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',
            '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.
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.
AutoEnableOrganizationMembers (string) –
Indicates the auto-enablement configuration of GuardDuty for the member accounts in the organization.
- NEW: Indicates that new accounts joining the organization are configured to have GuardDuty enabled automatically.
- ALL: Indicates that all accounts (new and existing members) in the organization are configured to have GuardDuty enabled automatically.
- NONE: Indicates that no account in the organization will be configured to have GuardDuty enabled automatically.

Return type:

dict

Returns:

Response Syntax

{}

Response Structure

(dict) –

Exceptions

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