Adding Governance to Tenancies

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 is created and then locked in the target tenancy.

A governance rule is a type of enforcement that a parent tenancy creates that 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 aren't 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 child tenancy is prevented from subscribing to other regions on the Region Management page. For quota policies, on the child tenancy's Quota Policies page the quota name has an adjacent lock icon, and on the quota policy details page, a message indicates 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 controls:

  • 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 must also update the governance rule for the changes to propagate to child tenancies.

Using the API

Run the AddGovernance operation to add governance rules to a tenancy.