Oracle Cloud Infrastructure Documentation


Skip to main content

Deleting Links to Invited Child Tenancies

As a parent tenancy, you can remove an invited child tenancy from the organization. Only invited child tenancies can be removed. Removing an invited child tenancy unlinks the tenancy from the organization so that the parent doesn't have cost or governance access.

By removing the invited child tenancy, the parent tenancy can no longer manage it. The parent tenancy can't view the invited child tenancy's future cost and usage information, nor manage its subscription mapping. If you want the child tenancy to consume from another subscription that's within the organization, you don't need to remove the tenancy. Instead, you can use subscription mapping to map the tenancy to another subscription.

For created child tenancies, you can transfer the tenancy to another organization by using the CLI. For more information about using the oci organizations organization-tenancy approve-organization-tenancy-for-transfer and oci organizations organization-tenancy unapprove-organization-tenancy-for-transfer commands, see Approving a Created Child Tenancy for Transfer.

  • Console
  • CLI
  • API
  • To remove an invited child tenancy, you first need to remove it from organization governance, use the Subscription Mapping page to assign the tenancy back to its original subscription, and then remove the tenancy from the Tenancies page after the tenancy has been remapped to its original subscription.

    To remove an invited child tenancy, follow these steps:

    1. Open the navigation menu and select Governance & Administration. Under Organization Management, select Tenancies.
    2. On the Tenancies list page under Tenancy name, select the invited tenancy that you want to remove.
    3. On the details page, remove the tenancy from organization governance by selecting Remove from organization governance and then confirming the removal. For more information about removing governance rules, see Removing Governance from Tenancies. For information about opting into and out of organization governance, see Opting In Tenancies to Use Governance Rules and Removing Governance from Tenancies.
    4. Back on the Tenancies list page, under Organization Management on the left side of the page, select Subscription Mapping.
    5. On the Subscription Mapping list page, select the child tenancy's original Universal Credits subscription in the Subscription ID column.
    6. On the subscription mapping details page, under Mapped Tenancies, select Map subscription.
    7. In the Map subscription panel, select Map subscription and select the child tenancy to map back to this subscription. Select Map subscription. A notification message is displayed informing you that you successfully mapped the subscription to the tenancy. The tenancy then appears under Mapped Tenancies on the subscription mapping details page.
      Note

      If other tenancies are mapped to this subscription, you must unmap any other tenancies from the subscription. See Unmapping a Subscription from a Tenancy.
    8. Back on the Subscription Mapping list page, under Organization Management on the left side of the page, select Tenancies.
    9. On the Tenancies list page, open the Actions menu (Actions Menu) for the tenancy that you want to remove and select Remove Tenancy.

      Confirm that you do want to remove the tenancy.

      Any subscriptions mapped to this tenancy move with the tenancy and are no longer associated with your organization. You might also need to reload the Tenancies page to verify that the invited tenancy has been removed.

      If you see the following error message in the Remove Tenancy dialog box, it means that you haven't yet mapped the child tenancy back to its own Oracle Universal Credits subscription:

      "Child isn't consuming from its own UCM subscription, ocid1.tenancy.oc1..<unique_ID>"

    The child tenancy is removed from the organization with its original subscription. Because you mapped the child tenancy back to its original subscription, the tenancy now consumes from its own subscription, and is responsible for paying for the subscription usage. Furthermore, because the tenancy has been removed from the organization, it now becomes a standalone parent tenancy of its own, which is indicated on the removed tenancy's own Tenancies page (under Tenancy name, Parent tenancy is indicated).

  • Use the oci organizations link delete command and required parameters to start a link termination workflow:

    oci organizations link delete --link-id [test] [OPTIONS]

    For a complete list of parameters and values for CLI commands, see the CLI Command Reference.

  • Run the DeleteLink operation to start a link termination workflow.

  • Copyright © 2025, Oracle and/or its affiliates.
  • About Oracle
  • Contact Us
  • Legal Notices
  • Terms of Use & Privacy
  • Document Conventions