Skip to content

EC2  >  Operations  >  associate_instance_event_window

associate_instance_event_window

Operation

associate_instance_event_window async

associate_instance_event_window(request: AssociateInstanceEventWindowInput | AssociateInstanceEventWindowInputDict, /, *, plugins: list[Plugin] | None = None) -> AssociateInstanceEventWindowOutput
associate_instance_event_window(*, plugins: list[Plugin] | None = None, **kwargs: Unpack[AssociateInstanceEventWindowInputDict]) -> AssociateInstanceEventWindowOutput

Associates one or more targets with an event window. Only one type of target (instance IDs, Dedicated Host IDs, or tags) can be specified with an event window.

For more information, see Define event windows for scheduled events in the Amazon EC2 User Guide.

Parameters:

Name Type Description Default
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None

Returns:

Type Description
AssociateInstanceEventWindowOutput

An instance of AssociateInstanceEventWindowOutput.

Input

Pass the input fields as keyword arguments, or pass a model or dictionary as the first positional argument. Pass plugins separately as a keyword argument.

Model

AssociateInstanceEventWindowInput dataclass

Bases: _SerdeShape

Dataclass for AssociateInstanceEventWindowInput structure.

Attributes
association_target class-attribute instance-attribute
association_target: InstanceEventWindowAssociationRequest | None = ...

One or more targets associated with the specified event window.

dry_run class-attribute instance-attribute
dry_run: bool | None = ...

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

instance_event_window_id class-attribute instance-attribute
instance_event_window_id: str | None = ...

The ID of the event window.

Dictionaries

AssociateInstanceEventWindowInputDict

Bases: TypedDict

Dictionary form of AssociateInstanceEventWindowInput.

Attributes
association_target instance-attribute

One or more targets associated with the specified event window.

dry_run instance-attribute
dry_run: bool | None

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

instance_event_window_id instance-attribute
instance_event_window_id: Required[str]

The ID of the event window.

Output

AssociateInstanceEventWindowOutput dataclass

Bases: _SerdeShape

Dataclass for AssociateInstanceEventWindowOutput structure.

Attributes

instance_event_window class-attribute instance-attribute
instance_event_window: InstanceEventWindow | None = ...

Information about the event window.

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.