Deleting Links

• Console
• CLI
• API

• As a parent tenancy, you can remove an invited child tenancy from the organization. Only invited child tenancies can be removed.

  Invited tenancy removal unlinks the tenancy from the organization so that the parent doesn't have cost or governance access. For created child tenancies, you can transfer the tenancy to another organization using the CLI. For more information on 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.

  By removing the child tenancy, the parent tenancy can no longer manage the child tenancy. The parent tenancy can't view the child's future cost and usage information, nor manage the child's subscription mapping. If you wanted 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 remap the tenancy to another subscription.

  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:

  1. Open the navigation menu and click Governance & Administration. Under Organization Management, click Tenancies.
  2. On the Tenancies page under Tenancy name, click the invited tenancy that will be removed, to remove it from organization governance. For more information on opting into and out of organization governance, and detaching governance rules, see To opt in tenancies to use governance rules and Removing Governance from Tenancies.
  3. Open the navigation menu and click Governance & Administration. Under Organization Management, click Subscription Mapping.
  4. On the Subscription Mapping page, select the child tenancy's original Universal Credits subscription from the Subscription ID column.
  5. On the subscription mapping details page, under Mapped Tenancies, click Map subscription.
  6. On the Map subscription panel, click Map subscription and select the child tenancy to be remapped. Click 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 need to unmap any other tenancies from the subscription. See Unmapping Subscriptions for more information.
  7. In Organization Management, click Tenancies.
  8. On the Tenancies page, open the Actions menu () for the tenancy you want to remove and select Remove Tenancy.

     In the Remove Tenancy confirmation, confirm that you do want to remove the tenancy, and click Remove Tenancy. Any subscriptions mapped to this tenancy will move with the tenancy, and will no longer be 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 an error in the Remove Tenancy dialog that states Child isn't consuming from its own UCM subscription, ocid1.tenancy.oc1..<unique_ID>, it means that you haven't yet remapped the child tenancy back to its own Oracle Universal Credits subscription.

  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 will consume from its own subscription going forward, 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 will be 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.