本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用创建仪表板 AWS CLI
<a name="create-dashboards-ai-dashboard-cli"></a>

**注意**  
新客户不再可以使用 SiteWise 监控功能。现有客户可以继续正常使用该服务。有关更多信息，请参阅[SiteWise 监控器可用性更改](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-monitor-availability-change.html)。

使用在仪表板中定义可视化（或微件）时 AWS CLI，必须在 `dashboardDefinition` JSON 文档中指定以下信息。此定义是[CreateDashboard](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateDashboard.html)和[UpdateDashboard](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateDashboard.html)操作的参数。

`displaySettings`  
具有以下参数的显示设置：  
+ `numRows`-仪表板布局中的行数。每行都宽度为**单元格大小**。
+ `numColumbs`-仪表板布局中的列数。每列的**单元格大小**都很宽。
+ `cellSize`—（可选）布局中单元格的大小（以像素为单位）。它必须是正数。默认值为 10。
+ `significantDigits`—（可选）要在控制面板中显示的有效数字的数量。默认值为 4。

`querySettings`  
带有以下参数的查询信息：  
+ `refreshRate`—（可选）以毫秒为单位的数据刷新速率。接受以下值——1000、5000、10000、60000、300000。

`defaultViewport`  
如果未提供，则默认为最后五分钟。包含以下参数：  
+ `duration`—（可选）确定从现在开始查询过去多久的数据。
+ `start`—（可选）它的类型为日期。查询数据的开始时间范围。需要指定`end`日期。
+ `end`—（可选）它的类型为日期。查询数据的结束时间范围。需要指定`start`日期。

`widgets`  
包含以下信息的小组件定义结构列表：    
`type`  
控件的类型。 AWS IoT SiteWise 提供以下控件类型：  
+ <a name="xy-plot"></a>`xy-plot`— 折线图或散点图，具体取决于配置。
+ <a name="bar-chart"></a>`bar-chart` – 条形图。
+ <a name="kpi-chart"></a>`kpi-chart`— 关键绩效指标图表。
+ <a name="status-timeline"></a>`status-timeline`— 一种状态控件，用于可视化和浏览来自一个或多个数据源的时间序列数据。
+ <a name="text-widget"></a>`text`— 文本控件。
+ <a name="table-widget"></a>`table` – 表格控件。  
`id`  
小组件的唯一标识符。  
`x`  
控件的水平位置，从仪表板的左侧开始。此值表示小部件在控制面板网格中的位置。  
`y`  
小组件的垂直位置，从仪表板顶部开始。此值表示小部件在控制面板网格中的位置。  
`z`  
控件的相对顺序。如果它们重叠，则较大的 Z 值控件会显示在较低的 Z 值构件的前面。  
`width`  
控件的宽度，以仪表板上的单元格数量表示。  
`height`  
控件的高度，以仪表板上的单元格数量表示。  
`properties`  
控件的属性列表。它因小部件的类型而异。有关详细信息，请参阅 [IoT 应用程序套件](https://awslabs.github.io/iot-app-kit/?path=/docs/components-statustimeline--docs)。

**Example 示例控制面板定义**  
以下示例从存储在 JSON 文件中的负载定义控制面板。  

```
aws iotsitewise create-dashboard \
  --project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE \
  --dashboard-name "Example Dashboard" \
  --dashboard-definition file://dashboard-definition.json
```
针对 `dashboard-definition.json` 的以下 JSON 示例定义具有以下可视化小部件的控制面板：  

```
{
    "displaySettings": {
        "numColumns": 200,
        "numRows": 1000,
        "cellSize": 20,
        "significantDigits": 4
    },
    "widgets": [{
        "id": "Ot73JcxUoc6oEXAMPLE",
        "type": "xy-plot",
        "width": 33,
        "height": 20,
        "x": 0,
        "y": 0,
        "z": 0,
        "properties": {
            "aggregationType": "AVERAGE",
            "queryConfig": {
                "source": "iotsitewise",
                "query": {
                    "assets": [{
                        "assetId": "97c97abf-e883-47bb-a3f4-EXAMPLE",
                        "properties": [{
                            "propertyId": "97cc61f4-57a4-4c5f-a82c-EXAMPLE",
                            "refId": "692ce941-f3d9-4074-a297-EXAMPLE",
                            "aggregationType": "AVERAGE",
                            "color": "#7d2105",
                            "resolution": "1m"
                        }]
                    }],
                    "properties": [],
                    "assetModels": [],
                    "alarms": [],
                    "alarmModels": []
                }
            },
            "line": {
                "connectionStyle": "linear",
                "style": "solid"
            },
            "symbol": {
                "style": "filled-circle"
            },
            "axis": {
                "yVisible": true,
                "xVisible": true
            },
            "legend": {
                "visible": true,
                "position": "right",
                "width": "30%",
                "height": "30%",
                "visibleContent": {
                    "unit": true,
                    "asset": true,
                    "latestValue": true,
                    "latestAlarmStateValue": true,
                    "maxValue": false,
                    "minValue": false
                }
            }
        }
    }, {
        "id": "fto7rF40Ny1EXAMPLE-G",
        "type": "bar-chart",
        "width": 33,
        "height": 20,
        "x": 0,
        "y": 20,
        "z": 0,
        "properties": {
            "aggregationType": "AVERAGE",
            "queryConfig": {
                "source": "iotsitewise",
                "query": {
                    "assets": [{
                        "assetId": "97c97abf-e883-47bb-a3f4-EXAMPLE",
                        "properties": [{
                            "propertyId": "c84ca8f3-3dea-478a-afec-EXAMPLE",
                            "aggregationType": "AVERAGE",
                            "refId": "2960b958-2034-4d6e-bcc2-EXAMPLE"
                        }]
                    }],
                    "properties": [],
                    "assetModels": [],
                    "alarms": [],
                    "alarmModels": [],
                    "requestSettings": {
                        "aggregation": "AVERAGE"
                    }
                }
            },
            "axis": {
                "showX": true,
                "showY": true
            },
            "styleSettings": {
                "2960b958-2034-4d6e-bcc2-360f1f02e505": {
                    "color": "#7d2105"
                }
            }
        }
    }],
    "querySettings": {
        "refreshRate": 5000
    }
}
```