SecurityLake / Paginator / ListLogSources

ListLogSources#

class SecurityLake.Paginator.ListLogSources#

paginator = client.get_paginator('list_log_sources')

paginate(**kwargs)#

Creates an iterator that will paginate through responses from SecurityLake.Client.list_log_sources().

Request Syntax

response_iterator = paginator.paginate(
    accounts=[
        'string',
    ],
    regions=[
        'string',
    ],
    sources=[
        {
            'awsLogSource': {
                'sourceName': 'ROUTE53'|'VPC_FLOW'|'SH_FINDINGS'|'CLOUD_TRAIL_MGMT'|'LAMBDA_EXECUTION'|'S3_DATA',
                'sourceVersion': 'string'
            },
            'customLogSource': {
                'attributes': {
                    'crawlerArn': 'string',
                    'databaseArn': 'string',
                    'tableArn': 'string'
                },
                'provider': {
                    'location': 'string',
                    'roleArn': 'string'
                },
                'sourceName': 'string',
                'sourceVersion': 'string'
            }
        },
    ],
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)

Parameters:

accounts (list) –
The list of Amazon Web Services accounts for which log sources are displayed.
- (string) –
regions (list) –
The list of regions for which log sources are displayed.
- (string) –
sources (list) –
The list of sources for which log sources are displayed.
- (dict) –
  
  The supported source types from which logs and events are collected in Amazon Security Lake. For a list of supported Amazon Web Services, see the Amazon Security Lake User Guide.
  
  Note
  This is a Tagged Union structure. Only one of the following top level keys can be set: awsLogSource, customLogSource.
  - awsLogSource (dict) –
    
    Amazon Security Lake supports log and event collection for natively supported Amazon Web Services. For more information, see the Amazon Security Lake User Guide.
    - sourceName (string) –
      
      The name for a Amazon Web Services source. This must be a Regionally unique value.
    - sourceVersion (string) –
      
      The version for a Amazon Web Services source. This must be a Regionally unique value.
  - customLogSource (dict) –
    
    Amazon Security Lake supports custom source types. For more information, see the Amazon Security Lake User Guide.
    - attributes (dict) –
      
      The attributes of a third-party custom source.
      - crawlerArn (string) –
        
        The ARN of the Glue crawler.
      - databaseArn (string) –
        
        The ARN of the Glue database where results are written, such as: arn:aws:daylight:us-east-1::database/sometable/*.
      - tableArn (string) –
        
        The ARN of the Glue table.
    - provider (dict) –
      
      The details of the log provider for a third-party custom source.
      - location (string) –
        
        The location of the partition in the Amazon S3 bucket for Security Lake.
      - roleArn (string) –
        
        The ARN of the IAM role to be used by the entity putting logs into your custom source partition. Security Lake will apply the correct access policies to this role, but you must first manually create the trust policy for this role. The IAM role name must start with the text ‘Security Lake’. The IAM role must trust the logProviderAccountId to assume the role.
    - sourceName (string) –
      
      The name for a third-party custom source. This must be a Regionally unique value.
    - sourceVersion (string) –
      
      The version for a third-party custom source. This must be a Regionally unique value.
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
- MaxItems (integer) –
  
  The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
- PageSize (integer) –
  
  The size of each page.
- StartingToken (string) –
  
  A token to specify where to start paginating. This is the NextToken from a previous response.

Return type:

dict

Returns:

Response Syntax

{
    'sources': [
        {
            'account': 'string',
            'region': 'string',
            'sources': [
                {
                    'awsLogSource': {
                        'sourceName': 'ROUTE53'|'VPC_FLOW'|'SH_FINDINGS'|'CLOUD_TRAIL_MGMT'|'LAMBDA_EXECUTION'|'S3_DATA',
                        'sourceVersion': 'string'
                    },
                    'customLogSource': {
                        'attributes': {
                            'crawlerArn': 'string',
                            'databaseArn': 'string',
                            'tableArn': 'string'
                        },
                        'provider': {
                            'location': 'string',
                            'roleArn': 'string'
                        },
                        'sourceName': 'string',
                        'sourceVersion': 'string'
                    }
                },
            ]
        },
    ],
    'NextToken': 'string'
}

Response Structure

(dict) –
- sources (list) –
  
  The list of log sources in your organization that send data to the data lake.
  - (dict) –
    
    Amazon Security Lake can collect logs and events from natively-supported Amazon Web Services services and custom sources.
    - account (string) –
      
      Specify the account from which you want to collect logs.
    - region (string) –
      
      Specify the Regions from which you want to collect logs.
    - sources (list) –
      
      Specify the sources from which you want to collect logs.
      - (dict) –
        
        The supported source types from which logs and events are collected in Amazon Security Lake. For a list of supported Amazon Web Services, see the Amazon Security Lake User Guide.
        
        Note
        This is a Tagged Union structure. Only one of the following top level keys will be set: awsLogSource, customLogSource. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:
        
        'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
        
        awsLogSource (dict) –
        
        Amazon Security Lake supports log and event collection for natively supported Amazon Web Services. For more information, see the Amazon Security Lake User Guide.
        
        sourceName (string) –
        
        The name for a Amazon Web Services source. This must be a Regionally unique value.
        
        sourceVersion (string) –
        
        The version for a Amazon Web Services source. This must be a Regionally unique value.
        
        customLogSource (dict) –
        
        Amazon Security Lake supports custom source types. For more information, see the Amazon Security Lake User Guide.
        
        attributes (dict) –
        
        The attributes of a third-party custom source.
        
        crawlerArn (string) –
        
        The ARN of the Glue crawler.
        
        databaseArn (string) –
        
        The ARN of the Glue database where results are written, such as: arn:aws:daylight:us-east-1::database/sometable/*.
        
        tableArn (string) –
        
        The ARN of the Glue table.
        
        provider (dict) –
        
        The details of the log provider for a third-party custom source.
        
        location (string) –
        
        The location of the partition in the Amazon S3 bucket for Security Lake.
        
        roleArn (string) –
        
        The ARN of the IAM role to be used by the entity putting logs into your custom source partition. Security Lake will apply the correct access policies to this role, but you must first manually create the trust policy for this role. The IAM role name must start with the text ‘Security Lake’. The IAM role must trust the logProviderAccountId to assume the role.
        
        sourceName (string) –
        
        The name for a third-party custom source. This must be a Regionally unique value.
        
        sourceVersion (string) –
        
        The version for a third-party custom source. This must be a Regionally unique value.
- NextToken (string) –
  
  A token to resume pagination.