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. Navigate to the Compute Instances list page. If you need help finding the list page, see Listing Instances.
    2. Select an instance.
    3. Select the option you see:
      • Select Actions then More actions then Edit.
      • Select More actions then Edit.
    4. Select the option you see:
      • Edit the Fault domain field and select a new fault domain.
      • Select Edit fault domain. Then, select a new fault domain.
    5. 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: