Inspector2 / Client / create_cis_scan_configuration

create_cis_scan_configuration

Inspector2.Client.create_cis_scan_configuration(**kwargs)

Creates a CIS scan configuration.

See also: AWS API Documentation

Request Syntax

response = client.create_cis_scan_configuration(
    scanName='string',
    securityLevel='LEVEL_1'|'LEVEL_2',
    schedule={
        'oneTime': {}
        ,
        'daily': {
            'startTime': {
                'timeOfDay': 'string',
                'timezone': 'string'
            }
        },
        'weekly': {
            'startTime': {
                'timeOfDay': 'string',
                'timezone': 'string'
            },
            'days': [
                'SUN'|'MON'|'TUE'|'WED'|'THU'|'FRI'|'SAT',
            ]
        },
        'monthly': {
            'startTime': {
                'timeOfDay': 'string',
                'timezone': 'string'
            },
            'day': 'SUN'|'MON'|'TUE'|'WED'|'THU'|'FRI'|'SAT'
        }
    },
    targets={
        'accountIds': [
            'string',
        ],
        'targetResourceTags': {
            'string': [
                'string',
            ]
        }
    },
    tags={
        'string': 'string'
    }
)
Parameters:

  • scanName (string) –

    [REQUIRED]

    The scan name for the CIS scan configuration.

  • securityLevel (string) –

    [REQUIRED]

    The security level for the CIS scan configuration. Security level refers to the Benchmark levels that CIS assigns to a profile.

  • schedule (dict) –

    [REQUIRED]

    The schedule for the CIS scan configuration.

    Note

    This is a Tagged Union structure. Only one of the following top level keys can be set: oneTime, daily, weekly, monthly.

    • oneTime (dict) –

      The schedule’s one time.

    • daily (dict) –

      The schedule’s daily.

      • startTime (dict) – [REQUIRED]

        The schedule start time.

        • timeOfDay (string) – [REQUIRED]

          The time of day in 24-hour format (00:00).

        • timezone (string) – [REQUIRED]

          The timezone.

    • weekly (dict) –

      The schedule’s weekly.

      • startTime (dict) – [REQUIRED]

        The weekly schedule’s start time.

        • timeOfDay (string) – [REQUIRED]

          The time of day in 24-hour format (00:00).

        • timezone (string) – [REQUIRED]

          The timezone.

      • days (list) – [REQUIRED]

        The weekly schedule’s days.

        • (string) –

    • monthly (dict) –

      The schedule’s monthly.

      • startTime (dict) – [REQUIRED]

        The monthly schedule’s start time.

        • timeOfDay (string) – [REQUIRED]

          The time of day in 24-hour format (00:00).

        • timezone (string) – [REQUIRED]

          The timezone.

      • day (string) – [REQUIRED]

        The monthly schedule’s day.

  • targets (dict) –

    [REQUIRED]

    The targets for the CIS scan configuration.

    • accountIds (list) – [REQUIRED]

      The CIS target account ids.

      • (string) –

    • targetResourceTags (dict) – [REQUIRED]

      The CIS target resource tags.

      • (string) –

        • (list) –

          • (string) –

  • tags (dict) –

    The tags for the CIS scan configuration.

    • (string) –

      • (string) –

Return type:

dict

Returns:

Response Syntax

{
    'scanConfigurationArn': 'string'
}

Response Structure

  • (dict) –

    • scanConfigurationArn (string) –

      The scan configuration ARN for the CIS scan configuration.

Exceptions