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.

  • Use the Console to move an instance into or out of capacity reservations.

    To move instances into a capacity reservation

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

    To move instances out of a capacity reservation

    1. Navigate to the Instances list page. If you need help finding the list page, see Listing Instances.
    2. Select an instance.
    3. Select the option you see:
      • Actions then More Actions then Edit.
      • More Actions then Edit.
    4. Select Show advanced options, and then select the Placement tab.
    5. Clear the Apply a capacity reservation checkbox.
    6. 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: