forked from signalfx/signalfx-go
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathmodel_create_update_dashboard_group_request.go
26 lines (23 loc) · 4.07 KB
/
model_create_update_dashboard_group_request.go
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
/*
* Dashboard Groups API
*
* Dashboard groups let you collect dashboards with common characteristics in one place in the web UI, so you can view them together or in sequence. ## Dashboard group membership A dashboard can belong to only one dashboard group, but a group can contain multiple dashboards. However, user default dashboard groups can only contain the user's default dashboard. <br> When you create a new dashboard group, the system generates a new dashboard for it. Similarly, when you create a new dashboard, the system creates a new dashboard group for it. Because a dashboard can only belong to one group, you can't add existing dashboards to a new group (the dashboards already belong to a group). To add an existing dashboard to a new group, create the group and then change the dashboard group of the dashboards to the new group. <br> You can add a new dashboard to an existing group at any time. ## Cloning dashboards into different groups You can also clone existing dashboards into another group. Use this feature to test dashboards in your user dashboard group before cloning them into a production group. You can also use this feature to customize an existing dashboard, by cloning it into your user group and then modifying it. ## Deleting dashboard groups When you delete a dashboard group, the system deletes the dashboards in the group and the charts that those dashboards contain.<br> **Note:** The system doesn't do this for dashboards. When you delete a dashboard, the system orphans its charts, but it doesn't delete them. <br> You can assign a dashboard group to one or more teams in your organization. The groups then appear on the team's landing page in the web UI. ## Viewing a dashboard group To view a dashboard group you create using the API, navigate to the following URL:<br> `https://app.<REALM>.signalfx.com/#/dashboard/<GROUP_ID>` <br> For `<GROUP_ID>`, substitute the value of the dashboard group ID. In the web UI, you see the dashboard group name, and underneath it the dashboard names displayed as tabs. ## Dashboard group authorizations By default, all users can edit or delete dashboard groups. If your organization has the \"write permissions\" feature enabled, your administrator can limit editing and deletion of specific dashboard groups to individual users or teams or both. This feature helps prevent unauthorized or accidental modifications to dashboard groups. Administrators can always modify write permissions, even for dashboard groups which they don't have permission to edit. This lets administrators escalate their access for any dashboard group. When a user deletes a dashboard group, the system deletes the group's dashboards without regard to the *dashboard* permissions. Only the dashgroup group permissions are considered.
*
* API version: 3.0.0
* Generated by: OpenAPI Generator (https://openapi-generator.tech)
*/
package dashboard_group
type CreateUpdateDashboardGroupRequest struct {
AuthorizedWriters *AuthorizedWriters `json:"authorizedWriters,omitempty"`
Permissions *ObjectPermissions `json:"permissions,omitempty"`
// Array of dashboard IDs. The system adds the specified dashboards to the dashboard group you're creating. If you omit the property, the system creates a new dashboard and assigns it to the new dashboard group.
Dashboards []string `json:"dashboards,omitempty"`
DashboardConfigs []*DashboardConfig `json:"dashboardConfigs,omitempty"`
// Description of the dashboard group. This value appears in the tooltip for the dashboard group on the Dashboards page in the web UI.
Description string `json:"description,omitempty"`
ImportQualifiers []*ImportQualifier `json:"importQualifiers,omitempty"`
// Name of the dashboard group. This value identifies the dashboard group in the web UI. It appears on the dashboards page and in the catalog. It also appears at the top left corner of the screen whenever you're viewing a dashboard that the group contains.
Name string `json:"name"`
// Array of existing team object ID. The dashboard group appears on the team landing page for any team in the list.
Teams []string `json:"teams,omitempty"`
}