翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# を使用してダッシュボードを作成する AWS CLI
<a name="create-dashboards-ai-dashboard-cli"></a>

**注記**  
SiteWise Monitor 機能は、新規のお客様は利用できなくなりました。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、[SiteWise Monitor の可用性の変更](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-monitor-availability-change.html)」を参照してください。

を使用してダッシュボードで視覚化 (またはウィジェット) を定義する場合は AWS CLI、JSON `dashboardDefinition` ドキュメントで次の情報を指定する必要があります。この定義は、[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` – ダッシュボードレイアウトの行数。各行は **cellSize** 全体です。
+ `numColumbs` – ダッシュボードレイアウトの列数。各列は **cellSize** 全体です。
+ `cellSize` – (オプション) レイアウト内のセルのサイズをピクセル単位で指定します。正の数である必要があります。デフォルトは 10 です。
+ `significantDigits` – (オプション) ダッシュボードに表示する重要な桁数。デフォルトは 4 です。

`querySettings`  
次のパラメータを持つクエリ情報。  
+ `refreshRate` – (オプション) データがミリ秒単位で更新されるレート。1000、5000、10000、60000、30000 の値を受け入れます。

`defaultViewport`  
指定しない場合、デフォルトは過去 5 分です。次のパラメータが含まれます。  
+ `duration` – (オプション) 現在からデータをクエリする過去の距離を決定します。
+ `start` – (オプション) タイプは Date です。データをクエリする開始時間範囲。指定された`end`日付が必要です。
+ `end` – (オプション) タイプは Date です。データをクエリする終了時間範囲。指定された`start`日付が必要です。

`widgets`  
以下の情報を含むウィジェット定義構造のリスト。    
`type`  
widget. のタイプは、次のウィジェットタイプ 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` – 1 つ以上のデータソースからの時系列データを視覚化およびナビゲートするステータスウィジェット。
+ <a name="text-widget"></a>`text` – テキストウィジェット。
+ <a name="table-widget"></a>`table` — テーブルウィジェット   
`id`  
ウィジェットの一意の識別子。  
`x`  
ダッシュボードの左から始まるウィジェットの水平位置。この値は、ダッシュボードのグリッド内のウィジェットの位置を参照します。  
`y`  
ダッシュボードの上部から始まるウィジェットの垂直位置。この値は、ダッシュボードのグリッド内のウィジェットの位置を参照します。  
`z`  
ウィジェットの相対的な順序。大きな Z 値ウィジェットは、下部の Z 値ウィジェットの前に重複している場合に表示されます。  
`width`  
ダッシュボード上のセル数で表されるウィジェットの幅。  
`height`  
ダッシュボード上のセル数で表されるウィジェットの高さ。  
`properties`  
ウィジェットのプロパティのリスト。ウィジェットのタイプによって異なります。詳細については、[「 IoT App Kit](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
    }
}
```