Oracle Cloud Infrastructure Documentation

Editing the Fault Domain for an Instance

You can change the fault domain where a virtual machine (VM) instance is placed.

A fault domain is a grouping of hardware and infrastructure that is distinct from other fault domains in the same availability domain. By properly leveraging fault domains you can increase the availability of applications running on Oracle Cloud Infrastructure. For more information and best practices, see Fault Domains.

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

Supported Shapes

You can change the fault domain for instances that use these shapes:

  • VM.Standard1 series
  • VM.Standard.B1 series
  • VM.Standard2 series
  • VM.Standard3.Flex
  • VM.Standard.E2 series
  • VM.Standard.E3.Flex
  • VM.Standard.E4.Flex
  • VM.Standard.E5.Flex
  • VM.Standard.E6.Flex
  • VM.GPU3 series
  • VM.GPU.A10 series
  • VM.Optimized3.Flex

These shapes cannot be edited:

  • VM.Standard.E2.1.Micro
  • VM.GPU2 series
  • VM.DenseIO1 series
  • VM.DenseIO2 series
  • VM.DenseIO.E4.Flex
  • VM instances that run on dedicated virtual machine hosts
  • Bare metal shapes
    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 Edit fault domain. Then, select a new fault domain.
    4. Select Save changes.

      If the instance is running, it's rebooted. Confirm when prompted.

  • 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 change the fault domain for an instance: