

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Crie painéis com AWS CLI
<a name="create-dashboards-ai-dashboard-cli"></a>

**nota**  
O recurso SiteWise Monitor não está mais disponível para novos clientes. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte [SiteWise Monitorar alterações na disponibilidade](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-monitor-availability-change.html).

Ao definir visualizações (ou widgets) em painéis usando o AWS CLI, você deve especificar as seguintes informações no `dashboardDefinition` documento JSON. Essa definição é um parâmetro das [UpdateDashboard](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateDashboard.html)operações [CreateDashboard](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateDashboard.html)e.

`displaySettings`  
As configurações de exibição com os seguintes parâmetros:  
+ `numRows`— Número de linhas no layout do painel. Cada linha tem a largura de **CellSize**.
+ `numColumbs`— Número de colunas no layout do painel. Cada coluna tem a largura de **CellSize**.
+ `cellSize`— (Opcional) O tamanho de uma célula no layout em pixels. Deve ser um número positivo. O padrão é 10.
+ `significantDigits`— (Opcional) Número de dígitos significativos a serem exibidos no painel. O padrão é 4.

`querySettings`  
As informações da consulta com o seguinte parâmetro:  
+ `refreshRate`— (Opcional) A taxa na qual os dados são atualizados em milissegundos. Aceita os seguintes valores - 1000, 5000, 10000, 60000, 300000.

`defaultViewport`  
Se não for fornecido, o padrão é os últimos cinco minutos. Contém os seguintes parâmetros:  
+ `duration`— (Opcional) Determina até que ponto no passado consultar dados a partir do momento presente.
+ `start`— (Opcional) É do tipo Data. O intervalo de horário de início para consultar dados. Precisa de uma `end` data especificada.
+ `end`— (Opcional) É do tipo Data. O intervalo de tempo de término para consultar dados. Precisa de uma `start` data especificada.

`widgets`  
Uma lista de estruturas de definição de widgets que contêm as seguintes informações:    
`type`  
O tipo de widget. AWS IoT SiteWise fornece os seguintes tipos de widget:  
+ <a name="xy-plot"></a>`xy-plot`— Um gráfico de linhas ou um gráfico de dispersão, dependendo da configuração. 
+ <a name="bar-chart"></a>`bar-chart`: um gráfico de barras. 
+ <a name="kpi-chart"></a>`kpi-chart`— Um gráfico de indicadores-chave de desempenho. 
+ <a name="status-timeline"></a>`status-timeline`— Um widget de status que visualiza e navega pelos dados de séries temporais de uma ou mais fontes de dados. 
+ <a name="text-widget"></a>`text`— Um widget de texto. 
+ <a name="table-widget"></a>`table`: um widget de tabela.   
`id`  
Um identificador exclusivo para o widget.  
`x`  
A posição horizontal do widget, começando pela esquerda do painel. Esse valor se refere à posição do widget na grade do painel.  
`y`  
A posição vertical do widget, começando pela parte superior do painel. Esse valor se refere à posição do widget na grade do painel.  
`z`  
A ordem relativa dos widgets. Um widget de valor Z maior é exibido na frente do widget de valor Z inferior, se eles se sobreporem.  
`width`  
A largura do widget, expressa em número de células no painel.  
`height`  
A altura do widget, expressa em número de células no painel.  
`properties`  
Uma lista das propriedades do widget. Isso varia de acordo com o tipo de widget. Consulte o [IoT App Kit para obter detalhes](https://awslabs.github.io/iot-app-kit/?path=/docs/components-statustimeline--docs).

**Example Exemplo de definição de painel**  
O exemplo a seguir define um painel de uma carga útil armazenada em um arquivo JSON.  

```
aws iotsitewise create-dashboard \
  --project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE \
  --dashboard-name "Example Dashboard" \
  --dashboard-definition file://dashboard-definition.json
```
O exemplo de JSON a seguir para `dashboard-definition.json` define o painel com os seguintes widgets de visualização:  

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