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.
- On the Console home page, click the Dashboard tab.
- In the dashboard banner, click the Manage groups button.
- Click Create dashboard group. The Create new dashboard group dialog opens.
- In the Create new dashboard group dialog, enter the following:
- 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. - Description: (Optional) Enter a description for the dashboard group. The following special characters are not allowed:
<>()=/'"&\
. - Resource compartment: Select the compartment to create the dashboard group in.
- 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:
- (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.
- Click Create.
- On the Console home page, click the Dashboard tab.
- In the dashboard banner, click the Manage groups button.
- If needed, under List Scope, change the compartment.
- To open the Dashboard Group Details page, click the name of the dashboard group.
- On the Dashboard Group Details page, click Edit. The Edit dashboard group dialog opens.
- 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. - Click Submit.
- On the Console home page, click the Dashboard tab.
- In the dashboard banner, click the Manage groups button.
- If needed, under List Scope, change the compartment.
- To open the Dashboard Group Details page, click the name of the dashboard group.
- On the Dashboard Group Details page, click Delete. The Delete dashboard group dialog opens.
- Click Delete.
You cannot delete a dashboard group that contains dashboards. Delete dashboards before you delete the dashboard group.
Using the API
You can use the Dashboards API to create, edit, and delete dashboard groups.
Use these API operations to manage your dashboard groups: