

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Buat dasbor dengan AWS CLI
<a name="create-dashboards-ai-dashboard-cli"></a>

**catatan**  
Fitur SiteWise Monitor tidak lagi tersedia untuk pelanggan baru. Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Untuk informasi selengkapnya, lihat [SiteWise Memantau perubahan ketersediaan](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-monitor-availability-change.html).

Saat Anda menentukan visualisasi (atau widget) di dasbor menggunakan AWS CLI, Anda harus menentukan informasi berikut dalam dokumen JSON. `dashboardDefinition` Definisi ini adalah parameter dari [CreateDashboard](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateDashboard.html)dan [UpdateDashboard](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateDashboard.html)operasi.

`displaySettings`  
Pengaturan tampilan dengan parameter berikut:  
+ `numRows`— Jumlah baris dalam tata letak dasbor. Setiap baris lebar **CellSize**.
+ `numColumbs`— Jumlah kolom dalam tata letak dasbor. Setiap kolom selebar **CellSize**.
+ `cellSize`— (Opsional) Ukuran sel dalam tata letak dalam piksel. Itu harus angka positif. Defaultnya adalah 10.
+ `significantDigits`— (Opsional) Jumlah digit signifikansi untuk ditampilkan di dasbor. Defaultnya adalah 4.

`querySettings`  
Informasi query dengan parameter berikut:  
+ `refreshRate`— (Opsional) Tingkat di mana data menyegarkan dalam milidetik. Menerima nilai-nilai berikut - 1000, 5000, 10000, 60000, 300000.

`defaultViewport`  
Jika tidak disediakan, default ke lima menit terakhir. Berisi parameter berikut:  
+ `duration`— (Opsional) Menentukan seberapa jauh ke masa lalu untuk menanyakan data mulai dari saat ini.
+ `start`— (Opsional) Ini adalah tipe Tanggal. Rentang waktu mulai untuk kueri data. Membutuhkan `end` tanggal yang ditentukan.
+ `end`— (Opsional) Ini adalah tipe Tanggal. Rentang waktu akhir untuk kueri data. Membutuhkan `start` tanggal yang ditentukan.

`widgets`  
Daftar struktur definisi widget yang berisi informasi berikut:    
`type`  
Jenis widget. AWS IoT SiteWise menyediakan jenis widget berikut:  
+ <a name="xy-plot"></a>`xy-plot`— Bagan garis atau plot pencar tergantung pada konfigurasi. 
+ <a name="bar-chart"></a>`bar-chart`— Bagan batang. 
+ <a name="kpi-chart"></a>`kpi-chart`— Grafik indikator kinerja utama. 
+ <a name="status-timeline"></a>`status-timeline`— Widget status yang memvisualisasikan dan menavigasi data deret waktu dari satu atau lebih sumber data. 
+ <a name="text-widget"></a>`text`- Widget teks. 
+ <a name="table-widget"></a>`table`— Sebuah widget tabel.   
`id`  
Pengidentifikasi unik untuk widget.  
`x`  
Posisi horizontal widget, mulai dari kiri dasbor. Nilai ini mengacu pada posisi widget di grid dashboard.  
`y`  
Posisi vertikal widget, mulai dari bagian atas dasbor. Nilai ini mengacu pada posisi widget di grid dashboard.  
`z`  
Urutan relatif dari widget. Widget nilai Z yang lebih besar ditampilkan di depan widget nilai Z yang lebih rendah, jika tumpang tindih.  
`width`  
Lebar widget, dinyatakan dalam jumlah sel di dasbor.  
`height`  
Ketinggian widget, dinyatakan dalam jumlah sel di dasbor.  
`properties`  
Daftar properti widget. Ini bervariasi menurut jenis widget. Lihat [Kit Aplikasi IoT](https://awslabs.github.io/iot-app-kit/?path=/docs/components-statustimeline--docs) untuk detailnya.

**Example Contoh definisi dasbor**  
Contoh berikut mendefinisikan dasbor dari payload yang disimpan dalam file JSON.  

```
aws iotsitewise create-dashboard \
  --project-id a1b2c3d4-5678-90ab-cdef-eeeeeEXAMPLE \
  --dashboard-name "Example Dashboard" \
  --dashboard-definition file://dashboard-definition.json
```
Contoh JSON berikut untuk `dashboard-definition.json` mendefinisikan dasbor dengan widget visualisasi berikut:  

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