Oracle Cloud Infrastructure Documentation

Organization Management Overview

Use Organization Management to centrally manage many tenancies, invite and create child tenancies, view and map subscriptions, and create and attach governance rules to tenancies in an organization.

With Organization Management, you can add tenancies to an organization, and have those tenancies consume from the primary funded subscription. You can create an isolated tenancy to build workloads, without needing to book a new order.

Two types of tenancies are involved when mapping and using a subscription in Organization Management:
  • Parent: Tenancy that's associated with the primary funded subscription.
  • Child: Tenancies that join an organization, so that the parent manage its cost and governance. Child tenancies can either be created as entirely new tenancies, or, existing tenancies can be invited to join the same organization.

An organization can have multiple child tenancies, which are managed by the parent tenancy. The parent tenancy can use Subscription Mapping to assign subscriptions to any child tenancy in the organization.

Benefits of Organization Management include the following:

  • Share a single commitment to help avoid cost overages and enable multitenancy cost management. You can analyze, report, and monitor across all linked tenancies in an organization. The parent tenancy can analyze and report across each of its tenancies through Cost Analysis and Cost and usage reports, and you can receive alerts through Budgets.
  • Customers with strict data isolation requirements can use a multitenancy strategy to isolate data and restrict resources across their tenancies.
  • Use governance rules to enforce and govern resources on specific child tenancies, or the entire organization.
Important

SaaS subscriptions services can only be provisioned in the tenancy where the subscription was activated. Activations into child tenancies aren’t permitted.

The remainder of this topic provides an overview of how to use Organization Management to create child tenancies, invite existing tenancies, view and revoke invitations, and how to remap subscriptions to tenancies. Cost reporting features are also described, which you can use to centrally manage cost and usage information across all tenancies in an organization. Using these features you can better manage a multitenancy environment.

Planning Considerations

Before you get more tenancies, evaluate your needs to ensure that a multi-tenancy approach is best for your workloads. The main reason to have multiple tenancies is for strong isolation, to help isolating workloads.

Because managing multiple tenancies can create extra management overhead, ensure that the isolation is worth it. If you don't require a strong level of isolation, you can instead consider using compartments to separate workloads.

By default, each parent and child tenancy comes with:

  • A distinct set of IAM users (which can be federated to another identity system).
  • A distinct set of IAM policies (permissions).
  • A distinct tenancy administrator.
  • Its own service limits.
  • Isolated Virtual Cloud Networks (VCNs).
  • Separate security and governance settings.

A tenancy can be a parent tenancy, and add child tenancies if the tenancy meets the following criteria:

  • The parent has enough organization child tenancy limits. These limits are initially granted based on the subscription the parent was activated. See below to see the limits of each subscription.
  • By default, Oracle Universal Credits commit and funded allocation subscriptions have a limit of 0 child tenancies. Pay As You Go or Trial subscriptions have a limit of 0. If you need a service limit increase, these can be requested through a support ticket. For more information, see Organizations Service Limits and Requesting a Service Limit Increase.
  • The parent tenancy must be subscribed to the superset of child-subscribed regions.

Invited tenancies can be a child of an organization if they meet the following criteria:

  • The invited tenancy must be using a paid subscription, such as Oracle Universal Credits, Pay As You Go, commit, or funded allocation.
  • The invited tenancy can't be Free Tier.

In regards to sharing a subscription in the organization:

  • Oracle Universal Credits subscriptions can be shared across multiple tenancies, while SaaS subscriptions can't be shared.
  • When a subscription is shared, the tenancy usage is metered against the subscription. Usgae costs are computed based on the subscription’s rate card  and currency. Costs are consumed from the subscriptions credits.
  • Subscriptions can be shared regardless of the contractual location.
  • Using Subscription Mapping, you can assign the subscription to a tenancy.

Required IAM Policy

To use Oracle Cloud Infrastructure, you must be granted security access in a policy  by an administrator. This access is required whether you're using the Console or the REST API with an SDK, CLI, or other tool. If you get a message that you don’t have permission or are unauthorized, verify with your administrator what type of access you have and which compartment  to work in.

If you're new to policies, see Getting Started with Policies and Common Policies.

To use Organization Management, the following policy statements are required:

Allow group linkUsers to use organizations-family in tenancy
Allow group linkAdmins to manage organizations-family in tenancy

To accept an invitation but not create one use the following:

allow group linkAccepters to manage organizations-recipient-invitations in tenancy

To view the current linked tenancies but not the invitations:

allow group linkViewers to read organizations-links in tenancy

Creating a New Child Tenancy

As the parent tenancy, you can create new child tenancies or invite existing tenancies to your organization. Newly created child tenancies consume from your organization's default subscription. If you want the new child tenancy to consume from another subscription, you can remap the created tenancy to another subscription on the Subscription Mapping page.

You can attach governance rules to the new child tenancy during creation, or you can come back later and attach rules. To attach governance rules before child tenancy creation, you can create any governance rules first on the Governance Rules page, so they're available for selection during new child tenancy creation.

Created child tenancies inherit the current default limits of the parent tenancy. Child tenancies receive their own set of limits, which aren't shared with other tenancies.

Note

Free Tier tenancies can't add new child tenancies.

To create a child tenancy, you provide the necessary information, and then sign-in instructions are provided to the child tenancy administrator. The created (child) tenancy automatically consumes from the default subscription of the organization, so all usage is charged based on the rate card  of the subscription. The parent tenancy is also responsible for the child tenancy’s usage.

  1. Open the navigation menu and click Governance & Administration. Under Organization Management, click Tenancies.
  2. Click Create new tenancy. The Create new tenancy panel is displayed.
  3. In the Tenancy details step, Tenancy name, enter a name for the new child tenancy. The tenancy name must be unique and all lowercase without any special characters. Avoid entering confidential information.
  4. From Home region, select a region from the list. The home region is one of the parent's subscribed regions.
  5. In Administrator email and Confirm Email, enter and confirm the email address of the tenancy administrator.
  6. Click Next. The Governance rules step is displayed, where you can select governance rules to attach to the tenancy, or skip and attach them later. You can always attach or detach rules, or opt the tenancy out of organization governance later.
  7. Under Governance rules, choose Select governance rules now (the default), or Skip and select governance rules later. If selecting governance rules now, select them from the table. You can filter the table by the rule type (tag, allowed regions, quotas), or the targeted tenancy. For any rule, click the down arrow (Logging down arrow) to expand the rule entry and view its details.

    Select one or more rules and click Next.

  8. Review the summary step to ensure the new child tenancy settings you specified are correct. Tenancy details shows the tenancy name, home region, and administrator email, while the Governance rules table shows the rule names, rule type, and targeted tenancies.
  9. Click Create tenancy. A notification is displayed, indicating that you have successfully requested to create a child tenancy. If the request completes successfully, then your authentication credentials are sent by email momentarily.

The child tenancy administrator will receive instructions to sign in. Use the temporary password provided to sign in to the new child tenancy the first time. You will be required to change the password.

Inviting an Existing Tenancy

If you have the correct limits, you can invite another tenancy to join your organization. If the tenancy joins your organization, its subscription will be managed by the parent tenancy.

See Organization Limits for more information on the limits related to inviting another tenancy.

The recipient tenancy needs to have the proper permissions to manage subscription sharing in the child tenancy, in order to accept the invitation. For more information, see Required IAM Policy.

You can attach governance rules to the invited tenancy during creation, or you can come back later and attach rules. To attach governance rules before sending the invitation, you can create any governance rules first on the Governance Rules page, so they're available for selection during the invite tenancy process.

Invited tenancies will continue to retain their own distinct service limits. For a limits increase, they can request it through support requests. For more information, see Requesting a Service Limit Increase.

An invited tenancy (also referred to as the recipient tenancy) automatically consumes from the default subscription in the organization, so all usage will be charged against the default subscription's rate card. If you don't want the invited, recipient tenancy to consume from the default subscription, you can remap the subscription back to the original subscription after the invited tenancy has joined the organization.

To invite a tenancy:

  1. Sign in to the (sender) tenancy that will send the invitation, as a user that has permissions to manage subscription sharing.
  2. Open the navigation menu and click Governance & Administration. Under Organization Management, click Tenancies.
  3. Click Invite tenancy. The Invite tenancy panel is displayed.
  4. In Invitation name, enter the name of the invite that will be visible to the recipient. Avoid entering confidential information.
    Note

    For the invitation name, it can be helpful to use notation that signifies the direction and number of sending invitation attempts. For example, entering a1 to b1 v1 can signify that tenancy a1 is sending an invitation to b1, and v1 as the first attempt. Such a convention allows the invitations to be more readable to the Console user, without having to access the invitation details page to view sender and recipient details. See Viewing Invitations for more information.
  5. In Recipient tenancy OCID, enter the recipient's OCID. You can find the OCID on the tenancy details page.
  6. In Recipient email, enter and confirm the recipient's email address.
    Note

    The recipient needs to have the proper permissions to manage subscription sharing in the recipient tenancy, to accept the invitation. For more information, see Required IAM Policy.
  7. Click Show advanced options and enter any tagging details. See Resource Tags for more information.
  8. Click Next. The Governance rules step is displayed, where you can select governance rules to attach to the tenancy, or skip and attach them later. You can always attach or detach rules, or opt the tenancy out of organization governance later.
  9. Under Governance rules, choose Select governance rules now (the default), or Skip and select governance rules later. If selecting governance rules now, select them from the table. You can filter the table by the rule type (tag, allowed regions, quotas), or the targeted tenancy. For any rule, click the down arrow (Logging down arrow) to expand the rule entry and view its details.
    Note

    Some rules are set by the entire organization, and so such rules are already selected, and cannot be disabled.

    Select one or more additional rules and click Next.

  10. Review the summary step to ensure the invited tenancy settings you specified are correct. Tenancy details shows the invitation name and recipient tenancy OCID, while the Governance rules table shows the rule names, rule type, and targeted tenancies. An indication of whether the invited tenancy is required to join organization governance (that is, use governance rules), is also displayed (whether Yes or No).
  11. Click Invite tenancy. The invitation is sent to the tenancy you are inviting to add to your organization, and share its subscription and any governance rules (if selected). A notification is displayed that you’ve successfully requested to invite a tenancy (with the associated OCID) to join the organization. If the request completes successfully, then the recipient tenancy will receive an invitation to accept. The invitation expires in 30 days.
    Note

    Parent tenancies and tenancies that are not already in a sharing relationship can send invitations. Child tenancies cannot send invitations.

    If the invitation is accepted by an authorized user in the recipient tenancy, and the recipient tenancy is subscribed to a Pay As You Go subscription, all usage in the recipient tenancy will be metered against your subscription. If you want to stop sharing your subscription with the recipient tenancy after the invitation has been accepted, you can remap the subscription.

  12. On the recipient (child) tenancy: Open the navigation menu and click Governance & Administration. Under Organization Management, click Invitations. The Invitations page is displayed.

    The invitation from the tenancy that sent the invite is displayed in the Invitations page list, with the following information:

    • Invitation Name: Click the linked name to go to the invitation details page.

    • Status: Displays the invitation status. For example, the status is Active when the invitation is received but not yet accepted. From the parent tenancy, this field shows Pending for an invitation that has been sent but not yet accepted.

      The possible status states for a sender and recipient invitation are the following:
      Sender Invitation Recipient Invitation
      • PENDING
      • CANCELED
      • ACCEPTED
      • EXPIRED
      • FAILED
      • PENDING
      • CANCELED
      • ACCEPTED
      • IGNORED
      • EXPIRED
      • FAILED
    • Type: The invitation type, whether Sent Invitation or Received Invitation. A Sent Request or Received Request invitation, meanwhile, means an invitation to join organization governance (use governance rules) was sent or received.
    • Created: The UTC creation date and time of the invitation.
  13. On the recipient (child) tenancy: Click the Actions menu (Actions Menu) and select Accept Invitation. A confirmation acceptance message is displayed, which indicates that you are about to accept an invitation from the tenancy.

    After clicking Accept, the invitation is processed, and the invitation's Status field changes to Accepted. The tenancy then becomes a child tenancy under the parent tenancy in the organization.

    After the sharing invitation is accepted, it will take one to two hours for metering to start flowing to the subscription in the parent tenancy. Going forward, however, all usage in the child tenancy will be metered against the parent tenancy's subscription. In addition, after the new tenancy joins the organization, it is recommended that you wait for a few hours before launching resources (that is, if you want to be sure that all spending will accrue against the subscription of the parent tenancy).

    If a remaining subscription balance exists, contact your sales representative to move it to a primary subscription in the sending tenancy.

    Note

    After the tenancy becomes a child tenancy in the organization, it cannot invite another tenancy to become a child tenancy.
  14. Open the child tenancy's Tenancies page in Organization Management. You cannot view any tenancy details, since the page is only available for a parent tenancy that belongs to an organization. A message is displayed to indicate this status. The Subscription Mapping page is also not available for the child tenancy that just joined the parent tenancy's organization.
    Note

    If a tenancy joins your organization, its subscription is managed by the parent tenancy. To remap a child tenancy back to the original subscription, you can use Subscription Mapping.

    Meanwhile on the parent tenancy's Tenancies page in Organization Management, you can view the child tenancy and parent tenancy, and other (child) tenancies that are being metered against the organization's subscription. The following is shown:

    • Tenancy name
    • Tenancy OCID
    • Status: Displays the invitation status.
    • Organization governance: Specifies whether the tenancy is using governance rules (Joined) or not (Not joined).
    • Join Date: The UTC date and time that the tenancy joined and subscription sharing began.

Viewing Invitations

Invitation details can be viewed from both the parent and child tenancy.

To view invitations:

  1. Open the navigation menu and click Governance & Administration. Under Organization Management, click Invitations. The Invitations page is displayed.
  2. Click the linked invitation name from the Invitation Name field, or click the Actions menu (Actions Menu) and select View Invitation Details. The Invitation Detail page is displayed.
  3. This page displays the invitation status, along with the following details on the Invitation Information tab:
    • Sent from Tenancy OCID
    • Type: This field shows both invitations (a parent tenancy wants a tenancy to become a child tenancy to join the organization), or requests (to use governance rules).
    • Last Status Change
    • Sent to Tenancy OCID
    • Sent Date

    You can also click Add Tags to add tagging information, to be viewed on the Tags tab. See Resource Tags for more information.

Revoking Invitations

A parent tenancy that sends an invitation to another tenancy to join the organization, can choose to later revoke such an invitation on the Invitations page.

To revoke an invitation:

  1. Sign in to the primary (parent) tenancy as a user that has permissions to manage invitations and subscription sharing.
  2. As the parent tenancy, open the navigation menu and click Governance & Administration. Under Organization Management, click Invitations. The Invitations page is displayed.
  3. For the invitation you want to revoke, click the Actions menu (Actions Menu) and select Revoke Invitation. On the invitation details page, you can also click Revoke. A Revoke Invitation confirmation is displayed. To cancel the invitation, click Revoke.
  4. On the Invitations page, the invitation's Status changes to Canceled.

Removing an Invited Tenancy

As a parent tenancy, you can remove an invited child tenancy from the organization. Only invited child tenancies can be removed. 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.

To remove an invited child tenancy, you first need to assign the tenancy back to its original subscription. After it has been remapped, you can remove the child tenancy.

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 a tenancy:

  1. Open the navigation menu and click Governance & Administration. Under Organization Management, click Subscription Mapping. The Subscription Mapping page is displayed.
  2. From the Subscription Mapping page, select the child tenancy’s original Universal Credits subscription from the Subscription ID column. The Subscription mapping details page opens.
  3. Under Mapped Tenancies, click Map subscription. The Map subscription panel opens.
  4. Select the child tenancy to be remapped and click Map subscription.
    Note

    If other tenancies are mapped to this subscription, you need to unmap any other tenancies from the subscription. See Subscription Mapping for more information.
  5. In Organization Management, click Tenancies. The Tenancies page is displayed.
  6. Open the Actions menu (Actions Menu) for the tenancy you want to remove and select Remove Tenancy. Confirm that you do want to remove the tenancy, and click Remove Tenancy.

    If you see an error in the Remove Tenancy dialog that states "Child is not consuming from its own UCM subscription", it means that you have not 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. Upon mapping the child tenancy back to its original subscription, the tenancy will consume from its own subscription, and is responsible for paying for the subscription usage.

Subscription Mapping

You can view and remap tenancies to the subscriptions within Organization Management.

An organization can have multiple subscriptions, which are managed by the parent tenancy. For example, an organization always starts out with only a single subscription (subscription "A"), but a child tenancy with its own subscription (subscription "B") that later joins the organization can bring its own subscription B. The parent tenancy can then use Subscription Mapping to map subscription B to other tenancies in the organization. As a result, an organization's subscriptions can be mapped to any tenancy in the organization.

Tenancies mapped to a subscription consume from the subscription’s credits (for Universal Credits Commitment subscriptions) and use its rate card. By remapping a tenancy to a subscription, the tenancy’s usage applies to the terms and conditions of the subscription, including its rate card, credit consumption, and other agreements within the subscription's contract.

To map subscriptions:

  1. Open the navigation menu and click Governance & Administration. Under Organization Management, click Subscription Mapping. The Subscription Mapping page is displayed.
  2. Click the subscription name from the Subscription ID field. The subscription mapping detail page is displayed.

    This page displays the subscription details, along with tenancies that are assigned to the subscription, in terms of the following:

    • Subscription ID
    • Subscription OCID
    • Subscription type
    • Subscription start date
    • Subscription end date
    • Subscription description
  3. Under Mapped tenancies, you can click Map subscription to open the Map subscription panel, and add other tenancies to be mapped to this subscription. When you remap the selected subscription to a tenancy, the tenancy stops consuming from the previously mapped subscription.
  4. In the Map subscription panel, make your selections and click Map subscription.

Using Governance Rules

Use governance rules to configure and attach controls to tenancies in your organization. When a governance rule is attached to a tenancy, a corresponding resource gets created and locked in the target tenancy.

A governance rule is a type of enforcement that a parent tenancy creates, which allows governing a resource on the child tenancy. The parent tenancy creates the governance rules, whereby they can be targeted to one or more child tenancies. After being set, the governance rule enforcements become locked, so that users within the child tenancy are not permitted to modify the rule. As a result, a lock icon appears in the interface of such resources. For example, if a parent tenancy created an allowed regions governance rule for a child tenancy, the quota name has an adjacent lock icon on the child tenancy's Quota Policies page. When viewing a quota policy details page, a message is displayed, indicating that the resource was created and locked by the parent tenancy using governance rules. To change the rule, the parent must unlock it and change it. For more information, see Resource Locking.

Using governance rules, you can enforce the following:

  • Allowed regions: One or more regions that the targeted tenancies are allowed to subscribe to. Set an allowable list of regions as permitted by your compliance standards.
    Note

    If a targeted tenancy is already subscribed to a region not on the allowed regions list, the tenancy remains subscribed to that region, and resources can still be deployed in that region.
  • Quota policies: Set a resource quota to limit the number of resources within a service, or disable certain services. Such quotas can be set at the tenancy level, for example:
    zero compute-core quotas in tenancy
set compute-core quota to 20 in tenancy
  • Tags: Define tags throughout your organization. You can share a tag namespace for consistent tagging, or define a tag default to ensure that all resources are tagged.
    Note

    When you update a resource (such as a tag namespace) in a parent tenancy that was used to create a governance rule, you need to also update the governance rule, or the changes will not propagate to child tenancies.

To create a governance rule and attach it to one or more tenancies:

  1. Open the navigation menu and click Governance & Administration. Under Organization Management, click Governance Rules.
  2. Click Create rule. The Create rule panel opens.
  3. In Name, enter a name for the new governance rule. Avoid entering confidential information.
  4. From Type, select a governance rule type, whether: Allowed regions, Quota policy, or Tags.
    1. If Allowed regions is selected, under Rule configuration, select one or more regions that the targeted tenancies are allowed to subscribe to.

      In Description, enter a name for the allowed region rule configuration. Avoid entering confidential information. From Regions, select the regions you want to allow.

    2. If Quota policy is selected, under Rule configuration, create a quota policy to be attached to the targeted tenancies.

      In Description, enter a name for the quota policy rule configuration. Avoid entering confidential information. Add the quota policy statements that you want to set in Quota policy statements. See Managing Quota Policies, Quota Policy Syntax, and Sample Quotas for more information on quota creation, syntax, and samples.

    3. If Tags is selected, under Rule configuration, create a tag namespace from your root compartment to clone onto the targeted tenancies, or define a default tag.

      Select the tag namespace from the Tag namespace list. Click View details to view more information about the namespace in the Tag namespace details panel. In the panel, you can view the Tag key, Value type, and Cost tracking tag detail, and the tag key description.

      To add a default tag, selecting the corresponding Add default tag option, and then select a tag key from the list. You can also set Required Tag Value Options. Use the Default value and enter the value in the Default value field, or select a User-applied value.

  5. Under Attach rule, you can choose to attach the rule to specific tenancies, or attach the rule to all current and future tenancies that have joined organization governance (using governance rules).

    If Attach to specific tenancies is selected, select one or more tenancies from the Tenancies field. You can also choose to not select any tenancies at this point (such rules have 0 in the Targeted tenancies field on the associated governance rule details page).

    If Attach to entire organization is selected, the rule is attached to your tenancy and all your organization’s tenancies that join organization governance. The rule attachment applies to both current and future tenancies.

  6. Specify any tagging settings to organize and track resources in your tenancy.
  7. Click Create rule. A new governance rule details page is displayed, associated with the rule you created.

    The governance rule details page shows the overall rule status. You can edit or delete the rule, change the attachment method (target specific tenancies or the entire organization), add tags, view rule details, and you can attach or detach the rule from tenancies. For each tenancy, you can also view the rule attachment work request progress. If the attachment failed, select Retry attaching from the Actions menu (Actions Menu).

    The governance rule details page Rule details tab shows the following information. Under General information:

    • OCID: OCID of the governance rule.
    • Created: Created time in UTC format.
    • Targeted tenancies: The number of targeted tenancies.
    • Attachment method: Attached to specific tenancies or the entire organization.

    Under Rule configuration, some information changes depending on whether the rule is for allowed regions, quota policies, or tags:

    • Rule type
    • (Allowed region rule only) Allowed regions: Lists the allowed regions in the rule.
    • (Quota policy rule only) Statement: Click the View details link to see the statements in the Quota policy statements panel.
    • (Tags rule only) Tag namespace: Lists the namespace and you can click the View details link to see the tag namespace in the Tag namespace details panel.
    • (Tags rule only) Tag defaults: Lists the number of tag defaults, and you can click the View details link to see the tag defaults in the Tag default details panel.
  8. Under the Tenancies section, you can select one or more tenancies to attach (or detach) from the governance rule.

    The Tenancies section of the governance rule details page lists the following for every tenancy:

    • Tenancy: The tenancy name.
    • Rule status: The rule status, whether Not attached or Attached.
    • Organization governance: Indicates whether the tenancy has joined organization governance. Only tenancies that have joined organization governance can be attached to rules.
    To attach tenancies, select one or more tenancies under Tenancies, and click Attach. A confirmation is displayed to confirm the attachment of the rule to which tenancies. Click Attach rule. The governance rule detail page reloads and a new work request is started. After the work request completes, the rule is attached to the tenancy, and the Rule Status changes to Attached.

The governance rule is now configured and enforces its restrictions on the child tenancies (or if specified, the entire organization and future tenancies that join the organization). You can also view the associated governance rules by accessing the Tenancies page in Organization Management. On the Tenancies page, click the linked tenancy name, which opens the linked tenancy details page. Under Governance rules, you can view the list of governance rules attached to the tenancy (to include their name and rule type). Click the linked governance rule name to go to the associated governance rule details page.

Meanwhile, the child tenancy that has attached governance rules can also view the rules on the Governance rules page, but can't interact with the rule, and can only view basic information about it, because the parent tenancy controls the rule configuration.

After the governance rule is created, you can edit or delete the rule, detach the rule, or change the attachment method. You can also choose to opt a tenancy in to using governance rules.

To edit a governance rule
  1. Open the navigation menu and click Governance & Administration. Under Organization Management, click Governance Rules.
  2. On the governance rule details page, click Edit rule configuration. The Edit rule configuration panel opens.
  3. Edit the rule configuration and click Save.
To change the governance rule attachment method
  1. Open the navigation menu and click Governance & Administration. Under Organization Management, click Governance Rules.
  2. On the governance rule details page, click Change attachment method. A Change attachment method confirmation is displayed.
  3. Choose the preferred attachment method, and click Attach rule.
To detach a governance rule
  1. Open the navigation menu and click Governance & Administration. Under Organization Management, click Governance Rules.
  2. On the governance rule details page, select one or more tenancies under Tenancies, and click Detach. A confirmation is displayed, indicating that the rule will no longer be applied to the targeted tenancy, and its associated resources will be deleted.
  3. Click Detach rule. The governance rule detail page reloads and a new work request is initiated. After the work request completes, the rule is no longer attached to the tenancy, and the Rule Status changes to Detached.
To delete a governance rule
  1. Open the navigation menu and click Governance & Administration. Under Organization Management, click Governance Rules.
  2. On the governance rule details page, click Delete rule. A Delete rule confirmation is displayed.
  3. Click Delete rule. Deletion is permanent and the rule’s associated resource in the targeted tenancies is also deleted.
To opt in existing tenancies to use governance rules

Certain types of tenancies that are already part of the organization can opt in to use governance rules.

  • A parent tenancy can both opt itself in or out.
  • A parent tenancy can request that a child tenancy agree to opt in, or opt out a child tenancy.
  • A child tenancy can be opted in by the parent tenancy or opt itself in, but a child tenancy cannot opt itself out.

To opt a tenancy in to governance rules:

  1. Open the navigation menu and click Governance & Administration. Under Organization Management, click Tenancies.
  2. From the Tenancies page, click the linked tenancy from the Tenancy name field and open its details page.
  3. Click Request to join governance. The Request to join governance panel opens, where you can request the tenancy to opt in. The recipient must have access to the child tenancy, and has 14 days to respond before the request expires.
  4. Optionally, in Recipient email, enter the recipient email address.
  5. In Governance Rules, select the chosen governance rules now, or skip and select governance rules later.
  6. Click Send Request. A message is displayed, indicating that your governance invite request has been sent, and the child tenancy will use organization governance soon if they decide to accept the request.

    On the sending tenancy's Invitations page, you can view the new governance invitation, which has Sent request in the Type field. Click the linked invitation to view the invitation details page, where you can view its status (initially Pending, until the receiving tenancy accepts the governance invitation). The Request field indicates that you requested the tenancy to join organization governance, and its Status is Pending. After the recipient tenancy accepts the request, you can create and attach governance rules to the tenancy.

    You can also choose to revoke the governance invitation by clicking Revoke.

  7. On the recipient child tenancy, open the navigation menu and click Governance & Administration. Under Organization Management, click Invitations. The new governance invitation has a Status of Pending, and its Type is Received request.
  8. Click the linked invitation to go to the Request details: Join organization governance page. The invitation Type is Received request, and the Request field indicates that by accepting the request, you're joining organization governance and agreeing to allow the parent tenancy to create and attach governance rules to your tenancy. After joining, only the parent tenancy can remove your tenancy from organization governance.

    You can also accept the governance invitation directly from the main Invitations page by clicking Accept Request directly from the Actions menu (Actions Menu).

  9. Click Accept. In the Accept Invitation confirmation, click Accept if you're sure you want to accept the request to join organization governance.

    If you click Decline, the invitation is rejected and the sending tenancy can send another governance invitation later.

    After a few minutes, the invitation status changes to Accepted. The invitation status can be viewed on both the sending (parent) tenancy, and the recipient (child) tenancy.

    On the sending tenancy Tenancies page, the Organization governance field displays Joined, to indicate that the tenancy is now using governance rules. The Governance state field on the tenancy's details page also shows Organization governance, to indicate that the tenancy is using governance rules.

To opt out existing tenancies from governance rules

To opt a tenancy out of governance rules:

  1. Open the navigation menu and click Governance & Administration. Under Organization Management, click Tenancies.
  2. From the Tenancies page, click the linked tenancy from the Tenancy name field and open its details page.
  3. Click Remove from organization governance.
  4. In the confirmation, click Remove from organization governance. A message is displayed, indicating that your request to opt out of governance has been accepted, and your tenancy will be removed from organization governance soon.

    After removing the tenancy from governance rules, you will no longer can attach governance rules to the tenancy. To attach rules in the future, you need to request the tenancy to opt in again.

    On the Tenancies page, the Organization governance field displays Not joined, to indicate that the tenancy isn't using governance rules. The Governance state field on the tenancy's details page also shows Cost management only, to indicate that the tenancy is no longer using governance rules, and is instead only sharing cost management details.

Troubleshooting Rules that Need Attention

Sometimes governance rules require attention while attaching to one or many tenancies in the organization. The work request for a specific tenancy gives detailed logs and error messages about the issue. Some of the typical scenarios include:
  • Creating a Tags governance rule and applying it to a tenancy, but the tenancy already has a tag namespace with the same name. For example, if you apply this kind of a rule to the parent tenancy, the template tag namespace prevents creation of another tag namespace with a matching name.
  • Syntax errors or mistakes in the quota policy statement still allow Quota policy governance rule creation, but such rules fail to attach to any of the tenancies.

Using the API

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 the following in the Organizations API for organization management.

To manage subscriptions and subscription mapping:

To manage tenancies and the organization:

To manage child tenancy reactivation:

To move a child tenancy from one organization to another:

To manage invitations:

To manage work requests:

To manage governance rules:

Cost Reporting Integration

You can use the Oracle billing and cost reporting features to centrally manage the cost and usage information across all tenancies in your organization.

After a tenancy has been created or joins your organization, you can filter or group by spending in your organization through the reporting options in Cost Analysis. As the parent tenancy, you can use Cost Analysis Overview to hone in on your organization's spending by using:

  • The Tenant ID and Tenant Name grouping dimensions; and
  • The Subscription ID grouping dimensions to filter by a specific subscription and find which subscription a tenancy’s usage was attributed against. As a result, you can view the cost and usage associated solely with a particular subscription. See Viewing Subscription Details and Costs for more information on viewing costs in an organization.

Child tenancies can also group by Tenant ID, Tenant Name, and Subscription ID, but the costs shown are only for the child tenancy (in contrast to a parent tenancy that can see its costs, plus the child tenancy costs).

You can also view granular cost and usage information using cost and usage reports, where you can get hourly level information to gain insights on your spending.

All spending against the subscription (in the parent and all child tenancies) is included in cost reporting in the parent tenancy, and child tenancies are limited to seeing spending in their own tenancy. Cost and usage reports are generated only in the parent tenancy, and include all usage for the parent and all its children. Both parent and child tenancies can create budgets. Parent tenancies can create budgets both for themselves and child tenancies, while child tenancies can only create budgets for themselves.

Important

A tenancy that has had its subscription reassigned will have data split across two subscriptions going forward (that is, before and after being reassigned). In Cost Analysis and Cost and usage reports, the data corresponds to a particular time, and impacts query filtering and grouping choices. For example, if "tenancy1" was reporting data to "subscription1" until October 15, and "subscription2" from October 16, then you must look at "subscription1" for consumption until October 15, and "subscription2" after October 15.
Note

Also see Viewing Billing Details for more information on billing details that can be viewed on the Console home page.

The following table describes the impact of Organization Management on cost reporting, in terms of all Oracle Cloud Infrastructure Billing and Cost Management features.

Parent Tenancy Child Tenancies
Cost Analysis Overview Reports on all usage and cost in the parent, and all children with the ability to group by tenancy or subscription ID. Parent tenancies can also view the subscription details for the parent and all child tenancies.

Reports on all usage and cost in the child tenancy. Child tenancies cannot view subscription details within Cost Analysis (they can only be viewed from the parent tenancy perspective).

Note: If a child tenancy wants to use Cost Analysis from the Console, you must subscribe to the parent tenancy's home region.
Cost and usage reports (CSVs) Includes all usage and costs in the parent and all children. Not available.
Budgets Budgets can be created against child tenancies, compartments, and tags in the primary tenancy. Budgets can be created against compartments, or tags within the child tenancy.
Oracle Cloud Advisor Recommendations can be viewed by the parent across all child tenancies. The parent can view the recommendation, but can't implement the recommendation. Child tenancies can view their own recommendations.

Support

Depending on how you created your tenancy, you either have:
  • Separate CSI (Customer Support Identifier) numbers, and support accounts for each tenancy.
  • Or, a combination of both.
To ensure that you get unique CSIs per tenancy, work with your account team to create tenancies in a way that creates new CSIs.