1. Registry
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. iot
  6. getScheduledAudit

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.85.0
published on Monday, Nov 2, 2026 by Pulumi
aws-native logo aws-native logo AWS Cloud Control

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.85.0
published on Monday, Nov 2, 2026 by Pulumi

    Scheduled audits can be used to specify the checks you want to perform during an audit and how often the audit should be run.

    Using getScheduledAudit

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getScheduledAudit(args: GetScheduledAuditArgs, opts?: InvokeOptions): Promise<GetScheduledAuditResult>
    function getScheduledAuditOutput(args: GetScheduledAuditOutputArgs, opts?: InvokeOutputOptions): Output<GetScheduledAuditResult>
    def get_scheduled_audit(scheduled_audit_name: Optional[str] = None,
                            opts: Optional[InvokeOptions] = None) -> GetScheduledAuditResult
    def get_scheduled_audit_output(scheduled_audit_name: pulumi.Input[Optional[str]] = None,
                            opts: Optional[InvokeOutputOptions] = None) -> Output[GetScheduledAuditResult]
    func LookupScheduledAudit(ctx *Context, args *LookupScheduledAuditArgs, opts ...InvokeOption) (*LookupScheduledAuditResult, error)
    func LookupScheduledAuditOutput(ctx *Context, args *LookupScheduledAuditOutputArgs, opts ...InvokeOption) LookupScheduledAuditResultOutput

    > Note: This function is named LookupScheduledAudit in the Go SDK.

    public static class GetScheduledAudit 
    {
        public static Task<GetScheduledAuditResult> InvokeAsync(GetScheduledAuditArgs args, InvokeOptions? opts = null)
        public static Output<GetScheduledAuditResult> Invoke(GetScheduledAuditInvokeArgs args, InvokeOptions? opts = null)
        public static Output<GetScheduledAuditResult> Invoke(GetScheduledAuditInvokeArgs args, InvokeOutputOptions opts)
    }
    public static CompletableFuture<GetScheduledAuditResult> getScheduledAudit(GetScheduledAuditArgs args, InvokeOptions options)
    public static Output<GetScheduledAuditResult> getScheduledAudit(GetScheduledAuditArgs args, InvokeOptions options)
    public static Output<GetScheduledAuditResult> getScheduledAudit(GetScheduledAuditArgs args, InvokeOutputOptions options)
    
    fn::invoke:
      function: aws-native:iot:getScheduledAudit
      arguments:
        # arguments dictionary
    data "aws-native_iot_get_scheduled_audit" "name" {
        # arguments
    }

    The following arguments are supported:

    ScheduledAuditName string
    The name you want to give to the scheduled audit.
    ScheduledAuditName string
    The name you want to give to the scheduled audit.
    scheduled_audit_name string
    The name you want to give to the scheduled audit.
    scheduledAuditName String
    The name you want to give to the scheduled audit.
    scheduledAuditName string
    The name you want to give to the scheduled audit.
    scheduled_audit_name str
    The name you want to give to the scheduled audit.
    scheduledAuditName String
    The name you want to give to the scheduled audit.

    getScheduledAudit Result

    The following output properties are available:

    DayOfMonth string
    The day of the month on which the scheduled audit takes place. Can be 1 through 31 or LAST. This field is required if the frequency parameter is set to MONTHLY.
    DayOfWeek Pulumi.AwsNative.IoT.ScheduledAuditDayOfWeek
    The day of the week on which the scheduled audit takes place. Can be one of SUN, MON, TUE,WED, THU, FRI, or SAT. This field is required if the frequency parameter is set to WEEKLY or BIWEEKLY.
    Frequency Pulumi.AwsNative.IoT.ScheduledAuditFrequency
    How often the scheduled audit takes place. Can be one of DAILY, WEEKLY, BIWEEKLY, or MONTHLY.
    ScheduledAuditArn string
    The ARN (Amazon resource name) of the scheduled audit.
    Tags List<Pulumi.AwsNative.Outputs.Tag>
    An array of key-value pairs to apply to this resource.
    TargetCheckNames List<string>
    Which checks are performed during the scheduled audit. Checks must be enabled for your account.
    DayOfMonth string
    The day of the month on which the scheduled audit takes place. Can be 1 through 31 or LAST. This field is required if the frequency parameter is set to MONTHLY.
    DayOfWeek ScheduledAuditDayOfWeek
    The day of the week on which the scheduled audit takes place. Can be one of SUN, MON, TUE,WED, THU, FRI, or SAT. This field is required if the frequency parameter is set to WEEKLY or BIWEEKLY.
    Frequency ScheduledAuditFrequency
    How often the scheduled audit takes place. Can be one of DAILY, WEEKLY, BIWEEKLY, or MONTHLY.
    ScheduledAuditArn string
    The ARN (Amazon resource name) of the scheduled audit.
    Tags Tag
    An array of key-value pairs to apply to this resource.
    TargetCheckNames []string
    Which checks are performed during the scheduled audit. Checks must be enabled for your account.
    day_of_month string
    The day of the month on which the scheduled audit takes place. Can be 1 through 31 or LAST. This field is required if the frequency parameter is set to MONTHLY.
    day_of_week "SUN" | "MON" | "TUE" | "WED" | "THU" | "FRI" | "SAT" | "UNSET_VALUE"
    The day of the week on which the scheduled audit takes place. Can be one of SUN, MON, TUE,WED, THU, FRI, or SAT. This field is required if the frequency parameter is set to WEEKLY or BIWEEKLY.
    frequency "DAILY" | "WEEKLY" | "BIWEEKLY" | "MONTHLY"
    How often the scheduled audit takes place. Can be one of DAILY, WEEKLY, BIWEEKLY, or MONTHLY.
    scheduled_audit_arn string
    The ARN (Amazon resource name) of the scheduled audit.
    tags list(object)
    An array of key-value pairs to apply to this resource.
    target_check_names list(string)
    Which checks are performed during the scheduled audit. Checks must be enabled for your account.
    dayOfMonth String
    The day of the month on which the scheduled audit takes place. Can be 1 through 31 or LAST. This field is required if the frequency parameter is set to MONTHLY.
    dayOfWeek ScheduledAuditDayOfWeek
    The day of the week on which the scheduled audit takes place. Can be one of SUN, MON, TUE,WED, THU, FRI, or SAT. This field is required if the frequency parameter is set to WEEKLY or BIWEEKLY.
    frequency ScheduledAuditFrequency
    How often the scheduled audit takes place. Can be one of DAILY, WEEKLY, BIWEEKLY, or MONTHLY.
    scheduledAuditArn String
    The ARN (Amazon resource name) of the scheduled audit.
    tags List<Tag>
    An array of key-value pairs to apply to this resource.
    targetCheckNames List<String>
    Which checks are performed during the scheduled audit. Checks must be enabled for your account.
    dayOfMonth string
    The day of the month on which the scheduled audit takes place. Can be 1 through 31 or LAST. This field is required if the frequency parameter is set to MONTHLY.
    dayOfWeek ScheduledAuditDayOfWeek
    The day of the week on which the scheduled audit takes place. Can be one of SUN, MON, TUE,WED, THU, FRI, or SAT. This field is required if the frequency parameter is set to WEEKLY or BIWEEKLY.
    frequency ScheduledAuditFrequency
    How often the scheduled audit takes place. Can be one of DAILY, WEEKLY, BIWEEKLY, or MONTHLY.
    scheduledAuditArn string
    The ARN (Amazon resource name) of the scheduled audit.
    tags Tag[]
    An array of key-value pairs to apply to this resource.
    targetCheckNames string[]
    Which checks are performed during the scheduled audit. Checks must be enabled for your account.
    day_of_month str
    The day of the month on which the scheduled audit takes place. Can be 1 through 31 or LAST. This field is required if the frequency parameter is set to MONTHLY.
    day_of_week ScheduledAuditDayOfWeek
    The day of the week on which the scheduled audit takes place. Can be one of SUN, MON, TUE,WED, THU, FRI, or SAT. This field is required if the frequency parameter is set to WEEKLY or BIWEEKLY.
    frequency ScheduledAuditFrequency
    How often the scheduled audit takes place. Can be one of DAILY, WEEKLY, BIWEEKLY, or MONTHLY.
    scheduled_audit_arn str
    The ARN (Amazon resource name) of the scheduled audit.
    tags Sequence[root_Tag]
    An array of key-value pairs to apply to this resource.
    target_check_names Sequence[str]
    Which checks are performed during the scheduled audit. Checks must be enabled for your account.
    dayOfMonth String
    The day of the month on which the scheduled audit takes place. Can be 1 through 31 or LAST. This field is required if the frequency parameter is set to MONTHLY.
    dayOfWeek "SUN" | "MON" | "TUE" | "WED" | "THU" | "FRI" | "SAT" | "UNSET_VALUE"
    The day of the week on which the scheduled audit takes place. Can be one of SUN, MON, TUE,WED, THU, FRI, or SAT. This field is required if the frequency parameter is set to WEEKLY or BIWEEKLY.
    frequency "DAILY" | "WEEKLY" | "BIWEEKLY" | "MONTHLY"
    How often the scheduled audit takes place. Can be one of DAILY, WEEKLY, BIWEEKLY, or MONTHLY.
    scheduledAuditArn String
    The ARN (Amazon resource name) of the scheduled audit.
    tags List<Property Map>
    An array of key-value pairs to apply to this resource.
    targetCheckNames List<String>
    Which checks are performed during the scheduled audit. Checks must be enabled for your account.

    Supporting Types

    ScheduledAuditDayOfWeek

    Sun
    SUN
    Mon
    MON
    Tue
    TUE
    Wed
    WED
    Thu
    THU
    Fri
    FRI
    Sat
    SAT
    UnsetValue
    UNSET_VALUE
    ScheduledAuditDayOfWeekSun
    SUN
    ScheduledAuditDayOfWeekMon
    MON
    ScheduledAuditDayOfWeekTue
    TUE
    ScheduledAuditDayOfWeekWed
    WED
    ScheduledAuditDayOfWeekThu
    THU
    ScheduledAuditDayOfWeekFri
    FRI
    ScheduledAuditDayOfWeekSat
    SAT
    ScheduledAuditDayOfWeekUnsetValue
    UNSET_VALUE
    "SUN"
    SUN
    "MON"
    MON
    "TUE"
    TUE
    "WED"
    WED
    "THU"
    THU
    "FRI"
    FRI
    "SAT"
    SAT
    "UNSET_VALUE"
    UNSET_VALUE
    Sun
    SUN
    Mon
    MON
    Tue
    TUE
    Wed
    WED
    Thu
    THU
    Fri
    FRI
    Sat
    SAT
    UnsetValue
    UNSET_VALUE
    Sun
    SUN
    Mon
    MON
    Tue
    TUE
    Wed
    WED
    Thu
    THU
    Fri
    FRI
    Sat
    SAT
    UnsetValue
    UNSET_VALUE
    SUN
    SUN
    MON
    MON
    TUE
    TUE
    WED
    WED
    THU
    THU
    FRI
    FRI
    SAT
    SAT
    UNSET_VALUE
    UNSET_VALUE
    "SUN"
    SUN
    "MON"
    MON
    "TUE"
    TUE
    "WED"
    WED
    "THU"
    THU
    "FRI"
    FRI
    "SAT"
    SAT
    "UNSET_VALUE"
    UNSET_VALUE

    ScheduledAuditFrequency

    Daily
    DAILY
    Weekly
    WEEKLY
    Biweekly
    BIWEEKLY
    Monthly
    MONTHLY
    ScheduledAuditFrequencyDaily
    DAILY
    ScheduledAuditFrequencyWeekly
    WEEKLY
    ScheduledAuditFrequencyBiweekly
    BIWEEKLY
    ScheduledAuditFrequencyMonthly
    MONTHLY
    "DAILY"
    DAILY
    "WEEKLY"
    WEEKLY
    "BIWEEKLY"
    BIWEEKLY
    "MONTHLY"
    MONTHLY
    Daily
    DAILY
    Weekly
    WEEKLY
    Biweekly
    BIWEEKLY
    Monthly
    MONTHLY
    Daily
    DAILY
    Weekly
    WEEKLY
    Biweekly
    BIWEEKLY
    Monthly
    MONTHLY
    DAILY
    DAILY
    WEEKLY
    WEEKLY
    BIWEEKLY
    BIWEEKLY
    MONTHLY
    MONTHLY
    "DAILY"
    DAILY
    "WEEKLY"
    WEEKLY
    "BIWEEKLY"
    BIWEEKLY
    "MONTHLY"
    MONTHLY

    Tag

    Key string
    The key name of the tag
    Value string
    The value of the tag
    Key string
    The key name of the tag
    Value string
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key str
    The key name of the tag
    value str
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo aws-native logo AWS Cloud Control

    We recommend new projects start with resources from the AWS provider.

    Viewing docs for AWS Cloud Control v1.85.0
    published on Monday, Nov 2, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial