1. Registry
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. ec2
  6. getInstanceEventWindow

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

Viewing docs for AWS Cloud Control v1.81.0
published on Monday, Sep 28, 2026 by Pulumi
aws-native logo aws-native logo

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

Viewing docs for AWS Cloud Control v1.81.0
published on Monday, Sep 28, 2026 by Pulumi

    Resource type definition for AWS::EC2::InstanceEventWindow. An event window defines a recurring set of time ranges, or a cron expression, during which AWS-initiated maintenance events may be scheduled for the associated Amazon EC2 instances or Dedicated Hosts.

    Using getInstanceEventWindow

    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 getInstanceEventWindow(args: GetInstanceEventWindowArgs, opts?: InvokeOptions): Promise<GetInstanceEventWindowResult>
    function getInstanceEventWindowOutput(args: GetInstanceEventWindowOutputArgs, opts?: InvokeOutputOptions): Output<GetInstanceEventWindowResult>
    def get_instance_event_window(arn: Optional[str] = None,
                                  opts: Optional[InvokeOptions] = None) -> GetInstanceEventWindowResult
    def get_instance_event_window_output(arn: pulumi.Input[Optional[str]] = None,
                                  opts: Optional[InvokeOutputOptions] = None) -> Output[GetInstanceEventWindowResult]
    func LookupInstanceEventWindow(ctx *Context, args *LookupInstanceEventWindowArgs, opts ...InvokeOption) (*LookupInstanceEventWindowResult, error)
    func LookupInstanceEventWindowOutput(ctx *Context, args *LookupInstanceEventWindowOutputArgs, opts ...InvokeOption) LookupInstanceEventWindowResultOutput

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

    public static class GetInstanceEventWindow 
    {
        public static Task<GetInstanceEventWindowResult> InvokeAsync(GetInstanceEventWindowArgs args, InvokeOptions? opts = null)
        public static Output<GetInstanceEventWindowResult> Invoke(GetInstanceEventWindowInvokeArgs args, InvokeOptions? opts = null)
        public static Output<GetInstanceEventWindowResult> Invoke(GetInstanceEventWindowInvokeArgs args, InvokeOutputOptions opts)
    }
    public static CompletableFuture<GetInstanceEventWindowResult> getInstanceEventWindow(GetInstanceEventWindowArgs args, InvokeOptions options)
    public static Output<GetInstanceEventWindowResult> getInstanceEventWindow(GetInstanceEventWindowArgs args, InvokeOptions options)
    public static Output<GetInstanceEventWindowResult> getInstanceEventWindow(GetInstanceEventWindowArgs args, InvokeOutputOptions options)
    
    fn::invoke:
      function: aws-native:ec2:getInstanceEventWindow
      arguments:
        # arguments dictionary
    data "aws-native_ec2_get_instance_event_window" "name" {
        # arguments
    }

    The following arguments are supported:

    Arn string
    The Amazon Resource Name (ARN) of the event window.
    Arn string
    The Amazon Resource Name (ARN) of the event window.
    arn string
    The Amazon Resource Name (ARN) of the event window.
    arn String
    The Amazon Resource Name (ARN) of the event window.
    arn string
    The Amazon Resource Name (ARN) of the event window.
    arn str
    The Amazon Resource Name (ARN) of the event window.
    arn String
    The Amazon Resource Name (ARN) of the event window.

    getInstanceEventWindow Result

    The following output properties are available:

    Arn string
    The Amazon Resource Name (ARN) of the event window.
    CronExpression string
    The cron expression defined for the event window. Exactly one of TimeRanges or CronExpression must be specified.
    InstanceEventWindowId string
    The ID of the event window.
    Name string
    The name of the event window.
    State string
    The current state of the event window. Observed values include creating, active, modifying, deleting and deleted.
    Tags List<Pulumi.AwsNative.Outputs.Tag>
    The tags applied to the event window.
    TimeRanges List<Pulumi.AwsNative.Ec2.Outputs.InstanceEventWindowTimeRange>
    The time ranges of the event window. Exactly one of TimeRanges or CronExpression must be specified.
    Arn string
    The Amazon Resource Name (ARN) of the event window.
    CronExpression string
    The cron expression defined for the event window. Exactly one of TimeRanges or CronExpression must be specified.
    InstanceEventWindowId string
    The ID of the event window.
    Name string
    The name of the event window.
    State string
    The current state of the event window. Observed values include creating, active, modifying, deleting and deleted.
    Tags Tag
    The tags applied to the event window.
    TimeRanges []InstanceEventWindowTimeRange
    The time ranges of the event window. Exactly one of TimeRanges or CronExpression must be specified.
    arn string
    The Amazon Resource Name (ARN) of the event window.
    cron_expression string
    The cron expression defined for the event window. Exactly one of TimeRanges or CronExpression must be specified.
    instance_event_window_id string
    The ID of the event window.
    name string
    The name of the event window.
    state string
    The current state of the event window. Observed values include creating, active, modifying, deleting and deleted.
    tags list(object)
    The tags applied to the event window.
    time_ranges list(object)
    The time ranges of the event window. Exactly one of TimeRanges or CronExpression must be specified.
    arn String
    The Amazon Resource Name (ARN) of the event window.
    cronExpression String
    The cron expression defined for the event window. Exactly one of TimeRanges or CronExpression must be specified.
    instanceEventWindowId String
    The ID of the event window.
    name String
    The name of the event window.
    state String
    The current state of the event window. Observed values include creating, active, modifying, deleting and deleted.
    tags List<Tag>
    The tags applied to the event window.
    timeRanges List<InstanceEventWindowTimeRange>
    The time ranges of the event window. Exactly one of TimeRanges or CronExpression must be specified.
    arn string
    The Amazon Resource Name (ARN) of the event window.
    cronExpression string
    The cron expression defined for the event window. Exactly one of TimeRanges or CronExpression must be specified.
    instanceEventWindowId string
    The ID of the event window.
    name string
    The name of the event window.
    state string
    The current state of the event window. Observed values include creating, active, modifying, deleting and deleted.
    tags Tag[]
    The tags applied to the event window.
    timeRanges InstanceEventWindowTimeRange[]
    The time ranges of the event window. Exactly one of TimeRanges or CronExpression must be specified.
    arn str
    The Amazon Resource Name (ARN) of the event window.
    cron_expression str
    The cron expression defined for the event window. Exactly one of TimeRanges or CronExpression must be specified.
    instance_event_window_id str
    The ID of the event window.
    name str
    The name of the event window.
    state str
    The current state of the event window. Observed values include creating, active, modifying, deleting and deleted.
    tags Sequence[root_Tag]
    The tags applied to the event window.
    time_ranges Sequence[InstanceEventWindowTimeRange]
    The time ranges of the event window. Exactly one of TimeRanges or CronExpression must be specified.
    arn String
    The Amazon Resource Name (ARN) of the event window.
    cronExpression String
    The cron expression defined for the event window. Exactly one of TimeRanges or CronExpression must be specified.
    instanceEventWindowId String
    The ID of the event window.
    name String
    The name of the event window.
    state String
    The current state of the event window. Observed values include creating, active, modifying, deleting and deleted.
    tags List<Property Map>
    The tags applied to the event window.
    timeRanges List<Property Map>
    The time ranges of the event window. Exactly one of TimeRanges or CronExpression must be specified.

    Supporting Types

    InstanceEventWindowTimeRange

    EndHour int
    The hour when the time range ends.
    EndWeekDay Pulumi.AwsNative.Ec2.InstanceEventWindowTimeRangeEndWeekDay
    The day on which the time range ends.
    StartHour int
    The hour when the time range begins.
    StartWeekDay Pulumi.AwsNative.Ec2.InstanceEventWindowTimeRangeStartWeekDay
    The day on which the time range begins.
    EndHour int
    The hour when the time range ends.
    EndWeekDay InstanceEventWindowTimeRangeEndWeekDay
    The day on which the time range ends.
    StartHour int
    The hour when the time range begins.
    StartWeekDay InstanceEventWindowTimeRangeStartWeekDay
    The day on which the time range begins.
    end_hour number
    The hour when the time range ends.
    end_week_day "sunday" | "monday" | "tuesday" | "wednesday" | "thursday" | "friday" | "saturday"
    The day on which the time range ends.
    start_hour number
    The hour when the time range begins.
    start_week_day "sunday" | "monday" | "tuesday" | "wednesday" | "thursday" | "friday" | "saturday"
    The day on which the time range begins.
    endHour Integer
    The hour when the time range ends.
    endWeekDay InstanceEventWindowTimeRangeEndWeekDay
    The day on which the time range ends.
    startHour Integer
    The hour when the time range begins.
    startWeekDay InstanceEventWindowTimeRangeStartWeekDay
    The day on which the time range begins.
    endHour number
    The hour when the time range ends.
    endWeekDay InstanceEventWindowTimeRangeEndWeekDay
    The day on which the time range ends.
    startHour number
    The hour when the time range begins.
    startWeekDay InstanceEventWindowTimeRangeStartWeekDay
    The day on which the time range begins.
    end_hour int
    The hour when the time range ends.
    end_week_day InstanceEventWindowTimeRangeEndWeekDay
    The day on which the time range ends.
    start_hour int
    The hour when the time range begins.
    start_week_day InstanceEventWindowTimeRangeStartWeekDay
    The day on which the time range begins.
    endHour Number
    The hour when the time range ends.
    endWeekDay "sunday" | "monday" | "tuesday" | "wednesday" | "thursday" | "friday" | "saturday"
    The day on which the time range ends.
    startHour Number
    The hour when the time range begins.
    startWeekDay "sunday" | "monday" | "tuesday" | "wednesday" | "thursday" | "friday" | "saturday"
    The day on which the time range begins.

    InstanceEventWindowTimeRangeEndWeekDay

    InstanceEventWindowTimeRangeStartWeekDay

    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

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

    Viewing docs for AWS Cloud Control v1.81.0
    published on Monday, Sep 28, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial