使用者資訊

製造商保有修改與變更本說明書所包含的資訊、文件與規格表的權利，且不需事前通知；製造商不會保證、明示、暗示或法定聲明其內容或特別否認其對於特殊用途的可銷售性與適用性；本說明書中所描述的任何被銷售與授權的製造商軟體亦同。

如果購買後證明軟體程式瑕疵，購買者（及非製造商、其經銷商或其購買商家）將需承擔所有因軟體瑕疵所造成的必要的服務費用、修理責任和任何偶發事件或間接損害。

本系統製造商並不擔負任何未經授權調整本裝置後所造成的收音機及／或電視干擾之責任，使用者必須自行修正干擾。

操作前如未正確選擇操作電壓的設定，製造商將不擔負因此所導致的任何損害之責任；使用前請務必確認電壓設定為正確的。

本廠向原始一般使用者（購買者）保證，本產品由購買日期起 1 年內，無任何材質或製造技術之缺陷。在保固期間及依購買證明，若產品因製造技術和／或材質有瑕疵而發生任何故障時，本廠將自行定奪，在不收取任何零件或人力費用下修理或更換缺陷產品或元件，以在其視為必要之範圍內，將產品或元件回復至正常操作狀態。任何更換將包含新的或重新製造功能相當之等值或更高價值的產品，更換內容將由本廠自行定奪，但若產品已經過修改、誤用、變造、因天災或不正常運作狀態而受損，則不適用本保固。

本保固將完全不適用於因任何第三人（包括但不限於本廠之客戶或一般使用者）安裝或使用、操作疏失和／或不當使用、未經本廠事先核準之修改、進行與本廠書面指示說明不符之維修、正常耗損、拆解產品、將產品連接至不相容的設備或軟體、將產品變更、轉換或整合至非本廠計畫內指定運用本產品之系統中、將不相容之硬體和／或軟體連接至本產品，以及一般使用者電腦網路上含有病毒、電信業者和／或服務供應商網路經修改、變更或中斷、產品經由非經本廠授權之人員維修，而造成產品和／或任何零件產生缺陷或不符規格。

若您的裝置無法正常運作，請聯絡裝置包裝內所附之支援及保固卡上所標示的服務供應商。

前言

本手冊收錄 Pelx Redfish 完整整合指南與 API 規格，供 DCIM、監控平台與 SI 整合使用。

對外整合入口：https://<host>/redfish/v1。

合規驗證

單一入口： spec/validation.md（Redfish 1.16.0、OCP Rack PDU／Baseline Profile、rf_service_validator + rf_interop_validator、日期與範圍）。

Interop 實測：OCP Rack PDU v1.0.0（2026-07-06）884 Pass／0 Fail；OCP Baseline Hardware Management v1.1.1（2026-07-22）203 Pass／0 Fail。指令見 「讀取流程」章節、前置條件見 overview.md。

手動探查單一 API 可用 redfishtool，範例見 「讀取流程」章節「redfishtool 測試」。

第一部分 第三方整合指南

本部分說明 DCIM、監控平台與 SI 整合 Pelx 設備的建議流程與主要 API。

第三方整合指南

本指南供 DCIM、監控平台、SI 使用：以 OCP Rack PDU Profile v1.0.0 為主線，必要時搭配 Pelx 擴充。JSON 範例與欄位定義見本手冊 API 規格章節。

對外唯一整合入口：https://<host>/redfish/v1。

整合原則

不需把 MQTT 包成 Redfish、DCIM 不必接 MQTT、不必實作 SSE。詳見 MQTT / WebSocket。

整合流程

flowchart TB
  subgraph core[OCP 必填 — 建議先打通]
    C1[1 整合準備] --> C2[2 設備識別]
    C2 --> C3[3 即時監控]
    C3 --> C4[4 電源控制]
    C2 --> C5[5 告警與事件]
    C2 --> C6[6 操作與稽核日誌]
  end
  subgraph ops[Baseline 維運 — 依需求]
    C8[8 韌體更新]
    C9[9 組態備份還原]
  end
  subgraph ext[選配與 OEM — 非 OCP 必填]
    C7[7 歷史趨勢]
    C4b[4b 插座群組]
    C10[10 進階擴充]
    C11[11 MQTT / WebSocket]
  end
  C2 --> C8
  C2 --> C9
  C3 --> C7
  C4 --> C4b
  C3 --> C10
  C3 --> C11

章節導讀

上線與驗收

• checklists — OutboundConnection 上線、OCP 合規、DCIM 整合 三份勾選表

合規驗證

實測進度參考（Redfish Interop Validator，--authtype Session，2026-07-06）：

兩項皆 Validation SUCCEEDED。

設備以 DMTF Service Validator 與 Interop Validator 驗證（詳見validation.md）。Interop：OCP Rack PDU v1.0.0（2026-07-06，884 Pass）與 OCP Baseline Hardware Management v1.1.1（2026-07-22，203 Pass），皆 0 Fail。自測指令見 「讀取流程」章節。

第 1 章：整合準備

1. 建立專用帳號（建議 viewer 唯讀監控、manager 含控制）
2. 選擇認證方式：Basic Auth（腳本／Validator）或 Session Token（長時間輪詢）
3. 匿名 GET /redfish/v1 應回 200（OCP Validator 需求）；子資源須認證

主要 Redfish API

OCP 範圍

✅ OCP Service Baseline 必填（Session、Account 等）

建議流程

GET /redfish/v1（可不帶認證）
  → POST /SessionService/Sessions（或全程 Basic）
  → 後續請求帶 X-Auth-Token 或 Authorization: Basic
  → 完成後 DELETE Session

curl 範例

# Service Root（對外）
curl -sk https://<host>/redfish/v1

# 建立 Session
curl -sk -u dcim-read:'<password>' -X POST \
  https://<host>/redfish/v1/SessionService/Sessions \
  -H 'Content-Type: application/json' -d '{}'
# 回應標頭 X-Auth-Token 用於後續請求

# 或全程 Basic
curl -sk -u dcim-read:'<password>' https://<host>/redfish/v1/PowerEquipment

curl -sk -u admin:'<password>' -X POST \
  -H 'Content-Type: application/json' \
  -d '{"UserName":"viewer1","TokenLifetimeSeconds":300,"Language":"zh-TW"}'
curl -sk -u admin:'<password>' -X POST \
  -H 'Content-Type: application/json' \
  -d '{"UserName":"viewer1","ClientIp":"203.0.113.50","TokenLifetimeSeconds":300}'
curl -sk -u admin:'<password>' -X POST \
  -H 'Content-Type: application/json' \
  -d '{"UserName":"viewer1","ReturnPath":"/eng/Peripheral","ClientIp":"203.0.113.50","TokenLifetimeSeconds":300}'

# 建立整合帳號（須 admin／Administrator）
curl -sk -u admin:'<password>' -X POST \
  https://<host>/redfish/v1/AccountService/Accounts \
  -H 'Content-Type: application/json' \
  -d '{"UserName":"dcim-read","Password":"ChangeMe-Strong1","RoleId":"ReadOnly"}'

帳號建立見 「認證」章節 — AccountService（POST .../Accounts；RoleId 對應 ReadOnly／Operator／Administrator）。Web 管理亦可使用 auth POST /users。

第 2 章：設備識別

取得設備型號、韌體版本、序號、UUID、機架位置（Rack／Row／Offset），供資產管理與告警關聯。

主要 Redfish API

OCP 範圍

✅ OCP Rack PDU Profile 必填（Chassis、Manager、RackPDU 識別欄位）

建議讀取順序

GET /redfish/v1
  → Chassis/1
  → Managers/1
  → PowerEquipment/RackPDUs/1

Chassis.Links.PowerDistribution 為單一物件（非陣列），與 RackPDUs 互相連結，可交叉驗證同一台 PDU。

序號／料號 fallback：SerialNumber 優先 devinfo.serialNumber，否則以 MAC（ethaddr）填入；PartNumber 優先 devinfo.partNumber，否則以 Model 填入。兩欄位在 Chassis 與 RackPDU 上一律輸出（OCP Interop 必填）。

curl 範例

curl -sk -u dcim-read:'<password>' https://<host>/redfish/v1/Chassis/1
curl -sk -u dcim-read:'<password>' https://<host>/redfish/v1/Managers/1
curl -sk -u dcim-read:'<password>' https://<host>/redfish/v1/PowerEquipment/RackPDUs/1

第 3 章：即時監控

輪詢進線（Mains）與插座（Outlets）之電壓、電流、功率、能耗；必要時讀取機櫃級彙總（Metrics）與標準感測器路徑（Chassis/Sensors）。

主要 Redfish API

Interop Validator 僅驗證 Chassis/{id}/Sensors；PowerEquipment/.../Sensors 為 DSP2056 快速查詢路徑，兩者成員一致。

OCP 範圍

✅ OCP Rack PDU Profile 必填（Mains、Outlets、Metrics、Sensor）

建議讀取順序

RackPDUs/1/Metrics          # 機櫃彙總
  → Mains                   # 進線列表 → Mains/{id}
  → Outlets                 # 插座列表 → Outlets/{id}
  → Chassis/1/Sensors       # 標準感測器（輪詢深度資料）

高頻輪詢建議 Session Token；唯讀帳號設 viewer 即可。

減少請求次數

OCP 沒有單一 API 一次回所有插座即時讀值，但可用下列標準方式降低往返：

多點網頁即時監控

多點即時：指同時監控多個介面／量測點的即時更新（變更即推），不限定固定點數。

依 整合原則：大量即時走 MQTT；DCIM 走 Redfish 常規輪詢（見下表），兩者分工，不需額外擴充 API。

方案取捨

勿以 Redfish 高頻輪詢（含 100 次逐筆 GET、Interfaces 1～2 秒輪詢）取代 MQTT；Oem/Pelx/Interfaces 集合維持 Redfish 慣例（Members 為連結），供探索與單筆讀取即可。

專屬頁（多點即時）

① GET /redfish/v1                   # 讀 MqttEndpoint
② GET .../Metrics                   # 頂部摘要（5 秒）
③ MQTT 訂閱 /updates/local、/update/local/#  # 多點即時（見第 11 章）
④ POST .../EventService/Subscriptions  # 告警
⑤ 控制 → Outlet.PowerControl        # Redfish

第三方 DCIM

Metrics + Outlets/Mains/Sensors（15～60 秒）
告警 → EventService 訂閱
歷史 → Telemetry MetricReports

刷新頻率

UI 建議

• Health Rollup 摘要（如 1 Critical、99 OK），點擊再展開明細
• 虛擬捲動：大量列僅渲染可見區域
• 依 Status.Health 綠／黃／紅標色

詳見 「總覽與合規」章節 — 一次回應多筆資料、「OEM 介面」章節。

# 彙總量測（推薦：監控儀表板首選）
curl -sk -u dcim-read:'<password>' \
  https://<host>/redfish/v1/PowerEquipment/RackPDUs/1/Metrics

# 展開所有插座（若設備支援 $expand）
curl -sk -u dcim-read:'<password>' \
  'https://<host>/redfish/v1/PowerEquipment/RackPDUs/1/Outlets?$expand=.'

curl 範例

curl -sk -u dcim-read:'<password>' \
  https://<host>/redfish/v1/PowerEquipment/RackPDUs/1/Metrics

curl -sk -u dcim-read:'<password>' \
  https://<host>/redfish/v1/PowerEquipment/RackPDUs/1/Outlets/1

curl -sk -u dcim-read:'<password>' \
  https://<host>/redfish/v1/Chassis/1/Sensors/Outlet1Current

第 4 章：電源控制

1. 單路插座：開、關、重啟（PowerCycle）
2. （選用）插座群組：一次控制多路插座

需 manager 或以上角色（Operator）。

主要 Redfish API

請求範例

{
  "PowerState": "On"
}

重啟："PowerState": "PowerCycle"。可選延遲：

{
  "PowerState": "On",
  "Oem": { "Pelx": { "OnDelaySec": 10, "OffDelaySec": 10 } }
}

建議流程

GET Outlets/{id}                    # 確認 PowerState
  → GET Outlet.PowerControlActionInfo
  → POST Outlet.PowerControl

群組控制：

GET RackPDUs/1/OutletGroups
  → GET OutletGroups/{id}（確認 Links.Outlets）
  → POST OutletGroup.PowerControl

curl 範例

# 關閉插座 1
curl -sk -u dcim-ctrl:'<password>' -X POST \
  https://<host>/redfish/v1/PowerEquipment/RackPDUs/1/Outlets/1/Actions/Outlet.PowerControl \
  -H 'Content-Type: application/json' \
  -d '{"PowerState":"Off"}'

第 5 章：告警與事件

1. 訂閱（OCP）：建立 EventService/Subscriptions，指定主機 Destination URL
2. 查目前告警（Pelx 擴充）：輪詢 EventService/Events 快照

訂閱持久化於設備本機；告警狀態變更時會 POST Redfish Event 至 Destination（含重試）。若需僅查目前告警而不訂閱，可輪詢 Events。

主要 Redfish API

建議流程

標準訂閱（OCP）

GET EventService
  → POST Subscriptions（Destination、EventTypes、Context）
  → 主機接收 POST 事件（格式依 Redfish Event）

僅需目前告警快照

GET EventService/Events
  → 必要時 GET Events/{eventId}

OEM 擴充做法（建議）

若需兼容舊版事件欄位，請維持標準 POST /EventService/Subscriptions，並在 request body 加入 Oem.Pelx 參數；未來啟用實際推送時，事件 payload 也以 Oem.Pelx 附帶相容欄位。
重點是：擴充標準訂閱，不另開一套取代 Subscriptions 的私有 API。

curl 範例

# 建立訂閱（範例）
curl -sk -u dcim-ctrl:'<password>' -X POST \
  https://<host>/redfish/v1/EventService/Subscriptions \
  -H 'Content-Type: application/json' \
  -d '{
    "Destination": "https://dcim.example.com/redfish/events",
    "EventTypes": ["Alert"],
    "Context": "dcim-prod"
  }'

# 查目前告警
curl -sk -u dcim-read:'<password>' \
  https://<host>/redfish/v1/EventService/Events

第 6 章：操作與稽核日誌

查詢設備上的操作紀錄（插座控制、參數變更等）與登入／稽核紀錄，供合規與故障追溯。統一中控補同步缺失事件時，另用 seq 區間 API（見下表）。

主要 Redfish API

OCP 範圍

✅ OCP Service Baseline（Manager LogServices）

建議流程

OCP 日誌查詢

GET Managers/1/LogServices
  → GET LogServices/Operational/Entries（或 Audit）
  → 依 Created 時間篩選；大量條目僅取最近 N 筆

主機補同步缺失事件（Pelx OEM，非 OCP 必填）

GET .../LogServices/Oem/Pelx/MaxSeq
  → 若主機 syncSeq < maxSeq
  → GET .../LogSync?fromSeq=syncSeq+1&toSeq=min(syncSeq+100, maxSeq)&lang=zh-hant
  → 重複直到追上 maxSeq

curl 範例

curl -sk -u dcim-read:'<password>' \
  https://<host>/redfish/v1/Managers/1/LogServices/Operational/Entries

第 7 章：歷史趨勢

取得電力等量測的時序資料，繪製趨勢圖或做容量分析。Redfish 標準以 MetricReport 的 MetricValues 陣列提供批量讀值：一次 GET .../MetricReports/{id} 可取得多筆 MetricId／MetricValue／Timestamp，無須對每個感測器逐筆輪詢歷史點。統一中控補同步缺失分鐘統計時，另用 addr ＋時間區間 API（見下表）。

非 OCP 必填 — DMTF 標準 TelemetryService；僅需 OCP 合規的整合方可略過本章。

主要 Redfish API

OCP 範圍

DMTF 標準（非 OCP 必填）

建議流程

GET TelemetryService
  → MetricReportDefinitions        # RecurrenceInterval PT1M、AppendLimit 120
  → MetricReports/{id}             # MetricValues[]；可選 ?$filter=Timestamp ge ...

curl -sk -u dcim-read:'<password>' \
  https://<host>/redfish/v1/TelemetryService/MetricReports/VoltageA

curl -sk -u dcim-read:'<password>' \
  'https://<host>/redfish/v1/TelemetryService/MetricReports/VoltageA?$filter=Timestamp%20ge%202026-06-10T07:00:00Z'

主機補同步缺失分鐘統計（Pelx OEM，非 OCP 必填）

GET .../Mains/{mainId} 或 .../Outlets/{outletId}
  → Oem.Pelx.Interfaces.CurrentAmps（等）.@odata.id → 取出 addr
GET .../Oem/Pelx/RollupRange/{addr}
  → 比對設備 latest.1min 與主機 syncMinTime
  → GET .../InterfaceRollup/{addr}?startTime=syncMinTime+60&endTime=...&by=1min
  → 單次最多 120 筆；下一批 startTime = 本批最末 time + 60
  → 主機補件不要帶 fill

設備 Web 趨勢圖：同一支 InterfaceRollup 加 &fill=null，缺採樣的時間格值為 null，前端斷線。

不需在 Mains／Outlets 另設 Rollup API；詳見 「歷史趨勢」章節 — 從 Mains／Outlet 取得 addr。

第 8 章：韌體更新

上傳整機設備映像（.swu）並執行 OTA，查詢 TaskService 進度。需 admin 或具升級權限帳號。

主要 Redfish API

上傳格式：僅 application/octet-stream 本體，不支援 multipart/form-data。

OCP 範圍

✅ OCP Service Baseline（UpdateService、TaskService）

建議流程

Recovery 模式：韌體更新為停機作業，執行期間 Redfish 可能短暫不可用。設備僅有一組可更新映像，非雙映像熱切換。若更新過程意外斷電，電力恢復後設備會自動續跑更新流程。

本地上傳

GET UpdateService/FirmwareInventory/Image   # 記錄升級前版本
  → POST UpdateService/upload（octet-stream 寫入暫存）
  → 設備驗證並套用韌體映像（非同步 Task）
  → GET TaskService/Tasks 查進度
  → 設備重啟後再 GET FirmwareInventory

遠端 URI

POST .../Actions/UpdateService.SimpleUpdate
  Body: { "ImageURI": "https://..." }

curl 範例

# 上傳映像
curl -sk -u admin:'<password>' -X POST \
  https://<host>/redfish/v1/UpdateService/upload \
  -H 'Content-Type: application/octet-stream' \
  --data-binary @rpm6_upgrade.swu

第 9 章：組態備份還原

匯出設備組態檔（cfg）備份，或上傳組態還原參數（插座名稱、閾值等）。不替換韌體映像。

Pelx 擴充 — 非 OCP Profile 必填；OCP 合規整合若只需監控／控制可略過。

主要 Redfish API

與韌體流程分開：勿對 UpdateService/upload 上傳組態檔。

建議流程

備份

POST PelxConfiguration.Download
  → 回應為組態二進位或導向下載

還原

POST PelxConfiguration.Upload（octet-stream）
  → 202 已接受；背景 restore/apply
  → 設備可能重啟，預留 rebootWaitTime

個別參數亦可 PATCH 各資源（如 ATS Parameters），與整包 cfg 互補。

第 10 章：進階擴充

存取 非 OCP 必填能力：ATS（DMTF TransferSwitches）、Pelx OEM 介面列表（含 DI/DO、E-Port 等）、排程管理，以及工程組態（RS485、VNode、圖控、自動化流程）。

下列資源不計入 OCP Rack PDU Profile 合規；整合方若只需 DCIM 標準監控／控制，可完全忽略本章。

同一套入口：工程組態對外只走 https://<host>/redfish/v1/Oem/Pelx/...，沿用 Redfish Session／Basic 與 auth.md RBAC（工程寫入須 Administrator）。不另開對外 REST。

主要 Redfish API

電子鎖為 iLock 獨立產品，非 PDU 功能；整合請見 「iLock 電子鎖」章節。

OCP 範圍

非 OCP 必填（含 DMTF 標準選配與 Pelx OEM）

建議流程

ATS

GET PowerEquipment/TransferSwitches
  → GET TransferSwitches/1
  → GET Feeders/A、Feeders/B
  → PATCH Parameters（切換參數，需權限）

非標準週邊／DI/DO

GET Oem/Pelx/Interfaces
  → GET Oem/Pelx/Interfaces/{addr}

排程

控制目標以 Links.Outlets（OCP 插座）或 Links.Interfaces（DO 開頭位址，如 E-Port 等外接輸出週邊）的 @odata.id 指定。

GET Oem/Pelx/Interfaces（篩選 addr 以 DO 開頭）
GET Oem/Pelx/Schedules
  → POST Oem/Pelx/Schedules（新增；Links + Arg.Action）
  → PATCH Oem/Pelx/Schedules/{id}（修改）
  → POST .../Actions/PelxSchedule.SetEnabled（啟用/停用）

工程組態（Administrator）

建機／AI 佈署建議順序：

GET /redfish/v1（確認 Oem.Pelx 連結）
  → PATCH Oem/Pelx/SerialBuses/{id}（RS485）
  → PATCH Oem/Pelx/VNodes/{id}（對應暫存器 → 介面）
  → POST/PATCH Oem/Pelx/HmiScreens（圖控 YAML）
  → GET .../HmiScreens/{id}/Export 或 POST .../ImportTemplate（樣版 ZIP）
  → POST Oem/Pelx/HmiImageLibraries/Actions/PelxHmiImageLibrary.Import（圖庫 zip）
  → POST/PATCH Oem/Pelx/Automations（Flow YAML）
  → POST .../Automations/{id}/Actions/PelxAutomation.SetRun

即時點值仍用 Oem/Pelx/Interfaces；Flow 執行在設備本地，Redfish 只負責組態。

第 11 章：MQTT / WebSocket（高效即時通道）

除 OCP Redfish REST 外，Pelx 設備另提供 MQTT over WebSocket，供高頻即時監控、狀態推送。本章說明與 Redfish 的分工、Topic 對照，以及多點網頁即時監控的建議架構。

非 OCP 標準協議。DMTF Redfish（DSP0266）與 OCP Rack PDU Profile 未定義 MQTT 或 WebSocket；設備同時提供 Redfish 與 MQTT 不影響 OCP 合規（Redfish 資源樹須完整通過 Interop Validator）。MQTT 列為 Pelx 平行增值通道（Sidecar Protocol）。

與 Redfish 的分工（雙軌架構）

業界慣例建議 Redfish + MQTT 並用，而非把 MQTT「包裝成 Redfish」：

不建議在閘道把 MQTT 逐筆轉成 Redfish Event——增加延遲與 Gateway 負擔。網頁或 BFF 可同時持有 REST Client（控制、探索）與 MQTT Client（即時顯示）。

MQTT 能否取代 EventService？

不能取代，應分工並用：

• Critical／Warning 告警 → EventService/Subscriptions（OCP 主線）
• 儀表板數值跳動、多點同步更新 → MQTT 訂閱
• MQTT /update 的 status 可驅動 UI 變色，不可當作 DCIM 標準告警通道

推送機制對照

連線方式

透過 Redfish Discovery（建議，DCIM）

整合方先讀 Redfish OEM 取得 MQTT URL，再以 Redfish Session 或 Basic Auth 連 WebSocket：

GET /redfish/v1/Oem/Pelx/Mqtt   → Endpoint、MqttAuth
POST .../SessionService/Sessions   → X-Auth-Token（或 Basic Auth）
WebSocket connect Endpoint         → 帶 X-Auth-Token 或 Authorization
subscribe /updates/local、/update/local/#

欄位定義見 「MQTT Discovery」章節。

工具測試：完整 MQTT 訂閱請用 MQTTX CLI ≥ 1.11（-wh 帶 HTTP Header、--insecure 略過自簽憑證）或 mqtt.js；MQTTX Desktop／Postman MQTT Request 無法設定 WebSocket 握手 Header。curl 可驗 HTTP 401／WebSocket 101。範例見 「MQTT Discovery」章節。

Postman：HTTP GET 與 WebSocket Request 可在 Headers 手動加 X-Auth-Token 或 Authorization: Basic ...；MQTT Request 的 Authorization 分頁會變成 MQTT CONNECT 帳密，不可用於 Redfish 路徑。

Topic ↔ Redfish 對照

控制與寫入

新整合的控制一律走 Redfish：

多點網頁即時監控

與 第 3 章 互補：

依 整合原則：Pelx 多點即時看板只用 MQTT；DCIM 只用 Redfish 常規輪詢，兩者不混用、不需額外 API。

建議前端流程

① Redfish GET /redfish/v1/Oem/Pelx/Mqtt  # Endpoint、MqttAuth
② POST SessionService/Sessions              # X-Auth-Token（DCIM）
③ MQTT connect Endpoint                     # 訂閱 /updates/local、/update/local/#
④ Redfish GET .../Metrics                   # 頂部摘要（5 秒）
⑤ Redfish POST .../EventService/Subscriptions  # 告警
⑥ 控制 → Outlet.PowerControl                # Redfish

OCP 合規與文件位置

• MQTT 不寫入 OCP 必填 spec 章節；連線資訊見 「MQTT Discovery」章節

• Topic 定義見 「MQTT Discovery」章節

• 告警與事件

• 進階擴充

• 「MQTT Discovery」章節

第二部分 API 規格

本部分為各 Redfish 資源的完整欄位定義、JSON 範例與 Pelx OEM 擴充說明。

API 規格索引

下列為 Redfish API 規格章節索引。

其他產品（非 PDU）

Pelx 擴充

Redfish API 總覽

以下 API 皆以對外入口 https://<host>/redfish/v1/... 撰寫。

協議範圍

本文件描述 OCP Rack PDU Profile v1.0.0（OCPRackPDU.v1_0_0.json）及相依的 OCP Service Baseline v1.0.0 所要求的 Redfish REST API，並以 DMTF DSP2056 為資源模型基礎。Pelx OEM 路徑（Oem/Pelx/*）列於 Pelx 擴充 章節，不計入 OCP Profile 合規範圍。

設計依據

OCP Rack PDU Profile 對照

驗證故事總表（版本、兩種 Validator、日期、範圍）：見 validation。

Profile 定義 Mandatory 資源與欄位；實作須通過 Redfish Interop Validator 搭配下列兩份 JSON 驗證：

git clone https://github.com/opencomputeproject/HWMgmt-OCP-Profiles.git
pipx install redfish-interop-validator

rf_interop_validator \
  -r https://<host> \
  -u admin -p '<password>' \
  --authtype Basic \
  --required_profiles_dir ./HWMgmt-OCP-Profiles \
  ./HWMgmt-OCP-Profiles/RackAndPower/OCPRackPDU.v1_0_0.json

Profile 目前為 Draft（RackAndPower/ 子目錄）。本文件 JSON 範例以通過上述 Validator 為目標撰寫。

實測進度參考（Redfish Interop Validator，--authtype Session，2026-07-06）：

兩項皆 Validation SUCCEEDED。

Profile 必填資源（摘要）

管理與安全 API OCP 合規對照

下列為近期補強的 AccountService、CertificateService、NetworkProtocol 等管理面 API。OCP Mandatory 表示 Interop Validator（搭配 Service Baseline）會檢查；Recommended 為建議實作；Oem 為 Pelx 擴充，不計入 Profile 合規，但符合 DMTF「標準路徑 + Oem 延伸」慣例（參考 Vertiv 等 PDU Redfish 實務）。

Validator 額外檢查點

• 密碼不符政策：回傳標準 error（如 PropertyValueIncorrect）
• NetworkProtocol：ProtocolEnabled、Port 型別正確；非法 NTP 伺服器回 400
• CertificateService：建議提供 GenerateCSRActionInfo（@Redfish.ActionInfo）
• 所有資源須含 @odata.type；可寫資源建議含 Allow 與 @Redfish.WriteableProperties

Sensor 雙路徑說明

OCP Profile 規定 Sensor 資源 URI 為 Chassis/{chassisId}/Sensors/{sensorId}。Pelx 另於 PowerEquipment/RackPDUs/{rackId}/Sensors 暴露相同量測（DSP2056 配電模型）；Interop Validator 僅驗證 Chassis 路徑。實作須：

• Chassis/1/Sensors 列出所有電氣與環境溫度感測器（與 RackPDU Sensors 成員一致；溫度 {id} 如 Temp1）
• Mains／Outlets／Metrics 的 DataSourceUri 指向 Chassis/1/Sensors/...
• PowerEquipment/.../Sensors 保留供配電整合快速查詢（非 OCP 驗證路徑）

一次回應多筆資料

Redfish／OCP 沒有獨立的「bulk read」端點，但 DMTF 標準提供多種機制，讓 DCIM 客戶端減少 HTTP 往返、一次取得多筆讀值或多個子資源。整合方應依場景選擇：

重點區分

• Collection 預設只回連結，不含各成員的 Reading、PowerState 等即時值。要一次拿所有插座狀態，須用 $expand（若設備支援，見 Service Root ProtocolFeaturesSupported.ExpandQuery），或對 Members 逐筆 GET。
• 沒有「單一 GET 回傳所有插座即時讀值」的 OCP 必填資源；Metrics 僅提供整機彙總，非逐路明細。
• 歷史／趨勢批量讀值的標準路徑是 TelemetryService/MetricReports/{id}：回應內 MetricValues 陣列，每筆含 MetricId、MetricValue、Timestamp（見 歷史趨勢）。
• 即時監控 OCP 主線：Metrics（彙總）＋必要時 $expand 或輪詢 Outlets／Chassis/Sensors（見 第 3 章）。
• 同時多點網頁即時顯示：多點即時看板用 MQTT /update；第三方 DCIM 用 Redfish 常規輪詢（Metrics、Outlets、Sensors，15～60 秒）；見 integration 整合原則。

ProtocolFeaturesSupported 宣告與 $expand 範例見 探索與識別；curl 範例見 讀取流程。

選配資源（DMTF 標準，非 OCP 必填）

下列為 DMTF Redfish 標準資源，Pelx 產品依機型或功能提供；OCP Rack PDU Profile 驗證不要求，整合若僅需 OCP 合規可忽略：

• PowerEquipment/TransferSwitches（ATS；見 ATS 轉換開關）
• PowerEquipment/RackPDUs/{id}/OutletGroups（插座群組；見 插座群組）
• TelemetryService（歷史趨勢；見 歷史趨勢）

Pelx 擴充（OEM，非 OCP 必填）

下列為 Pelx OEM 路徑，非 DMTF 標準資源模型：

• Oem/Pelx/Interfaces（完整介面；大量即時請用 MQTT，見 第 11 章）

• Oem/Pelx/PeripheralTree（週邊結構樹；設備週邊結構服務，見 週邊樹）

• Oem.Pelx.MqttEndpoint（MQTT 連線 URL；Redfish Discovery，見 MQTT Discovery）

• Oem/Pelx/Configuration（組態檔單獨上傳／下載）

• Oem/Pelx/Schedules（排程）

• EventService/Events（目前告警快照；OCP 標準事件訂閱見 Subscriptions）

• GET /redfish/v1 與 GET /redfish/v1/ 皆應 200（勿對 /redfish/v1/ 做 301 轉址）。

資源樹概覽（OCP Rack PDU Profile）

/redfish/v1                          ServiceRoot（OCP Baseline + PowerEquipment）
├── SessionService/Sessions          認證工作階段（Baseline）
├── AccountService/Accounts          帳號（Baseline）
├── AccountService/Roles             角色（Baseline）
├── AccountService/OutboundConnections  出站 WebSocket（2023.2+ 選配；已實作）
├── CertificateService               憑證服務（Baseline）
├── Managers/1                       管理控制器（Baseline）
│   ├── EthernetInterfaces/{id}      網路介面（Baseline Mandatory）
│   ├── NetworkProtocol              通訊協定設定（Baseline）
│   └── LogServices/{logId}/Entries  日誌（Baseline）
├── Chassis/1                        機箱（OCP PDU Profile）
│   ├── Sensors/{id}                 感測器（OCP Profile Mandatory URI）
│   ├── Thermal                      溫濕度（建議）
│   └── Power                        電源（可選）
├── PowerEquipment                   PDU 配電（OCP Profile 核心）
│   ├── TransferSwitches/{id}        ATS（DSP2056；設備支援 ATS 時）
│   └── RackPDUs/{id}                PowerDistribution
│       ├── Metrics                  PowerDistributionMetrics（Profile Mandatory）
│       ├── Mains/{id}               進線 Circuit
│       ├── Branches/{id}            分支 Circuit（集合必須存在；可為空）
│       ├── Outlets/{id}             插座 Outlet
│       ├── OutletGroups/{id}        插座群組（DSP2056）
│       └── Sensors/{id}             感測器 Sensor
├── TelemetryService                 歷史趨勢（DMTF 標準；非 OCP 必填）
├── EventService                     事件服務（Baseline + Profile）
│   ├── Subscriptions/{id}           事件訂閱（Usage Guide 建議）
│   └── Events                       目前告警快照（Pelx OEM）
├── UpdateService                    韌體更新（Baseline Mandatory）
│   ├── FirmwareInventory/Image      設備映像
│   ├── SimpleUpdateActionInfo       SimpleUpdate 參數定義
│   ├── upload                       上傳映像
│   └── Oem/Pelx/Configuration    組態備份／還原（Pelx OEM）
├── TaskService/Tasks/{taskId}       非同步任務（Baseline）
└── Oem/Pelx/*                    Interfaces、PeripheralTree、Schedules 等（Pelx OEM；PDU 選用）

iLock 電子鎖主機之 Service Root 不含 PowerEquipment；門禁 API 見 iLock 電子鎖。

通用 JSON 欄位

各 API 回應格式如下所示：先列 JSON 範例，再以「#### 欄位說明如下」逐欄、逐層說明（含巢狀子物件與陣列元素）。下列為常見欄位語意速查，各 API 章節仍會完整列出該回應的所有欄位。

Redfish 標準欄位

• @odata.id: 資源 URI（如 /redfish/v1/Chassis/1），後續請求可直接使用
• @odata.type: 資源型別，對應 DMTF Schema 版本（Mandatory；缺此欄位 Interop Validator 報 Missing Type Error）
• Id: 資源識別碼，通常與 URI 最後一段相同
• Name: 顯示名稱
• Members: 集合成員連結陣列，元素為 { "@odata.id": "..." }
• Members@odata.count: Members 筆數
• Status: 狀態物件
  • State: 運作狀態，如 Enabled（正常）、Disabled（停用）、Absent（不存在）
  • Health: 健康狀態，OK / Warning / Critical，由介面狀態碼轉換，見文末「狀態對照」
  • HealthRollup: 子資源健康彙整（Chassis 等上層資源使用）

HTTP 回應標頭與可寫屬性標註

含可寫屬性（UserLabel、Location 等）的資源，GET 回應須同時提供：

1. Allow 標頭 — 供 Validator 確認支援 PATCH
2. @Redfish.WriteableProperties — 標示可 PATCH 的屬性；Location：Contacts；Location.Placement：Rack、Row、RackOffset、RackOffsetUnits | | RackPDU | GET, PATCH | 根層：AssetTag、UserLabel、LocationIndicatorActive；Location／Placement 同 Chassis | | Mains | GET, PATCH | UserLabel、ElectricalSourceManagerURI、ElectricalSourceName | | Outlet | GET, PATCH | UserLabel、ElectricalConsumerNames、LocationIndicatorActive |

PATCH 持久化：部分可寫欄位重啟後還原；長期保存請用組態備份／還原。

範例（Chassis）：

{
  "@odata.id": "/redfish/v1/Chassis/1",
  "@odata.type": "#Chassis.v1_22_0.Chassis",
  "@Redfish.WriteableProperties": [
    "AssetTag"
  ],
  "Id": "1",
  "Location": {
    "@Redfish.WriteableProperties": [
      "Contacts"
    ],
    "Placement": {
      "@Redfish.WriteableProperties": [
        "Rack",
        "Row",
        "RackOffset",
        "RackOffsetUnits"
      ],
      "Rack": "Rack-01"
    }
  }
}

對應回應標頭：Allow: GET, PATCH

缺 @Redfish.WriteableProperties 時，Validator 報 WriteableProperties Warning（即使已有 Allow 標頭）。

量測與閾值欄位

• Reading: 即時數值，對應 GET /interfaces 的 value
• ReadingVolts / ReadingCelsius / ReadingAmps 等: 具單位語意的讀值（部分資源直接放在物件頂層）
• DataSourceUri: 指向 Sensors/{id} 的連結，供進一步查詢感測器細項
• Thresholds / UpperThresholdCritical 等: 閾值，對應 interfaces 的 params
  • hc → UpperThresholdCritical / UpperCritical
  • hw → UpperThresholdNonCritical / UpperCaution
  • lw → LowerThresholdNonCritical / LowerCaution
  • lc → LowerThresholdCritical / LowerCritical

Oem.Pelx 擴充欄位

、interfaces；對外一律以 @odata.id 資源連結表示，以 @odata.id 表示。自 hwctrl 2026 合規版起，不再使用 Oem.Pelx.Links 包裝：

• @odata.type: 固定 #Pelx.v1_0_0.Pelx（DMTF Service Validator 必填）
• Interface: 單一 Pelx 介面資源連結（Pelx.InterfaceLink，僅 @odata.id）；用於 Sensor、Event、Thermal 等
• Interfaces: 多個量測／控制對應之介面連結物件（如 Voltage、CurrentAmps、PowerState）；用於 Mains、Outlet、Branch
• InterfaceGroups: 三相等巢狀量測對照（如 PolyPhaseVoltage.Line1ToNeutral）；用於 INFEED3P 進線

CSDL 定義內嵌於 GET /redfish/v1/$metadata，亦可 GET /redfish/v1/schemas/Pelx_v1.xml（部署路徑：/root/rpm6/share/rpm6/redfish/schemas/Pelx_v1.xml）。執行 DMTF Service Validator 時，本機 csdl/Pelx_v1.xml 須與設備同步。

• MqttAuth: MQTT 認證方式（Redfish：RedfishSession）
• ElementId / elementId: 週邊路數，對應週邊路數
• Alias / alias: 介面別名（如 V、FREQ）
• peripheralAlias: 週邊分類別名（如 INFEED、OUTLET、TEMPRH）
• Unit / unit: 資料單位（如 V、°C、kWh）
• type: 資料型別，如 FLOAT、BOOL、STRING
• value: 即時讀值，同即時讀值欄位
• status: 介面狀態碼（如 ok、hw、hc），見 mqtt-topic
• params: 閾值參數，欄位同 GET /interfaces 的 params
• health: 已由 status 轉換的 Redfish Health 值

認證

支援兩種方式，與多數 PDU 廠商（Vertiv、eConnect 等）一致：

1. HTTP Basic Auth — 適合單次查詢、腳本測試；每次請求帶 Authorization: Basic ...
2. Session Token — 適合長時間輪詢；先 POST /redfish/v1/SessionService/Sessions 取得 X-Auth-Token，後續請求帶此標頭

認證架構

POST /redfish/v1/SessionService/Sessions 建立 Redfish Session 並回傳 X-Auth-Token。

Redfish 服務依 auth role 映射權限如下：

ReadOnly（OCP Baseline 基礎角色）

ReadOnly 為 OCP Service Baseline Mandatory 三角色之一（與 Administrator、Operator 並列），DMTF 預設 AssignedPrivileges 為 Login、ConfigureSelf（不含 ConfigureComponents、ConfigureManager、ConfigureUsers）。

核心規範（Pelx 實作須符合）：

Pelx 追加限制（嚴於部分廠商慣例，不違反 OCP）：GET .../AccountService/Accounts 須 Operator 以上；工程模式資源之 GET／寫入須 Administrator。其餘監測類 GET 依預設，ReadOnly 可讀。

角色與權限模型（RBAC）

與 Web UI 選單對齊。

權限層級

ReadOnly 僅能 登入、改自己密碼、GET 監測數據；嚴禁任何配置修改與控制 Action。Administrator 涵蓋 Operator 全部權限（含控制）。

Web「工程模式」↔ Redfish API

工程模式選單（週邊資訊、密碼政策、LDAP、RADIUS／TACACS+、SNMP Agent、告警服務、韌體更新）對外整合時對應下列 Redfish；讀寫皆須 Administrator（403 若為 Operator／ReadOnly）：

同一資源內若混有工程與一般欄位（如 NetworkProtocol），依欄位路徑分別檢查：SNMP 區塊須 Administrator；NTP／SSH／ICMP 區塊須 Operator 以上（見 網路協定）。

一般選單（非工程模式）控制與寫入

控制 Action 與一般寫入皆須 Operator 以上；ReadOnly 回 403。

控制（POST .../Actions/*）：

• 插座／插座群組：Outlet.PowerControl、OutletGroup.PowerControl、Outlet.ResetMetrics
• 電子鎖：PelxElectronicLock.Control
• 電力：ResetMetrics（Rack PDU／Mains）
• 排程：Schedules/{id}/Actions/...Run 等

一般寫入（PATCH／POST／DELETE）：

• 排程 CRUD、ATS 參數、電子鎖白名單／卡號
• Managers/1/NetworkProtocol 之 NTP、SSH、ICMP（非 SNMP Agent）
• EventService/Subscriptions 建立／修改（若產品政策允許 Operator 管理訂閱）
• AccountService/OutboundConnections 建立／修改／刪除（Administrator；見 outbound connection）

帳號 CRUD 授權矩陣

POST／PATCH／DELETE AccountService/Accounts 依呼叫者角色與目標帳號 RoleId 決定：

附加規則：

• Operator 不可將既有帳號之 RoleId 改為 Administrator，不可修改或刪除 RoleId 為 Administrator 的帳號
• 不可刪除最後一個 Administrator 帳號
• GET .../Accounts／{id}：Operator 以上；ReadOnly 回 403（帳號清單屬敏感資訊）
• Operator 建立／管理之帳號，RoleId 僅能為 Operator 或 ReadOnly

403 回應時 Message 宜註明「權限不足」或「不可管理系統管理員帳號」。

Role 資源與 OemPrivileges

GET .../AccountService/Roles/{RoleId} 之 OemPrivileges 反映 Pelx 工程模式（非 DMTF 標準必填）：

整合方可先 GET .../Roles/{RoleId} 判斷是否具工程模式寫入資格。

文件撰寫慣例（各 spec 章節）

各 API 章節不必逐條重複最低角色；以本文「角色與權限模型」為唯一權威來源。

預設規則

僅在下列情況於 API 段落額外標註

符合預設的控制 Action 與 POST／PATCH（如 Outlet.PowerControl、排程 CRUD）不必再寫「須 Operator 以上」。各章可在標題下加一行：「權限預設見 認證（控制 Action 至少 Operator）。」

403 撰寫

整合方應以 Redfish AccountService/Accounts 建立專用帳號（OCP Baseline Mandatory），例如 dcim-read 設 RoleId: ReadOnly、dcim-ctrl 設 Operator，與管理員 admin 分離。與 Web UI 共用帳號庫。。

OCP AccountService 要求（摘要）

標準角色 Administrator、Operator、ReadOnly 為 OCP 必填；app 角色不經 Redfish 暴露。

外部帳號提供者（LDAP／RADIUS／TACACS+）

OCP PDU 對 LDAP、RADIUS 為 Recommended（非 Baseline Mandatory）。TACACS+ 為 Pelx OEM 擴充：

密碼強度政策

本地帳號密碼須符合 AccountService 內嵌政策（OCP Recommended）。透過 AccountService 設定。

建立或修改帳號（POST／PATCH Accounts）時，依此政策驗證 Password。

Interop Validator 與認證

對外須轉送 Authorization、X-Auth-Token（見「服務資訊」）。

GET https://

取得 Session 服務能力與逾時設定。

{
  "@odata.id": "/redfish/v1/SessionService",
  "@odata.type": "#SessionService.v1_1_1.SessionService",
  "Id": "SessionService",
  "Name": "Session Service",
  "ServiceEnabled": true,
  "SessionTimeout": 1800,
  "Sessions": {
    "@odata.id": "/redfish/v1/SessionService/Sessions"
  },
  "Actions": {
      }
}

欄位說明如下:

• @odata.id: Session 服務 URI
• @odata.type: 資源型別，固定 #SessionService.v1_1_1.SessionService
• Id: 固定為 SessionService
• Name: 顯示名稱
• ServiceEnabled: Session 服務是否啟用，true 表示可建立工作階段
• SessionTimeout: 工作階段逾時（秒），預設 1800（30 分鐘），可 PATCH 調整（範圍 30–86400）
• Sessions: Session 集合連結物件
  • @odata.id: Session 列表 URI，固定 /redfish/v1/SessionService/Sessions；GET 可列出有效 Session，POST 可建立新 Session
• Actions: Pelx 擴充 Action

回傳資料狀態

PATCH https://

修改 Session 逾時。

{
  "SessionTimeout": 3600
}

欄位說明如下:

• SessionTimeout: 工作階段逾時（秒），範圍 30–86400

回傳資料狀態

GET https://

列出目前有效 Session。

{
  "@odata.id": "/redfish/v1/SessionService/Sessions",
  "@odata.type": "#SessionCollection.SessionCollection",
  "Members": [
    {
      "@odata.id": "/redfish/v1/SessionService/Sessions/a1b2c3d4"
    }
  ],
  "Members@odata.count": 1
}

欄位說明如下:

• @odata.id: Session 集合資源 URI，固定 /redfish/v1/SessionService/Sessions
• @odata.type: 資源型別，固定 #SessionCollection.SessionCollection
• Members: 目前有效 Session 連結陣列，元素為 { "@odata.id": "..." }
  • @odata.id: 單一 Session 資源 URI，如 /redfish/v1/SessionService/Sessions/a1b2c3d4；GET 可查詳情，DELETE 可登出終止
• Members@odata.count: Members 陣列筆數，即目前有效 Session 數量

回傳資料狀態

POST https://

建立認證工作階段。請求需帶 Basic Auth 或 JSON 帳密（二擇一，建議 Basic Auth）。

方式 A — Basic Auth 標頭 + 空 body

POST /redfish/v1/SessionService/Sessions HTTP/1.1
Authorization: Basic YWRtaW46cGFzc3dvcmQ=
Content-Type: application/json

方式 B — JSON body

{
  "UserName": "admin",
  "Password": "password"
}

欄位說明如下:

• UserName: 登入帳號，對應 auth 使用者名稱
• Password: 登入密碼

回傳資料格式如下:

回應標頭：

HTTP/1.1 201 Created
Location: /redfish/v1/SessionService/Sessions/a1b2c3d4
X-Auth-Token: 7c3f8a2b9e1d4f6a8c0b2d4e6f8a0c2

回應 body：

{
  "@odata.id": "/redfish/v1/SessionService/Sessions/a1b2c3d4",
  "@odata.type": "#Session.v1_7_2.Session",
  "Id": "a1b2c3d4",
  "Name": "admin",
  "UserName": "admin",
  "Description": "User Session"
}

欄位說明如下:

• X-Auth-Token（回應標頭）: 後續 API 請求須帶此標頭，取代 Basic Auth
• Location（回應標頭）: Session 資源 URI，登出時對此 URI 執行 DELETE
• @odata.id: 新建 Session 的資源 URI
• @odata.type: 資源型別，固定 #Session.v1_7_2.Session
• Id: Session 識別碼，與 URI 最後一段相同
• Name: 通常為登入帳號名稱
• UserName: 登入帳號
• Description: 工作階段說明

回傳資料狀態

GET https://

查詢指定 Session 資訊。請求須帶 X-Auth-Token 或 Basic Auth。

• id（路徑參數）: Session 識別碼，與 POST /SessionService/Sessions 回應的 Id 相同

回傳資料格式如下:

回應標頭：

HTTP/1.1 200 OK
Content-Type: application/json

回應 body：

{
  "@odata.id": "/redfish/v1/SessionService/Sessions/a1b2c3d4",
  "@odata.type": "#Session.v1_7_2.Session",
  "Id": "a1b2c3d4",
  "Name": "admin",
  "UserName": "admin",
  "Description": "User Session"
}

欄位說明如下:

• @odata.id: Session 資源 URI
• @odata.type: 資源型別，固定 #Session.v1_7_2.Session
• Id: Session 識別碼，與 URI 最後一段相同
• Name: 通常為登入帳號名稱
• UserName: 登入帳號
• Description: 工作階段說明

回傳資料狀態

DELETE https://

登出並終止 Session。請求須帶對應的 X-Auth-Token。無請求 body。

欄位說明如下:

• id（路徑參數）: 要終止的 Session 識別碼

回傳資料狀態

curl -sk -u admin:'

curl -sk -u admin:'

curl -sk -u admin:'

#### 回傳資料狀態

狀態碼 | 說明
----- | -------------
200   | 成功
400   | JSON 錯誤、參數超出範圍，或 `ReturnPath` 格式／白名單不符
401   | 未認證
403   | 權限不足、帳號停用，或 Operator 試圖為他人簽發
404   | 指定 UserName 不存在

### GET https://<host>/redfish/v1/AccountService

查詢帳號服務資訊。本地帳號集合為唯讀探索連結；LDAP／RADIUS／TACACS+ 設定內嵌於本資源。

```json
{
  "@odata.id": "/redfish/v1/AccountService",
  "@odata.type": "#AccountService.v1_15_0.AccountService",
  "Id": "AccountService",
  "Name": "Account Service",
  "ServiceEnabled": true,
  "MinPasswordLength": 8,
  "MaxPasswordLength": 16,
  "Accounts": {
    "@odata.id": "/redfish/v1/AccountService/Accounts"
  },
  "Roles": {
    "@odata.id": "/redfish/v1/AccountService/Roles"
  },
  "OutboundConnections": {
    "@odata.id": "/redfish/v1/AccountService/OutboundConnections"
  },
  "LDAP": {
    "ServiceEnabled": false,
    "ServiceAddresses": [],
    "Authentication": {
      "AuthenticationType": "UsernameAndPassword",
      "Username": null,
      "Password": null
    },
    "LDAPService": {
      "SearchSettings": {
        "BaseDistinguishedNames": [],
        "UsernameAttribute": "uid"
      }
    },
    "Oem": {
      "Pelx": {
        "FallbackLocal": true
      }
    }
  },
  "Oem": {
    "Pelx": {
      "PasswordPolicy": {
        "RequireUppercase": true,
        "RequireLowercase": true,
        "RequireNumbers": true,
        "RequireSpecialChars": true
      },
      "Radius": {
        "ServiceEnabled": false,
        "ServiceAddress": "",
        "ServicePort": 1812,
        "TimeoutSec": 5,
        "MaxRetries": 3,
        "FallbackLocal": true,
        "Secret": null
      },
      "Tacacs": {
        "ServiceEnabled": false,
        "ServiceAddress": "",
        "ServicePort": 49,
        "TimeoutSec": 5,
        "FallbackLocal": true,
        "Secret": null
      }
    }
  },
  "Actions": {
    "#PelxAccountService.TestLDAPConnection": {
      "target": "/redfish/v1/AccountService/Actions/PelxAccountService.TestLDAPConnection"
    },
    "#PelxAccountService.TestRADIUSConnection": {
      "target": "/redfish/v1/AccountService/Actions/PelxAccountService.TestRADIUSConnection"
    },
    "#PelxAccountService.TestTACACSConnection": {
      "target": "/redfish/v1/AccountService/Actions/PelxAccountService.TestTACACSConnection"
    }
  }
}

欄位說明如下:

• @odata.id: AccountService 資源 URI，固定 /redfish/v1/AccountService
• @odata.type: 資源型別，固定 #AccountService.v1_15_0.AccountService
• Id: 資源識別碼，固定 AccountService
• Name: 顯示名稱，固定 Account Service
• ServiceEnabled: 帳號服務是否啟用，true 表示可透過 Redfish 查詢帳號資訊
• MinPasswordLength／MaxPasswordLength: 密碼長度上下限（DMTF 標準欄位）
• Oem.Pelx.PasswordPolicy: 複雜度要求（大寫、小寫、數字、特殊字元）
• Accounts: 帳號集合連結物件
  • @odata.id: 帳號列表 URI（/redfish/v1/AccountService/Accounts）；支援 GET／POST；單筆支援 GET／PATCH／DELETE
• Roles: 角色定義集合連結物件
  • @odata.id: 角色列表 URI（/redfish/v1/AccountService/Roles）
• OutboundConnections: 出站 WebSocket 連線集合（DMTF 2023.2+；見 outbound connection）
  • @odata.id: 出站連線列表 URI（/redfish/v1/AccountService/OutboundConnections）；GET／POST；單筆支援 GET／PATCH／DELETE
• LDAP: 標準 LDAP 外部帳號提供者（DMTF LDAPService）；PATCH 本資源之 LDAP 區塊更新
• Oem.Pelx.Radius: RADIUS 伺服器設定（DMTF 無單一標準屬性，以 OEM 表示）
• Oem.Pelx.Tacacs: TACACS+ 伺服器設定（Pelx OEM）
• Actions: LDAP／RADIUS／TACACS+ 連線測試 Action

回傳資料狀態

GET https://

列出帳號（不回傳密碼）。

{
  "@odata.id": "/redfish/v1/AccountService/Accounts",
  "@odata.type": "#ManagerAccountCollection.ManagerAccountCollection",
  "Members": [
    {
      "@odata.id": "/redfish/v1/AccountService/Accounts/1"
    }
  ],
  "Members@odata.count": 1
}

欄位說明如下:

• @odata.id: 帳號集合資源 URI，固定 /redfish/v1/AccountService/Accounts
• @odata.type: 資源型別，固定 #ManagerAccountCollection.ManagerAccountCollection（Mandatory）
• Members: 帳號資源連結陣列，元素為 { "@odata.id": "..." }，不含密碼
  • @odata.id: 單一帳號資源 URI，如 /redfish/v1/AccountService/Accounts/1
• Members@odata.count: Members 陣列筆數，即帳號數量

回傳資料狀態

GET https://

查詢單一帳號詳細資訊（不回傳密碼）。

{id} 為帳號資源識別碼，對應上一節 Members 中 @odata.id 的最後一段路徑，例如 /redfish/v1/AccountService/Accounts/1 的 {id} 為 1。{id} 與 UserName 不一定相同；登入名稱請讀回應中的 UserName 欄位。

回傳資料格式如下:

{
  "@odata.id": "/redfish/v1/AccountService/Accounts/1",
  "@odata.type": "#ManagerAccount.v1_12_0.ManagerAccount",
  "Id": "1",
  "UserName": "admin",
  "RoleId": "Administrator",
  "Enabled": true,
  "Locked": false,
  "@Redfish.WriteableProperties": ["RoleId", "Password", "Enabled", "Locked"]
}

欄位說明如下:

• @odata.id: 帳號資源 URI，如 /redfish/v1/AccountService/Accounts/1
• @odata.type: 資源型別，固定 #ManagerAccount.v1_12_0.ManagerAccount
• Id: 帳號資源識別碼，與 URI 路徑參數 {id} 相同
• UserName: 登入帳號名稱，對應 auth 使用者名稱
• RoleId: Redfish 角色識別碼，如 Administrator、Operator、ReadOnly；由 auth role 映射，見本文「認證」章節
• Enabled: 帳號是否啟用，false 時無法登入
• Locked: 帳號是否鎖定（如多次登入失敗），true 時無法登入直至解鎖
• @Redfish.WriteableProperties: 可 PATCH 欄位陣列（須 Administrator）

回傳資料狀態

{id} 不存在時不會回傳其他帳號內容，請重新 GET /AccountService/Accounts 從 Members 取得有效 id。

404 回應範例：

{
  "error": {
    "@Message.ExtendedInfo": [
      {
        "Message": "The resource at the URI /redfish/v1/AccountService/Accounts/999 was not found.",
        "MessageId": "Base.1.18.ResourceNotFound",
        "Severity": "Critical",
        "Resolution": "Place a valid resource URI in the request."
      }
    ]
  }
}

欄位說明如下:

• error: 錯誤物件
  • @Message.ExtendedInfo: 延伸錯誤資訊陣列
    • Message: 詳細說明
    • MessageId: 訊息識別碼，如 Base.1.18.ResourceNotFound
    • Severity: 嚴重程度，如 Critical
    • Resolution: 建議處理方式

POST https://

建立本地帳號（OCP Baseline Mandatory）。須 Operator 以上；依 帳號 CRUD 授權矩陣 檢查 RoleId。閘道轉呼叫 auth POST /users。

請求 body 範例：

{
  "UserName": "dcim-read",
  "Password": "ChangeMe-Strong1",
  "RoleId": "ReadOnly",
  "Enabled": true
}

欄位說明如下:

• UserName: 登入帳號名稱（必填）
• Password: 登入密碼（必填）
• RoleId: Redfish 角色，須為 Administrator、Operator 或 ReadOnly（不可 app）
• Enabled: 是否啟用，預設 true；false

欄位對照（Redfish → auth）

Redfish 建立帳號不接受 outlets、notifications 等 Web 專用欄位；插座權限請用 Web 或 auth API 另行設定。

回傳資料狀態

PATCH https://

修改帳號（OCP Baseline Mandatory）。須 Operator 以上；依 帳號 CRUD 授權矩陣 檢查目標帳號之 RoleId 與變更後 RoleId。閘道轉呼叫 auth PATCH /users/{username}（username 由資源 {id} 查得）。

請求 body 範例（僅送要變更的欄位）：

{
  "RoleId": "Operator",
  "Password": "NewPassword-Strong1",
  "Enabled": true
}

可寫欄位

回傳資料狀態

DELETE https://

刪除帳號（OCP Baseline Mandatory）。須 Operator 以上；依 帳號 CRUD 授權矩陣 檢查目標帳號。閘道轉呼叫 auth DELETE /users/{username}。

無請求 body。

回傳資料狀態

GET https://

角色集合（OCP Service Baseline）。

{
  "@odata.id": "/redfish/v1/AccountService/Roles",
  "@odata.type": "#RoleCollection.RoleCollection",
  "Members": [
    { "@odata.id": "/redfish/v1/AccountService/Roles/Administrator" },
    { "@odata.id": "/redfish/v1/AccountService/Roles/Operator" },
    { "@odata.id": "/redfish/v1/AccountService/Roles/ReadOnly" }
  ],
  "Members@odata.count": 3
}

欄位說明如下:

• @odata.id: 角色集合 URI，固定 /redfish/v1/AccountService/Roles
• @odata.type: 資源型別，固定 #RoleCollection.RoleCollection（Mandatory）
• Members: 角色資源連結陣列
• Members@odata.count: 角色數量

回傳資料狀態

GET https://

查詢單一角色定義（OCP Baseline Mandatory）。RoleId 為 Administrator、Operator 或 ReadOnly。預設角色 IsPredefined: true，AssignedPrivileges 不可 PATCH 修改。

Administrator 範例：

{
  "@odata.id": "/redfish/v1/AccountService/Roles/Administrator",
  "@odata.type": "#Role.v1_3_0.Role",
  "Id": "Administrator",
  "Name": "Administrator",
  "IsPredefined": true,
  "AssignedPrivileges": ["Login", "ConfigureManager", "ConfigureUsers", "ConfigureSelf", "ConfigureComponents"],
  "OemPrivileges": ["ConfigureEngineering"]
}

ReadOnly 範例（OCP 基礎角色）：

{
  "@odata.id": "/redfish/v1/AccountService/Roles/ReadOnly",
  "@odata.type": "#Role.v1_3_0.Role",
  "Id": "ReadOnly",
  "Name": "Read Only",
  "IsPredefined": true,
  "AssignedPrivileges": ["Login", "ConfigureSelf"],
  "OemPrivileges": []
}

回傳資料狀態

PATCH https://

修改帳號服務設定（密碼政策、LDAP、RADIUS、TACACS+）。須 Administrator（工程模式）。僅送要變更的區塊。

密碼強度政策範例

{
  "MinPasswordLength": 10,
  "MaxPasswordLength": 32,
  "Oem": {
    "Pelx": {
      "PasswordPolicy": {
        "RequireUppercase": true,
        "RequireLowercase": true,
        "RequireNumbers": true,
        "RequireSpecialChars": true
      }
    }
  }
}

LDAP 範例

{
  "LDAP": {
    "ServiceEnabled": true,
    "ServiceAddresses": ["ldap://ldap.example.com:389"],
    "Authentication": {
      "AuthenticationType": "UsernameAndPassword",
      "Username": "cn=admin,dc=example,dc=com",
      "Password": "bind-secret"
    },
    "LDAPService": {
      "SearchSettings": {
        "BaseDistinguishedNames": ["dc=example,dc=com"],
        "UsernameAttribute": "uid"
      }
    },
    "Oem": {
      "Pelx": {
        "FallbackLocal": true
      }
    }
  }
}

RADIUS 範例

{
  "Oem": {
    "Pelx": {
      "Radius": {
        "ServiceEnabled": true,
        "ServiceAddress": "radius.example.com",
        "ServicePort": 1812,
        "Secret": "radius_secret",
        "TimeoutSec": 5,
        "MaxRetries": 3,
        "FallbackLocal": true
      }
    }
  }
}

TACACS+ 範例

{
  "Oem": {
    "Pelx": {
      "Tacacs": {
        "ServiceEnabled": true,
        "ServiceAddress": "tacacs.example.com",
        "ServicePort": 49,
        "Secret": "tacacs_secret",
        "TimeoutSec": 5,
        "FallbackLocal": true
      }
    }
  }
}

欄位對照（Redfish → auth）

LDAP → PATCH /config/ldap：

RADIUS → PATCH /config/radius：

TACACS+ → PATCH /config/tacacs：

密碼強度 → PATCH /config/password-policy：

GET 回應不回傳 Authentication.Password、Radius.Secret、Tacacs.Secret（null 或省略）。

回傳資料狀態

POST https://

測試 LDAP 連線。須 Administrator。。

請求 body 範例（可省略已儲存於 LDAP 的欄位，改送測試帳密）：

{
  "ServiceAddresses": ["ldap://ldap.example.com:389"],
  "Authentication": {
    "Username": "cn=admin,dc=example,dc=com",
    "Password": "bind-secret"
  },
  "LDAPService": {
    "SearchSettings": {
      "BaseDistinguishedNames": ["dc=example,dc=com"],
      "UsernameAttribute": "uid"
    }
  },
  "TestUserName": "testuser",
  "TestPassword": "testpassword"
}

回傳資料狀態

POST https://

測試 RADIUS 連線。須 Administrator。。

請求 body 範例：

{
  "ServiceAddress": "radius.example.com",
  "ServicePort": 1812,
  "Secret": "radius_secret",
  "TimeoutSec": 5,
  "MaxRetries": 3,
  "TestUserName": "testuser",
  "TestPassword": "testpassword"
}

回傳資料狀態

POST https://

測試 TACACS+ 連線。須 Administrator。。

請求 body 範例：

{
  "ServiceAddress": "tacacs.example.com",
  "ServicePort": 49,
  "Secret": "tacacs_secret",
  "TimeoutSec": 5,
  "TestUserName": "testuser",
  "TestPassword": "testpassword"
}

回傳資料狀態

實作狀態：LDAP／RADIUS／TACACS+ 為規格定義。

HTTPS 憑證（實際作業方式）

設備對外 HTTPS（Web 管理介面、Redfish over HTTPS）支援兩種模式：

|------|--------------------------------------|-------------| | uacme（預設） | uacme | CertificateService 與 PelxCertificateService.TestUacme | | manual | manual | GET/PATCH /tls、POST /tls/csr、POST /tls/certificates/replace |

GET https://

憑證服務（OCP Service Baseline Mandatory）。

{
  "@odata.id": "/redfish/v1/CertificateService",
  "@odata.type": "#CertificateService.v1_0_1.CertificateService",
  "Id": "CertificateService",
  "Name": "Certificate Service",
  "ServiceEnabled": true,
  "CertificateLocations": {
    "@odata.id": "/redfish/v1/CertificateService/CertificateLocations"
  },
  "Oem": {
    "Pelx": {
      "CertificateMode": "uacme",
      "Uacme": {
        "ServiceEnabled": true,
        "Domain": "pdu.example.com",
        "ContactEmail": "admin@example.com"
      }
    }
  },
  "Actions": {
    "#CertificateService.GenerateCSR": {
      "target": "/redfish/v1/CertificateService/Actions/CertificateService.GenerateCSR"
    },
    "#CertificateService.ReplaceCertificate": {
      "target": "/redfish/v1/CertificateService/Actions/CertificateService.ReplaceCertificate"
    },
    "#PelxCertificateService.TestUacme": {
      "target": "/redfish/v1/CertificateService/Actions/PelxCertificateService.TestUacme"
    }
  }
}

欄位說明如下:

• @odata.id: CertificateService 資源 URI，固定 /redfish/v1/CertificateService
• ServiceEnabled: 服務是否啟用（Baseline Mandatory）
• CertificateLocations: 憑證存放位置集合（Baseline Mandatory）
• Oem.Pelx.CertificateMode: manual 或 uacme（。須 Administrator。 與／或 PATCH /uacme。

切換為 uacme（預設生產模式）：

{
  "Oem": {
    "Pelx": {
      "CertificateMode": "uacme",
      "Uacme": {
        "ServiceEnabled": true,
        "Domain": "pdu.example.com",
        "ContactEmail": "admin@example.com"
      }
    }
  }
}

切換為手動憑證（企業 CA／CSR）：

{
  "Oem": {
    "Pelx": {
      "CertificateMode": "manual",
      "Uacme": {
        "ServiceEnabled": false
      }
    }
  }
}

回傳資料狀態

POST https://

測試 uacme 申請條件（不實際簽發）。須 Administrator。。

請求 body 範例：

{
  "Domain": "pdu.example.com",
  "ContactEmail": "admin@example.com"
}

|---------|----------------------| | Domain | domain | | ContactEmail | mail |

回傳資料狀態

GET https://

列出可管理的憑證位置（OCP Service Baseline Mandatory）。

{
  "@odata.id": "/redfish/v1/CertificateService/CertificateLocations",
  "@odata.type": "#CertificateLocations.v1_0_2.CertificateLocations",
  "Id": "CertificateLocations",
  "Links": {
    "Certificates": [
      { "@odata.id": "/redfish/v1/CertificateService/Certificates/https-server" }
    ]
  }
}

欄位說明如下:

• @odata.id: CertificateLocations 資源 URI，固定 /redfish/v1/CertificateService/CertificateLocations
• @odata.type: 資源型別，固定 #CertificateLocations.v1_0_2.CertificateLocations
• Id: 資源識別碼，固定 CertificateLocations
• Links.Certificates: 憑證資源連結陣列；有 HTTPS 憑證時指向 .../CertificateService/Certificates/https-server（含 certMode=uacme 時使用自動憑證）；無憑證時為空陣列 []

回傳資料狀態

GET https://

憑證集合。。

{
  "@odata.id": "/redfish/v1/CertificateService/Certificates",
  "@odata.type": "#CertificateCollection.CertificateCollection",
  "Members": [
    { "@odata.id": "/redfish/v1/CertificateService/Certificates/https-server" }
  ],
  "Members@odata.count": 1
}

回傳資料狀態

GET https://

查詢指定憑證 slot 的 PEM 公開資訊（不含私鑰）。id 固定為 https-server（別名 1）。

{
  "@odata.id": "/redfish/v1/CertificateService/Certificates/https-server",
  "@odata.type": "#Certificate.v1_8_0.Certificate",
  "Id": "https-server",
  "Name": "HTTPS Server Certificate",
  "CertificateType": "PEM",
  "CertificateString": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----",
  "Issuer": { "CommonName": "Example CA" },
  "Subject": { "CommonName": "CN=pdu.example.com" },
  "ValidNotBefore": "2026-06-01T00:00:00Z",
  "ValidNotAfter": "2027-06-01T00:00:00Z"
}

回傳資料狀態

POST https://

產生 CSR（DMTF Redfish 標準 Action）。（須 certMode=manual）。

請求 body 範例：

{
  "Country": "TW",
  "State": "Taipei",
  "City": "Taipei",
  "Organization": "Example Corp",
  "OrganizationalUnit": "IT",
  "CommonName": "pdu.example.com",
  "Email": "admin@example.com",
  "AlternativeNames": ["pdu.example.com", "192.168.1.100"],
  "KeyBitLength": 2048
}

成功回應：

{
  "CSRString": "-----BEGIN CERTIFICATE REQUEST-----\n...\n-----END CERTIFICATE REQUEST-----"
}

回傳資料狀態

POST https://

更換憑證。。

請求 body 範例：

{
  "CertificateUri": "/redfish/v1/CertificateService/Certificates/https-server",
  "CertificateType": "PEM",
  "CertificateString": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----"
}

亦可附 CertificateChain 陣列（中繼憑證 PEM）。

回傳資料狀態

探索與識別

Redfish Service Root，作為所有資源的入口。

{
  "@odata.id": "/redfish/v1",
  "@odata.type": "#ServiceRoot.v1_16_0.ServiceRoot",
  "Id": "RootService",
  "Name": "Root Service",
  "RedfishVersion": "1.16.0",
  "UUID": "00000000-0000-0000-0000-000000000001",
  "Vendor": "Pelx",
  "SessionService": {
    "@odata.id": "/redfish/v1/SessionService"
  },
  "AccountService": {
    "@odata.id": "/redfish/v1/AccountService"
  },
  "CertificateService": {
    "@odata.id": "/redfish/v1/CertificateService"
  },
  "Chassis": {
    "@odata.id": "/redfish/v1/Chassis"
  },
  "Managers": {
    "@odata.id": "/redfish/v1/Managers"
  },
  "PowerEquipment": {
    "@odata.id": "/redfish/v1/PowerEquipment"
  },
  "EventService": {
    "@odata.id": "/redfish/v1/EventService"
  },
  "UpdateService": {
    "@odata.id": "/redfish/v1/UpdateService"
  },
  "TaskService": {
    "@odata.id": "/redfish/v1/TaskService"
  },
  "Product": {
    "Vendor": "Pelx",
    "Name": "Rack PDU"
  },
  "ProtocolFeaturesSupported": {
    "ExpandQuery": {
      "ExpandAll": true,
      "Levels": true
    },
    "FilterQuery": true,
    "OnlyMemberQuery": true
  },
  "Links": {
    "Sessions": {
      "@odata.id": "/redfish/v1/SessionService/Sessions"
    }
  },
  "Oem": {
    "Pelx": {
      "Interfaces": {
        "@odata.id": "/redfish/v1/Oem/Pelx/Interfaces"
      },
      "PeripheralTree": {
        "@odata.id": "/redfish/v1/Oem/Pelx/PeripheralTree"
      },
      "TelemetryService": {
        "@odata.id": "/redfish/v1/TelemetryService"
      },
      "Mqtt": {
        "@odata.id": "/redfish/v1/Oem/Pelx/Mqtt"
      },
      "MqttEndpoint": "wss://<host>/redfish/v1/Oem/Pelx/Mqtt",
      "MqttAuth": "RedfishSession",
      "SerialBuses": {
        "@odata.id": "/redfish/v1/Oem/Pelx/SerialBuses"
      },
      "VNodes": {
        "@odata.id": "/redfish/v1/Oem/Pelx/VNodes"
      },
      "HmiScreens": {
        "@odata.id": "/redfish/v1/Oem/Pelx/HmiScreens"
      },
      "HmiImageLibraries": {
        "@odata.id": "/redfish/v1/Oem/Pelx/HmiImageLibraries"
      },
      "Automations": {
        "@odata.id": "/redfish/v1/Oem/Pelx/Automations"
      }
    }
  }
}

欄位說明如下:

• @odata.id: Service Root 資源 URI，固定 /redfish/v1
• @odata.type: 資源型別，固定 #ServiceRoot.v1_16_0.ServiceRoot
• Id: 資源識別碼，固定 RootService
• Name: 顯示名稱，固定 Root Service
• RedfishVersion: Redfish 協議版本（OCP Baseline Mandatory）
• UUID: 設備唯一識別碼（OCP Baseline Mandatory）
• Vendor: 廠商名稱（OCP Baseline Mandatory），固定 Pelx
• SessionService: Session 服務連結（Baseline Mandatory）
• AccountService: 帳號服務連結（Baseline Mandatory）
• CertificateService: 憑證服務連結（Baseline Mandatory）
• Chassis: 機箱集合連結（Baseline）
• Managers: 管理控制器集合連結（Baseline Mandatory）
• PowerEquipment: 配電設備連結（OCP Rack PDU Profile Mandatory）
• EventService: 事件服務連結（Baseline Mandatory）
• UpdateService: 韌體更新服務連結（Baseline Mandatory）
• TaskService: 任務服務連結（Baseline Mandatory）
• Product: 產品識別物件（Baseline Mandatory）
  • Vendor: 廠商名稱
  • Name: 產品名稱
• ProtocolFeaturesSupported: 協定能力（Baseline Mandatory）
  • ExpandQuery: 支援 $expand（Baseline Recommended）；ExpandAll、Levels 為 true 時可用 $expand=.、$expand=.($levels=N) 一次展開子資源
  • FilterQuery: 支援 $filter（Baseline Recommended）
  • OnlyMemberQuery: 支援 $only（Baseline Mandatory）；如 GET .../Outlets?$only 僅回 Members 陣列
• Links: 服務層連結（Session 建立所需）
  • Sessions: Session 集合 URI（Interop Validator Session 模式 Mandatory）
• Oem.Pelx: Pelx 擴充連結（非 OCP 必填）
  • Interfaces: 介面列表
  • PeripheralTree: 週邊結構樹
  • TelemetryService: 歷史趨勢服務
  • MqttEndpoint: MQTT over WebSocket URL（Redfish 整合：/redfish/v1/Oem/Pelx/Mqtt；見 MQTT Discovery）
  • MqttAuth: MQTT 認證方式；Redfish 整合為 RedfishSession（X-Auth-Token 或 Basic Auth）
  • SerialBuses: RS485 參數（僅 devinfo.rs485；見 oem serial buses）
  • VNodes: VNode 組態（僅 devinfo.vnode；見 oem vnodes）
  • HmiScreens: 圖控畫面與樣版匯出／載入（僅 devinfo.hmi；見 oem hmi screens）
  • HmiImageLibraries: 圖控圖庫（僅 devinfo.hmi；見 oem hmi image libraries）
  • Automations: 自動化流程（僅 devinfo.autoBuilder；見 oem automations）

SerialBuses／VNodes／HmiScreens／HmiImageLibraries／Automations 依能力旗標條件出現；未支援時省略該連結（客戶端勿假設永遠存在）。讀寫皆須 Administrator（工程模式）。

回傳資料狀態

$expand 與 $only 範例

Service Root 宣告 ProtocolFeaturesSupported.ExpandQuery 時，可用 OData 查詢減少往返（不支援時回 501）：

Collection 未加 $expand 時，Members 僅含 @odata.id 連結，不含各插座 Reading／PowerState。詳見 「總覽與合規」章節 — 一次回應多筆資料。

GET https://

{
  "@odata.id": "/redfish/v1/Managers",
  "@odata.type": "#ManagerCollection.ManagerCollection",
  "Members": [
    { "@odata.id": "/redfish/v1/Managers/1" }
  ],
  "Members@odata.count": 1
}

欄位說明如下:

• @odata.id: Manager 集合資源 URI，固定 /redfish/v1/Managers
• @odata.type: 資源型別，固定 #ManagerCollection.ManagerCollection（Baseline Mandatory）
• Members: Manager 資源連結陣列，元素為 { "@odata.id": "..." }
  • @odata.id: 單一 Manager 資源 URI，如 /redfish/v1/Managers/1
• Members@odata.count: Members 陣列筆數；本機單台產品通常為 1

回傳資料狀態

GET https://

管理控制器識別，韌體版本見 FirmwareVersion。路徑參數 {id} 為 Manager 資源識別碼；本機單台 PDU 產品通常僅一筆，id 為 1。整合方應先 GET /Managers，從 Members 的 @odata.id 取得有效 id，勿寫死。

{
  "@odata.id": "/redfish/v1/Managers/1",
  "@odata.type": "#Manager.v1_19_0.Manager",
  "Id": "1",
  "Name": "Manager",
  "ManagerType": "BMC",
  "FirmwareVersion": "1.60.3",
  "UUID": "00000000-0000-0000-0000-000000000001",
  "DateTime": "2026-06-15T10:00:00+08:00",
  "DateTimeLocalOffset": "+08:00",
  "Status": {
    "State": "Enabled",
    "Health": "OK"
  },
  "EthernetInterfaces": {
    "@odata.id": "/redfish/v1/Managers/1/EthernetInterfaces"
  },
  "NetworkProtocol": {
    "@odata.id": "/redfish/v1/Managers/1/NetworkProtocol"
  },
  "Links": {
    "ManagerForChassis": [
      { "@odata.id": "/redfish/v1/Chassis/1" }
    ],
    "ManagerForPowerEquipment": [
      { "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1" }
    ]
  },
  "LogServices": {
    "@odata.id": "/redfish/v1/Managers/1/LogServices"
  },
  "Oem": {
    "Pelx": {
      "Build": "202301161315",
      "CompanyOid": "26104",
      "Mqtt": {
        "@odata.id": "/redfish/v1/Oem/Pelx/Mqtt"
      },
      "MqttEndpoint": "wss://<host>/redfish/v1/Oem/Pelx/Mqtt",
      "MqttAuth": "RedfishSession"
    }
  }
}

欄位說明如下:

• @odata.id: Manager 資源 URI，固定 /redfish/v1/Managers/1
• @odata.type: 資源型別，固定 #Manager.v1_19_0.Manager
• Id: 資源識別碼，固定 1
• Name: 顯示名稱，固定 Manager
• ManagerType: 管理器類型（Baseline Mandatory），固定 BMC
• FirmwareVersion: 設備映像版本（Baseline Mandatory），對應 Managers/1.FirmwareVersion
• UUID: 管理器 UUID（Baseline Mandatory）
• DateTime: 管理器目前時間 ISO 8601（Baseline Mandatory）
• DateTimeLocalOffset: 時區偏移（Baseline Mandatory），如 +08:00
• Status: 狀態物件（Baseline Mandatory）
• EthernetInterfaces: 網路介面集合（Baseline Mandatory）
• NetworkProtocol: 通訊協定設定（Baseline Supported）
• Links: 關聯資源（Baseline Mandatory）
  • ManagerForChassis: 所管理機箱
  • ManagerForPowerEquipment: 所管理配電資源
• LogServices: 日誌服務（Baseline Mandatory）
• Oem.Pelx: Pelx 擴充（非 OCP 必填）
  • Build: 版號（建置時間），建置版號
  • CompanyOid: 公司 OID，公司 OID
  • MqttEndpoint: MQTT over WebSocket URL（見 MQTT Discovery）
  • MqttAuth: RedfishSession（X-Auth-Token 或 Basic Auth）

回傳資料狀態

GET https://

{
  "@odata.id": "/redfish/v1/Managers/1/EthernetInterfaces",
  "@odata.type": "#EthernetInterfaceCollection.EthernetInterfaceCollection",
  "Members": [
    { "@odata.id": "/redfish/v1/Managers/1/EthernetInterfaces/1" }
  ],
  "Members@odata.count": 1
}

GET https://

{
  "@odata.id": "/redfish/v1/Managers/1/EthernetInterfaces/1",
  "@odata.type": "#EthernetInterface.v1_12_0.EthernetInterface",
  "Id": "1",
  "Name": "eth0",
  "MACAddress": "00:11:22:33:44:55",
  "InterfaceEnabled": true,
  "LinkStatus": "LinkUp",
  "SpeedMbps": 1000,
  "IPv4Addresses": [
    {
      "Address": "192.168.1.100",
      "SubnetMask": "255.255.255.0",
      "AddressOrigin": "Static",
      "Gateway": "192.168.1.1"
    }
  ],
  "Status": {
    "State": "Enabled",
    "Health": "OK"
  }
}

GET https://

NTP、SNMP 設定見 網路協定。

{
  "@odata.id": "/redfish/v1/Managers/1/NetworkProtocol",
  "@odata.type": "#ManagerNetworkProtocol.v1_9_1.ManagerNetworkProtocol",
  "Id": "NetworkProtocol",
  "HostName": "pdu-1",
  "HTTPS": {
    "ProtocolEnabled": true,
    "Port": 443
  },
  "HTTP": {
    "ProtocolEnabled": false,
    "Port": 80
  },
  "NTP": {
    "ProtocolEnabled": true,
    "NTPServers": ["time.stdtime.gov.tw"]
  },
  "SNMP": {
    "ProtocolEnabled": true,
    "Port": 161
  },
  "SSH": {
    "ProtocolEnabled": false,
    "Port": 22
  },
  "Status": {
    "State": "Enabled",
    "Health": "OK"
  }
}

GET https://

{
  "@odata.id": "/redfish/v1/Chassis",
  "@odata.type": "#ChassisCollection.ChassisCollection",
  "Members": [
    { "@odata.id": "/redfish/v1/Chassis/1" }
  ],
  "Members@odata.count": 1
}

欄位說明如下:

• @odata.id: Chassis 集合資源 URI，固定 /redfish/v1/Chassis
• @odata.type: 資源型別，固定 #ChassisCollection.ChassisCollection（Baseline）
• Members: Chassis 資源連結陣列，元素為 { "@odata.id": "..." }
  • @odata.id: 單一 Chassis 資源 URI，如 /redfish/v1/Chassis/1
• Members@odata.count: Members 陣列筆數；本機單台產品通常為 1

回傳資料狀態

GET https://

機箱識別與健康彙整。路徑參數 {chassisId} 為 Chassis 資源識別碼；本機單台 PDU 產品通常僅一筆，id 為 1。整合方應先 GET /Chassis，從 Members 的 @odata.id 取得有效 id，勿寫死。

{
  "@odata.id": "/redfish/v1/Chassis/1",
  "@odata.type": "#Chassis.v1_22_0.Chassis",
  "@Redfish.WriteableProperties": [
    "AssetTag"
  ],
  "Id": "1",
  "Name": "Chassis",
  "ChassisType": "RackMount",
  "Manufacturer": "Pelx",
  "Model": "ZDL-2A-12Z",
  "PartNumber": "ZDL-2A-12Z",
  "SerialNumber": "001122AABBCC",
  "AssetTag": "",
  "UUID": "00000000-0000-0000-0000-000000000002",
  "PowerState": "On",
  "Location": {
    "@Redfish.WriteableProperties": [
      "Contacts"
    ],
    "Contacts": "",
    "Placement": {
      "@Redfish.WriteableProperties": [
        "Rack",
        "Row",
        "RackOffset",
        "RackOffsetUnits"
      ],
      "Rack": "Rack-01",
      "Row": "Row-A",
      "RackOffset": 42,
      "RackOffsetUnits": "EIA_310"
    }
  },
  "Status": {
    "State": "Enabled",
    "Health": "OK",
    "HealthRollup": "OK"
  },
  "Links": {
    "ManagedBy": [
      { "@odata.id": "/redfish/v1/Managers/1" }
    ],
    "PowerDistribution": {
      "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1"
    }
  },
  "Sensors": {
    "@odata.id": "/redfish/v1/Chassis/1/Sensors"
  },
  "ThermalSubsystem": {
    "@odata.id": "/redfish/v1/Chassis/1/ThermalSubsystem"
  },
  "EnvironmentMetrics": {
    "@odata.id": "/redfish/v1/Chassis/1/EnvironmentMetrics"
  },
  "PowerSubsystem": {
    "@odata.id": "/redfish/v1/Chassis/1/PowerSubsystem"
  },
  "Power": {
    "@odata.id": "/redfish/v1/Chassis/1/Power"
  }
}

注意：Links.PowerDistribution 為單一物件 { "@odata.id": "..." }，非陣列（DMTF Chassis schema 要求）。Chassis 不再連結已棄用之 Thermal；環境量測請用 ThermalSubsystem／ThermalMetrics（見 環境感測）。

欄位說明如下:

• @odata.id: Chassis 資源 URI，固定 /redfish/v1/Chassis/1
• @odata.type: 資源型別，固定 #Chassis.v1_22_0.Chassis
• Id: 資源識別碼，固定 1
• Name: 顯示名稱，固定 Chassis
• ChassisType: 機箱類型（OCP Mandatory），如 RackMount
• Manufacturer: 製造商，製造商識別
• Model: 型號，設備型號
• PartNumber: 料號（OCP Mandatory）；devinfo.partNumber 為空時以 Model 填入
• SerialNumber: 序號；devinfo.serialNumber 為空時以 MAC（ethaddr，去冒號）填入
• UUID: 機箱 UUID（OCP Mandatory）
• PowerState: 整機電源狀態（OCP Mandatory），On 或 Off
• Location: 機架位置（OCP Mandatory）
  • Placement.Rack: 機架名稱（Mandatory，可寫入）
  • Placement.Row: 列／區域（Recommended）
  • Placement.RackOffset: U 位偏移（Recommended）
  • Placement.RackOffsetUnits: 偏移單位，如 EIA_310
• Status: 運作與健康狀態
  • HealthRollup: 整機健康彙整，依告警彙整
• Links: 關聯資源（OCP Mandatory）
  • ManagedBy: 管理此機箱的 Manager
  • PowerDistribution: 對應 Rack PDU 資源（單一物件，非陣列）
• Sensors: 機箱感測器集合（OCP Mandatory）；含電氣量測與 TEMPRH 溫度（Temp1 等）
• ThermalSubsystem: 環境熱管理子系統（OCP Baseline）；內含 ThermalMetrics
• EnvironmentMetrics: 機箱環境彙總（如 PowerWatts）；不含 TemperatureSummaryCelsius
• PowerSubsystem / Power: 電源子系統與傳統 Power 資源（Power 為 deprecated，Validator 可能 WARN）

回傳資料狀態

GET https://

OCP Profile Mandatory 感測器集合 URI。成員與 PowerEquipment/RackPDUs/{rackId}/Sensors 相同，但 @odata.id 須在 Chassis 路徑下（Interop Validator 掃描此集合）。

{
  "@odata.id": "/redfish/v1/Chassis/1/Sensors",
  "@odata.type": "#SensorCollection.SensorCollection",
  "Members": [
    { "@odata.id": "/redfish/v1/Chassis/1/Sensors/CurrentA" },
    { "@odata.id": "/redfish/v1/Chassis/1/Sensors/PowerA" },
    { "@odata.id": "/redfish/v1/Chassis/1/Sensors/EnergyA" },
    { "@odata.id": "/redfish/v1/Chassis/1/Sensors/VoltageA" },
    { "@odata.id": "/redfish/v1/Chassis/1/Sensors/Outlet1Current" },
    { "@odata.id": "/redfish/v1/Chassis/1/Sensors/Temp1" }
  ],
  "Members@odata.count": 6
}

欄位說明如下:

• @odata.id: 感測器集合 URI，固定 /redfish/v1/Chassis/{chassisId}/Sensors
• Members: 感測器連結；{sensorId} 命名規則見「電力與配電」章節 Sensor 定義
• Members@odata.count: 感測器數量

回傳資料狀態

GET https://

單一感測器（OCP Profile 規定 URI）。內容與 PowerEquipment/.../Sensors/{sensorId} 相同；DataSourceUri 須指向本 URI。

{
  "@odata.id": "/redfish/v1/Chassis/1/Sensors/PowerA",
  "@odata.type": "#Sensor.v1_9_0.Sensor",
  "Id": "PowerA",
  "Name": "Infeed1 Power",
  "Reading": 2750.0,
  "ReadingUnits": "W",
  "ReadingType": "Power",
  "ElectricalContext": "Total",
  "ReadingTime": "2026-06-15T10:00:05+08:00",
  "SensingInterval": "PT5S",
  "PeakReading": 3100.0,
  "PeakReadingTime": "2026-06-14T18:22:00+08:00",
  "Status": {
    "State": "Enabled",
    "Health": "OK"
  },
  "Thresholds": {
    "UpperCritical": { "Reading": 3500 },
    "UpperCaution": { "Reading": 3000 }
  },
  "Oem": {
    "Pelx": {
      "@odata.type": "#Pelx.v1_0_0.Pelx",
      "Interface": {
        "@odata.id": "/redfish/v1/Oem/Pelx/Interfaces/CAI2105"
      },
      "RackPduSensorUri": "/redfish/v1/PowerEquipment/RackPDUs/1/Sensors/PowerA"
    }
  }
}

欄位說明如下:

• @odata.id: 感測器 URI，固定 /redfish/v1/Chassis/{chassisId}/Sensors/{sensorId}
• Reading: 即時讀值（OCP Mandatory）
• ReadingType: 量測類型（OCP Mandatory）
• ElectricalContext: 電氣上下文（電氣量測 OCP Mandatory）
• ReadingTime: 讀值時間 ISO 8601（OCP Mandatory）
• SensingInterval: 取樣間隔，如 PT5S（OCP Mandatory）
• PeakReading / PeakReadingTime: 功率感測器至少一筆須提供峰值（OCP Supported）
• Oem.Pelx.Interface: 對應之 Pelx 介面資源連結（Pelx.InterfaceLink）
• Oem.Pelx.RackPduSensorUri: 對應之 DSP2056 配電路徑（選用，方便整合）

回傳資料狀態

網路協定

Managers/1/NetworkProtocol 彙整管理介面通訊協定。OCP Service Baseline 要求 NetworkProtocol 資源存在；NTP、SNMP、SSH 為 Mandatory（須支援 GET／PATCH 之 ProtocolEnabled、Port；Vertiv PDU 文件亦有 PATCH NTP／SSH 範例）。SNMP v3、ICMP 等細節以 Oem 延伸。

權限：PATCH 依欄位分級（例外）；詳見下方表格與 認證。

GET https://

{
  "@odata.id": "/redfish/v1/Managers/1/NetworkProtocol",
    "@odata.type": "#ManagerNetworkProtocol.v1_10_1.ManagerNetworkProtocol",
  "Id": "NetworkProtocol",
  "HostName": "pdu-1",
  "HTTPS": {
    "ProtocolEnabled": true,
    "Port": 443
  },
  "HTTP": {
    "ProtocolEnabled": false,
    "Port": 80
  },
  "NTP": {
    "ProtocolEnabled": true,
    "NTPServers": ["time.stdtime.gov.tw"]
  },
  "SNMP": {
    "ProtocolEnabled": true,
    "Port": 161
  },
  "SSH": {
    "ProtocolEnabled": false,
    "Port": 22
  },
  "Proxy": {
    "Enabled": false,
    "ProxyServerURI": "http://proxy.corp.com:8080",
    "Username": "proxyuser",
    "Password": null,
    "PasswordSet": true,
    "ExcludeAddresses": ["dc.local"],
    "ProxyAutoConfigURI": null
  },
  "Oem": {
    "Pelx": {
      "ICMPEchoReply": {
        "ProtocolEnabled": true
      },
      "DateTime": {
        "TimeZone": "Asia/Taipei",
        "CustomNTPServer": false
      },
      "SNMPAgent": {
        "SNMPv1v2c": {
          "ProtocolEnabled": true,
          "ReadCommunity": "public",
          "WriteEnabled": true,
          "WriteCommunity": "private"
        },
        "SNMPv3": {
          "ProtocolEnabled": false,
          "UserName": "snmpuser",
          "AccessMode": "ReadWrite",
          "AuthProtocol": "MD5",
          "PrivProtocol": "DES"
        },
        "SystemName": "ZDL-2A-12Z",
        "Contact": "Administrator",
        "Location": "Office"
      }
    }
  },
  "Status": {
    "State": "Enabled",
    "Health": "OK"
  }
}

欄位說明如下:

• HostName: 設備主機名稱
• HTTPS／HTTP: Web 與 Redfish 對外埠（Baseline）
  • ProtocolEnabled: 是否啟用
  • Port: 監聽埠
• NTP: 時間同步（OCP Mandatory）
  • ProtocolEnabled:
  • NTPServers: NTP 伺服器位址陣列；customTimeServer=true 時為 timeServer，否則為預設池或空陣列
• SNMP: Agent 是否對外提供（OCP Mandatory）
  • ProtocolEnabled: SNMPAgent.SNMPv1v2c 或 SNMPv3 任一啟用即為 true
  • Port: UDP 161（固定）
• SSH: 遠端 Shell（OCP Mandatory；生產環境預設 停用）
  • ProtocolEnabled: ；true 表示允許 SSH 登入（搭配 sshcli）
  • Port: TCP 22（固定；Cascade 轉發見 串接.md）
• Proxy: 設備出站 HTTP/HTTPS 代理（DMTF ManagerNetworkProtocol v1.8+；供 OutboundConnection 等連外使用）
  • Enabled: 是否啟用
  • ProxyServerURI: 代理伺服器 URI（如 http://proxy.corp.com:8080）
  • Username／Password: 代理認證；Password 僅寫入，GET 固定 null，以 PasswordSet 表示是否已設定
  • ExcludeAddresses: 不走代理的主機名或 IP 清單（localhost、127.0.0.1 永遠排除）
  • ProxyAutoConfigURI: PAC 檔 URI（已儲存；連線邏輯尚未依 PAC 自動選路）
• Oem.Pelx.ICMPEchoReply: ICMP Echo（ping）回應
  • ProtocolEnabled: true 允許 ping；false
• Oem.Pelx.DateTime: 時區等延伸欄位
• Oem.Pelx.SNMPAgent: 完整 SNMP Agent 設定（；GET 不回傳 community／密碼字串，僅顯示是否已設定）

回傳資料狀態

PATCH https://

修改通訊協定設定。依欄位分級（見 認證 RBAC）：

僅送要變更的區塊。若單次 PATCH 同時含 SNMP 與 NTP，須 Administrator。

NTP 範例：

{
  "NTP": {
    "ProtocolEnabled": true,
    "NTPServers": ["ntp.example.com"]
  },
  "Oem": {
    "Pelx": {
      "DateTime": {
        "TimeZone": "Asia/Taipei",
        "CustomNTPServer": true
      }
    }
  }
}

SNMP v1/v2c 範例：

{
  "SNMP": {
    "ProtocolEnabled": true
  },
  "Oem": {
    "Pelx": {
      "SNMPAgent": {
        "SNMPv1v2c": {
          "ProtocolEnabled": true,
          "ReadCommunity": "public",
          "WriteEnabled": false
        }
      }
    }
  }
}

SSH 與 ICMP 範例：

{
  "SSH": {
    "ProtocolEnabled": true
  },
  "Oem": {
    "Pelx": {
      "ICMPEchoReply": {
        "ProtocolEnabled": false
      }
    }
  }
}

HTTP Proxy 範例（OutboundConnection 連外時經企業代理）：

{
  "Proxy": {
    "Enabled": true,
    "ProxyServerURI": "http://proxy.corp.com:8080",
    "Username": "proxyuser",
    "Password": "secret",
    "ExcludeAddresses": ["nms.local"]
  }
}

回傳資料狀態

電力與配電（PowerEquipment）

依 OCP Rack PDU Profile 與 DMTF DSP2056，Rack PDU 資源置於 PowerEquipment/RackPDUs；須含 Metrics、Mains、Branches（可為空集合）、Outlets 與 Links。具 ATS 功能之機型見 ATS 轉換開關（TransferSwitches）。

權限：預設見 認證（控制 Action 與寫入至少 Operator）。

GET https://

{
  "@odata.id": "/redfish/v1/PowerEquipment",
  "@odata.type": "#PowerEquipment.v1_2_3.PowerEquipment",
  "Id": "PowerEquipment",
  "RackPDUs": {
    "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs"
  },
  "TransferSwitches": {
    "@odata.id": "/redfish/v1/PowerEquipment/TransferSwitches"
  }
}

TransferSwitches 僅在 設備支援 ATS 時出現；無 ATS 機型省略此欄位。

欄位說明如下:

• @odata.id: PowerEquipment 資源 URI，固定 /redfish/v1/PowerEquipment
• @odata.type: 資源型別，固定 #PowerEquipment.v1_2_3.PowerEquipment
• Id: 資源識別碼，固定 PowerEquipment
• RackPDUs: Rack PDU 集合連結物件
  • @odata.id: Rack PDU 列表 URI（/redfish/v1/PowerEquipment/RackPDUs）；GET 進一步取得 RackPDUs/{id}
• TransferSwitches: ATS 轉換開關集合連結物件（僅 設備支援 ATS 時）
  • @odata.id: ATS 列表 URI（/redfish/v1/PowerEquipment/TransferSwitches）；GET 進一步取得 TransferSwitches/{id}

回傳資料狀態

GET https://

{
  "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs",
  "@odata.type": "#PowerDistributionCollection.PowerDistributionCollection",
  "Members": [
    { "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1" }
  ],
  "Members@odata.count": 1
}

欄位說明如下:

• @odata.id: Rack PDU 集合資源 URI，固定 /redfish/v1/PowerEquipment/RackPDUs
• @odata.type: 資源型別，固定 #PowerDistributionCollection.PowerDistributionCollection
• Members: Rack PDU 資源連結陣列，元素為 { "@odata.id": "..." }
  • @odata.id: 單一 Rack PDU 資源 URI，如 /redfish/v1/PowerEquipment/RackPDUs/1
• Members@odata.count: Members 陣列筆數，Rack PDU 數量；本機單台產品通常為 1

回傳資料狀態

GET https://

Rack PDU 主資源，彙整進線、分支、插座連結。路徑參數 {id} 為 Rack PDU 資源識別碼；本機單台 PDU 產品通常僅一筆，id 為 1。整合方應先 GET /PowerEquipment/RackPDUs，從 Members 的 @odata.id 取得有效 id，勿寫死。

以下範例以 {id} = 1 表示常見單機情境。

{
  "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1",
  "@odata.type": "#PowerDistribution.v1_4_0.PowerDistribution",
  "@Redfish.WriteableProperties": [
    "AssetTag",
    "UserLabel",
    "LocationIndicatorActive"
  ],
  "Id": "1",
  "Name": "RackPDU",
  "EquipmentType": "RackPDU",
  "UserLabel": "PDU-1",
  "Manufacturer": "Pelx",
  "Model": "ZDL-2A-12Z",
  "PartNumber": "ZDL-2A-12Z",
  "SerialNumber": "001122AABBCC",
  "AssetTag": "",
  "LocationIndicatorActive": false,
  "FirmwareVersion": "1.60.3",
  "UUID": "00000000-0000-0000-0000-000000000003",
  "Location": {
    "@Redfish.WriteableProperties": [
      "Contacts"
    ],
    "Contacts": "",
    "Placement": {
      "@Redfish.WriteableProperties": [
        "Rack",
        "Row",
        "RackOffset",
        "RackOffsetUnits"
      ],
      "Rack": "Rack-01",
      "Row": "Row-A",
      "RackOffset": 42,
      "RackOffsetUnits": "EIA_310"
    }
  },
  "Status": {
    "State": "Enabled",
    "Health": "OK"
  },
  "Metrics": {
    "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Metrics"
  },
  "Mains": {
    "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Mains"
  },
  "Branches": {
    "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Branches"
  },
  "Outlets": {
    "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Outlets"
  },
  "Sensors": {
    "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Sensors"
  },
  "Links": {
    "Chassis": [
      { "@odata.id": "/redfish/v1/Chassis/1" }
    ],
    "ManagedBy": [
      { "@odata.id": "/redfish/v1/Managers/1" }
    ]
  }
}

欄位說明如下:

• id（路徑參數）: Rack PDU 資源識別碼；單機產品通常為 1
• @odata.id: Rack PDU 資源 URI，如 /redfish/v1/PowerEquipment/RackPDUs/1
• @odata.type: 資源型別，固定 #PowerDistribution.v1_4_0.PowerDistribution
• Id: 資源識別碼，與路徑參數 {id} 相同
• Name: 顯示名稱，固定 RackPDU
• EquipmentType: 設備類型（OCP Mandatory），固定 RackPDU
• UserLabel: 使用者自訂標籤（OCP Mandatory，可寫入）
• Manufacturer: 製造商
• Model: 型號，設備型號
• PartNumber: 料號；devinfo.partNumber 為空時以 Model 填入
• SerialNumber: 序號；devinfo.serialNumber 為空時以 MAC（ethaddr，去冒號）填入
• FirmwareVersion: 韌體版本
• UUID: Rack PDU UUID（OCP Mandatory）
• Location: 機架位置（OCP Mandatory）；Placement.Rack 必填
• Status: 運作與健康狀態
• Metrics: 彙總量測資源（OCP Mandatory）
• Mains: 電源進線集合
• Branches: 分支電路集合（OCP Mandatory）；一律提供連結，無分支時 Members 為空
• Outlets: 插座集合
• Sensors: 感測器集合
• Links: 關聯資源（OCP Mandatory）
  • Chassis: 對應實體機箱
  • ManagedBy: 管理此 PDU 的 Manager

路徑說明：GET/PATCH .../RackPDUs/{id} 與 GET .../RackPDUs/{id}/Metrics、POST .../Metrics/Actions/... 支援變數 {id}（無效 id 回 404）。其餘子資源（Mains、Branches、Outlets、Sensors、OutletGroups）的 GET／PATCH／Action 路由目前實作為 .../RackPDUs/1/...（單機產品 id 固定為 1）。

回傳資料狀態

{id} 無效時回傳 Redfish 標準 error 物件（格式見文末「通用錯誤回應」），例如請求 /redfish/v1/PowerEquipment/RackPDUs/999：

{
  "error": {
    "@Message.ExtendedInfo": [
      {
        "Message": "The resource at the URI /redfish/v1/PowerEquipment/RackPDUs/999 was not found.",
        "MessageId": "Base.1.18.ResourceNotFound",
        "Severity": "Critical",
        "Resolution": "Place a valid resource URI in the request."
      }
    ],
    "code": "Base.1.18.ResourceNotFound",
    "message": "The resource at the URI /redfish/v1/PowerEquipment/RackPDUs/999 was not found."
  }
}

GET https://

Rack PDU 彙總量測（OCP PowerDistributionMetrics Mandatory）。{rackId} 為 Rack PDU 路徑參數。一次回應含整機 PowerWatts、EnergykWh、PowerLoadPercent 三項讀值（OCP 批量即時量測的標準做法；逐路插座仍須查 Outlets 或 $expand）。

{
  "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Metrics",
  "@odata.type": "#PowerDistributionMetrics.v1_3_0.PowerDistributionMetrics",
  "Id": "Metrics",
  "Name": "Rack PDU Metrics",
  "PowerWatts": {
    "Reading": 2750.0,
    "DataSourceUri": "/redfish/v1/Chassis/1/Sensors/PowerA"
  },
  "EnergykWh": {
    "Reading": 1523.6,
    "DataSourceUri": "/redfish/v1/Chassis/1/Sensors/EnergyA"
  },
  "PowerLoadPercent": {
    "Reading": 45.2
  },
  "Actions": {
    "#PowerDistributionMetrics.ResetMetrics": {
      "target": "/redfish/v1/PowerEquipment/RackPDUs/1/Metrics/Actions/PowerDistributionMetrics.ResetMetrics"
    }
  }
}

欄位說明如下:

• @odata.id: Metrics 資源 URI，固定 .../RackPDUs/{rackId}/Metrics
• @odata.type: 資源型別，固定 #PowerDistributionMetrics.v1_3_0.PowerDistributionMetrics
• PowerWatts: 總有功功率（OCP Mandatory）
• EnergykWh: 總累計能耗（OCP Mandatory）
• PowerLoadPercent: 負載百分比（OCP Mandatory）
• Actions.#PowerDistributionMetrics.ResetMetrics: 重設能耗計數（OCP Mandatory Action）；見下方 POST 章節

回傳資料狀態

POST https://

重設 Rack PDU 累計能耗。（整機能耗歸零，非逐路插座）。

請求 body 可為空物件 {}。

回傳資料狀態

GET https://

進線電路集合（OCP Mandatory）。依 OCP Rack PDU Profile AC Mains use case，每筆成員須能表達整機（或該路進線）之功率／能耗與接線型態；單相與三相機型皆透過此集合暴露。

單相（一進線）與三相（整體進線）集合結構相同；多路單相進線時 Members 可含多筆（如 Mains/1、Mains/2）。

{
  "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Mains",
  "@odata.type": "#CircuitCollection.CircuitCollection",
  "Members": [
    { "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Mains/1" }
  ],
  "Members@odata.count": 1
}

欄位說明如下:

• @odata.id: 進線集合 URI，固定 .../RackPDUs/{rackId}/Mains
• @odata.type: 資源型別，固定 #CircuitCollection.CircuitCollection（Mandatory）
• Members: 進線電路連結陣列；單相多進線時每路一筆，三相整體進線通常僅一筆
• Members@odata.count: 進線路數（與 Members 長度相同）

回傳資料狀態

GET https://

電源進線電路（CircuitType: Mains）。{mainId} 為進線路數。依 DMTF DSP2056 Circuit schema 與 OCP AC Mains use case：

• 單相（單相進線）：對應單相進線週邊；使用 Voltage、CurrentAmps，PhaseWiringType 為 OnePhase3Wire。
• 三相（三相進線）：對應三相進線週邊（L1／L2／L3，elements.id 1–3）；使用 PolyPhaseVoltage、PolyPhaseCurrentAmps 等，不得同時出現單相 Voltage／CurrentAmps（OCP Conditional：二擇一）。
• 無進線機型：合成 Mains/1（Oem.Pelx.Synthetic: true）。

OCP 量測互斥（Mains）：

PolyPhaseVoltage／PolyPhaseCurrentAmps 之子鍵為 ElectricalContext 列舉（如 Line1ToNeutral、Line1）；各子鍵內含 Reading 與建議之 DataSourceUri（指向 Chassis/1/Sensors/...）。

OCP AC Mains 欄位名稱合規對照

以下對照 OCPRackPDU.v1_0_0.json Circuit → AC Mains use case。

命名與型別注意

• NominalVoltage：DMTF 為 NominalVoltageType 列舉字串（如 AC230V、AC100To240V），不是 { "Reading": … } 物件；即時電壓請用 Voltage 或 PolyPhaseVoltage。
• Links：OCP Mains 建議 Links.PowerOutlet；DMTF Circuit 亦支援 Links.Outlets（與 Branches 相同結構），實作可擇一或並列。
• Sensor {id}（如 VoltageA）：Pelx 命名，非 OCP 標準；OCP 僅要求 DataSourceUri 指向 Chassis/…/Sensors/{sensorId}。
• Oem.Pelx：廠商擴充，不計入 OCP 合規。

PolyPhaseVoltage 子鍵（OCP IfImplemented，依機型擇一或多個）：

PolyPhaseCurrentAmps 子鍵：Line1、Line2、Line3、Neutral（IfImplemented）。

單相進線範例（INFEED）

{
  "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/{rackId}/Mains/{mainId}",
  "@odata.type": "#Circuit.v1_8_1.Circuit",
  "Id": "{mainId}",
  "Name": "Infeed1",
  "UserLabel": "Main Input",
  "CircuitType": "Mains",
  "ElectricalContext": "Total",
  "NominalVoltage": "AC230V",
  "VoltageType": "AC",
  "PhaseWiringType": "OnePhase3Wire",
  "RatedCurrentAmps": 32,
  "PowerState": "On",
  "Voltage": {
    "Reading": 220.4,
    "DataSourceUri": "/redfish/v1/Chassis/1/Sensors/VoltageA"
  },
  "CurrentAmps": {
    "Reading": 12.5,
    "DataSourceUri": "/redfish/v1/Chassis/1/Sensors/CurrentA"
  },
  "PowerWatts": {
    "Reading": 2750.0,
    "DataSourceUri": "/redfish/v1/Chassis/1/Sensors/PowerA"
  },
  "EnergykWh": {
    "Reading": 1523.6,
    "DataSourceUri": "/redfish/v1/Chassis/1/Sensors/EnergyA"
  },
  "FrequencyHz": {
    "Reading": 60.0,
    "DataSourceUri": "/redfish/v1/Chassis/1/Sensors/FrequencyA"
  },
  "Links": {
    "Outlets": [
      { "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Outlets/1" },
      { "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Outlets/2" }
    ]
  },
  "Status": {
    "State": "Enabled",
    "Health": "OK"
  },
  "Actions": {
    "#Circuit.ResetMetrics": {
      "target": "/redfish/v1/PowerEquipment/RackPDUs/1/Mains/1/Actions/Circuit.ResetMetrics"
    }
  },
  "Oem": {
    "Pelx": {
      "@odata.type": "#Pelx.v1_0_0.Pelx",
      "ElementId": 1,
      "Alias": "INFEED",
      "Interfaces": {
        "Voltage": { "@odata.id": "/redfish/v1/Oem/Pelx/Interfaces/AI2101" },
        "CurrentAmps": { "@odata.id": "/redfish/v1/Oem/Pelx/Interfaces/AI2103" },
        "PowerWatts": { "@odata.id": "/redfish/v1/Oem/Pelx/Interfaces/CAI2105" },
        "FrequencyHz": { "@odata.id": "/redfish/v1/Oem/Pelx/Interfaces/AI2102" }
      }
    }
  }
}

三相進線範例（INFEED3P，infeedKind=ThreePhase）

三相機型以單一 Mains/1 表示整體 AC 進線；各相量測彙整至 PolyPhase*。INFEED3P 的 elements.id 1／2／3 分別對應 L1（X）／L2（Y）／L3（Z）。

{
  "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Mains/1",
  "@odata.type": "#Circuit.v1_8_1.Circuit",
  "Id": "1",
  "Name": "Main Input",
  "UserLabel": "Main Input",
  "CircuitType": "Mains",
  "ElectricalContext": "Total",
  "NominalVoltage": "AC230V",
  "VoltageType": "AC",
  "PhaseWiringType": "ThreePhase4Wire",
  "RatedCurrentAmps": 32,
  "PowerState": "On",
  "PolyPhaseVoltage": {
    "Line1ToNeutral": {
      "Reading": 220.1,
      "DataSourceUri": "/redfish/v1/Chassis/1/Sensors/VoltageA"
    },
    "Line2ToNeutral": {
      "Reading": 219.8,
      "DataSourceUri": "/redfish/v1/Chassis/1/Sensors/VoltageB"
    },
    "Line3ToNeutral": {
      "Reading": 220.4,
      "DataSourceUri": "/redfish/v1/Chassis/1/Sensors/VoltageC"
    }
  },
  "PolyPhaseCurrentAmps": {
    "Line1": {
      "Reading": 12.5,
      "DataSourceUri": "/redfish/v1/Chassis/1/Sensors/CurrentA"
    },
    "Line2": {
      "Reading": 11.8,
      "DataSourceUri": "/redfish/v1/Chassis/1/Sensors/CurrentB"
    },
    "Line3": {
      "Reading": 12.1,
      "DataSourceUri": "/redfish/v1/Chassis/1/Sensors/CurrentC"
    }
  },
  "PolyPhasePowerWatts": {
    "Line1ToNeutral": {
      "Reading": 2750.0,
      "DataSourceUri": "/redfish/v1/Chassis/1/Sensors/PowerA"
    },
    "Line2ToNeutral": {
      "Reading": 2594.0,
      "DataSourceUri": "/redfish/v1/Chassis/1/Sensors/PowerB"
    },
    "Line3ToNeutral": {
      "Reading": 2666.0,
      "DataSourceUri": "/redfish/v1/Chassis/1/Sensors/PowerC"
    }
  },
  "PowerWatts": {
    "Reading": 8010.0,
    "DataSourceUri": "/redfish/v1/Chassis/1/Sensors/PowerTotal"
  },
  "EnergykWh": {
    "Reading": 4521.3,
    "DataSourceUri": "/redfish/v1/Chassis/1/Sensors/EnergyTotal"
  },
  "FrequencyHz": {
    "Reading": 60.0,
    "DataSourceUri": "/redfish/v1/Chassis/1/Sensors/FrequencyA"
  },
  "Links": {
    "Outlets": [
      { "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Outlets/1" },
      { "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Outlets/2" }
    ]
  },
  "Status": {
    "State": "Enabled",
    "Health": "OK"
  },
  "Actions": {
    "#Circuit.ResetMetrics": {
      "target": "/redfish/v1/PowerEquipment/RackPDUs/1/Mains/1/Actions/Circuit.ResetMetrics"
    }
  },
  "Oem": {
    "Pelx": {
      "@odata.type": "#Pelx.v1_0_0.Pelx",
      "Alias": "INFEED3P",
      "InterfaceGroups": {
        "PolyPhaseVoltage": {
          "Line1ToNeutral": { "@odata.id": "/redfish/v1/Oem/Pelx/Interfaces/AI1B201" },
          "Line2ToNeutral": { "@odata.id": "/redfish/v1/Oem/Pelx/Interfaces/AI1B202" },
          "Line3ToNeutral": { "@odata.id": "/redfish/v1/Oem/Pelx/Interfaces/AI1B203" }
        },
        "PolyPhaseCurrentAmps": {
          "Line1": { "@odata.id": "/redfish/v1/Oem/Pelx/Interfaces/AI1B401" },
          "Line2": { "@odata.id": "/redfish/v1/Oem/Pelx/Interfaces/AI1B402" },
          "Line3": { "@odata.id": "/redfish/v1/Oem/Pelx/Interfaces/AI1B403" }
        },
        "PolyPhasePowerWatts": {
          "Line1ToNeutral": { "@odata.id": "/redfish/v1/Oem/Pelx/Interfaces/CAI1B501" }
        }
      }
    }
  }
}

介面 alias 對照（INFEED3P 每相元素）：

欄位說明如下:

• id（路徑參數）: 進線路數；單相對應 INFEED.elements.id，三相整體進線固定 1
• @odata.id: 進線電路資源 URI，如 /redfish/v1/PowerEquipment/RackPDUs/1/Mains/1
• @odata.type: 資源型別，固定 #Circuit.v1_8_1.Circuit
• Id: 資源識別碼，與路徑參數 {mainId} 相同
• Name: 顯示名稱；單相如 Infeed1，三相如 Main Input
• CircuitType: 電路類型，進線固定 Mains（OCP AC Mains use case）
• UserLabel: 使用者標籤（OCP Mandatory，可寫入）
• ElectricalContext: 電氣上下文（OCP Mandatory），進線總量為 Total
• VoltageType: 電壓類型，如 AC
• PhaseWiringType: 相線接線類型（OCP Mandatory）；單相 OnePhase3Wire，三相 ThreePhase4Wire 或 ThreePhase5Wire（依機型中性線配置）
• RatedCurrentAmps: 額定電流（A），額定電流設定
• PowerState: 進線供電狀態，On 或 Off
• NominalVoltage: 額定電壓類型（DMTF NominalVoltageType 字串列舉，如 AC230V、AC100To240V）；由即時讀值或機型預設推斷，非量測 excerpt 物件
• Voltage: 單相即時電壓（OCP Conditional：無 PolyPhaseVoltage 時 Mandatory）；三相機型省略
  • DataSourceUri: 須指向 Chassis/{chassisId}/Sensors/{sensorId}
• CurrentAmps: 單相電流量測（OCP Conditional：無 PolyPhaseCurrentAmps 時 Mandatory）；三相機型省略
• PolyPhaseVoltage: 三相線對中性點／線間電壓（OCP Conditional：無 Voltage 時 Mandatory）；子鍵為 Line1ToNeutral、Line2ToNeutral、Line3ToNeutral 等
• PolyPhaseCurrentAmps: 三相各相電流（OCP Conditional：無 CurrentAmps 時 Mandatory）；子鍵為 Line1、Line2、Line3
• PolyPhasePowerWatts: 各相有功功率（OCP Recommended）；子鍵為 Line1ToNeutral 等
• PolyPhaseEnergykWh: 各相累計能耗（OCP Recommended）；若僅回報總量可省略，改以 EnergykWh 表示
• PowerWatts: 有功功率總量（OCP Mandatory）；三相為各相 AP 彙總或晶片總功率
• EnergykWh: 累計能耗總量（OCP Mandatory）
• FrequencyHz: 頻率（OCP Recommended）；三相通常取 L1 之 FREQ
• Links: 電路關聯（OCP Recommended）
  • PowerOutlet / Outlets: 此進線供電之插座列表（OCP Mains 建議 PowerOutlet；DMTF 亦支援 Outlets）
  • DistributionCircuits: 下層分支／配電電路（OCP Recommended）
• Actions.#Circuit.ResetMetrics: 重設進線能耗計數（OCP Recommended）；見下方 POST 章節
• Status: 運作與健康狀態物件
  • State: 運作狀態，固定 Enabled
  • Health: 健康狀態，由相關介面 status 彙整
• Oem: 廠商擴充欄位容器
  • Pelx: Pelx OEM 命名空間
    • ElementId: 週邊路數（單相 INFEED）；三相整體進線可省略或標示主相
    • Alias: 週邊別名；單相 INFEED，三相 INFEED3P
    • Synthetic: true 表示無實體進線之合成資源（如 DPB）
    • Interfaces: 各量測對應之 Pelx 介面資源連結（單相 INFEED）
    • InterfaceGroups: 三相巢狀量測對照（INFEED3P）；結構與 PolyPhaseVoltage 等欄位對應
• 若機型無某量測（如瓦時），該欄位省略

回傳資料狀態

POST https://

重設進線能耗計數。重設該插座能耗計數。

請求 body 可為空物件 {}。

回傳資料狀態

GET https://

分支電路集合（OCP Mandatory；無實體分支時 Members 為空陣列）。

{
  "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Branches",
  "@odata.type": "#CircuitCollection.CircuitCollection",
  "Members": [
    { "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Branches/1" }
  ],
  "Members@odata.count": 1
}

無分支時 Members 為 []，Members@odata.count 為 0。

欄位說明如下:

• @odata.id: 分支集合 URI，固定 .../RackPDUs/{rackId}/Branches
• Members: 分支電路連結陣列；無分支時為 []
• Members@odata.count: 分支數量

回傳資料狀態

GET https://

分支電路（CircuitType: Branch）。若無分支進線 且無分支，集合為空。

{
  "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Branches/1",
  "@odata.type": "#Circuit.v1_8_1.Circuit",
  "Id": "1",
  "Name": "Branch1",
  "UserLabel": "Branch 1",
  "CircuitType": "Branch",
  "ElectricalContext": "Line1",
  "NominalVoltage": "AC230V",
  "VoltageType": "AC",
  "PhaseWiringType": "OnePhase3Wire",
  "CurrentAmps": {
    "Reading": 8.2,
    "DataSourceUri": "/redfish/v1/Chassis/1/Sensors/Branch1Current"
  },
  "PowerWatts": {
    "Reading": 1804.0,
    "DataSourceUri": "/redfish/v1/Chassis/1/Sensors/Branch1Power"
  },
  "Links": {
    "SourceCircuit": {
      "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Mains/1"
    },
    "Outlets": [
      { "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Outlets/1" },
      { "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Outlets/2" }
    ]
  },
  "Status": {
    "State": "Enabled",
    "Health": "OK"
  },
  "Oem": {
    "Pelx": {
      "@odata.type": "#Pelx.v1_0_0.Pelx",
      "ElementId": 1,
      "Alias": "BRANCH",
      "Interfaces": {
        "CurrentAmps": { "@odata.id": "/redfish/v1/Oem/Pelx/Interfaces/AI2203" },
        "PowerWatts": { "@odata.id": "/redfish/v1/Oem/Pelx/Interfaces/CAI2205" }
      }
    }
  }
}

欄位說明如下:

• id（路徑參數）: 分支路數
• @odata.id: 分支電路資源 URI，如 /redfish/v1/PowerEquipment/RackPDUs/1/Branches/1
• @odata.type: 資源型別，固定 #Circuit.v1_8_1.Circuit
• Id: 資源識別碼，與路徑參數 {id} 相同
• Name: 顯示名稱，如 Branch1
• CircuitType: 電路類型，固定 Branch 或 Bus（OCP Branches use case）
• UserLabel: 使用者標籤（OCP Mandatory，可寫入）
• ElectricalContext: 電氣上下文；分支 1／2／3 分別為 Line1／Line2／Line3
• Links: 電路關聯（OCP Branches use case）
  • SourceCircuit: 上層進線電路
  • Outlets: 此分支下屬插座列表
• CurrentAmps: 電流量測物件
  • Reading: 分支電流（A）
  • DataSourceUri: 電流感測器資源 URI
• PowerWatts: 功率量測物件
  • Reading: 分支功率（W）
  • DataSourceUri: 功率感測器資源 URI
• Status: 運作與健康狀態物件
  • State: 運作狀態，固定 Enabled
  • Health: 健康狀態，由相關介面 status 彙整
• Oem: 廠商擴充欄位容器
  • Pelx: Pelx OEM 命名空間
    • ElementId: 週邊路數
    • Alias: 週邊別名，通常為 BRANCH
    • Interfaces: 各量測對應之 Pelx 介面資源連結

回傳資料狀態

GET https://

列出本 Rack PDU 下所有感測器資源（DSP2056 配電路徑）。成員與 Chassis/1/Sensors 相同；OCP Interop Validator 驗證 Chassis/.../Sensors，DataSourceUri 須使用 Chassis URI。

{
  "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Sensors",
  "@odata.type": "#SensorCollection.SensorCollection",
  "Members": [
    { "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Sensors/CurrentA" },
    { "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Sensors/PowerA" },
    { "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Sensors/EnergyA" },
    { "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Sensors/Outlet1Current" }
  ],
  "Members@odata.count": 4
}

欄位說明如下:

• @odata.id: 感測器集合 URI，固定 .../RackPDUs/{rackId}/Sensors
• @odata.type: 資源型別，固定 #SensorCollection.SensorCollection
• Members: 感測器資源連結陣列
  • @odata.id: 單一感測器 URI；{id} 見下節命名規則
• Members@odata.count: 感測器數量

回傳資料狀態

Sensor {id} 定義

一筆 Sensor = 一個可讀取的 AI／CAI 量測介面（可讀取之量測介面），來源週邊限於 Rack PDU 配電範圍：

不納入 Sensor 集合者：DI／DO 狀態位、其餘週邊（改走 Oem/Pelx/Interfaces）。TEMPRH 溫度同時出現在 Chassis/1/Sensors/Temp{n} 與 ThermalSubsystem/ThermalMetrics；濕度等若無標準欄位請查 Oem/Pelx/Interfaces。

{id} 命名規則（字串，URI 區分大小寫）：

{週邊縮寫}{路數}{量測別名}

常見 {id} 範例（依 Mains／Outlets 內 DataSourceUri 與 Oem.Pelx.Interfaces 互相對照）：

整合方應以 GET .../Chassis/1/Sensors 的 Members（OCP）或 GET .../RackPDUs/.../Sensors（DSP2056）取得有效 {id}，並以 Mains／Outlets 的 DataSourceUri 交叉對照。

與 DSP2056 一致：Mains／Outlets 上可內嵌 Reading 做快速瀏覽；Sensors/{id} 提供完整 Reading、Thresholds 與 Status，供監控系統深入輪詢。

GET https://

單一感測器讀值與閾值。{sensorId} 見上節。{rackId} 為 Rack PDU 路徑參數。

{
  "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/{rackId}/Sensors/{sensorId}",
  "@odata.type": "#Sensor.v1_9_0.Sensor",
  "Id": "{sensorId}",
  "Name": "Infeed1 Voltage",
  "Reading": 220.4,
  "ReadingUnits": "V",
  "ReadingType": "Voltage",
  "ElectricalContext": "Line1ToNeutral",
  "ReadingTime": "2026-06-15T10:00:05+08:00",
  "SensingInterval": "PT5S",
  "Status": {
    "State": "Enabled",
    "Health": "OK"
  },
  "Thresholds": {
    "UpperCritical": { "Reading": 250 },
    "UpperCaution": { "Reading": 240 },
    "LowerCaution": { "Reading": 200 },
    "LowerCritical": { "Reading": 190 }
  },
  "Oem": {
    "Pelx": {
      "@odata.type": "#Pelx.v1_0_0.Pelx",
      "Interface": {
        "@odata.id": "/redfish/v1/Oem/Pelx/Interfaces/AI2101"
      }
    }
  }
}

欄位說明如下:

• id（路徑參數）: 感測器識別碼（如 VoltageA）
• @odata.id: 感測器資源 URI，如 /redfish/v1/PowerEquipment/RackPDUs/1/Sensors/VoltageA
• @odata.type: 資源型別，固定 #Sensor.v1_9_0.Sensor
• Id: 資源識別碼，與路徑參數 {id} 相同
• Name: 顯示名稱，如 Infeed1 Voltage
• Reading: 即時讀值，對應 interfaces 的 value
• ReadingUnits: 單位（如 V、A、W、kWh）
• ReadingType: 量測類型（如 Voltage、Current、Power、Energy）
• ElectricalContext: 電氣上下文（OCP 電氣感測器 Mandatory）
• ReadingTime: 讀值時間 ISO 8601（OCP Mandatory）
• SensingInterval: 取樣間隔 ISO 8601 duration（OCP Mandatory），如 PT5S
• Status: 運作與健康狀態物件
  • State: 運作狀態，固定 Enabled
  • Health: 健康狀態，由對應介面 status 轉換
• Thresholds: 閾值物件，對應 interfaces 的 params
  • UpperCritical: 過高異常閾值物件
    • Reading: 閾值數值（過高異常閾值）
  • UpperCaution: 過高警告閾值物件
    • Reading: 閾值數值（過高警告閾值）
  • LowerCaution: 過低警告閾值物件
    • Reading: 閾值數值（過低警告閾值）
  • LowerCritical: 過低異常閾值物件
    • Reading: 閾值數值（過低異常閾值）
• Oem: 廠商擴充欄位容器
  • Pelx: Pelx OEM 命名空間
    • Interface: 對應之 Pelx 介面資源連結（/redfish/v1/Oem/Pelx/Interfaces/{addr}）

回傳資料狀態

ATS 轉換開關（TransferSwitches）

Redfish 標準以 Transfer Switch 表示 ATS（非字串 ATS）。僅當設備支援 ATS 時提供下列資源；否則 GET .../TransferSwitches 回傳空集合 Members: []。

權限：預設見 認證（控制 Action 與寫入至少 Operator）。

GET https://

{
  "@odata.id": "/redfish/v1/PowerEquipment/TransferSwitches",
  "@odata.type": "#PowerDistributionCollection.PowerDistributionCollection",
  "Members": [
    { "@odata.id": "/redfish/v1/PowerEquipment/TransferSwitches/1" }
  ],
  "Members@odata.count": 1
}

無 ATS 時 Members 為空陣列，Members@odata.count 為 0。

欄位說明如下:

• @odata.id: ATS 集合資源 URI，固定 /redfish/v1/PowerEquipment/TransferSwitches
• @odata.type: 資源型別，固定 #PowerDistributionCollection.PowerDistributionCollection
• Members: ATS 資源連結陣列，元素為 { "@odata.id": "..." }
  • @odata.id: 單一 ATS 資源 URI，如 /redfish/v1/PowerEquipment/TransferSwitches/1
• Members@odata.count: Members 陣列筆數；有 ATS 時通常為 1

回傳資料狀態

GET https://

ATS 主資源。路徑參數 {atsId} 通常為 1；應自 Members 探索，無效 id 回 404。

本回應是否要有 A、B 廻路資料？ 依 DSP2056 與一般 PDU 實作：

亦即：主資源只回答「現在走 A 還是 B、切換設定為何」；兩路詳細讀值需再請求 Feeders 子資源。你實機 Postman 看到的結構（ActiveMainsId: "A" + Feeders 連結、無內嵌 V/Hz）符合設計。

使用者怎麼知道要打 .../Feeders/B？ Redfish 不應猜 URL，依 @odata.id 連結逐層探索：

① GET /redfish/v1/PowerEquipment
      → 若有 TransferSwitches，取 TransferSwitches.@odata.id

② GET .../TransferSwitches          （或 ① 已含 Members）
      → Members[].@odata.id → .../TransferSwitches/1

③ GET .../TransferSwitches/1
      → Feeders.@odata.id → .../TransferSwitches/1/Feeders
      → TransferConfiguration.ActiveMainsId → 目前 "A" 或 "B"（僅狀態，非完整 URI）

④ GET .../TransferSwitches/1/Feeders
      → Members[] 列出每一廻路完整 URI，例如：
         .../Feeders/A
         .../Feeders/B

⑤ GET Members 中的 @odata.id        （整合程式對 Members 逐筆 GET 即可）

整合程式只需跟著 JSON 裡的 @odata.id 走，不必事先知道廻路叫 A/B 還是數字。若略過 ④ 直接猜 Feeders/1，會得到 404。

{
  "@odata.id": "/redfish/v1/PowerEquipment/TransferSwitches/1",
  "@odata.type": "#PowerDistribution.v1_4_0.PowerDistribution",
  "Id": "1",
  "Name": "ATS",
  "EquipmentType": "AutomaticTransferSwitch",
  "Manufacturer": "Pelx",
  "Model": "ZDL-2A-12Z",
  "Status": {
    "State": "Enabled",
    "Health": "OK"
  },
  "Feeders": {
    "@odata.id": "/redfish/v1/PowerEquipment/TransferSwitches/1/Feeders"
  },
  "Mains": {
    "@odata.id": "/redfish/v1/PowerEquipment/TransferSwitches/1/Mains"
  },
  "TransferConfiguration": {
    "ActiveMainsId": "A",
    "AutoTransferEnabled": true,
    "TransferSensitivity": "Medium"
  },
  "Oem": {
    "Pelx": {
      "AtsKind": 1,
      "Parameters": {
        "@odata.id": "/redfish/v1/PowerEquipment/TransferSwitches/1/Oem/Pelx/Parameters"
      }
    }
  }
}

欄位說明如下:

• atsId（路徑參數）: ATS 資源識別碼；有 ATS 時通常為 1
• @odata.id: ATS 資源 URI，如 /redfish/v1/PowerEquipment/TransferSwitches/1
• @odata.type: 資源型別，固定 #PowerDistribution.v1_4_0.PowerDistribution
• Id: 資源識別碼，與路徑參數 {atsId} 相同
• Name: 顯示名稱，固定 ATS
• EquipmentType: 設備類型，固定 AutomaticTransferSwitch（自動轉換開關）
• Manufacturer: 製造商，製造商識別
• Model: 型號，設備型號
• Status: 運作與健康狀態物件
  • State: 運作狀態，固定 Enabled
  • Health: 健康狀態，由 ATS 廻路與告警彙整
• Feeders: 輸入廻路集合連結物件（A／B 源）
  • @odata.id: 廻路列表 URI（.../Feeders）；GET .../Feeders/A、.../Feeders/B
• Mains: 輸出側電路集合連結物件（ATS 切換後輸出）
  • @odata.id: 輸出列表 URI（.../Mains）；GET .../Mains/1
• TransferConfiguration: ATS 切換組態（對應 DSP2056）；本資源內表示 A/B 的唯一即時欄位為 ActiveMainsId
  • ActiveMainsId: 目前供電廻路，A 或 B
  • AutoTransferEnabled: 是否啟用自動切換
  • TransferSensitivity: 切換靈敏度，High / Medium / Low
• Oem: 廠商擴充欄位容器
  • Pelx: Pelx OEM 命名空間
    • AtsKind: ATS 種類，ATS 種類（1=110V、2=220V）
    • Parameters: ATS 參數資源連結物件
      • @odata.id: 完整參數 URI

回傳資料狀態

GET https://

列出 ATS 兩路輸入源。廻路識別碼為 A、B（字串），不是數字 1、2。

{
  "@odata.id": "/redfish/v1/PowerEquipment/TransferSwitches/1/Feeders",
  "@odata.type": "#CircuitCollection.CircuitCollection",
  "Members": [
    { "@odata.id": "/redfish/v1/PowerEquipment/TransferSwitches/1/Feeders/A" },
    { "@odata.id": "/redfish/v1/PowerEquipment/TransferSwitches/1/Feeders/B" }
  ],
  "Members@odata.count": 2
}

欄位說明如下:

• atsId（路徑參數）: ATS 資源識別碼，通常為 1
• @odata.id: 廻路集合 URI，如 .../TransferSwitches/1/Feeders
• @odata.type: 資源型別，固定 #CircuitCollection.CircuitCollection
• Members: 輸入廻路連結陣列，固定兩筆 A、B
  • @odata.id: 單一廻路 URI；.../Feeders/A 或 .../Feeders/B
• Members@odata.count: 固定 2

回傳資料狀態

GET https://

輸入廻路量測。feederId 僅允許 A 或 B。

常見誤用：GET .../Feeders/1 或 .../Feeders/2 會回 404——廻路不是用數字路數編號，請改請求 .../Feeders/A、.../Feeders/B，或先 GET .../Feeders 從 Members 取得 URI。

{
  "@odata.id": "/redfish/v1/PowerEquipment/TransferSwitches/1/Feeders/A",
  "@odata.type": "#Circuit.v1_8_1.Circuit",
  "Id": "A",
  "Name": "Source A",
  "CircuitType": "Mains",
  "NominalVoltage": {
    "Reading": 110.2
  },
  "FrequencyHz": {
    "Reading": 60.0
  },
  "Status": {
    "State": "Enabled",
    "Health": "OK"
  },
  "Oem": {
    "Pelx": {
      "Alias": "ATS",
      "Links": {
        "Interfaces": {
          "Voltage": { "@odata.id": "/redfish/v1/Oem/Pelx/Interfaces/AI0E201" },
          "FrequencyHz": { "@odata.id": "/redfish/v1/Oem/Pelx/Interfaces/AI0E301" },
          "Present": { "@odata.id": "/redfish/v1/Oem/Pelx/Interfaces/DI0E401" }
        }
      }
    }
  }
}

欄位說明如下:

• atsId（路徑參數）: ATS 資源識別碼
• feederId（路徑參數）: 廻路識別碼，僅 A 或 B（非 1／2）
• @odata.id: 廻路電路資源 URI，如 .../Feeders/A
• @odata.type: 資源型別，固定 #Circuit.v1_8_1.Circuit
• Id: 資源識別碼，與 feederId 相同
• Name: 顯示名稱，如 Source A
• CircuitType: 電路類型，輸入廻路固定 Mains（DSP2056 對 Transfer Switch 之輸入源）
• NominalVoltage: 電壓量測物件
  • Reading: 廻路電壓（V），對應 ATAV（A）或 ATBV（B）
• FrequencyHz: 頻率量測物件
  • Reading: 廻路頻率（Hz），對應 ATAF（A）或 ATBF（B）
• Status: 運作與健康狀態物件
  • State: 運作狀態
  • Health: 健康狀態；廻路有電／電壓頻率告警由 ATAI、ATAVH 等 DI 彙整
• Oem: 廠商擴充欄位容器
  • Pelx: Pelx OEM 命名空間
    • Alias: 週邊別名，固定 ATS
    • Interfaces: 各量測對應之 Pelx 介面資源連結（/redfish/v1/Oem/Pelx/Interfaces/{addr}）
      • Voltage: 電壓介面
      • FrequencyHz: 頻率介面
      • Present: 有電狀態介面（ATAI / ATBI）

回傳資料狀態

ATS 切換參數。

{
  "@odata.id": "/redfish/v1/PowerEquipment/TransferSwitches/1/Oem/Pelx/Parameters",
  "@odata.type": "#Pelx.AtsParameters",
  "Id": "Parameters",
  "brownOutHighA": 120,
  "brownOutHighB": 120,
  "brownOutLowA": 100,
  "brownOutLowB": 80,
  "frequencyHighA": 65,
  "frequencyHighB": 65,
  "frequencyLowA": 55,
  "frequencyLowB": 55,
  "frequencyNominal": 60,
  "frequencyTolerance": 5,
  "voltageNominal": 110,
  "voltageTolerance": 10
}

欄位說明如下:

• id（路徑參數）: ATS 資源識別碼
• @odata.id: 參數資源 URI
• brownOutHighA / brownOutHighB: A／B 廻路過高電壓閾值（V）
• brownOutLowA / brownOutLowB: A／B 廻路過低電壓閾值（V）
• frequencyHighA / frequencyHighB: A／B 廻路過高頻率閾值（Hz）
• frequencyLowA / frequencyLowB: A／B 廻路過低頻率閾值（Hz）
• frequencyNominal: 基準頻率（Hz）
• frequencyTolerance: 頻率容許範圍（Hz）
• voltageNominal: 基準電壓（V）；110V 系統可為 100／110／120，220V 系統可為 200／210／220／230
• voltageTolerance: 電壓容許範圍；110V：10–23，220V：15–25

回傳資料狀態

PATCH https://

設定 ATS 參數。；可部分更新。

{
  "voltageNominal": 110,
  "voltageTolerance": 10,
  "frequencyTolerance": 5
}

欄位說明如下:

• id（路徑參數）: ATS 資源識別碼
• voltageNominal: 基準電壓，合法值依 ATS 機型 見上節
• voltageTolerance: 電壓容許範圍
• frequencyTolerance: 頻率容許範圍（3–10）

回傳資料狀態

插座（Outlets）

依 DSP2056，所有插座集中於單一 Outlets 集合，無需先查分支電路即可定位。

權限：預設見 認證（GET ReadOnly 以上；控制 Action 與寫入至少 Operator）。

GET https://

{
  "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Outlets",
  "@odata.type": "#OutletCollection.OutletCollection",
  "Members": [
    { "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Outlets/1" },
    { "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Outlets/2" }
  ],
  "Members@odata.count": 2
}

欄位說明如下:

• @odata.id: 插座集合資源 URI，固定 /redfish/v1/PowerEquipment/RackPDUs/1/Outlets
• @odata.type: 資源型別，固定 #OutletCollection.OutletCollection
• Members: 插座資源連結陣列，元素為 { "@odata.id": "..." }
  • @odata.id: 單一插座資源 URI，如 /redfish/v1/PowerEquipment/RackPDUs/1/Outlets/1
• Members@odata.count: Members 陣列筆數，插座數量，插座總數

回傳資料狀態

GET https://

單路插座詳細資料。id 對應插座路數。

{
  "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Outlets/1",
  "@odata.type": "#Outlet.v1_4_4.Outlet",
  "Id": "1",
  "Name": "Outlet1",
  "UserLabel": "Server-1",
  "OutletType": "NEMA_5_20R",
  "ElectricalContext": "Line1",
  "NominalVoltage": {
    "Reading": 220
  },
  "VoltageType": "AC",
  "PhaseWiringType": "OnePhase3Wire",
  "RatedCurrentAmps": 20,
  "PowerState": "On",
  "PowerEnabled": true,
  "PowerRestorePolicy": "AlwaysOn",
  "Voltage": {
    "Reading": 220.1,
    "DataSourceUri": "/redfish/v1/Chassis/1/Sensors/Outlet1Voltage"
  },
  "CurrentAmps": {
    "Reading": 4.2,
    "DataSourceUri": "/redfish/v1/Chassis/1/Sensors/Outlet1Current"
  },
  "PowerWatts": {
    "Reading": 924.4,
    "DataSourceUri": "/redfish/v1/Chassis/1/Sensors/Outlet1Power"
  },
  "EnergykWh": {
    "Reading": 128.5,
    "DataSourceUri": "/redfish/v1/Chassis/1/Sensors/Outlet1Energy"
  },
  "Status": {
    "State": "Enabled",
    "Health": "OK"
  },
  "Links": {
    "BranchCircuit": {
      "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Branches/1"
    }
  },
  "Actions": {
    "#Outlet.PowerControl": {
      "target": "/redfish/v1/PowerEquipment/RackPDUs/1/Outlets/1/Actions/Outlet.PowerControl",
      "@Redfish.ActionInfo": "/redfish/v1/PowerEquipment/RackPDUs/1/Outlets/1/Outlet.PowerControlActionInfo"
    },
    "#Outlet.ResetMetrics": {
      "target": "/redfish/v1/PowerEquipment/RackPDUs/1/Outlets/1/Actions/Outlet.ResetMetrics"
    }
  },
  "Oem": {
    "Pelx": {
      "@odata.type": "#Pelx.v1_0_0.Pelx",
      "ElementId": 1,
      "Alias": "OUTLET",
      "Interfaces": {
        "PowerState": { "@odata.id": "/redfish/v1/Oem/Pelx/Interfaces/DO00101" },
        "Voltage": { "@odata.id": "/redfish/v1/Oem/Pelx/Interfaces/AI00101" },
        "CurrentAmps": { "@odata.id": "/redfish/v1/Oem/Pelx/Interfaces/AI00102" },
        "PowerWatts": { "@odata.id": "/redfish/v1/Oem/Pelx/Interfaces/AI00103" },
        "EnergykWh": { "@odata.id": "/redfish/v1/Oem/Pelx/Interfaces/CAI00104" }
      }
    }
  }
}

欄位說明如下:

• id（路徑參數）: 插座路數，對應插座路數
• @odata.id: 插座資源 URI，如 /redfish/v1/PowerEquipment/RackPDUs/1/Outlets/1
• @odata.type: 資源型別，固定 #Outlet.v1_4_4.Outlet
• Id: 資源識別碼，與路徑參數 {id} 相同
• Name: 顯示名稱，如 Outlet1
• UserLabel: 使用者標籤（OCP Recommended，可寫入）
• OutletType: 插座實體規格（如 NEMA_5_20R），依產品規格填入
• ElectricalContext: 電氣上下文（OCP Mandatory）；依插座所屬相別為 Line1、Line2 或 Line3（由 relayBoardMap 推斷；預設 Line1）
• NominalVoltage: 額定電壓
• VoltageType: 電壓類型，如 AC
• PhaseWiringType: 相線接線類型
• RatedCurrentAmps: 額定電流（A）
• PowerRestorePolicy: 斷電恢復策略（OCP Mandatory），AlwaysOn / AlwaysOff / LastState
• PowerState: 目前電源狀態（讀取）；僅 On 或 Off，由 DO 介面 value 轉換（true → On）。不含 PowerCycle——重啟為控制指令，見 POST .../Outlet.PowerControl
• PowerEnabled: 插座輸出是否啟用，true 表示允許供電
• Voltage / CurrentAmps / PowerWatts / EnergykWh: 量測物件（OCP Recommended）
  • Reading: 即時讀值
  • DataSourceUri: 須指向 Chassis/{chassisId}/Sensors/{sensorId}（OCP Profile）
• Status: 運作與健康狀態物件
  • State: 運作狀態，固定 Enabled
  • Health: 健康狀態，由相關介面 status 彙整
• Links: 關聯資源連結物件
  • BranchCircuit: 所屬分支電路（OCP Mandatory）
    • @odata.id: 分支 URI；無實體分支時指向對應 Mains/{mainId}（OCP Usage Guide）
• Actions: 可執行操作物件
  • #Outlet.PowerControl: 電源控制；須含 @Redfish.ActionInfo 指向 ActionInfo 資源
  • #Outlet.ResetMetrics: 重設插座能耗計數（OCP Recommended）
• Oem: 廠商擴充欄位容器
  • Pelx: Pelx OEM 命名空間
    • ElementId: 週邊路數
    • Alias: 週邊別名，通常為 OUTLET
    • Interfaces: 各量測／控制對應之 Pelx 介面資源連結（/redfish/v1/Oem/Pelx/Interfaces/{addr}）
      • PowerState: DO 輸出控制介面（DO…）；Outlet.PowerControl
      • Voltage / CurrentAmps / PowerWatts / EnergykWh: 量測介面連結
• 若機型無某量測，該欄位省略

回傳資料狀態

GET https://

Outlet.PowerControl 的參數定義（Interop Validator Mandatory 驗證 PowerState 允許值）。每個插座各有一筆 ActionInfo，URI 在對應 Outlet 路徑下（非 RackPDU 根層）。

{
  "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Outlets/1/Outlet.PowerControlActionInfo",
  "@odata.type": "#ActionInfo.v1_4_2.ActionInfo",
  "Id": "OutletPowerControlActionInfo",
  "Name": "Outlet Power Control Action Info",
  "Parameters": [
    {
      "Name": "PowerState",
      "Required": true,
      "DataType": "String",
      "AllowableValues": ["On", "Off", "PowerCycle"]
    }
  ]
}

POST https://

控制插座電源。。

{
  "PowerState": "On"
}

PowerState 可選值：

可選延遲參數（對應 onDelay / offDelay）：

{
  "PowerState": "On",
  "Oem": {
    "Pelx": {
      "OnDelaySec": 10,
      "OffDelaySec": 10
    }
  }
}

欄位說明如下:

• id（路徑參數）: 插座路數，對應 Outlets/{id}
• PowerState: 目標電源狀態，On / Off / PowerCycle（重啟），見上表
• Oem: 廠商擴充欄位容器（可選）
  • Pelx: Pelx OEM 命名空間
    • OnDelaySec: 開啟延遲（秒），即 OnDelaySec
    • OffDelaySec: 關閉延遲（秒），即 OffDelaySec

回傳資料狀態

POST https://

重設插座能耗計數。重設該插座能耗計數。

請求 body 可為空物件 {}。

回傳資料狀態

插座群組（OutletGroups）

DMTF DSP2056 標準資源。依資料庫群組定義，一次控制多個插座。路徑固定於 RackPDUs/1/OutletGroups（非 OCP Rack PDU Profile 必填）。

權限：預設見 認證（控制 Action 與寫入至少 Operator）。

GET https://

{
  "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/OutletGroups",
  "Members": [
    { "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/OutletGroups/1" }
  ],
  "Members@odata.count": 1
}

集合回應目前未含 @odata.type。

GET https://

{
  "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/OutletGroups/1",
  "@odata.type": "#OutletGroup.v1_2_0.OutletGroup",
  "Id": "1",
  "Name": "Group A",
  "PowerState": "On",
  "Status": { "State": "Enabled", "Health": "OK" },
  "Links": {
    "Outlets": [
      { "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Outlets/1" },
      { "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Outlets/2" }
    ]
  },
  "Actions": {
    "#OutletGroup.PowerControl": {
      "target": "/redfish/v1/PowerEquipment/RackPDUs/1/OutletGroups/1/Actions/OutletGroup.PowerControl"
    }
  },
  "Oem": { "Pelx": { "uId": 1 } }
}

• PowerState：群組內任一插座為 Off 時為 Off，否則為 On
• Links.Outlets：群組成員插座連結
• Actions.#OutletGroup.PowerControl：批次電源控制（參數同 Outlet.PowerControl）

POST https://

對群組內所有插座執行電源控制。請求 body 同 Outlet.PowerControl。

回傳資料狀態

環境感測（Thermal）

環境溫度資料來源為溫濕度感測週邊。OCP Baseline 與 DMTF Service Validator 以 ThermalSubsystem／ThermalMetrics 為主路徑；Chassis/1/Thermal 仍保留相容舊整合，但 Chassis 資源已不再連結 Thermal。

GET https://

熱管理子系統（OCP Baseline Mandatory）。

{
  "@odata.id": "/redfish/v1/Chassis/1/ThermalSubsystem",
  "@odata.type": "#ThermalSubsystem.v1_3_0.ThermalSubsystem",
  "Id": "ThermalSubsystem",
  "Name": "Thermal Subsystem",
  "Status": {
    "State": "Enabled",
    "Health": "OK"
  },
  "Fans": {
    "@odata.id": "/redfish/v1/Chassis/1/ThermalSubsystem/Fans"
  },
  "ThermalMetrics": {
    "@odata.id": "/redfish/v1/Chassis/1/ThermalSubsystem/ThermalMetrics"
  }
}

欄位說明

• Fans: 風扇集合（本設備通常為空集合）
• ThermalMetrics: 溫度彙總與讀值連結

GET https://

溫度讀值與摘要（DMTF ThermalMetrics excerpt 格式）。

{
  "@odata.id": "/redfish/v1/Chassis/1/ThermalSubsystem/ThermalMetrics",
  "@odata.type": "#ThermalMetrics.v1_3_0.ThermalMetrics",
  "Id": "ThermalMetrics",
  "Name": "Thermal Metrics",
  "TemperatureReadingsCelsius": [
    {
      "DataSourceUri": "/redfish/v1/Chassis/1/Sensors/Temp1",
      "Reading": 26.5,
      "PhysicalContext": "Room"
    }
  ],
  "TemperatureSummaryCelsius": {
    "Ambient": {
      "Reading": 26.5,
      "DataSourceUri": "/redfish/v1/Chassis/1/Sensors/Temp1"
    }
  }
}

欄位說明

• TemperatureReadingsCelsius: 溫度讀值陣列（excerpt 格式）
  • DataSourceUri: 指向 Chassis/1/Sensors/Temp{n}（OCP Sensor 路徑）
  • Reading: 溫度（°C）
  • PhysicalContext: 物理情境，如 Room
• TemperatureSummaryCelsius: 摘要物件（非 AverageReading／MaxReading／MinReading）
  • Ambient: 第一個感測點讀值
  • Internal: 多感測點時為平均值（僅一點時省略）

EnvironmentMetrics 不含 TemperatureSummaryCelsius；溫度摘要僅在 ThermalMetrics 提供。

GET https://

溫度感測器與電氣 Sensor 共用 Chassis/1/Sensors 集合；{id} 為 Temp + TEMPRH.elements.id（如 Temp1）。

{
  "@odata.id": "/redfish/v1/Chassis/1/Sensors/Temp1",
  "@odata.type": "#Sensor.v1_9_0.Sensor",
  "Id": "Temp1",
  "Name": "Temp1 Temperature",
  "Reading": 26.5,
  "ReadingUnits": "C",
  "ReadingType": "Temperature",
  "ReadingTime": "2026-06-15T10:00:05+08:00",
  "SensingInterval": "PT5S",
  "Status": {
    "State": "Enabled",
    "Health": "OK"
  },
  "Oem": {
    "Pelx": {
      "@odata.type": "#Pelx.v1_0_0.Pelx",
      "Interface": {
        "@odata.id": "/redfish/v1/Oem/Pelx/Interfaces/AI00301"
      },
      "RackPduSensorUri": "/redfish/v1/PowerEquipment/RackPDUs/1/Sensors/Temp1"
    }
  }
}

GET https://

機箱環境彙總（可含進線功率 PowerWatts）；不含溫度摘要欄位。

GET https://

舊版 Thermal.v1_7_3 資源，仍可直接 GET 取得 Temperatures[] 與 ReadingCelsius。不含 Oem.Pelx 連結；新整合請改用 ThermalSubsystem／Sensors/Temp{n}。

{
  "@odata.id": "/redfish/v1/Chassis/1/Thermal",
  "@odata.type": "#Thermal.v1_7_3.Thermal",
  "Id": "Thermal",
  "Temperatures": [
    {
      "MemberId": "1",
      "Name": "Temp1",
      "ReadingCelsius": 26.5,
      "Status": {
        "State": "Enabled",
        "Health": "OK"
      }
    }
  ],
  "Fans": []
}

• 濕度等量測若無標準 Thermal／ThermalMetrics 欄位，請改查 Oem/Pelx/Interfaces

回傳資料狀態

告警與事件（EventService）

OCP Rack PDU Profile 要求提供 EventService；標準事件訂閱見 Subscriptions。Pelx 另提供 Events 作為目前告警快照（非 OCP 必填，見「Pelx 擴充」）。

若整合環境中設備無法被外部主動連線（防火牆／NAT），可採 DMTF OutboundConnection（設備主動 WebSocket 連至雲端）；見 outbound connection。告警推送仍建議用本章 Subscriptions。

GET https://

{
  "@odata.id": "/redfish/v1/EventService",
  "@odata.type": "#EventService.v1_11_0.EventService",
  "Id": "EventService",
  "ServiceEnabled": true,
  "DeliveryRetryAttempts": 3,
  "DeliveryRetryIntervalSeconds": 60,
  "RegistryPrefixes": [
    "Power",
    "SensorEvent",
    "Update"
  ],
  "Subscriptions": {
    "@odata.id": "/redfish/v1/EventService/Subscriptions"
  },
  "Events": {
    "@odata.id": "/redfish/v1/EventService/Events"
  }
}

欄位說明如下:

• @odata.id: EventService 資源 URI，固定 /redfish/v1/EventService
• @odata.type: 資源型別，固定 #EventService.v1_11_0.EventService
• Id: 資源識別碼，固定 EventService
• ServiceEnabled: 事件服務是否啟用（Baseline Mandatory）
• DeliveryRetryAttempts: 訂閱投遞重試次數（Baseline Mandatory）
• DeliveryRetryIntervalSeconds: 重試間隔秒數（Baseline Mandatory）
• RegistryPrefixes: 支援的 Registry 前綴（OCP Recommended）；PDU 建議含 Power、SensorEvent、Update
• Subscriptions: 事件訂閱集合（Baseline Mandatory）
• Events: 目前告警快照（Pelx 擴充；對應 interfaces/alarms）

回傳資料狀態

GET https://

{
  "@odata.id": "/redfish/v1/EventService/Subscriptions",
  "@odata.type": "#EventDestinationCollection.EventDestinationCollection",
  "Members": [],
  "Members@odata.count": 0
}

欄位說明如下:

• @odata.id: 訂閱集合 URI，固定 /redfish/v1/EventService/Subscriptions
• Members: 訂閱資源連結陣列；POST 此集合建立新訂閱
• Members@odata.count: 訂閱數量

回傳資料狀態

POST https://

建立事件訂閱。訂閱持久化於設備本機，重啟後自動載入。告警狀態變更時，設備會以 Redfish Event 格式 POST 至各訂閱的 Destination（依 DeliveryRetryAttempts／DeliveryRetryIntervalSeconds 重試）。若 Managers/1/NetworkProtocol.Proxy.Enabled 為 true 且 Destination 主機不在 ExcludeAddresses，投遞會經 HTTP/HTTPS 代理（與 OutboundConnection 共用設定）。

{
  "Destination": "https://example.com/redfish/events",
  "Protocol": "Redfish",
  "Context": "Pelx monitoring"
}

欄位說明如下:

• Destination: 事件接收 URL（Mandatory）；須為有效 http:// 或 https:// URL
• Protocol: 協定，預設 Redfish
• Context: 訂閱識別字串，預設 Pelx；會附在推送 payload 的 Context 欄位
• EventTypes: 可選；如 ["Alert"] 僅推送告警，["StatusChange"] 僅推送恢復／狀態變更；未指定則推送所有支援類型
• HttpHeaders: 可選；POST 至 Destination 時附加的 HTTP 標頭（如 Authorization）

成功時回 201 Created，Location 指向 /redfish/v1/EventService/Subscriptions/{id}。

回傳資料狀態

OEM 擴充（Pelx）— 訂閱與推送 payload

為兼容既有整合欄位，可在不改變標準 Subscriptions 路徑的前提下，於請求與事件內容加上 Oem.Pelx。此作法不影響 OCP Baseline 必填欄位。

建立訂閱（含 OEM 參數）範例：

{
  "Destination": "https://example.com/redfish/events",
  "Protocol": "Redfish",
  "Context": "Pelx monitoring",
  "Oem": {
    "Pelx": {
      "DeliveryMode": "EventOnly",
      "IncludeAlarmSeries": false,
      "IncludeInterfaceSnapshot": false
    }
  }
}

OEM 欄位建議如下:

• Oem: 廠商擴充欄位容器（可選）
  • Pelx: Pelx OEM 命名空間（可選）
    • DeliveryMode: 推送模式，建議值 EventOnly
    • IncludeAlarmSeries: 是否附帶趨勢摘要（布林）
    • IncludeInterfaceSnapshot: 是否附帶介面快照（布林）

若未指定 Oem.Pelx，推送 payload 仍含標準 Redfish Event 欄位；啟用 IncludeAlarmSeries／IncludeInterfaceSnapshot 時，於事件 payload 的 Oem.Pelx 附上 AlarmSeries 或 InterfaceSnapshot。

推送 payload 範例（POST 至 Destination）：

{
  "@odata.type": "#Event.v1_7_0.Event",
  "Name": "Event Array",
  "Context": "Pelx monitoring",
  "Events": [
    {
      "@odata.type": "#Event.v1_11_0.Event",
      "Id": "1",
      "Name": "High Warning",
      "EventType": "Alert",
      "Severity": "Warning",
      "Message": "Infeed1 V High Warning",
      "MessageId": "Pelx.1.0.highWarningAlarm",
      "EventTimestamp": "2026-06-10T08:30:00Z",
      "OriginOfCondition": {
        "@odata.id": "/redfish/v1/Oem/Pelx/Interfaces/AI2101"
      },
      "Oem": {
        "Pelx": {
          "@odata.type": "#Pelx.v1_0_0.Pelx",
          "Interface": {
            "@odata.id": "/redfish/v1/Oem/Pelx/Interfaces/AI2101"
          },
          "Name": "Infeed1",
          "Alias": "V",
          "Value": 241.2,
          "Unit": "V",
          "Status": "hw",
          "Seq": 1
        }
      }
    }
  ]
}

GET https://

查詢單一訂閱。

回傳資料狀態

DELETE https://

刪除訂閱。

回傳資料狀態

GET https://

目前告警快照（Pelx 擴充。

{
  "@odata.id": "/redfish/v1/EventService/Events",
  "Members": [
    {
      "@odata.id": "/redfish/v1/EventService/Events/1"
    }
  ],
  "Members@odata.count": 1
}

欄位說明如下:

• @odata.id: 事件集合資源 URI，固定 /redfish/v1/EventService/Events
• Members: 告警事件連結陣列，元素為 { "@odata.id": "..." }
  • @odata.id: 單一事件資源 URI，如 /redfish/v1/EventService/Events/1
• Members@odata.count: Members 陣列筆數，目前告警事件數量

回傳資料狀態

GET https://

{
  "@odata.id": "/redfish/v1/EventService/Events/1",
  "@odata.type": "#Event.v1_11_0.Event",
  "Id": "1",
  "Name": "High Warning",
  "EventType": "Alert",
  "Severity": "Warning",
  "Message": "Infeed1 Voltage high warning",
  "MessageId": "Pelx.1.0.VoltageHighWarning",
  "Created": "2026-06-10T08:30:00Z",
  "Oem": {
    "Pelx": {
      "@odata.type": "#Pelx.v1_0_0.Pelx",
      "Interface": {
        "@odata.id": "/redfish/v1/Oem/Pelx/Interfaces/AI2101"
      },
      "Name": "Infeed1",
      "Alias": "V",
      "Value": 241.2,
      "Unit": "V",
      "Status": "hw"
    }
  }
}

欄位說明如下:

• id（路徑參數）: 事件識別碼
• @odata.id: 事件資源 URI，如 /redfish/v1/EventService/Events/1
• @odata.type: 資源型別，固定 #Event.v1_11_0.Event
• Id: 資源識別碼，與路徑參數 {id} 相同
• Name: 事件顯示名稱，如 High Warning
• EventType: 事件類型，告警固定 Alert
• Severity: 嚴重程度，Warning 對應 GET /interfaces/alarms?kind=warnings；Critical 對應 kind=critical
• Message: 人可讀告警訊息
• MessageId: 告警訊息識別碼，如 Pelx.1.0.VoltageHighWarning
• Created: 事件時間（ISO 8601 UTC），如 2026-06-10T08:30:00Z
• Oem: 廠商擴充欄位容器
  • Pelx: Pelx OEM 命名空間
    • Interface: 觸發告警的 Pelx 介面資源連結
    • Name: 週邊名稱
    • Alias: 介面別名
    • Value: 觸發時讀值
    • Unit: 單位
    • Status: 介面狀態碼（如 hw、hc）

回傳資料狀態

OutboundConnection（出站 WebSocket 連線）

DMTF Redfish 2023.2 起新增 OutboundConnection schema（OutboundConnection.v1_0_2）：設備在防火牆或 NAT 後方時，可主動以 WebSocket（wss://） 連至外部服務（雲端 DCIM、事件閘道等），由遠端接收 Redfish 請求／回應，無須對設備開放 inbound 連線。

實作狀態：已實作（hwctrl）。REST 設定／憑證管理、WebSocket 出站連線、Session 與 Redfish over WebSocket 隧道轉發均已支援。若僅需事件推送，仍可使用 告警與事件 之 EventService/Subscriptions；高頻即時監控見 MQTT Discovery。

與其他推送機制的分工

資源路徑

OutboundConnection 掛於 AccountService 下（DMTF 慣例）：

/redfish/v1/AccountService
└── OutboundConnections/{id}     出站連線設定與狀態
    ├── Certificates               遠端伺服器憑證（MTLS 驗證用）
    └── ClientCertificates         設備端憑證（MTLS 用）

連線建立後，hwctrl 建立對應 Session 資源（Outbound-{id}）；Links.Session 指向該 Session。連線關閉時 Session 刪除。

Web UI 與 sysctrl 對應

詳見 modules/sysctrl/web.md。

使用限制

整合方與操作人員須注意下列限制（與 DMTF schema 不可變欄位及 Pelx id 保留策略有關）：

常見操作對照

GET https://

列出出站連線設定。須 Operator 以上。

{
  "@odata.id": "/redfish/v1/AccountService/OutboundConnections",
  "@odata.type": "#OutboundConnectionCollection.OutboundConnectionCollection",
  "Members": [],
  "Members@odata.count": 0
}

欄位說明如下:

• @odata.id: 集合 URI，固定 /redfish/v1/AccountService/OutboundConnections
• Members: 各 OutboundConnection 資源連結
• Members@odata.count: 連線設定數量

回傳資料狀態

POST https://

建立出站連線。須 Administrator。若 ConnectionEnabled 為 true，建立後即嘗試連線。

{
  "Name": "cloud-dcim",
  "Description": "Primary cloud gateway",
  "EndpointURI": "wss://dcim.example.com/redfish/ws",
  "Authentication": "MTLS",
  "ConnectionEnabled": true,
  "WebSocketPingIntervalMinutes": 5,
  "Roles": ["Operator"],
  "RetryPolicy": {
    "ConnectionRetryPolicy": "RetryForever",
    "RetryIntervalMinutes": 5
  },
  "PreUpgradeHTTPHeaders": {
    "Authorization": "Bearer <token>"
  }
}

請求欄位（requiredOnCreate 摘要）

• EndpointURI（必填）: 遠端 WebSocket URI；須為 wss://（RFC6455）
• Authentication（必填）: None｜MTLS｜JWT｜OEM
• Roles（必填）: 遠端客戶端在此連線上擁有的 Redfish 角色（如 Operator）；hwctrl 以第一個角色建立 Session
• WebSocketPingIntervalMinutes（必填）: WebSocket ping 間隔（分）；0 表示不送 ping
• ConnectionEnabled: 是否啟用；省略時預設 true
• PreUpgradeHTTPHeaders: WebSocket 升級前送出的 HTTP 標頭（如 JWT 的 Authorization: Bearer ...）；儲存於設定檔，GET 回應固定為空物件（不洩漏敏感標頭）
• RetryPolicy: 重連策略（None｜RetryForever｜RetryCount）及 RetryIntervalMinutes、RetryCount

成功時回 201 Created，Location 指向 /redfish/v1/AccountService/OutboundConnections/{id}。{id} 由伺服器自動分配，從 2 起（1 保留給 sysctrl／Web UI）。

回傳資料狀態

GET https://

查詢單一出站連線。

{
  "@odata.id": "/redfish/v1/AccountService/OutboundConnections/1",
  "@odata.type": "#OutboundConnection.v1_0_2.OutboundConnection",
  "Id": "1",
  "Name": "cloud-dcim",
  "Description": "Primary cloud gateway",
  "EndpointURI": "wss://dcim.example.com/redfish/ws",
  "Authentication": "MTLS",
  "ConnectionEnabled": true,
  "WebSocketPingIntervalMinutes": 5,
  "Roles": ["Operator"],
  "Status": {
    "State": "Enabled",
    "Health": "OK"
  },
  "RetryPolicy": {
    "ConnectionRetryPolicy": "RetryForever",
    "RetryIntervalMinutes": 5
  },
  "Certificates": {
    "@odata.id": "/redfish/v1/AccountService/OutboundConnections/1/Certificates"
  },
  "ClientCertificates": {
    "@odata.id": "/redfish/v1/AccountService/OutboundConnections/1/ClientCertificates"
  },
  "Links": {
    "Session": {
      "@odata.id": "/redfish/v1/SessionService/Sessions/Outbound-1"
    }
  },
  "PreUpgradeHTTPHeaders": {}
}

欄位說明如下:

• EndpointURI: 遠端 WebSocket 端點（唯讀；建立後不可改）
• Authentication: 認證機制（唯讀）
  • MTLS: 雙向 TLS；使用 Certificates／ClientCertificates 內 PEM
  • JWT: 以 PreUpgradeHTTPHeaders 帶 Bearer Token（握手時送出）
  • None: 不帶客戶端憑證；wss 時若未上傳 Certificates 則不驗證伺服器憑證
• ConnectionEnabled: 是否啟用；false 時關閉既有連線
• Roles: 遠端客戶端權限角色（唯讀）
• Status: 連線狀態（唯讀）
  • State: Enabled（ConnectionEnabled=true）或 Disabled
  • Health: 已連線為 OK；啟用但未連上為 Warning
• Links.Session: 作用中 WebSocket 對應的 Session（Outbound-{id}）；無連線時為 null
• Certificates／ClientCertificates: MTLS 憑證集合連結

回傳資料狀態

PATCH https://

更新可寫欄位。須 Administrator。變更後若連線已啟用，hwctrl 會重新套用設定（可能重連）。

可 PATCH 欄位：

• ConnectionEnabled: 啟用／停用連線
• WebSocketPingIntervalMinutes: ping 間隔
• RetryPolicy: 重連策略（RetryIntervalMinutes、RetryCount 等）
• Name／Description: 顯示名稱（Pelx 延伸）

EndpointURI、Authentication、Roles、PreUpgradeHTTPHeaders 建立後不可變更；須刪除後重建（id=1 見上方使用限制）。

回傳資料狀態

DELETE https://

刪除出站連線設定並關閉作用中連線。須 Administrator。

id=1 注意：可刪除，但 Redfish POST 無法再建立 id=1；Web UI 連線須改由 sysctrl PATCH /redfish-outbound 恢復。見使用限制。

回傳資料狀態

GET https://

列出遠端伺服器信任憑證（MTLS 驗證遠端用）。須 Operator 以上。

{
  "@odata.id": "/redfish/v1/AccountService/OutboundConnections/1/Certificates",
  "@odata.type": "#CertificateCollection.CertificateCollection",
  "Members": [
    { "@odata.id": "/redfish/v1/AccountService/OutboundConnections/1/Certificates/1" }
  ],
  "Members@odata.count": 1
}

POST https://

上傳信任憑證 PEM。須 Administrator。成功回 201 Created。

{
  "Name": "Remote CA",
  "CertificateType": "PEM",
  "CertificateString": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----"
}

上傳後若連線已啟用，hwctrl 會重連以套用新憑證。

GET https://

查詢單筆信任憑證（Certificate.v1_8_0）。須 Operator 以上。

{
  "@odata.id": "/redfish/v1/AccountService/OutboundConnections/1/Certificates/1",
  "@odata.type": "#Certificate.v1_8_0.Certificate",
  "Id": "1",
  "Name": "Remote CA",
  "CertificateType": "PEM",
  "CertificateString": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----",
  "Issuer": { "CommonName": "" },
  "Subject": { "CommonName": "" },
  "ValidNotBefore": "",
  "ValidNotAfter": ""
}

DELETE https://

刪除信任憑證。須 Administrator。回 204 No Content。

GET https://

列出設備客戶端憑證。須 Operator 以上。格式同 Certificates 集合。

POST https://

上傳客戶端憑證與私鑰。須 Administrator。須同時提供 CertificateString 與 PrivateKeyString（PEM）。

{
  "Name": "Device Client Cert",
  "CertificateType": "PEM",
  "CertificateString": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----",
  "PrivateKeyString": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----"
}

GET 單筆客戶端憑證時不回傳 PrivateKeyString（僅內部儲存供 MTLS 握手）。

GET／DELETE .../ClientCertificates/{certId}

語意同 Certificates/{certId}；DELETE 回 204。

與 CertificateService 的差異：CertificateService 管理設備入站 HTTPS（https-server）；OutboundConnection 底下集合為出站 MTLS 專用，路徑與儲存皆獨立。

Session（Outbound-{id}）