API / SDK / developer guide
CreateAssetModel
| 目標讀者 TA | 資產模型設計者 |
|---|---|
| 官方文件能力 | 定義標準化資產屬性及階層。 |
| 輸入 → 輸出 | 模型定義 → 模型識別及生命週期狀態。 |
| 執行環境 | 選定帳號及區域的 AWS IoT SiteWise，具授權 IAM 存取 |
| 本站選型評估 | 建立模型不是發現實體資產。 |
| 本站建議驗證 | 建立資產前驗證型別、單位及就緒。 |
工業 IoT／SCADA · API / SDK
AWS IoT SiteWise API
AWS
透過服務 API 存取工業資產模型與相關資料。
AWS IOT SITEWISE / DEVELOPER FIELD GUIDE
選對接口，定義可驗證的結果。
公司／專案背景、十個技術入口，以及每份引用的實作分析。
2026-10-08 · 串接尚未實測
公司／專案背景全貌
依官方公司或專案自述撰寫的原創概要；完整原文請見來源。
| 服務 | AWS IoT SiteWise 是收集、組織及監測工業設備資料的代管服務。 |
|---|---|
| 資產脈絡 | 資產模型將資料依廠區、區域及機台組織。 |
| 開發範圍 | API 提供模型、資產及時序操作；裝置連線及可信量測需要另設匯入流程。 |
| 適用角色 | 進行 AI 供應商初選的採購、合作夥伴與產品負責人。 |
|---|---|
| 本站評估 | 用定位與公司背景判斷初步適配度；另行取得專案部署、支援與商務條件。 |
已核對官方來源；未執行真實 API、推論或效能測試。預期結果為建議內部契約。
十項技術入口比較
依開發任務選出的十個有文件技術入口；不是十套獨立 SDK 或官方排名。
| 接口 | 用途與 TA |
|---|---|
| 01 · CreateAssetModelAPI / SDK / developer guide | 定義標準化資產屬性及階層。資產模型設計者 |
| 02 · CreateAssetAPI / SDK / developer guide | 使用已定義模型建立資產。資產導入團隊 |
| 03 · DescribeAssetAPI / SDK / developer guide | 取得資產屬性及中繼資料。資產清查工程師 |
| 04 · ListAssetsAPI / SDK / developer guide | 列出符合支援篩選的資產。清查同步團隊 |
| 05 · BatchPutAssetPropertyValueAPI / SDK / developer guide | 提交資產屬性的時間戳值。遙測匯入工程師 |
| 06 · GetAssetPropertyValueAPI / SDK / developer guide | 讀取最新可用屬性值。監測工程師 |
| 07 · GetAssetPropertyValueHistoryAPI / SDK / developer guide | 讀取歷史屬性值。時序分析師 |
| 08 · GetAssetPropertyAggregatesAPI / SDK / developer guide | 取得支援的彙總統計。工業 KPI 團隊 |
| 09 · AssociateAssetsAPI / SDK / developer guide | 將子資產關聯至已定義階層。工廠模型架構師 |
| 10 · ExecuteQueryAPI / SDK / developer guide | 透過支援查詢介面查詢 SiteWise 資料。資料應用工程師 |
逐份文件分析
能力摘要依據官方文件；限制與建議測試為本站工程評估。
API / SDK / developer guide
CreateAsset
| 目標讀者 TA | 資產導入團隊 |
|---|---|
| 官方文件能力 | 使用已定義模型建立資產。 |
| 輸入 → 輸出 | 模型 ID 及資產資訊 → 資產識別。 |
| 執行環境 | 選定帳號及區域的 AWS IoT SiteWise，具授權 IAM 存取 |
| 本站選型評估 | API 接受可能早於資產就緒。 |
| 本站建議驗證 | 觀察生命週期狀態並驗證指派模型。 |
API / SDK / developer guide
DescribeAsset
| 目標讀者 TA | 資產清查工程師 |
|---|---|
| 官方文件能力 | 取得資產屬性及中繼資料。 |
| 輸入 → 輸出 | 資產 ID → 模型、屬性及狀態。 |
| 執行環境 | 選定帳號及區域的 AWS IoT SiteWise，具授權 IAM 存取 |
| 本站選型評估 | 資產資訊不證明設備當前健康。 |
| 本站建議驗證 | 依預期設備檢查屬性 ID 及模型參照。 |
API / SDK / developer guide
ListAssets
| 目標讀者 TA | 清查同步團隊 |
|---|---|
| 官方文件能力 | 列出符合支援篩選的資產。 |
| 輸入 → 輸出 | 篩選及分頁 → 資產摘要。 |
| 執行環境 | 選定帳號及區域的 AWS IoT SiteWise，具授權 IAM 存取 |
| 本站選型評估 | 單一回應可能僅一頁。 |
| 本站建議驗證 | 取得分頁並保留資產 ID，避免重複。 |
API / SDK / developer guide
BatchPutAssetPropertyValue
| 目標讀者 TA | 遙測匯入工程師 |
|---|---|
| 官方文件能力 | 提交資產屬性的時間戳值。 |
| 輸入 → 輸出 | 批次項目 → 各項匯入錯誤或接受。 |
| 執行環境 | 選定帳號及區域的 AWS IoT SiteWise，具授權 IAM 存取 |
| 本站選型評估 | 成功 HTTP 回應可能包含個別項目錯誤。 |
| 本站建議驗證 | 檢查每項錯誤，僅重試適用失敗資料。 |
API / SDK / developer guide
GetAssetPropertyValue
| 目標讀者 TA | 監測工程師 |
|---|---|
| 官方文件能力 | 讀取最新可用屬性值。 |
| 輸入 → 輸出 | 屬性參照 → 值、時間戳及品質。 |
| 執行環境 | 選定帳號及區域的 AWS IoT SiteWise，具授權 IAM 存取 |
| 本站選型評估 | 最新可用不一定為當前或良好品質。 |
| 本站建議驗證 | 顯示狀態前採新鮮度及品質規則。 |
API / SDK / developer guide
GetAssetPropertyValueHistory
| 目標讀者 TA | 時序分析師 |
|---|---|
| 官方文件能力 | 讀取歷史屬性值。 |
| 輸入 → 輸出 | 屬性及時間範圍 → 分頁值。 |
| 執行環境 | 選定帳號及區域的 AWS IoT SiteWise，具授權 IAM 存取 |
| 本站選型評估 | 缺失資料不是零，時間邊界須明確。 |
| 本站建議驗證 | 檢查順序、時間精度及完整視窗覆蓋。 |
API / SDK / developer guide
GetAssetPropertyAggregates
| 目標讀者 TA | 工業 KPI 團隊 |
|---|---|
| 官方文件能力 | 取得支援的彙總統計。 |
| 輸入 → 輸出 | 屬性、視窗及彙總型別 → 統計。 |
| 執行環境 | 選定帳號及區域的 AWS IoT SiteWise，具授權 IAM 存取 |
| 本站選型評估 | 彙總解析度及缺值／品質篩選影響解讀。 |
| 本站建議驗證 | 以已知視窗與獨立計算預期統計比對。 |
API / SDK / developer guide
AssociateAssets
| 目標讀者 TA | 工廠模型架構師 |
|---|---|
| 官方文件能力 | 將子資產關聯至已定義階層。 |
| 輸入 → 輸出 | 父層、階層及子層 ID → 關聯。 |
| 執行環境 | 選定帳號及區域的 AWS IoT SiteWise，具授權 IAM 存取 |
| 本站選型評估 | 階層關係須符合模型定義。 |
| 本站建議驗證 | 讀回關聯並拒絕無效父子組合。 |
API / SDK / developer guide
ExecuteQuery
| 目標讀者 TA | 資料應用工程師 |
|---|---|
| 官方文件能力 | 透過支援查詢介面查詢 SiteWise 資料。 |
| 輸入 → 輸出 | 查詢陳述 → 欄位及資料列。 |
| 執行環境 | 選定帳號及區域的 AWS IoT SiteWise，具授權 IAM 存取 |
| 本站選型評估 | 查詢結構及限制不同於通用 SQL 資料庫。 |
| 本站建議驗證 | 檢查結果中繼資料、空資料列及續頁處理。 |
Official API reference
| TA | 整合架構師 |
|---|---|
| 本站驗證建議 | 實作前檢查配額、區域可用性及操作級 IAM 權限。 |
04 / INPUT · EXPECTED OUTPUT · ACCEPTANCE
實作前先看懂預期結果
資產遙測讀取封裝示意，不是 SiteWise API 原生 JSON。未上傳遙測、建立資產或呼叫 API。
示意契約 · 未呼叫 API 或執行模型 · 不是供應商實測輸出
回傳屬性值
| 輸入 | 授權查詢已知屬性及時間視窗。 |
|---|---|
| 預期結果 | ok 與型別值、時間戳及品質資訊。 |
| 驗收條件 | KPI 計算前確認單位、時間視窗及品質。 |
範圍無歷史
| 輸入 | 有效歷史請求無資料點。 |
|---|---|
| 預期結果 | ok 且 values: []；不是零讀值。 |
| 驗收條件 | 明確呈現缺資料，不靜默插值。 |
部分匯入拒絕
| 輸入 | 假設批次含有效及無效項目。 |
|---|---|
| 預期結果 | partial 與失敗項目 ID，即使 HTTP 傳輸成功。 |
| 驗收條件 | 檢查逐項錯誤，不盲目重傳已接受項目。 |
資產未就緒
| 輸入 | 資產建立已接受，但生命週期工作尚未完成。 |
|---|---|
| 預期結果 | pending；不宣稱遙測串流可用。 |
| 驗收條件 | 相依操作前檢查資產狀態。 |
過期或品質不佳值
| 輸入 | 最新儲存值超過新鮮度門檻或品質不合格。 |
|---|---|
| 預期結果 | 有效讀取但資料狀態 degraded，不代表設備當前健康。 |
| 驗收條件 | 保留原始時間戳／品質，並要求明確下游策略。 |
將預期結果對應至你的應用
整合後將實際 SDK 或服務回應對應至此建議內部契約。下列識別碼與數值均為示意；不含憑證或真實請求。
預期輸出 JSON — 示意，非實測 · AWSIoTSiteWise-expected-results.json
{
"schema_version": "1.0.0",
"example": true,
"provider": "AWS IoT SiteWise",
"status": "ok",
"input_id": "sample-001",
"data": {
"asset_id": "example-machine",
"property_id": "example-temperature",
"values": [
{
"value": 24,
"unit": "C",
"timestamp": "2026-10-08T00:00:00Z",
"quality": "example-good"
}
],
"freshness_verified": false
},
"error": null,
"verification": "illustrative-only;not-provider-response"
}| 結果解讀 | 傳輸或執行成功不代表模型準確。有效空結果須與操作失敗分開。 |
|---|---|
| 可重現性 | 記錄模型、環境、設定與輸入識別；代表性測試前約定品質及延遲條件。不宣稱已實測效能。 |
| 操作範圍 | 資產遙測讀取封裝示意，不是 SiteWise API 原生 JSON。未上傳遙測、建立資產或呼叫 API。 |
開發評估
機台資產資料檢視器
開發構想規格・串接尚未實測
接口能力依據官方文件或程式庫；以下產品方向、輸入、交付與驗收條件則是我們的開發評估。
需整合驗證
估算可交付產品前，需共同驗證執行環境、資料結構或硬體。
- 原型輸入規劃
- 測試設備或模擬器、訊號對照表與明確單位。
- 原型交付規劃
- 附時間、資料新鮮度、單位與連線狀態的設備數值。
- 驗收條件
- 對照來源驗證比例與時間；設備斷線時不得顯示正常。
- 依賴條件
- 閘道或服務帳號、設備資料結構與測試環境。
開發順序
- 確認 AWS IoT SiteWise API 的存取、授權與支援版本。
- 準備上述樣本，針對「機台資產資料檢視器」先實作一個有官方文件的操作。
- 整理輸出時保留來源、時間與錯誤狀態，並保留供應商回應供審核。
- 通過驗收條件後，再估算擴展投入與客戶交付。
如何驗證需求
記錄產品瀏覽、官方文件點擊、規格下載與技術 Hub 點擊。這些是事件次數，不等於獨立人數或已完成串接。
本次可行性評估依實作條件判斷；尚未給定流量排名或交期承諾。