Skip to content

modify_reserved_instances

modify_reserved_instances(
    *,
    config_overrides: Optional[EC2ClientConfig] = None,
    reserved_instances_ids: Optional[ReservedInstancesIdStringList] = None,
    client_token: Optional[String] = None,
    target_configurations: Optional[ReservedInstancesConfigurationList] = None,
) -> ModifyReservedInstancesResult

Modifies the configuration of your Reserved Instances, such as the Availability Zone, instance count, or instance type. The Reserved Instances to be modified must be identical, except for Availability Zone, network platform, and instance type.

For more information, see Modify Reserved Instances in the Amazon EC2 User Guide.

Parameters:

Raises:

Source code in docs_src/capo_ec2/_services/ec2.py
def modify_reserved_instances(
    self,
    *,
    config_overrides: Optional[EC2ClientConfig] = None,
    reserved_instances_ids: Optional[
        "capo_ec2.types.reserved_instances_id_string_list.ReservedInstancesIdStringList"
    ] = None,
    client_token: Optional["capo_ec2.types.string.String"] = None,
    target_configurations: Optional[
        "capo_ec2.types.reserved_instances_configuration_list.ReservedInstancesConfigurationList"
    ] = None,
) -> (
    "capo_ec2.types.modify_reserved_instances_result.ModifyReservedInstancesResult"
):
    """<p>Modifies the configuration of your Reserved Instances, such as the Availability Zone, instance count, or instance type. The Reserved Instances to be modified must be identical, except for Availability Zone, network platform, and instance type.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ri-modifying.html">Modify Reserved Instances</a> in the <i>Amazon EC2 User Guide</i>.</p>

    Args:
        reserved_instances_ids: <p>The IDs of the Reserved Instances to modify.</p>
        client_token: <p>A unique, case-sensitive token you provide to ensure idempotency of your modification request. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring Idempotency</a>.</p>
        target_configurations: <p>The configuration settings for the Reserved Instances to modify.</p>

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

    def _handler(
        req: "OperationRequest[capo_ec2.types.modify_reserved_instances_request.ModifyReservedInstancesRequest]",
    ) -> OperationResponse[
        "capo_ec2.types.modify_reserved_instances_result.ModifyReservedInstancesResult"
    ]:
        import capo_ec2._operations.amazon_ec2.modify_reserved_instances

        output, http_response = (
            capo_ec2._operations.amazon_ec2.modify_reserved_instances.modify_reserved_instances(
                req.options, req.input
            )
        )
        return OperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("ModifyReservedInstances")
    )
    input_: capo_ec2.types.modify_reserved_instances_request.ModifyReservedInstancesRequest = {}
    if reserved_instances_ids is not None:
        input_["reserved_instances_ids"] = reserved_instances_ids
    if client_token is not None:
        input_["client_token"] = client_token
    if target_configurations is not None:
        input_["target_configurations"] = target_configurations

    response = execute_pipeline(
        OperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    response.response.close()
    return response.output