

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Erstellen Sie Dashboards mit AWS CLI
<a name="create-dashboards-ai-dashboard-cli"></a>

**Anmerkung**  
Die SiteWise Monitor-Funktion ist für Neukunden nicht mehr verfügbar. Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter [Änderung der Verfügbarkeit SiteWise überwachen](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-monitor-availability-change.html).

Wenn Sie Visualisierungen (oder Widgets) in Dashboards mithilfe von definieren AWS CLI, müssen Sie die folgenden Informationen im JSON-Dokument angeben. `dashboardDefinition` Diese Definition ist ein Parameter der [CreateDashboard](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateDashboard.html)Operationen und. [UpdateDashboard](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateDashboard.html)

`displaySettings`  
Die Anzeigeeinstellungen mit den folgenden Parametern:  
+ `numRows`— Anzahl der Zeilen im Dashboard-Layout. Jede Zeile ist **cellSize-breit**.
+ `numColumbs`— Anzahl der Spalten im Dashboard-Layout. Jede Spalte ist **cellSize-breit**.
+ `cellSize`— (Optional) Die Größe einer Zelle im Layout in Pixeln. Es muss eine positive Zahl sein. Die Standardeinstellung ist 10.
+ `significantDigits`— (Optional) Anzahl der signifikanten Ziffern, die im Dashboard angezeigt werden sollen. Die Standardeinstellung ist 4.

`querySettings`  
Die Abfrageinformationen mit dem folgenden Parameter:  
+ `refreshRate`— (Optional) Die Geschwindigkeit, mit der Daten aktualisiert werden, in Millisekunden. Akzeptiert die folgenden Werte: 1000, 5000, 10000, 60000, 300000.

`defaultViewport`  
Wenn nicht angegeben, werden standardmäßig die letzten fünf Minuten verwendet. Enthält die folgenden Parameter:  
+ `duration`— (Optional) Legt fest, wie weit in die Vergangenheit Daten ausgehend von der Gegenwart abgefragt werden sollen.
+ `start`— (Optional) Es ist vom Typ Datum. Der Startzeitbereich für die Datenabfrage. Es muss ein `end` Datum angegeben werden.
+ `end`— (Optional) Es ist vom Typ Datum. Der Endzeitbereich für die Datenabfrage. Es muss ein `start` Datum angegeben werden.

`widgets`  
Eine Liste von Strukturen für Widget-Definitionen, die die folgenden Informationen enthalten:    
`type`  
Der Typ des Widgets. AWS IoT SiteWise bietet die folgenden Widget-Typen:  
+ <a name="xy-plot"></a>`xy-plot`— Je nach Konfiguration ein Liniendiagramm oder ein Streudiagramm. 
+ <a name="bar-chart"></a>`bar-chart`— Ein Balkendiagramm. 
+ <a name="kpi-chart"></a>`kpi-chart`— Ein Diagramm mit wichtigen Leistungsindikatoren. 
+ <a name="status-timeline"></a>`status-timeline`— Ein Status-Widget, das Zeitreihendaten aus einer oder mehreren Datenquellen visualisiert und darin navigiert. 
+ <a name="text-widget"></a>`text`— Ein Text-Widget. 
+ <a name="table-widget"></a>`table`— Ein Tabellen-Widget.   
`id`  
Eine eindeutige Kennung für das Widget.  
`x`  
Die horizontale Position des Widgets, beginnend von der linken Seite des Dashboards. Dieser Wert bezieht sich auf die Position des Widgets im Raster des Dashboards.  
`y`  
Die vertikale Position des Widgets, beginnend am oberen Rand des Dashboards. Dieser Wert bezieht sich auf die Position des Widgets im Raster des Dashboards.  
`z`  
Die relative Reihenfolge der Widgets. Ein größeres Z-Wert-Widget wird vor dem Widget mit niedrigerem Z-Wert angezeigt, wenn sie sich überschneiden.  
`width`  
Die Breite des Widgets, ausgedrückt in der Anzahl der Zellen auf dem Dashboard.  
`height`  
Die Höhe des Widgets, ausgedrückt in der Anzahl der Zellen auf dem Dashboard.  
`properties`  
Eine Liste der Eigenschaften des Widgets. Sie variiert je nach Art des Widgets. Einzelheiten finden Sie im [IoT App Kit](https://awslabs.github.io/iot-app-kit/?path=/docs/components-statustimeline--docs).

**Example Dashboard-Beispieldefinition**  
Im folgenden Beispiel wird ein Dashboard aus einer Nutzlast definiert, die in einer JSON-Datei gespeichert ist.  

```
aws iotsitewise create-dashboard \
  --project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE \
  --dashboard-name "Example Dashboard" \
  --dashboard-definition file://dashboard-definition.json
```
Das folgende JSON-Beispiel für `dashboard-definition.json` definiert ein Dashboard mit den folgenden Visualisierungs-Widgets:  

```
{
    "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
    }
}
```