[comment]: # ({3170cb57-6acd087d})
# 24 SLA 报告

[comment]: # ({/3170cb57-6acd087d})

[comment]: # ({df4b95aa-b112d173})
### 描述

这些参数及对应仪表板小组件字段objects的可选属性值，可用于配置`dashboard.create`和`dashboard.update`方法中的[*SLA report*](/manual/web_interface/frontend_sections/dashboards/widgets/sla_report)小组件。

::: noteimportant
小组件`fields`的属性在仪表板创建或update过程中不会进行验证。
这使得用户可以修改[built-in widgets](/manual/web_interface/frontend_sections/dashboards/widgets)和create[custom widgets](/devel/modules/tutorials/widget)，但也存在错误创建或更新小组件的风险。
为确保成功创建或update*SLA报告*小组件，请参考下表中列出的参数行为规范。

:::

[comment]: # ({/df4b95aa-b112d173})

[comment]: # ({38e4bb72-b48fed5a})
### 参数

*SLA报告*小部件支持以下参数。

| 参数 | [仪表板小部件字段](/manual/api/reference/dashboard/object#仪表板小部件字段) | 名称 | 值 |
|-----|-|-----|-------------------|
| *Refresh interval* | 0 | rf_rate | 0 - *(默认)* 无刷新；<br>10 - 10 秒；<br>30 - 30 秒；<br>60 - 1 分钟；<br>120 - 2 分钟；<br>600 - 10 分钟；<br>900 - 15 分钟。 |
| *SLA* | 10 | slaid.0 | [SLA](/manual/api/reference/sla/get) ID。<br><br>[参数行为](/manual/api/reference_commentary#参数行为)：<br>- *必须* |
| *Service* | 9 | serviceid.0 | [Service](/manual/api/reference/service/get) ID. |
| *Show periods* | 0 | show_periods | 可能的取值范围为 1-100。<br><br>默认值：20。|
| *From* | 1 | date_from | 有效日期 string，格式为 `YYYY-MM-DD`。<br>支持带修饰符 `d`、`w`、`M`、`y` 的 [Relative dates](/manual/web_interface/time_period_selector)（例如 `now`、`now/d`、`now/w-1w` 等）。 |
| *To* | 1 | date_to | 有效日期 string，格式为 `YYYY-MM-DD`。<br>支持带修饰符 `d`、`w`、`M`、`y` 的 [Relative dates](/manual/web_interface/time_period_selector)（例如 `now`、`now/d`、`now/w-1w` 等）。 |

[comment]: # ({/38e4bb72-b48fed5a})

[comment]: # ({a1887e00-50899945})
### 示例

以下示例仅用于描述如何配置仪表板 widget 字段 objects 以用于 *SLA 报告* 小组件。
有关配置仪表板的更多信息，请参阅 [`dashboard.create`](/manual/api/reference/dashboard/create)。

[comment]: # ({/a1887e00-50899945})

[comment]: # ({00863279-d501029a})
#### 配置 *SLA 报告* 小部件

配置一个*SLA报告* widget，用于显示SLA“4”服务“2”在过去30天内的SLA报告。

[执行请求](/manual/api#执行请求):


```json
{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "slareport",
                        "name": "SLA report",
                        "x": 0,
                        "y": 0,
                        "width": 36,
                        "height": 5,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 10,
                                "name": "slaid.0",
                                "value": 4
                            },
                            {
                                "type": 9,
                                "name": "serviceid.0",
                                "value": 2
                            },
                            {
                                "type": 1,
                                "name": "date_from",
                                "value": "now-30d"
                            },
                            {
                                "type": 1,
                                "name": "date_to",
                                "value": "now"
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}
```
响应：


```json
{
    "jsonrpc": "2.0",
    "result": {
        "dashboardids": [
            "3"
        ]
    },
    "id": 1
}
```

[comment]: # ({/00863279-d501029a})

[comment]: # ({e9d30322-ccbde9ad})
### 另请参阅

-   [Dashboard widget field](/manual/api/reference/dashboard/object#dashboard-widget-field)
-   [`dashboard.create`](/manual/api/reference/dashboard/create)
-   [`dashboard.update`](/manual/api/reference/dashboard/update)

[comment]: # ({/e9d30322-ccbde9ad})