Oracle Cloud Infrastructure Documentation

Working with Console Dashboards Groups

Dashboard groups let you share collections of dashboards with designated groups of people. For example, each team within an organization can have its own dashboard group. Use IAM polices to control membership in dashboard groups and access to dashboards. You can use the Console or the Dashboards API to create, edit, and manage your groups.

Sharing Dashboards with Groups

Use IAM policies to control access to dashboards.

The following policy gives users in the specified group manage permissions for this dashboard group at the compartment level:

Allow group CompartmentUsers to manage dashboard-groups in compartment <compartment_name> where target.dashboardgroup.id='ocid1.dashboardgroup.oc1.phx.<uniqueID>'

The following policy gives users in the specified group manage permissions for this dashboard group at the tenancy level:

Allow group TenancyUsers to manage dashboard-groups in tenancy where target.dashboardgroup.id='ocid1.dashboardgroup.oc1.phx.<uniqueID>'

Using the Console

You can use the Console to create, edit, and manage dashboard groups.

To create a dashboard group
  1. On the Console home page, click the Dashboard tab.
  2. In the dashboard banner, click the Manage groups button.
  3. Click Create dashboard group. The Create new dashboard group dialog opens.
  4. In the Create new dashboard group dialog, enter the following:
    1. Dashboard group name: Enter a name for the dashboard group. You can add or change the name later. The name doesn't need to be unique, because an Oracle Cloud Identifier (OCID) uniquely identifies the dashboard group. Leading and trailing spaces and the following special characters are not allowed: <>()=/'"&\. Avoid entering confidential information.
    2. Description: (Optional) Enter a description for the dashboard group. The following special characters are not allowed: <>()=/'"&\.
    3. Resource compartment: Select the compartment to create the dashboard group in.
  5. (Optional) Click Show additional options. The Add tags tab opens.

    If you have permission to create a resource, then you also have permission to apply free-form tags to that resource. To apply a defined tag, you must have permission to use the tag namespace. For more information about tagging, see Tagging. If you are not sure whether to apply tags, skip this option (you can apply tags later) or ask your administrator.

  6. Click Create.
To edit the dashboard group name and description
  1. On the Console home page, click the Dashboard tab.
  2. In the dashboard banner, click the Manage groups button.
  3. If needed, under List Scope, change the compartment.
  4. To open the Dashboard Group Details page, click the name of the dashboard group.
  5. On the Dashboard Group Details page, click Edit. The Edit dashboard group dialog opens.
  6. Enter a new name and description. For the name, leading and trailing spaces and the following special characters are not allowed: <>()=/'"&\. For the description, the following special characters are not allowed: <>()=/'"&\. Avoid entering confidential information.
  7. Click Submit.
To delete dashboard groups
  1. On the Console home page, click the Dashboard tab.
  2. In the dashboard banner, click the Manage groups button.
  3. If needed, under List Scope, change the compartment.
  4. To open the Dashboard Group Details page, click the name of the dashboard group.
  5. On the Dashboard Group Details page, click Delete. The Delete dashboard group dialog opens.
  6. Click Delete.
Note

You cannot delete a dashboard group that contains dashboards. Delete dashboards before you delete the dashboard group.