CloudTrail / Client / put_event_configuration

put_event_configuration

CloudTrail.Client.put_event_configuration(**kwargs)

Updates the event configuration settings for the specified event data store. You can update the maximum event size and context key selectors.

See also: AWS API Documentation

Request Syntax

response = client.put_event_configuration(
    EventDataStore='string',
    MaxEventSize='Standard'|'Large',
    ContextKeySelectors=[
        {
            'Type': 'TagContext'|'RequestContext',
            'Equals': [
                'string',
            ]
        },
    ]
)
Parameters:

  • EventDataStore (string) – The Amazon Resource Name (ARN) or ID suffix of the ARN of the event data store for which you want to update event configuration settings.

  • MaxEventSize (string) –

    [REQUIRED]

    The maximum allowed size for events to be stored in the specified event data store. If you are using context key selectors, MaxEventSize must be set to Large.

  • ContextKeySelectors (list) –

    [REQUIRED]

    A list of context key selectors that will be included to provide enriched event data.

    • (dict) –

      An object that contains information types to be included in CloudTrail enriched events.

      • Type (string) – [REQUIRED]

        Specifies the type of the event record field in ContextKeySelector. Valid values include RequestContext, TagContext.

      • Equals (list) – [REQUIRED]

        A list of keys defined by Type to be included in CloudTrail enriched events.

        • (string) –

Return type:

dict

Returns:

Response Syntax

{
    'EventDataStoreArn': 'string',
    'MaxEventSize': 'Standard'|'Large',
    'ContextKeySelectors': [
        {
            'Type': 'TagContext'|'RequestContext',
            'Equals': [
                'string',
            ]
        },
    ]
}

Response Structure

  • (dict) –

    • EventDataStoreArn (string) –

      The Amazon Resource Name (ARN) or ID suffix of the ARN of the event data store for which the event configuration settings were updated.

    • MaxEventSize (string) –

      The maximum allowed size for events stored in the specified event data store.

    • ContextKeySelectors (list) –

      The list of context key selectors that are configured for the event data store.

      • (dict) –

        An object that contains information types to be included in CloudTrail enriched events.

        • Type (string) –

          Specifies the type of the event record field in ContextKeySelector. Valid values include RequestContext, TagContext.

        • Equals (list) –

          A list of keys defined by Type to be included in CloudTrail enriched events.

          • (string) –

Exceptions

  • CloudTrail.Client.exceptions.EventDataStoreARNInvalidException

  • CloudTrail.Client.exceptions.EventDataStoreNotFoundException

  • CloudTrail.Client.exceptions.InvalidEventDataStoreStatusException

  • CloudTrail.Client.exceptions.InvalidEventDataStoreCategoryException

  • CloudTrail.Client.exceptions.InactiveEventDataStoreException

  • CloudTrail.Client.exceptions.UnsupportedOperationException

  • CloudTrail.Client.exceptions.OperationNotPermittedException

  • CloudTrail.Client.exceptions.ThrottlingException

  • CloudTrail.Client.exceptions.InvalidParameterException

  • CloudTrail.Client.exceptions.InvalidParameterCombinationException

  • CloudTrail.Client.exceptions.CloudTrailARNInvalidException

  • CloudTrail.Client.exceptions.ConflictException

  • CloudTrail.Client.exceptions.NotOrganizationMasterAccountException

  • CloudTrail.Client.exceptions.NoManagementAccountSLRExistsException

  • CloudTrail.Client.exceptions.InsufficientDependencyServiceAccessPermissionException

  • CloudTrail.Client.exceptions.InsufficientIAMAccessPermissionException