Oracle Cloud Infrastructure Documentation

Changing the Capacity Reservation for an Instance

You can move instances into or out of capacity reservations without having to rebuild your instances. Capacity reservations let you reserve instances in advance so that the capacity is available for your workloads when you need it.

For permissions, see Required IAM Policy for Working with Instances.

Before You Begin

To move an instance into a capacity reservation, you must have an existing capacity reservation. For steps to create capacity reservations, see Capacity Reservations.

  • You can use the Console to move instance into or out of capacity reservations.

    To move instances into a capacity reservation

    1. On the Compute list page, select the instance that you want to work with. If you need help finding the list page, see Listing Instances.
    2. Select More Actions, and then select Edit.
    3. Select Show advanced options, and then select the Placement tab.
    4. Select the Apply a capacity reservation checkbox.
    5. For Capacity reservation, select the capacity reservation that you want to move the instance into.
    6. Select Save changes.

    To move instances out of a capacity reservation

    1. On the Compute list page, select the instance that you want to work with. If you need help finding the list page, see Listing Instances.
    2. Select More Actions, and then select Edit.
    3. Select Show advanced options, and then select the Placement tab.
    4. Clear the Apply a capacity reservation checkbox.
    5. Select Save changes.

  • Use the instance update command and required parameters to update an instance:

    oci compute instance update --from-json <file://path/to/file.json>

    <file://path/to/file.json> is the path to a JSON file that defines the instance details. For information about how to generate an example of the JSON file, see Advanced JSON Options.

    For a complete list of flags and variable options for the Compute Service CLI commands, see the command line reference for Compute.

  • For information about using the API and signing requests, see REST API documentation and Security Credentials. For information about SDKs, see SDKs and the CLI.

    Use this API operation to move instances into and out of capacity reservations: