API / SDK / developer guide
V2 getting started
| 目標讀者 TA | 邊緣工程師 |
|---|---|
| 官方文件能力 | 安裝核心裝置並封裝元件。 |
| 輸入 → 輸出 | 裝置及元件設定 → 開發部署。 |
| 執行環境 | Greengrass V2 核心裝置及選定 AWS 帳號／區域 |
| 本站選型評估 | 教學設定不是正式佈建設計。 |
| 本站建議驗證 | 檢查目標支援 OS、身分及元件啟動。 |
工業 IoT／SCADA · API / SDK
AWS IoT Greengrass API
AWS
管理連網裝置的邊緣元件與部署。
本指南不採用已結束支援路徑 V1。官方頁面列出不同 2026 結束支援日期（6 月 1 日及 10 月 7 日），皆早於本次查核。請採 V2 並向 AWS 核對遷移細節。
AWS IOT GREENGRASS V2 / DEVELOPER FIELD GUIDE
選對接口，定義可驗證的結果。
公司／專案背景、十個技術入口，以及每份引用的實作分析。
2026-10-08 · 串接尚未實測
公司／專案背景全貌
依官方公司或專案自述撰寫的原創概要；完整原文請見來源。
| 產品 | AWS IoT Greengrass 結合開源邊緣執行環境與裝置軟體雲端管理。 |
|---|---|
| 本地操作 | 元件可處理本地資料，並與本地服務或 AWS IoT Core 通訊。 |
| 生命週期 | 本指南針對 Version 2；官方來源已公告 Version 1 結束支援。 |
| 適用角色 | 進行 AI 供應商初選的採購、合作夥伴與產品負責人。 |
|---|---|
| 本站評估 | 用定位與公司背景判斷初步適配度；另行取得專案部署、支援與商務條件。 |
已核對官方來源；未執行真實 API、推論或效能測試。預期結果為建議內部契約。
十項技術入口比較
依開發任務選出的十個有文件技術入口；不是十套獨立 SDK 或官方排名。
| 接口 | 用途與 TA |
|---|---|
| 01 · V2 getting startedAPI / SDK / developer guide | 安裝核心裝置並封裝元件。邊緣工程師 |
| 02 · Component developmentAPI / SDK / developer guide | 以 recipe 及產物建立模組軟體。元件作者 |
| 03 · Component recipeAPI / SDK / developer guide | 宣告元件生命週期、設定及相依項。發行工程師 |
| 04 · IPC SDK integrationAPI / SDK / developer guide | 與 nucleus 及支援本地服務通訊。裝置 SDK 工程師 |
| 05 · Local publish/subscribeAPI / SDK / developer guide | 在本地元件間交換訊息。本地事件工程師 |
| 06 · IoT Core MQTT IPCAPI / SDK / developer guide | 透過 IPC 發布或訂閱 AWS IoT Core。雲端遙測團隊 |
| 07 · Deployment guideAPI / SDK / developer guide | 將元件及設定部署至裝置。裝置群營運者 |
| 08 · CreateDeployment APIAPI / SDK / developer guide | 建立目標部署或新修訂。部署 API 團隊 |
| 09 · GetDeployment APIAPI / SDK / developer guide | 取得部署定義及中繼資料。部署狀態整合者 |
| 10 · ListInstalledComponents APIAPI / SDK / developer guide | 檢視核心裝置回報已安裝元件。裝置群清查團隊 |
逐份文件分析
能力摘要依據官方文件；限制與建議測試為本站工程評估。
API / SDK / developer guide
Component development
| 目標讀者 TA | 元件作者 |
|---|---|
| 官方文件能力 | 以 recipe 及產物建立模組軟體。 |
| 輸入 → 輸出 | Recipe 及二進位檔 → 版本化元件。 |
| 執行環境 | Greengrass V2 核心裝置及選定 AWS 帳號／區域 |
| 本站選型評估 | 產物須符合裝置平台及相依項。 |
| 本站建議驗證 | 於測試裝置驗證安裝／執行／關閉階段。 |
API / SDK / developer guide
Component recipe
| 目標讀者 TA | 發行工程師 |
|---|---|
| 官方文件能力 | 宣告元件生命週期、設定及相依項。 |
| 輸入 → 輸出 | JSON／YAML recipe → 元件執行定義。 |
| 執行環境 | Greengrass V2 核心裝置及選定 AWS 帳號／區域 |
| 本站選型評估 | 生命週期腳本可變更裝置，需要限定權限。 |
| 本站建議驗證 | 驗證平台選擇及缺少相依項行為。 |
API / SDK / developer guide
IPC SDK integration
| 目標讀者 TA | 裝置 SDK 工程師 |
|---|---|
| 官方文件能力 | 與 nucleus 及支援本地服務通訊。 |
| 輸入 → 輸出 | SDK IPC 請求 → 授權本地操作。 |
| 執行環境 | Greengrass V2 核心裝置及選定 AWS 帳號／區域 |
| 本站選型評估 | IPC 授權不同於 AWS 雲端 IAM。 |
| 本站建議驗證 | 分別測試允許及拒絕的 IPC 資源。 |
API / SDK / developer guide
Local publish/subscribe
| 目標讀者 TA | 本地事件工程師 |
|---|---|
| 官方文件能力 | 在本地元件間交換訊息。 |
| 輸入 → 輸出 | 主題及內容 → 本地訂閱傳遞。 |
| 執行環境 | Greengrass V2 核心裝置及選定 AWS 帳號／區域 |
| 本站選型評估 | 本地傳遞不代表雲端同步。 |
| 本站建議驗證 | 透過關聯 ID 檢查主題權限及訂閱接收。 |
API / SDK / developer guide
IoT Core MQTT IPC
| 目標讀者 TA | 雲端遙測團隊 |
|---|---|
| 官方文件能力 | 透過 IPC 發布或訂閱 AWS IoT Core。 |
| 輸入 → 輸出 | MQTT 主題／內容 → 雲端訊息操作。 |
| 執行環境 | Greengrass V2 核心裝置及選定 AWS 帳號／區域 |
| 本站選型評估 | 網路、元件權限及 IoT 政策均影響傳遞。 |
| 本站建議驗證 | 測試斷線，區分發布接受與接收端處理。 |
API / SDK / developer guide
Deployment guide
| 目標讀者 TA | 裝置群營運者 |
|---|---|
| 官方文件能力 | 將元件及設定部署至裝置。 |
| 輸入 → 輸出 | 目標及預期元件版本 → 部署推送。 |
| 執行環境 | Greengrass V2 核心裝置及選定 AWS 帳號／區域 |
| 本站選型評估 | 離線裝置可能不會立即收到預期狀態。 |
| 本站建議驗證 | 觀察各裝置完成及版本核對。 |
API / SDK / developer guide
CreateDeployment API
| 目標讀者 TA | 部署 API 團隊 |
|---|---|
| 官方文件能力 | 建立目標部署或新修訂。 |
| 輸入 → 輸出 | 目標 ARN 及元件映射 → 部署識別。 |
| 執行環境 | Greengrass V2 核心裝置及選定 AWS 帳號／區域 |
| 本站選型評估 | 新部署會替換先前目標部署定義。 |
| 本站建議驗證 | 審查完整元件集並使用文件化冪等金鑰行為。 |
API / SDK / developer guide
GetDeployment API
| 目標讀者 TA | 部署狀態整合者 |
|---|---|
| 官方文件能力 | 取得部署定義及中繼資料。 |
| 輸入 → 輸出 | 部署 ID → 部署紀錄。 |
| 執行環境 | Greengrass V2 核心裝置及選定 AWS 帳號／區域 |
| 本站選型評估 | 部署中繼資料本身不證明每個裝置健康。 |
| 本站建議驗證 | 比對預期版本與各裝置已安裝元件。 |
API / SDK / developer guide
ListInstalledComponents API
| 目標讀者 TA | 裝置群清查團隊 |
|---|---|
| 官方文件能力 | 檢視核心裝置回報已安裝元件。 |
| 輸入 → 輸出 | 核心裝置及分頁 → 元件清單。 |
| 執行環境 | Greengrass V2 核心裝置及選定 AWS 帳號／區域 |
| 本站選型評估 | 雲端回報狀態可能落後斷線裝置。 |
| 本站建議驗證 | 保留狀態新鮮度並取得所有分頁。 |
V2 API reference
| TA | 雲端整合團隊 |
|---|---|
| 本站驗證建議 | 區分 V2 雲端管理 API 操作及裝置 IPC。 |
V2 developer overview and V1 lifecycle
| TA | 既有部署負責人 |
|---|---|
| 本站驗證建議 | 將 V1 假設轉為 V2，並向 AWS 核對帳號特定生命週期資訊。 |
04 / INPUT · EXPECTED OUTPUT · ACCEPTANCE
實作前先看懂預期結果
逐裝置部署收據示意，不是 AWS API 原生輸出。未執行 AWS 請求、元件部署或裝置操作。
示意契約 · 未呼叫 API 或執行模型 · 不是供應商實測輸出
裝置符合預期版本
| 輸入 | 設定的 V2 元件部署已於目標完成。 |
|---|---|
| 預期結果 | ok 與預期及觀察元件版本。 |
| 驗收條件 | 確認裝置端健康及時間戳，不只部署建立。 |
空清單
| 輸入 | 有效裝置清查請求未回傳元件。 |
|---|---|
| 預期結果 | ok 且 components: []；保留新鮮度資訊。 |
| 驗收條件 | 不僅凭空清單標示裝置健康。 |
裝置離線
| 輸入 | 雲端接受預期部署，但目標斷線。 |
|---|---|
| 預期結果 | pending／未確認；分開保留最後回報版本。 |
| 驗收條件 | 不捏造完成或新裝置狀態。 |
元件失敗
| 輸入 | 裝置產物或生命週期程序失敗。 |
|---|---|
| 預期結果 | error 與元件資訊及設定失敗處理。 |
| 驗收條件 | 失敗處理後驗證實際版本及健康。 |
將預期結果對應至你的應用
整合後將實際 SDK 或服務回應對應至此建議內部契約。下列識別碼與數值均為示意；不含憑證或真實請求。
預期輸出 JSON — 示意，非實測 · AWSGreengrass-expected-results.json
{
"schema_version": "1.0.0",
"example": true,
"provider": "AWS IoT Greengrass V2",
"status": "ok",
"input_id": "sample-001",
"data": {
"deployment_id": "example-deployment",
"core_device": "example-device",
"desired_component": {
"name": "example.component",
"version": "1.0.0"
},
"reported_version": "1.0.0",
"device_state": "example-healthy",
"observed_at": null
},
"error": null,
"verification": "illustrative-only;not-provider-response"
}| 結果解讀 | 傳輸或執行成功不代表模型準確。有效空結果須與操作失敗分開。 |
|---|---|
| 可重現性 | 記錄模型、環境、設定與輸入識別；代表性測試前約定品質及延遲條件。不宣稱已實測效能。 |
| 操作範圍 | 逐裝置部署收據示意，不是 AWS API 原生輸出。未執行 AWS 請求、元件部署或裝置操作。 |
開發評估
邊緣軟體部署追蹤器
開發構想規格・串接尚未實測
接口能力依據官方文件或程式庫；以下產品方向、輸入、交付與驗收條件則是我們的開發評估。
需整合驗證
估算可交付產品前，需共同驗證執行環境、資料結構或硬體。
- 原型輸入規劃
- 測試設備或模擬器、訊號對照表與明確單位。
- 原型交付規劃
- 附時間、資料新鮮度、單位與連線狀態的設備數值。
- 驗收條件
- 對照來源驗證比例與時間；設備斷線時不得顯示正常。
- 依賴條件
- 閘道或服務帳號、設備資料結構與測試環境。
串接前置條件
本指南不採用已結束支援路徑 V1。官方頁面列出不同 2026 結束支援日期（6 月 1 日及 10 月 7 日），皆早於本次查核。請採 V2 並向 AWS 核對遷移細節。
開發順序
- 確認 AWS IoT Greengrass API 的存取、授權與支援版本。
- 準備上述樣本，針對「邊緣軟體部署追蹤器」先實作一個有官方文件的操作。
- 整理輸出時保留來源、時間與錯誤狀態，並保留供應商回應供審核。
- 通過驗收條件後，再估算擴展投入與客戶交付。
如何驗證需求
記錄產品瀏覽、官方文件點擊、規格下載與技術 Hub 點擊。這些是事件次數，不等於獨立人數或已完成串接。
本次可行性評估依實作條件判斷；尚未給定流量排名或交期承諾。