> **Experimental**
>
> `@aws-cdk/aws-iot-alpha` is an [**experimental**](/stability) (alpha) package: its API may change in any release, without a major version bump.
# ScheduledAuditProps

Properties for defining AWS IoT Scheduled Audit.

Extends: ScheduledAuditProps
Used as props by: ScheduledAudit

- Stability: [Experimental](/cdk/api/stability.html)
- Source: [`lib/scheduled-audit.ts`](https://github.com/aws/aws-cdk/blob/v2.275.0-alpha.0/packages/@aws-cdk/aws-iot-alpha/lib/scheduled-audit.ts#L235)

## Example

```ts
declare const config: iot.AccountAuditConfiguration;

// Daily audit
const dailyAudit = new iot.ScheduledAudit(this, 'DailyAudit', {
  accountAuditConfiguration: config,
  frequency: iot.Frequency.DAILY,
  auditChecks: [
    iot.AuditCheck.AUTHENTICATED_COGNITO_ROLE_OVERLY_PERMISSIVE_CHECK,
  ],
})

// Weekly audit
const weeklyAudit = new iot.ScheduledAudit(this, 'WeeklyAudit', {
  accountAuditConfiguration: config,
  frequency: iot.Frequency.WEEKLY,
  dayOfWeek: iot.DayOfWeek.SUNDAY,
  auditChecks: [
    iot.AuditCheck.CA_CERTIFICATE_EXPIRING_CHECK,
  ],
});

// Monthly audit
const monthlyAudit = new iot.ScheduledAudit(this, 'MonthlyAudit', {
  accountAuditConfiguration: config,
  frequency: iot.Frequency.MONTHLY,
  dayOfMonth: iot.DayOfMonth.of(1),
  auditChecks: [
    iot.AuditCheck.CA_CERTIFICATE_KEY_QUALITY_CHECK,
  ],
});
```

## Properties

- `accountAuditConfiguration`: [IAccountAuditConfiguration](/cdk/api/v2/docs/@aws-cdk_aws-iot-alpha.IAccountAuditConfiguration.html) (required) — Account audit configuration.

  The audit checks specified in `auditChecks` must be enabled in this configuration.

- `auditChecks`: [AuditCheck](/cdk/api/v2/docs/@aws-cdk_aws-iot-alpha.AuditCheck.html)[] (required) — Which checks are performed during the scheduled audit.

  Checks must be enabled for your account.

- `dayOfMonth`: [DayOfMonth](/cdk/api/v2/docs/@aws-cdk_aws-iot-alpha.DayOfMonth.html) — The day of the month on which the scheduled audit is run (if the frequency is "MONTHLY").

  **Default:** required if frequency is "MONTHLY", not allowed otherwise

  If days 29-31 are specified, and the month does not have that many days, the audit takes place on the "LAST" day of the month.

- `dayOfWeek`: [DayOfWeek](/cdk/api/v2/docs/@aws-cdk_aws-iot-alpha.DayOfWeek.html) — The day of the week on which the scheduled audit is run (if the frequency is "WEEKLY" or "BIWEEKLY").

  **Default:** required if frequency is "WEEKLY" or "BIWEEKLY", not allowed otherwise

- `frequency`: [Frequency](/cdk/api/v2/docs/@aws-cdk_aws-iot-alpha.Frequency.html) (required) — How often the scheduled audit occurs.

- `scheduledAuditName`: string — The name of the scheduled audit.

  **Default:** auto generated name