本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
创建控制面板 (Amazon Command Line Interface)
当您使用 Amazon CLI 在控制面板中定义可视化内容（或小部件）时，必须在 dashboardDefinition JSON 文档中指定以下信息。此定义是CreateDashboard和UpdateDashboard操作的参数。
widgets-
小部件定义结构的列表，其中每个结构均包含以下信息：
type-
小部件的类型。Amazon IoT SiteWise 提供了以下小部件类型：
-
sc-line-chart– 折线图。有关更多信息，请参阅 Amazon IoT SiteWise Monitor 应用指南中的折线图。 -
sc-scatter-chart– 散点图。有关更多信息，请参阅Amazon IoT SiteWise Monitor应用程序指南中的散点图。 -
sc-bar-chart– 条形图。有关更多信息，请参阅Amazon IoT SiteWise Monitor应用指南中的条形图。 -
sc-status-grid– 一个状态控件，以网格形式显示资产属性的最新值。有关更多信息，请参阅Amazon IoT SiteWise Monitor应用程序指南中的状态控件。 -
sc-status-timeline– 一个状态控件，以时间轴的形式显示资产属性的历史值。有关更多信息，请参阅Amazon IoT SiteWise Monitor应用程序指南中的状态控件。 -
sc-kpi– 关键绩效指标 (KPI) 可视化。有关更多信息，请参阅Amazon IoT SiteWise Monitor应用指南中的 KPI 控件。 -
sc-table– 表格控件。有关更多信息，请参阅Amazon IoT SiteWise Monitor应用指南中的表格控件。
-
title-
小部件的标题。
x-
小部件的水平位置，从网格的左侧开始。此值表示小部件在控制面板网格中的位置。
y-
小部件的垂直位置，从网格的顶部开始。此值表示小部件在控制面板网格中的位置。
width-
小部件的宽度，用控制面板网格上的空格数表示。
height-
小部件的高度，用控制面板网格上的空格数表示。
metrics-
指标结构的列表，其中每个结构均为此小部件定义一个数据流。此列表中的每个结构都必须包含以下信息：
label-
要为此指标显示的标签。
type-
此指标的数据源类型。Amazon IoT SiteWise 提供以下指标类型：
-
iotsitewise– 控制面板提取 Amazon IoT SiteWise中的资产属性的数据。如果选择此选项，则必须为此指标定义assetId和propertyId。
-
assetId-
（可选）Amazon IoT SiteWise 中的资产的 ID。
如果您在该指标中为
type选择iotsitewise，则此字段是必填字段。 propertyId-
（可选）Amazon IoT SiteWise 中的资产属性的 ID。
如果您在该指标中为
type选择iotsitewise，则此字段是必填字段。 analysis-
或者，一种结构，用于定义要为小组件显示的分析（例如趋势线）。有关更多信息，请参阅Amazon IoT SiteWise Monitor应用指南中的配置趋势线。您可以在小组件中为每个属性添加每种类型的趋势线。分析结构包含以下信息：
trends-
或者，趋势结构列表，每个趋势结构都为该小组件定义了趋势分析。此列表中的每个结构包含以下信息：
type-
趋势线的类型。选择以下选项：
-
linear-regression— 显示线性回归线。 SiteWise Monitor 使用最小二乘法计算线性回归。
-
annotations-
或者，定义小组件阈值的注释结构。有关更多信息，请参阅https://docs.amazonaws.cn/iot-sitewise/latest/appguide/configure-thresholds.html版本指南中的Amazon IoT SiteWise Monitor配置阈值。每个控件可以添加最多 6 个注释。注释结构包含以下信息：
y-
或者，注释结构列表，每个注释结构都定义了此小组件的水平阈值。此列表中的每个结构包含以下信息：
comparisonOperator-
阈值的比较运算符。选择以下操作之一：
-
LT– 突出显示至少有一个数据点小于value的属性。 -
GT– 突出显示至少有一个数据点大于value的属性。 -
LTE– 突出显示至少有一个数据点小于或等于value的属性。 -
GTE– 突出显示至少有一个数据点大于或等于value的属性。 -
EQ– 突出显示至少有一个数据点等于value的属性。
-
value-
用于将数据点与
comparisonOperator进行比较的阈值。 color-
（可选）阈值颜色的 6 位十六进制代码。对于至少有一个数据点符合阈值规则的属性，可视化效果会以这种颜色显示属性图例。默认值为黑色（
#000000）。 showValue-
或者，是否在控件的边距中显示阈值的值。默认值为
true。
properties-
（可选）小部件属性的平面字典。该结构的成员取决于上下文。Amazon IoT SiteWise 提供了以下使用
properties的小部件：
例 示例控制面板定义
以下示例从存储在 JSON 文件中的负载定义控制面板。
aws iotsitewise create-dashboard \ --project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE \ --dashboard-name "Wind Farm Dashboard" \ --dashboard-definition file://dashboard-definition.json
针对 dashboard-definition.json 的以下 JSON 示例定义具有以下可视化小部件的控制面板：
-
控制面板左上角的直观显示风电场总功率的折线图。该折线图包括一个阈值，该阈值指示风电场何时输出功率少于其最低预期输出。该折线图还包括一条线性回归趋势线。
-
控制面板右上角的直观显示四个涡轮机的风速的折线图。
注意
此示例表示控制面板上的折线图和条形图可视化效果。此控制面板与示例风电场控制面板类似。
{ "widgets": [ { "type": "sc-line-chart", "title": "Total Average Power", "x": 0, "y": 0, "height": 3, "width": 3, "metrics": [ { "label": "Power", "type": "iotsitewise", "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE", "propertyId": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE", "analysis": { "trends": [ { "type": "linear-regression" } ] } } ], "annotations": { "y": [ { "comparisonOperator": "LT", "value": 20000, "color": "#D13212", "showValue": true } ] } }, { "type": "sc-bar-chart", "title": "Wind Speed", "x": 3, "y": 3, "height": 3, "width": 3, "metrics": [ { "label": "Turbine 1", "type": "iotsitewise", "assetId": "a1b2c3d4-5678-90ab-cdef-2a2a2EXAMPLE", "propertyId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE" }, { "label": "Turbine 2", "type": "iotsitewise", "assetId": "a1b2c3d4-5678-90ab-cdef-2b2b2EXAMPLE", "propertyId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE" }, { "label": "Turbine 3", "type": "iotsitewise", "assetId": "a1b2c3d4-5678-90ab-cdef-2c2c2EXAMPLE", "propertyId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE" }, { "label": "Turbine 4", "type": "iotsitewise", "assetId": "a1b2c3d4-5678-90ab-cdef-2d2d2EXAMPLE", "propertyId": "a1b2c3d4-5678-90ab-cdef-55555EXAMPLE" } ] } ] }