Deleting a Compartment
Delete a compartment from an IAM tenancy.
To delete a compartment, it must be empty of all resources. Before you initiate deleting a compartment, ensure that you have moved, deleted, or terminated all its resources, including any policies attached to the compartment.
The delete action is asynchronous and initiates a work request. The state of the compartment changes to Deleting while the work request is executing. It typically takes several minutes for the work request to complete. While it's in the Deleting state, the compartment isn't displayed in the compartment picker. If the work request fails, the compartment isn't deleted and it returns to the Active state.
After a compartment is deleted, its state is updated to Deleted and a random string of characters is appended to its name, for example, CompartmentA
might become CompartmentA.qR5hP2BD
. Renaming the compartment allows you to reuse the original name for a different compartment. The deleted compartment is displayed on the Compartments page for 90 days before it's removed from the compartment picker. If any policy statements reference the deleted compartment, the name in the policy statement is updated to the new name.
If you have problems deleting a compartment, see Compartment Fails to Delete.
Use the delete command and required parameters to delete a compartment:
oci iam compartment delete --compartment-id compartment_ocid
For a complete list of parameters and values for CLI commands, see the CLI Command Reference.
Run the DeleteCompartment operation to delete a compartment.