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

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.

    Create InstanceEventWindow Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new InstanceEventWindow(name: string, args?: InstanceEventWindowArgs, opts?: CustomResourceOptions);
    @overload
    def InstanceEventWindow(resource_name: str,
                            args: Optional[InstanceEventWindowArgs] = None,
                            opts: Optional[ResourceOptions] = None)
    
    @overload
    def InstanceEventWindow(resource_name: str,
                            opts: Optional[ResourceOptions] = None,
                            cron_expression: Optional[str] = None,
                            name: Optional[str] = None,
                            tags: Optional[Sequence[_root_inputs.TagArgs]] = None,
                            time_ranges: Optional[Sequence[InstanceEventWindowTimeRangeArgs]] = None)
    func NewInstanceEventWindow(ctx *Context, name string, args *InstanceEventWindowArgs, opts ...ResourceOption) (*InstanceEventWindow, error)
    public InstanceEventWindow(string name, InstanceEventWindowArgs? args = null, CustomResourceOptions? opts = null)
    public InstanceEventWindow(String name, InstanceEventWindowArgs args)
    public InstanceEventWindow(String name, InstanceEventWindowArgs args, CustomResourceOptions options)
    
    type: aws-native:ec2:InstanceEventWindow
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "aws-native_ec2_instance_event_window" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args InstanceEventWindowArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args InstanceEventWindowArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args InstanceEventWindowArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args InstanceEventWindowArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args InstanceEventWindowArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    InstanceEventWindow Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The InstanceEventWindow resource accepts the following input properties:

    CronExpression string
    The cron expression defined for the event window. Exactly one of TimeRanges or CronExpression must be specified.
    Name string
    The name of the event window.
    Tags List<Pulumi.AwsNative.Inputs.Tag>
    The tags applied to the event window.
    TimeRanges List<Pulumi.AwsNative.Ec2.Inputs.InstanceEventWindowTimeRange>
    The time ranges of the event window. Exactly one of TimeRanges or CronExpression must be specified.
    CronExpression string
    The cron expression defined for the event window. Exactly one of TimeRanges or CronExpression must be specified.
    Name string
    The name of the event window.
    Tags TagArgs
    The tags applied to the event window.
    TimeRanges []InstanceEventWindowTimeRangeArgs
    The time ranges of the event window. Exactly one of TimeRanges or CronExpression must be specified.
    cron_expression string
    The cron expression defined for the event window. Exactly one of TimeRanges or CronExpression must be specified.
    name string
    The name of the event window.
    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.
    cronExpression String
    The cron expression defined for the event window. Exactly one of TimeRanges or CronExpression must be specified.
    name String
    The name of the event window.
    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.
    cronExpression string
    The cron expression defined for the event window. Exactly one of TimeRanges or CronExpression must be specified.
    name string
    The name of the event window.
    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.
    cron_expression str
    The cron expression defined for the event window. Exactly one of TimeRanges or CronExpression must be specified.
    name str
    The name of the event window.
    tags Sequence[TagArgs]
    The tags applied to the event window.
    time_ranges Sequence[InstanceEventWindowTimeRangeArgs]
    The time ranges of the event window. Exactly one of TimeRanges or CronExpression must be specified.
    cronExpression String
    The cron expression defined for the event window. Exactly one of TimeRanges or CronExpression must be specified.
    name String
    The name of the event window.
    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.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the InstanceEventWindow resource produces the following output properties:

    Arn string
    The Amazon Resource Name (ARN) of the event window.
    Id string
    The provider-assigned unique ID for this managed resource.
    InstanceEventWindowId string
    The ID of the event window.
    State string
    The current state of the event window. Observed values include creating, active, modifying, deleting and deleted.
    Arn string
    The Amazon Resource Name (ARN) of the event window.
    Id string
    The provider-assigned unique ID for this managed resource.
    InstanceEventWindowId string
    The ID of the event window.
    State string
    The current state of the event window. Observed values include creating, active, modifying, deleting and deleted.
    arn string
    The Amazon Resource Name (ARN) of the event window.
    id string
    The provider-assigned unique ID for this managed resource.
    instance_event_window_id string
    The ID of the event window.
    state string
    The current state of the event window. Observed values include creating, active, modifying, deleting and deleted.
    arn String
    The Amazon Resource Name (ARN) of the event window.
    id String
    The provider-assigned unique ID for this managed resource.
    instanceEventWindowId String
    The ID of the event window.
    state String
    The current state of the event window. Observed values include creating, active, modifying, deleting and deleted.
    arn string
    The Amazon Resource Name (ARN) of the event window.
    id string
    The provider-assigned unique ID for this managed resource.
    instanceEventWindowId string
    The ID of the event window.
    state string
    The current state of the event window. Observed values include creating, active, modifying, deleting and deleted.
    arn str
    The Amazon Resource Name (ARN) of the event window.
    id str
    The provider-assigned unique ID for this managed resource.
    instance_event_window_id str
    The ID of the event window.
    state str
    The current state of the event window. Observed values include creating, active, modifying, deleting and deleted.
    arn String
    The Amazon Resource Name (ARN) of the event window.
    id String
    The provider-assigned unique ID for this managed resource.
    instanceEventWindowId String
    The ID of the event window.
    state String
    The current state of the event window. Observed values include creating, active, modifying, deleting and deleted.

    Supporting Types

    InstanceEventWindowTimeRange, InstanceEventWindowTimeRangeArgs

    A time range during which an AWS-initiated maintenance event may occur.
    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, InstanceEventWindowTimeRangeEndWeekDayArgs

    Sunday
    sunday
    Monday
    monday
    Tuesday
    tuesday
    Wednesday
    wednesday
    Thursday
    thursday
    Friday
    friday
    Saturday
    saturday
    InstanceEventWindowTimeRangeEndWeekDaySunday
    sunday
    InstanceEventWindowTimeRangeEndWeekDayMonday
    monday
    InstanceEventWindowTimeRangeEndWeekDayTuesday
    tuesday
    InstanceEventWindowTimeRangeEndWeekDayWednesday
    wednesday
    InstanceEventWindowTimeRangeEndWeekDayThursday
    thursday
    InstanceEventWindowTimeRangeEndWeekDayFriday
    friday
    InstanceEventWindowTimeRangeEndWeekDaySaturday
    saturday
    "sunday"
    sunday
    "monday"
    monday
    "tuesday"
    tuesday
    "wednesday"
    wednesday
    "thursday"
    thursday
    "friday"
    friday
    "saturday"
    saturday
    Sunday
    sunday
    Monday
    monday
    Tuesday
    tuesday
    Wednesday
    wednesday
    Thursday
    thursday
    Friday
    friday
    Saturday
    saturday
    Sunday
    sunday
    Monday
    monday
    Tuesday
    tuesday
    Wednesday
    wednesday
    Thursday
    thursday
    Friday
    friday
    Saturday
    saturday
    SUNDAY
    sunday
    MONDAY
    monday
    TUESDAY
    tuesday
    WEDNESDAY
    wednesday
    THURSDAY
    thursday
    FRIDAY
    friday
    SATURDAY
    saturday
    "sunday"
    sunday
    "monday"
    monday
    "tuesday"
    tuesday
    "wednesday"
    wednesday
    "thursday"
    thursday
    "friday"
    friday
    "saturday"
    saturday

    InstanceEventWindowTimeRangeStartWeekDay, InstanceEventWindowTimeRangeStartWeekDayArgs

    Sunday
    sunday
    Monday
    monday
    Tuesday
    tuesday
    Wednesday
    wednesday
    Thursday
    thursday
    Friday
    friday
    Saturday
    saturday
    InstanceEventWindowTimeRangeStartWeekDaySunday
    sunday
    InstanceEventWindowTimeRangeStartWeekDayMonday
    monday
    InstanceEventWindowTimeRangeStartWeekDayTuesday
    tuesday
    InstanceEventWindowTimeRangeStartWeekDayWednesday
    wednesday
    InstanceEventWindowTimeRangeStartWeekDayThursday
    thursday
    InstanceEventWindowTimeRangeStartWeekDayFriday
    friday
    InstanceEventWindowTimeRangeStartWeekDaySaturday
    saturday
    "sunday"
    sunday
    "monday"
    monday
    "tuesday"
    tuesday
    "wednesday"
    wednesday
    "thursday"
    thursday
    "friday"
    friday
    "saturday"
    saturday
    Sunday
    sunday
    Monday
    monday
    Tuesday
    tuesday
    Wednesday
    wednesday
    Thursday
    thursday
    Friday
    friday
    Saturday
    saturday
    Sunday
    sunday
    Monday
    monday
    Tuesday
    tuesday
    Wednesday
    wednesday
    Thursday
    thursday
    Friday
    friday
    Saturday
    saturday
    SUNDAY
    sunday
    MONDAY
    monday
    TUESDAY
    tuesday
    WEDNESDAY
    wednesday
    THURSDAY
    thursday
    FRIDAY
    friday
    SATURDAY
    saturday
    "sunday"
    sunday
    "monday"
    monday
    "tuesday"
    tuesday
    "wednesday"
    wednesday
    "thursday"
    thursday
    "friday"
    friday
    "saturday"
    saturday

    Tag, TagArgs

    A set of tags to apply to the resource.
    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