associate_instance_event_window `async` ¶

associate_instance_event_window(
    *,
    config_overrides: Optional[AsyncEC2ClientConfig] = None,
    dry_run: Optional[Boolean] = None,
    instance_event_window_id: Optional[InstanceEventWindowId] = None,
    association_target: Optional[InstanceEventWindowAssociationRequest] = None,
) -> AssociateInstanceEventWindowResult

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:

dry_run (Optional[Boolean], default: 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 (Optional[InstanceEventWindowId], default: None ) –

The ID of the event window.
association_target (Optional[InstanceEventWindowAssociationRequest], default: None ) –

One or more targets associated with the specified event window.

Raises:

UnknownServiceError –

The service returned an error code this client does not model.

Source code in docs_src/capo_ec2/_services/async_ec2.py

async def associate_instance_event_window(
    self,
    *,
    config_overrides: Optional[AsyncEC2ClientConfig] = None,
    dry_run: Optional["capo_ec2.types.boolean.Boolean"] = None,
    instance_event_window_id: Optional[
        "capo_ec2.types.instance_event_window_id.InstanceEventWindowId"
    ] = None,
    association_target: Optional[
        "capo_ec2.types.instance_event_window_association_request.InstanceEventWindowAssociationRequest"
    ] = None,
) -> "capo_ec2.types.associate_instance_event_window_result.AssociateInstanceEventWindowResult":
    """<p>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.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/event-windows.html">Define event windows for scheduled events</a> in the <i>Amazon EC2 User Guide</i>.</p>

    Args:
        dry_run: <p>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 <code>DryRunOperation</code>. Otherwise, it is <code>UnauthorizedOperation</code>.</p>
        instance_event_window_id: <p>The ID of the event window.</p>
        association_target: <p>One or more targets associated with the specified event window.</p>

    Raises:
        capo_ec2.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    async def _handler(
        req: "AsyncOperationRequest[capo_ec2.types.associate_instance_event_window_request.AssociateInstanceEventWindowRequest]",
    ) -> AsyncOperationResponse[
        "capo_ec2.types.associate_instance_event_window_result.AssociateInstanceEventWindowResult"
    ]:
        import capo_ec2._operations.amazon_ec2.associate_instance_event_window

        (
            output,
            http_response,
        ) = await capo_ec2._operations.amazon_ec2.associate_instance_event_window.async_associate_instance_event_window(
            req.options, req.input
        )
        return AsyncOperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("AssociateInstanceEventWindow")
    )
    input_: capo_ec2.types.associate_instance_event_window_request.AssociateInstanceEventWindowRequest = {}
    if dry_run is not None:
        input_["dry_run"] = dry_run
    if instance_event_window_id is not None:
        input_["instance_event_window_id"] = instance_event_window_id
    if association_target is not None:
        input_["association_target"] = association_target

    response = await aexecute_pipeline(
        AsyncOperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    await response.response.aclose()
    return response.output

associate_instance_event_window async ¶

associate_instance_event_window `async` ¶