Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Créez des tableaux de bord avec AWS CLI
**Note**
La fonction de SiteWise surveillance n'est plus disponible pour les nouveaux clients. Les clients existants peuvent continuer à utiliser le service normalement. Pour plus d'informations, voir [SiteWise Surveiller l'évolution de la disponibilité](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-monitor-availability-change.html).
Lorsque vous définissez des visualisations (ou des widgets) dans des tableaux de bord à l'aide du AWS CLI, vous devez spécifier les informations suivantes dans le document `dashboardDefinition` JSON. Cette définition est un paramètre des [UpdateDashboard](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateDashboard.html)opérations [CreateDashboard](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateDashboard.html)et.
`displaySettings`
Les paramètres d'affichage avec les paramètres suivants :
+ `numRows`— Nombre de lignes dans la mise en page du tableau de bord. Chaque ligne a la largeur de **CellSize**.
+ `numColumbs`— Nombre de colonnes dans la mise en page du tableau de bord. La largeur de chaque colonne est de **CellSize**.
+ `cellSize`— (Facultatif) Taille d'une cellule dans le modèle en pixels. Il doit s'agir d'un nombre positif. La valeur par défaut est 10.
+ `significantDigits`— (Facultatif) Nombre de chiffres significatifs à afficher dans le tableau de bord. La valeur par défaut est 4.
`querySettings`
Les informations de requête avec le paramètre suivant :
+ `refreshRate`— (Facultatif) La vitesse à laquelle les données sont actualisées en millisecondes. Accepte les valeurs suivantes : 1000, 5000, 10000, 60000, 300000.
`defaultViewport`
Si ce n'est pas le cas, la valeur par défaut est les cinq dernières minutes. Contient les paramètres suivants :
+ `duration`— (Facultatif) Détermine jusqu'où il faut interroger les données en commençant par le présent.
+ `start`— (Facultatif) Il est de type Date. La plage horaire de début pour interroger les données. Nécessite une `end` date spécifiée.
+ `end`— (Facultatif) Il est de type Date. L'intervalle de temps de fin pour interroger les données. Nécessite une `start` date spécifiée.
`widgets`
Liste des structures de définition de widgets contenant les informations suivantes :
`type`
Type de widget. AWS IoT SiteWise fournit les types de widgets suivants :
+ `xy-plot`— Un graphique linéaire ou un nuage de points selon la configuration.
+ `bar-chart`— Un graphique à barres.
+ `kpi-chart`— Un tableau des indicateurs de performance clés.
+ `status-timeline`— Un widget d'état qui permet de visualiser et de parcourir les données de séries chronologiques provenant d'une ou de plusieurs sources de données.
+ `text`— Un widget de texte.
+ `table`— Un widget de tableau.
`id`
Identifiant unique pour le widget.
`x`
Position horizontale du widget, en partant de la gauche du tableau de bord. Cette valeur fait référence à la position du widget dans la grille du tableau de bord.
`y`
Position verticale du widget, en commençant par le haut du tableau de bord. Cette valeur fait référence à la position du widget dans la grille du tableau de bord.
`z`
L'ordre relatif des widgets. Un widget de valeur Z plus grande est affiché devant le widget de valeur Z inférieure, s'ils se chevauchent.
`width`
Largeur du widget, exprimée en nombre de cellules sur le tableau de bord.
`height`
Hauteur du widget, exprimée en nombre de cellules sur le tableau de bord.
`properties`
Liste des propriétés du widget. Cela varie en fonction du type de widget. Consultez [IoT App Kit](https://awslabs.github.io/iot-app-kit/?path=/docs/components-statustimeline--docs) pour plus de détails.
**Example Exemple de définition de tableau de bord**
L'exemple suivant définit un tableau de bord à partir d'une charge utile stockée dans un fichier JSON.
```
aws iotsitewise create-dashboard \
--project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE \
--dashboard-name "Example Dashboard" \
--dashboard-definition file://dashboard-definition.json
```
L'exemple JSON suivant pour `dashboard-definition.json` définit un tableau de bord avec les widgets de visualisation suivants :
```
{
"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
}
}
```