[{"data":1,"prerenderedAt":1337},["ShallowReactive",2],{"manual-Redfish-zh-TW":3},{"model":4,"locale":5,"headings":6,"html":1334,"markdown":1335,"pdf":1336},"Redfish","zh-TW",[7,11,14,18,21,24,27,30,33,36,38,41,44,47,50,53,56,58,60,63,65,68,70,72,74,77,80,84,87,90,93,96,98,101,103,106,108,110,113,115,117,120,122,125,127,129,131,133,136,138,140,142,145,147,149,151,153,156,158,160,163,165,167,169,172,175,178,181,184,187,190,193,195,198,201,204,207,210,213,216,219,222,225,228,231,234,237,240,243,246,249,252,255,258,261,264,267,271,274,277,280,283,286,289,292,295,298,301,304,307,310,313,316,319,322,325,327,329,331,333,335,338,340,343,345,347,349,351,353,355,358,360,362,364,366,368,370,372,374,376,378,380,382,384,386,389,391,393,396,398,400,402,404,406,408,410,412,414,417,420,423,426,428,430,432,434,436,438,440,442,445,447,449,451,453,455,457,459,461,463,465,467,469,471,473,475,477,480,482,484,487,489,491,493,495,497,499,501,503,505,507,509,511,513,515,517,519,521,523,525,527,529,532,534,536,538,540,542,545,547,549,551,553,555,557,559,561,563,565,567,569,571,573,575,577,579,581,584,587,590,592,594,596,598,600,602,604,606,608,610,612,614,616,619,621,623,625,628,630,632,634,636,638,640,642,644,646,648,650,652,654,656,658,660,662,665,667,669,671,673,675,677,679,681,683,685,687,689,692,694,696,698,700,703,705,708,710,712,714,716,718,720,723,725,727,729,731,733,735,737,739,741,744,747,749,751,753,755,757,759,761,763,765,767,770,773,776,779,782,785,787,789,791,793,796,798,800,802,804,806,808,810,812,814,816,818,820,822,824,827,830,833,836,838,841,844,847,850,853,855,857,859,861,863,865,867,869,871,873,876,879,881,883,886,888,890,892,894,896,899,901,903,906,908,910,913,916,919,921,923,925,927,929,931,933,935,937,940,942,944,946,948,950,952,954,956,958,960,962,964,966,968,971,974,977,979,981,983,985,987,989,992,994,996,999,1002,1004,1007,1010,1013,1016,1018,1020,1022,1024,1026,1028,1030,1032,1034,1036,1038,1040,1042,1044,1047,1049,1051,1053,1055,1057,1059,1061,1063,1065,1067,1069,1071,1073,1075,1077,1079,1081,1083,1086,1089,1092,1094,1097,1100,1102,1105,1108,1111,1113,1116,1118,1121,1124,1127,1130,1133,1136,1138,1140,1142,1144,1146,1149,1151,1153,1155,1157,1159,1161,1164,1166,1168,1170,1172,1174,1176,1179,1181,1183,1185,1187,1189,1191,1193,1195,1197,1199,1201,1203,1205,1207,1209,1211,1213,1215,1217,1219,1221,1223,1225,1227,1230,1233,1236,1238,1240,1243,1245,1247,1249,1251,1254,1257,1259,1261,1263,1266,1269,1272,1275,1278,1281,1284,1286,1289,1291,1294,1297,1299,1302,1305,1307,1309,1311,1314,1316,1318,1320,1322,1324,1326,1328,1330,1332],{"id":8,"title":9,"level":10},"section-1","使用者資訊",1,{"id":12,"title":13,"level":10},"section-2","前言",{"id":15,"title":16,"level":17},"section-3","合規驗證",2,{"id":19,"title":20,"level":10},"section-4","第一部分 第三方整合指南",{"id":22,"title":23,"level":17},"section-5","第三方整合指南",{"id":25,"title":26,"level":17},"section-6","整合原則",{"id":28,"title":29,"level":17},"section-7","整合流程",{"id":31,"title":32,"level":17},"section-8","章節導讀",{"id":34,"title":35,"level":17},"section-9","上線與驗收",{"id":37,"title":16,"level":17},"section-10",{"id":39,"title":40,"level":10},"section-11","第 1 章：整合準備",{"id":42,"title":43,"level":17},"section-12","主要 Redfish API",{"id":45,"title":46,"level":17},"section-13","OCP 範圍",{"id":48,"title":49,"level":17},"section-14","建議流程",{"id":51,"title":52,"level":17},"section-15","curl 範例",{"id":54,"title":55,"level":10},"section-16","第 2 章：設備識別",{"id":57,"title":43,"level":17},"section-17",{"id":59,"title":46,"level":17},"section-18",{"id":61,"title":62,"level":17},"section-19","建議讀取順序",{"id":64,"title":52,"level":17},"section-20",{"id":66,"title":67,"level":10},"section-21","第 3 章：即時監控",{"id":69,"title":43,"level":17},"section-22",{"id":71,"title":46,"level":17},"section-23",{"id":73,"title":62,"level":17},"section-24",{"id":75,"title":76,"level":17},"section-25","減少請求次數",{"id":78,"title":79,"level":17},"section-26","多點網頁即時監控",{"id":81,"title":82,"level":83},"section-27","方案取捨",3,{"id":85,"title":86,"level":83},"section-28","專屬頁（多點即時）",{"id":88,"title":89,"level":83},"section-29","第三方 DCIM",{"id":91,"title":92,"level":83},"section-30","刷新頻率",{"id":94,"title":95,"level":83},"section-31","UI 建議",{"id":97,"title":52,"level":17},"section-32",{"id":99,"title":100,"level":10},"section-33","第 4 章：電源控制",{"id":102,"title":43,"level":17},"section-34",{"id":104,"title":105,"level":17},"section-35","請求範例",{"id":107,"title":49,"level":17},"section-36",{"id":109,"title":52,"level":17},"section-37",{"id":111,"title":112,"level":10},"section-38","第 5 章：告警與事件",{"id":114,"title":43,"level":17},"section-39",{"id":116,"title":49,"level":17},"section-40",{"id":118,"title":119,"level":17},"section-41","OEM 擴充做法（建議）",{"id":121,"title":52,"level":17},"section-42",{"id":123,"title":124,"level":10},"section-43","第 6 章：操作與稽核日誌",{"id":126,"title":43,"level":17},"section-44",{"id":128,"title":46,"level":17},"section-45",{"id":130,"title":49,"level":17},"section-46",{"id":132,"title":52,"level":17},"section-47",{"id":134,"title":135,"level":10},"section-48","第 7 章：歷史趨勢",{"id":137,"title":43,"level":17},"section-49",{"id":139,"title":46,"level":17},"section-50",{"id":141,"title":49,"level":17},"section-51",{"id":143,"title":144,"level":10},"section-52","第 8 章：韌體更新",{"id":146,"title":43,"level":17},"section-53",{"id":148,"title":46,"level":17},"section-54",{"id":150,"title":49,"level":17},"section-55",{"id":152,"title":52,"level":17},"section-56",{"id":154,"title":155,"level":10},"section-57","第 9 章：組態備份還原",{"id":157,"title":43,"level":17},"section-58",{"id":159,"title":49,"level":17},"section-59",{"id":161,"title":162,"level":10},"section-60","第 10 章：進階擴充",{"id":164,"title":43,"level":17},"section-61",{"id":166,"title":46,"level":17},"section-62",{"id":168,"title":49,"level":17},"section-63",{"id":170,"title":171,"level":10},"section-64","第 11 章：MQTT \u002F WebSocket（高效即時通道）",{"id":173,"title":174,"level":17},"section-65","與 Redfish 的分工（雙軌架構）",{"id":176,"title":177,"level":83},"section-66","MQTT 能否取代 EventService？",{"id":179,"title":180,"level":83},"section-67","推送機制對照",{"id":182,"title":183,"level":17},"section-68","連線方式",{"id":185,"title":186,"level":83},"section-69","透過 Redfish Discovery（建議，DCIM）",{"id":188,"title":189,"level":17},"section-70","Topic ↔ Redfish 對照",{"id":191,"title":192,"level":83},"section-71","控制與寫入",{"id":194,"title":79,"level":17},"section-72",{"id":196,"title":197,"level":83},"section-73","建議前端流程",{"id":199,"title":200,"level":17},"section-74","OCP 合規與文件位置",{"id":202,"title":203,"level":10},"section-75","第二部分 API 規格",{"id":205,"title":206,"level":10},"section-76","API 規格索引",{"id":208,"title":209,"level":17},"section-77","其他產品（非 PDU）",{"id":211,"title":212,"level":17},"section-78","Pelx 擴充",{"id":214,"title":215,"level":10},"section-79","Redfish API 總覽",{"id":217,"title":218,"level":17},"section-80","協議範圍",{"id":220,"title":221,"level":17},"section-81","設計依據",{"id":223,"title":224,"level":17},"section-82","OCP Rack PDU Profile 對照",{"id":226,"title":227,"level":83},"section-83","Profile 必填資源（摘要）",{"id":229,"title":230,"level":83},"section-84","管理與安全 API OCP 合規對照",{"id":232,"title":233,"level":83},"section-85","Sensor 雙路徑說明",{"id":235,"title":236,"level":83},"section-86","一次回應多筆資料",{"id":238,"title":239,"level":83},"section-87","選配資源（DMTF 標準，非 OCP 必填）",{"id":241,"title":242,"level":83},"section-88","Pelx 擴充（OEM，非 OCP 必填）",{"id":244,"title":245,"level":83},"section-89","資源樹概覽（OCP Rack PDU Profile）",{"id":247,"title":248,"level":17},"section-90","通用 JSON 欄位",{"id":250,"title":251,"level":83},"section-91","Redfish 標準欄位",{"id":253,"title":254,"level":83},"section-92","HTTP 回應標頭與可寫屬性標註",{"id":256,"title":257,"level":83},"section-93","量測與閾值欄位",{"id":259,"title":260,"level":83},"section-94","Oem.Pelx 擴充欄位",{"id":262,"title":263,"level":10},"section-95","認證",{"id":265,"title":266,"level":83},"section-96","認證架構",{"id":268,"title":269,"level":270},"section-97","ReadOnly（OCP Baseline 基礎角色）",4,{"id":272,"title":273,"level":83},"section-98","角色與權限模型（RBAC）",{"id":275,"title":276,"level":270},"section-99","權限層級",{"id":278,"title":279,"level":270},"section-100","Web「工程模式」↔ Redfish API",{"id":281,"title":282,"level":270},"section-101","一般選單（非工程模式）控制與寫入",{"id":284,"title":285,"level":270},"section-102","帳號 CRUD 授權矩陣",{"id":287,"title":288,"level":270},"section-103","Role 資源與 OemPrivileges",{"id":290,"title":291,"level":83},"section-104","文件撰寫慣例（各 spec 章節）",{"id":293,"title":294,"level":270},"section-105","預設規則",{"id":296,"title":297,"level":270},"section-106","僅在下列情況於 API 段落額外標註",{"id":299,"title":300,"level":270},"section-107","403 撰寫",{"id":302,"title":303,"level":83},"section-108","OCP AccountService 要求（摘要）",{"id":305,"title":306,"level":83},"section-109","外部帳號提供者（LDAP／RADIUS／TACACS+）",{"id":308,"title":309,"level":83},"section-110","密碼強度政策",{"id":311,"title":312,"level":83},"section-111","Interop Validator 與認證",{"id":314,"title":315,"level":83},"section-112","GET https:\u002F\u002F",{"id":317,"title":318,"level":270},"section-113","欄位說明如下:",{"id":320,"title":321,"level":270},"section-114","回傳資料狀態",{"id":323,"title":324,"level":83},"section-115","PATCH https:\u002F\u002F",{"id":326,"title":318,"level":270},"section-116",{"id":328,"title":321,"level":270},"section-117",{"id":330,"title":315,"level":83},"section-118",{"id":332,"title":318,"level":270},"section-119",{"id":334,"title":321,"level":270},"section-120",{"id":336,"title":337,"level":83},"section-121","POST https:\u002F\u002F",{"id":339,"title":318,"level":270},"section-122",{"id":341,"title":342,"level":270},"section-123","回傳資料格式如下:",{"id":344,"title":318,"level":270},"section-124",{"id":346,"title":321,"level":270},"section-125",{"id":348,"title":315,"level":83},"section-126",{"id":350,"title":342,"level":270},"section-127",{"id":352,"title":318,"level":270},"section-128",{"id":354,"title":321,"level":270},"section-129",{"id":356,"title":357,"level":83},"section-130","DELETE https:\u002F\u002F",{"id":359,"title":318,"level":270},"section-131",{"id":361,"title":321,"level":270},"section-132",{"id":363,"title":318,"level":270},"section-133",{"id":365,"title":321,"level":270},"section-134",{"id":367,"title":315,"level":83},"section-135",{"id":369,"title":318,"level":270},"section-136",{"id":371,"title":321,"level":270},"section-137",{"id":373,"title":315,"level":83},"section-138",{"id":375,"title":342,"level":270},"section-139",{"id":377,"title":318,"level":270},"section-140",{"id":379,"title":321,"level":270},"section-141",{"id":381,"title":318,"level":270},"section-142",{"id":383,"title":337,"level":83},"section-143",{"id":385,"title":318,"level":270},"section-144",{"id":387,"title":388,"level":270},"section-145","欄位對照（Redfish → auth）",{"id":390,"title":321,"level":270},"section-146",{"id":392,"title":324,"level":83},"section-147",{"id":394,"title":395,"level":270},"section-148","可寫欄位",{"id":397,"title":321,"level":270},"section-149",{"id":399,"title":357,"level":83},"section-150",{"id":401,"title":321,"level":270},"section-151",{"id":403,"title":315,"level":83},"section-152",{"id":405,"title":318,"level":270},"section-153",{"id":407,"title":321,"level":270},"section-154",{"id":409,"title":315,"level":83},"section-155",{"id":411,"title":321,"level":270},"section-156",{"id":413,"title":324,"level":83},"section-157",{"id":415,"title":416,"level":270},"section-158","密碼強度政策範例",{"id":418,"title":419,"level":270},"section-159","LDAP 範例",{"id":421,"title":422,"level":270},"section-160","RADIUS 範例",{"id":424,"title":425,"level":270},"section-161","TACACS+ 範例",{"id":427,"title":388,"level":270},"section-162",{"id":429,"title":321,"level":270},"section-163",{"id":431,"title":337,"level":83},"section-164",{"id":433,"title":321,"level":270},"section-165",{"id":435,"title":337,"level":83},"section-166",{"id":437,"title":321,"level":270},"section-167",{"id":439,"title":337,"level":83},"section-168",{"id":441,"title":321,"level":270},"section-169",{"id":443,"title":444,"level":83},"section-170","HTTPS 憑證（實際作業方式）",{"id":446,"title":315,"level":83},"section-171",{"id":448,"title":318,"level":270},"section-172",{"id":450,"title":321,"level":270},"section-173",{"id":452,"title":337,"level":83},"section-174",{"id":454,"title":321,"level":270},"section-175",{"id":456,"title":315,"level":83},"section-176",{"id":458,"title":318,"level":270},"section-177",{"id":460,"title":321,"level":270},"section-178",{"id":462,"title":315,"level":83},"section-179",{"id":464,"title":321,"level":270},"section-180",{"id":466,"title":315,"level":83},"section-181",{"id":468,"title":321,"level":270},"section-182",{"id":470,"title":337,"level":83},"section-183",{"id":472,"title":321,"level":270},"section-184",{"id":474,"title":337,"level":83},"section-185",{"id":476,"title":321,"level":270},"section-186",{"id":478,"title":479,"level":10},"section-187","探索與識別",{"id":481,"title":318,"level":270},"section-188",{"id":483,"title":321,"level":270},"section-189",{"id":485,"title":486,"level":270},"section-190","$expand 與 $only 範例",{"id":488,"title":315,"level":83},"section-191",{"id":490,"title":318,"level":270},"section-192",{"id":492,"title":321,"level":270},"section-193",{"id":494,"title":315,"level":83},"section-194",{"id":496,"title":318,"level":270},"section-195",{"id":498,"title":321,"level":270},"section-196",{"id":500,"title":315,"level":83},"section-197",{"id":502,"title":315,"level":83},"section-198",{"id":504,"title":315,"level":83},"section-199",{"id":506,"title":315,"level":83},"section-200",{"id":508,"title":318,"level":270},"section-201",{"id":510,"title":321,"level":270},"section-202",{"id":512,"title":315,"level":83},"section-203",{"id":514,"title":318,"level":270},"section-204",{"id":516,"title":321,"level":270},"section-205",{"id":518,"title":315,"level":83},"section-206",{"id":520,"title":318,"level":270},"section-207",{"id":522,"title":321,"level":270},"section-208",{"id":524,"title":315,"level":83},"section-209",{"id":526,"title":318,"level":270},"section-210",{"id":528,"title":321,"level":270},"section-211",{"id":530,"title":531,"level":10},"section-212","網路協定",{"id":533,"title":315,"level":83},"section-213",{"id":535,"title":318,"level":270},"section-214",{"id":537,"title":321,"level":270},"section-215",{"id":539,"title":324,"level":83},"section-216",{"id":541,"title":321,"level":270},"section-217",{"id":543,"title":544,"level":10},"section-218","電力與配電（PowerEquipment）",{"id":546,"title":315,"level":83},"section-219",{"id":548,"title":318,"level":270},"section-220",{"id":550,"title":321,"level":270},"section-221",{"id":552,"title":315,"level":83},"section-222",{"id":554,"title":318,"level":270},"section-223",{"id":556,"title":321,"level":270},"section-224",{"id":558,"title":315,"level":83},"section-225",{"id":560,"title":318,"level":270},"section-226",{"id":562,"title":321,"level":270},"section-227",{"id":564,"title":315,"level":83},"section-228",{"id":566,"title":318,"level":270},"section-229",{"id":568,"title":321,"level":270},"section-230",{"id":570,"title":337,"level":83},"section-231",{"id":572,"title":321,"level":270},"section-232",{"id":574,"title":315,"level":83},"section-233",{"id":576,"title":318,"level":270},"section-234",{"id":578,"title":321,"level":270},"section-235",{"id":580,"title":315,"level":83},"section-236",{"id":582,"title":583,"level":270},"section-237","OCP AC Mains 欄位名稱合規對照",{"id":585,"title":586,"level":270},"section-238","單相進線範例（INFEED）",{"id":588,"title":589,"level":270},"section-239","三相進線範例（INFEED3P，infeedKind=ThreePhase）",{"id":591,"title":318,"level":270},"section-240",{"id":593,"title":321,"level":270},"section-241",{"id":595,"title":337,"level":83},"section-242",{"id":597,"title":321,"level":270},"section-243",{"id":599,"title":315,"level":83},"section-244",{"id":601,"title":318,"level":270},"section-245",{"id":603,"title":321,"level":270},"section-246",{"id":605,"title":315,"level":83},"section-247",{"id":607,"title":318,"level":270},"section-248",{"id":609,"title":321,"level":270},"section-249",{"id":611,"title":315,"level":83},"section-250",{"id":613,"title":318,"level":270},"section-251",{"id":615,"title":321,"level":270},"section-252",{"id":617,"title":618,"level":83},"section-253","Sensor {id} 定義",{"id":620,"title":315,"level":83},"section-254",{"id":622,"title":318,"level":270},"section-255",{"id":624,"title":321,"level":270},"section-256",{"id":626,"title":627,"level":10},"section-257","ATS 轉換開關（TransferSwitches）",{"id":629,"title":315,"level":83},"section-258",{"id":631,"title":318,"level":270},"section-259",{"id":633,"title":321,"level":270},"section-260",{"id":635,"title":315,"level":83},"section-261",{"id":637,"title":318,"level":270},"section-262",{"id":639,"title":321,"level":270},"section-263",{"id":641,"title":315,"level":83},"section-264",{"id":643,"title":318,"level":270},"section-265",{"id":645,"title":321,"level":270},"section-266",{"id":647,"title":315,"level":83},"section-267",{"id":649,"title":318,"level":270},"section-268",{"id":651,"title":321,"level":270},"section-269",{"id":653,"title":318,"level":270},"section-270",{"id":655,"title":321,"level":270},"section-271",{"id":657,"title":324,"level":83},"section-272",{"id":659,"title":318,"level":270},"section-273",{"id":661,"title":321,"level":270},"section-274",{"id":663,"title":664,"level":10},"section-275","插座（Outlets）",{"id":666,"title":315,"level":83},"section-276",{"id":668,"title":318,"level":270},"section-277",{"id":670,"title":321,"level":270},"section-278",{"id":672,"title":315,"level":83},"section-279",{"id":674,"title":318,"level":270},"section-280",{"id":676,"title":321,"level":270},"section-281",{"id":678,"title":315,"level":83},"section-282",{"id":680,"title":337,"level":83},"section-283",{"id":682,"title":318,"level":270},"section-284",{"id":684,"title":321,"level":270},"section-285",{"id":686,"title":337,"level":83},"section-286",{"id":688,"title":321,"level":270},"section-287",{"id":690,"title":691,"level":10},"section-288","插座群組（OutletGroups）",{"id":693,"title":315,"level":83},"section-289",{"id":695,"title":315,"level":83},"section-290",{"id":697,"title":337,"level":83},"section-291",{"id":699,"title":321,"level":270},"section-292",{"id":701,"title":702,"level":10},"section-293","環境感測（Thermal）",{"id":704,"title":315,"level":83},"section-294",{"id":706,"title":707,"level":270},"section-295","欄位說明",{"id":709,"title":315,"level":83},"section-296",{"id":711,"title":707,"level":270},"section-297",{"id":713,"title":315,"level":83},"section-298",{"id":715,"title":315,"level":83},"section-299",{"id":717,"title":315,"level":83},"section-300",{"id":719,"title":321,"level":270},"section-301",{"id":721,"title":722,"level":10},"section-302","告警與事件（EventService）",{"id":724,"title":315,"level":83},"section-303",{"id":726,"title":318,"level":270},"section-304",{"id":728,"title":321,"level":270},"section-305",{"id":730,"title":315,"level":83},"section-306",{"id":732,"title":318,"level":270},"section-307",{"id":734,"title":321,"level":270},"section-308",{"id":736,"title":337,"level":83},"section-309",{"id":738,"title":318,"level":270},"section-310",{"id":740,"title":321,"level":270},"section-311",{"id":742,"title":743,"level":83},"section-312","OEM 擴充（Pelx）— 訂閱與推送 payload",{"id":745,"title":746,"level":270},"section-313","OEM 欄位建議如下:",{"id":748,"title":315,"level":83},"section-314",{"id":750,"title":321,"level":270},"section-315",{"id":752,"title":357,"level":83},"section-316",{"id":754,"title":321,"level":270},"section-317",{"id":756,"title":315,"level":83},"section-318",{"id":758,"title":318,"level":270},"section-319",{"id":760,"title":321,"level":270},"section-320",{"id":762,"title":315,"level":83},"section-321",{"id":764,"title":318,"level":270},"section-322",{"id":766,"title":321,"level":270},"section-323",{"id":768,"title":769,"level":10},"section-324","OutboundConnection（出站 WebSocket 連線）",{"id":771,"title":772,"level":83},"section-325","與其他推送機制的分工",{"id":774,"title":775,"level":83},"section-326","資源路徑",{"id":777,"title":778,"level":83},"section-327","Web UI 與 sysctrl 對應",{"id":780,"title":781,"level":83},"section-328","使用限制",{"id":783,"title":784,"level":270},"section-329","常見操作對照",{"id":786,"title":315,"level":83},"section-330",{"id":788,"title":318,"level":270},"section-331",{"id":790,"title":321,"level":270},"section-332",{"id":792,"title":337,"level":83},"section-333",{"id":794,"title":795,"level":270},"section-334","請求欄位（requiredOnCreate 摘要）",{"id":797,"title":321,"level":270},"section-335",{"id":799,"title":315,"level":83},"section-336",{"id":801,"title":318,"level":270},"section-337",{"id":803,"title":321,"level":270},"section-338",{"id":805,"title":324,"level":83},"section-339",{"id":807,"title":321,"level":270},"section-340",{"id":809,"title":357,"level":83},"section-341",{"id":811,"title":321,"level":270},"section-342",{"id":813,"title":315,"level":83},"section-343",{"id":815,"title":337,"level":83},"section-344",{"id":817,"title":315,"level":83},"section-345",{"id":819,"title":357,"level":83},"section-346",{"id":821,"title":315,"level":83},"section-347",{"id":823,"title":337,"level":83},"section-348",{"id":825,"title":826,"level":83},"section-349","GET／DELETE ...\u002FClientCertificates\u002F{certId}",{"id":828,"title":829,"level":83},"section-350","Session（Outbound-{id}）",{"id":831,"title":832,"level":83},"section-351","連線行為（hwctrl 實作）",{"id":834,"title":835,"level":270},"section-352","已知限制（相對 DMTF 完整語意）",{"id":837,"title":52,"level":83},"section-353",{"id":839,"title":840,"level":83},"section-354","持久化與權限",{"id":842,"title":843,"level":83},"section-355","相關章節",{"id":845,"title":846,"level":10},"section-356","歷史訊息（LogServices）",{"id":848,"title":849,"level":83},"section-357","Operational 與 Audit 的區別",{"id":851,"title":852,"level":83},"section-358","與 EventService、TelemetryService 的區別",{"id":854,"title":315,"level":83},"section-359",{"id":856,"title":318,"level":270},"section-360",{"id":858,"title":321,"level":270},"section-361",{"id":860,"title":315,"level":83},"section-362",{"id":862,"title":318,"level":270},"section-363",{"id":864,"title":321,"level":270},"section-364",{"id":866,"title":315,"level":83},"section-365",{"id":868,"title":318,"level":270},"section-366",{"id":870,"title":321,"level":270},"section-367",{"id":872,"title":315,"level":83},"section-368",{"id":874,"title":875,"level":270},"section-369","Operational — 插座操作範例",{"id":877,"title":878,"level":270},"section-370","Audit — 登入／登出範例",{"id":880,"title":318,"level":270},"section-371",{"id":882,"title":321,"level":270},"section-372",{"id":884,"title":885,"level":17},"section-373","主機事件補同步（Pelx OEM）",{"id":887,"title":315,"level":83},"section-374",{"id":889,"title":342,"level":270},"section-375",{"id":891,"title":318,"level":270},"section-376",{"id":893,"title":321,"level":270},"section-377",{"id":895,"title":315,"level":83},"section-378",{"id":897,"title":898,"level":270},"section-379","查詢參數",{"id":900,"title":342,"level":270},"section-380",{"id":902,"title":318,"level":270},"section-381",{"id":904,"title":905,"level":270},"section-382","主機補足缺失記錄（建議流程）",{"id":907,"title":52,"level":270},"section-383",{"id":909,"title":321,"level":270},"section-384",{"id":911,"title":912,"level":10},"section-385","歷史趨勢（TelemetryService）",{"id":914,"title":915,"level":83},"section-386","MetricReportDefinition、MetricReport、MetricDefinition 的區別",{"id":917,"title":918,"level":83},"section-387","產品預設（MetricReports）",{"id":920,"title":315,"level":83},"section-388",{"id":922,"title":318,"level":270},"section-389",{"id":924,"title":321,"level":270},"section-390",{"id":926,"title":315,"level":83},"section-391",{"id":928,"title":321,"level":270},"section-392",{"id":930,"title":315,"level":83},"section-393",{"id":932,"title":318,"level":270},"section-394",{"id":934,"title":321,"level":270},"section-395",{"id":936,"title":315,"level":83},"section-396",{"id":938,"title":939,"level":270},"section-397","查詢參數（$filter）",{"id":941,"title":318,"level":270},"section-398",{"id":943,"title":321,"level":270},"section-399",{"id":945,"title":315,"level":83},"section-400",{"id":947,"title":318,"level":270},"section-401",{"id":949,"title":321,"level":270},"section-402",{"id":951,"title":315,"level":83},"section-403",{"id":953,"title":318,"level":270},"section-404",{"id":955,"title":321,"level":270},"section-405",{"id":957,"title":315,"level":83},"section-406",{"id":959,"title":318,"level":270},"section-407",{"id":961,"title":321,"level":270},"section-408",{"id":963,"title":315,"level":83},"section-409",{"id":965,"title":318,"level":270},"section-410",{"id":967,"title":321,"level":270},"section-411",{"id":969,"title":970,"level":17},"section-412","主機統計補同步（Pelx OEM）",{"id":972,"title":973,"level":83},"section-413","從 Mains／Outlet 取得 addr（不需專用 Rollup API）",{"id":975,"title":976,"level":270},"section-414","範例（插座電流）",{"id":978,"title":315,"level":83},"section-415",{"id":980,"title":342,"level":270},"section-416",{"id":982,"title":318,"level":270},"section-417",{"id":984,"title":321,"level":270},"section-418",{"id":986,"title":315,"level":83},"section-419",{"id":988,"title":898,"level":270},"section-420",{"id":990,"title":991,"level":270},"section-421","by 欄位值",{"id":993,"title":342,"level":270},"section-422",{"id":995,"title":318,"level":270},"section-423",{"id":997,"title":998,"level":270},"section-424","主機補足缺失資料（建議流程）",{"id":1000,"title":1001,"level":270},"section-425","範例",{"id":1003,"title":321,"level":270},"section-426",{"id":1005,"title":1006,"level":10},"section-427","韌體與組態（UpdateService）",{"id":1008,"title":1009,"level":83},"section-428","權限",{"id":1011,"title":1012,"level":83},"section-429","韌體更新",{"id":1014,"title":1015,"level":83},"section-430","組態更新",{"id":1017,"title":315,"level":83},"section-431",{"id":1019,"title":318,"level":270},"section-432",{"id":1021,"title":321,"level":270},"section-433",{"id":1023,"title":315,"level":83},"section-434",{"id":1025,"title":318,"level":270},"section-435",{"id":1027,"title":321,"level":270},"section-436",{"id":1029,"title":315,"level":83},"section-437",{"id":1031,"title":318,"level":270},"section-438",{"id":1033,"title":321,"level":270},"section-439",{"id":1035,"title":315,"level":83},"section-440",{"id":1037,"title":318,"level":270},"section-441",{"id":1039,"title":321,"level":270},"section-442",{"id":1041,"title":337,"level":83},"section-443",{"id":1043,"title":318,"level":270},"section-444",{"id":1045,"title":1046,"level":270},"section-445","回傳資料",{"id":1048,"title":321,"level":270},"section-446",{"id":1050,"title":337,"level":83},"section-447",{"id":1052,"title":318,"level":270},"section-448",{"id":1054,"title":1046,"level":270},"section-449",{"id":1056,"title":321,"level":270},"section-450",{"id":1058,"title":315,"level":83},"section-451",{"id":1060,"title":315,"level":83},"section-452",{"id":1062,"title":318,"level":270},"section-453",{"id":1064,"title":321,"level":270},"section-454",{"id":1066,"title":315,"level":83},"section-455",{"id":1068,"title":318,"level":270},"section-456",{"id":1070,"title":321,"level":270},"section-457",{"id":1072,"title":337,"level":83},"section-458",{"id":1074,"title":318,"level":270},"section-459",{"id":1076,"title":1046,"level":270},"section-460",{"id":1078,"title":321,"level":270},"section-461",{"id":1080,"title":337,"level":83},"section-462",{"id":1082,"title":321,"level":270},"section-463",{"id":1084,"title":1085,"level":83},"section-464","操作範例（curl）",{"id":1087,"title":1088,"level":10},"section-465","讀取流程建議",{"id":1090,"title":1091,"level":83},"section-466","減少請求次數（一次回多筆）",{"id":1093,"title":52,"level":83},"section-467",{"id":1095,"title":1096,"level":83},"section-468","redfishtool 測試",{"id":1098,"title":1099,"level":10},"section-469","通用錯誤回應",{"id":1101,"title":318,"level":270},"section-470",{"id":1103,"title":1104,"level":10},"section-471","iLock 電子鎖主機",{"id":1106,"title":1107,"level":17},"section-472","產品與協議範圍",{"id":1109,"title":1110,"level":83},"section-473","Service Root 差異（相對於 PDU）",{"id":1112,"title":318,"level":270},"section-474",{"id":1114,"title":1115,"level":83},"section-475","與 Chassis 的關係",{"id":1117,"title":318,"level":270},"section-476",{"id":1119,"title":1120,"level":17},"section-477","電子鎖資源（Oem\u002FPelx\u002FElectronicLocks）",{"id":1122,"title":1123,"level":270},"section-478","出現條件",{"id":1125,"title":1126,"level":270},"section-479","介面連結",{"id":1128,"title":1129,"level":270},"section-480","路數與硬體埠對照",{"id":1131,"title":1132,"level":270},"section-481","卡號兩種資料源",{"id":1134,"title":1135,"level":270},"section-482","未連線時的讀寫行為",{"id":1137,"title":315,"level":83},"section-483",{"id":1139,"title":318,"level":270},"section-484",{"id":1141,"title":321,"level":270},"section-485",{"id":1143,"title":315,"level":83},"section-486",{"id":1145,"title":318,"level":270},"section-487",{"id":1147,"title":1148,"level":270},"section-488","LastUnlockResult 對照",{"id":1150,"title":321,"level":270},"section-489",{"id":1152,"title":324,"level":83},"section-490",{"id":1154,"title":318,"level":270},"section-491",{"id":1156,"title":321,"level":270},"section-492",{"id":1158,"title":337,"level":83},"section-493",{"id":1160,"title":318,"level":270},"section-494",{"id":1162,"title":1163,"level":270},"section-495","ControlType 對照",{"id":1165,"title":321,"level":270},"section-496",{"id":1167,"title":315,"level":83},"section-497",{"id":1169,"title":318,"level":270},"section-498",{"id":1171,"title":321,"level":270},"section-499",{"id":1173,"title":337,"level":83},"section-500",{"id":1175,"title":318,"level":270},"section-501",{"id":1177,"title":1178,"level":270},"section-502","回應欄位說明如下:",{"id":1180,"title":321,"level":270},"section-503",{"id":1182,"title":357,"level":83},"section-504",{"id":1184,"title":321,"level":270},"section-505",{"id":1186,"title":315,"level":83},"section-506",{"id":1188,"title":318,"level":270},"section-507",{"id":1190,"title":321,"level":270},"section-508",{"id":1192,"title":315,"level":83},"section-509",{"id":1194,"title":318,"level":270},"section-510",{"id":1196,"title":321,"level":270},"section-511",{"id":1198,"title":337,"level":83},"section-512",{"id":1200,"title":318,"level":270},"section-513",{"id":1202,"title":321,"level":270},"section-514",{"id":1204,"title":324,"level":83},"section-515",{"id":1206,"title":318,"level":270},"section-516",{"id":1208,"title":321,"level":270},"section-517",{"id":1210,"title":357,"level":83},"section-518",{"id":1212,"title":318,"level":270},"section-519",{"id":1214,"title":321,"level":270},"section-520",{"id":1216,"title":315,"level":83},"section-521",{"id":1218,"title":318,"level":270},"section-522",{"id":1220,"title":321,"level":270},"section-523",{"id":1222,"title":324,"level":83},"section-524",{"id":1224,"title":318,"level":270},"section-525",{"id":1226,"title":321,"level":270},"section-526",{"id":1228,"title":1229,"level":270},"section-527","事件與日誌",{"id":1231,"title":1232,"level":10},"section-528","Pelx 擴充（OEM）",{"id":1234,"title":1235,"level":17},"section-529","OEM 擴充：完整介面列表（Pelx 擴充）",{"id":1237,"title":315,"level":83},"section-530",{"id":1239,"title":318,"level":270},"section-531",{"id":1241,"title":1242,"level":270},"section-532","單筆介面欄位（GET ...\u002FInterfaces\u002F{addr}）",{"id":1244,"title":321,"level":270},"section-533",{"id":1246,"title":315,"level":83},"section-534",{"id":1248,"title":318,"level":270},"section-535",{"id":1250,"title":321,"level":270},"section-536",{"id":1252,"title":1253,"level":83},"section-537","Pelx CSDL 與 $metadata",{"id":1255,"title":1256,"level":17},"section-538","週邊樹（PeripheralTree，Pelx 擴充）",{"id":1258,"title":315,"level":83},"section-539",{"id":1260,"title":318,"level":270},"section-540",{"id":1262,"title":321,"level":270},"section-541",{"id":1264,"title":1265,"level":83},"section-542","Service Root 連結",{"id":1267,"title":1268,"level":83},"section-543","使用建議（AI／整合）",{"id":1270,"title":1271,"level":17},"section-544","OEM 擴充：MQTT 連線資訊（Pelx 擴充）",{"id":1273,"title":1274,"level":83},"section-545","暴露位置",{"id":1276,"title":1277,"level":83},"section-546","GET \u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FMqtt 範例",{"id":1279,"title":1280,"level":83},"section-547","Service Root 範例（精簡）",{"id":1282,"title":1283,"level":83},"section-548","MQTT Topic",{"id":1285,"title":707,"level":83},"section-549",{"id":1287,"title":1288,"level":83},"section-550","串接 Slave",{"id":1290,"title":29,"level":83},"section-551",{"id":1292,"title":1293,"level":83},"section-552","手動測試",{"id":1295,"title":1296,"level":17},"section-553","排程（Schedules，Pelx 擴充）",{"id":1298,"title":1123,"level":270},"section-554",{"id":1300,"title":1301,"level":270},"section-555","SlaveTargets 出現條件",{"id":1303,"title":1304,"level":270},"section-556","DO 位址語意",{"id":1306,"title":315,"level":83},"section-557",{"id":1308,"title":315,"level":83},"section-558",{"id":1310,"title":318,"level":270},"section-559",{"id":1312,"title":1313,"level":270},"section-560","task ↔ Redfish 欄位對照",{"id":1315,"title":337,"level":83},"section-561",{"id":1317,"title":318,"level":270},"section-562",{"id":1319,"title":321,"level":270},"section-563",{"id":1321,"title":324,"level":83},"section-564",{"id":1323,"title":318,"level":270},"section-565",{"id":1325,"title":321,"level":270},"section-566",{"id":1327,"title":357,"level":83},"section-567",{"id":1329,"title":321,"level":270},"section-568",{"id":1331,"title":337,"level":83},"section-569",{"id":1333,"title":321,"level":270},"section-570","\u003Cp>\u003Cimg src=\"\u002Fmanual\u002FRedfish\u002Fmedia\u002Fproducts\u002FBellwin-Redfish\u002Fmedia\u002Fcover.jpeg\" alt=\"圖片\">\u003C\u002Fp>\n\u003Ch1 id=\"section-1\">使用者資訊\u003C\u002Fh1>\n\u003Cp>製造商保有修改與變更本說明書所包含的資訊、文件與規格表的權利，且不需事前通知；製造商不會保證、明示、暗示或法定聲明其內容或特別否認其對於特殊用途的可銷售性與適用性；本說明書中所描述的任何被銷售與授權的製造商軟體亦同。\u003C\u002Fp>\n\u003Cp>如果購買後證明軟體程式瑕疵，購買者（及非製造商、其經銷商或其購買商家）將需承擔所有因軟體瑕疵所造成的必要的服務費用、修理責任和任何偶發事件或間接損害。\u003C\u002Fp>\n\u003Cp>本系統製造商並不擔負任何未經授權調整本裝置後所造成的收音機及／或電視干擾之責任，使用者必須自行修正干擾。\u003C\u002Fp>\n\u003Cp>操作前如未正確選擇操作電壓的設定，製造商將不擔負因此所導致的任何損害之責任；使用前請務必確認電壓設定為正確的。\u003C\u002Fp>\n\u003Cp>本廠向原始一般使用者（購買者）保證，本產品由購買日期起 1 年內，無任何材質或製造技術之缺陷。在保固期間及依購買證明，若產品因製造技術和／或材質有瑕疵而發生任何故障時，本廠將自行定奪，在不收取任何零件或人力費用下修理或更換缺陷產品或元件，以在其視為必要之範圍內，將產品或元件回復至正常操作狀態。任何更換將包含新的或重新製造功能相當之等值或更高價值的產品，更換內容將由本廠自行定奪，但若產品已經過修改、誤用、變造、因天災或不正常運作狀態而受損，則不適用本保固。\u003C\u002Fp>\n\u003Cp>本保固將完全不適用於因任何第三人（包括但不限於本廠之客戶或一般使用者）安裝或使用、操作疏失和／或不當使用、未經本廠事先核準之修改、進行與本廠書面指示說明不符之維修、正常耗損、拆解產品、將產品連接至不相容的設備或軟體、將產品變更、轉換或整合至非本廠計畫內指定運用本產品之系統中、將不相容之硬體和／或軟體連接至本產品，以及一般使用者電腦網路上含有病毒、電信業者和／或服務供應商網路經修改、變更或中斷、產品經由非經本廠授權之人員維修，而造成產品和／或任何零件產生缺陷或不符規格。\u003C\u002Fp>\n\u003Cp>若您的裝置無法正常運作，請聯絡裝置包裝內所附之支援及保固卡上所標示的服務供應商。\u003C\u002Fp>\n\u003Ch1 id=\"section-2\">前言\u003C\u002Fh1>\n\u003Cp>本手冊收錄 \u003Cstrong>Pelx Redfish\u003C\u002Fstrong> 完整整合指南與 API 規格，供 DCIM、監控平台與 SI 整合使用。\u003C\u002Fp>\n\u003Cblockquote>\n\u003Cp>對外整合入口：\u003Ccode>https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u003C\u002Fcode>。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch2 id=\"section-3\">合規驗證\u003C\u002Fh2>\n\u003Cp>\u003Cstrong>單一入口：\u003C\u002Fstrong> spec\u002Fvalidation.md（Redfish \u003Cstrong>1.16.0\u003C\u002Fstrong>、OCP Rack PDU／Baseline Profile、\u003Ccode>rf_service_validator\u003C\u002Fcode> + \u003Ccode>rf_interop_validator\u003C\u002Fcode>、日期與範圍）。\u003C\u002Fp>\n\u003Cp>Interop 實測：OCP Rack PDU v1.0.0（2026-07-06）\u003Cstrong>884 Pass／0 Fail\u003C\u002Fstrong>；OCP Baseline Hardware Management v1.1.1（2026-07-22）\u003Cstrong>203 Pass／0 Fail\u003C\u002Fstrong>。指令見 「讀取流程」章節、前置條件見 overview.md。\u003C\u002Fp>\n\u003Cp>手動探查單一 API 可用 \u003Ca rel=\"noopener noreferrer\" href=\"https:\u002F\u002Fgithub.com\u002FDMTF\u002Fredfishtool\">redfishtool\u003C\u002Fa>，範例見 「讀取流程」章節「redfishtool 測試」。\u003C\u002Fp>\n\u003Ch1 id=\"section-4\">第一部分 第三方整合指南\u003C\u002Fh1>\n\u003Cp>本部分說明 DCIM、監控平台與 SI 整合 Pelx 設備的建議流程與主要 API。\u003C\u002Fp>\n\u003Ch2 id=\"section-5\">第三方整合指南\u003C\u002Fh2>\n\u003Cp>本指南供 \u003Cstrong>DCIM、監控平台、SI\u003C\u002Fstrong> 使用：以 \u003Cstrong>OCP Rack PDU Profile v1.0.0\u003C\u002Fstrong> 為主線，必要時搭配 \u003Cstrong>Pelx 擴充\u003C\u002Fstrong>。JSON 範例與欄位定義見本手冊 API 規格章節。\u003C\u002Fp>\n\u003Cblockquote>\n\u003Cp>對外唯一整合入口：\u003Ccode>https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u003C\u002Fcode>。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch2 id=\"section-6\">整合原則\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>場景\u003C\u002Fth>\n\u003Cth>通道\u003C\u002Fth>\n\u003Cth>必要 API\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>大量即時\u003C\u002Fstrong>（多點即時看板）\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>MQTT\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>先 \u003Ccode>GET \u002Fredfish\u002Fv1\u003C\u002Fcode> 讀 \u003Ccode>Oem.Pelx.MqttEndpoint\u003C\u002Fcode>，再訂閱 \u003Ccode>\u002Fupdates\u002Flocal\u003C\u002Fcode>、\u003Ccode>\u002Fupdate\u002Flocal\u002F#\u003C\u002Fcode>；詳「MQTT Discovery」章節\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>第三方 DCIM \u002F OCP\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Redfish REST\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Metrics\u003C\u002Fcode>、\u003Ccode>Mains\u003C\u002Fcode>、\u003Ccode>Outlets\u003C\u002Fcode>、\u003Ccode>Chassis\u002FSensors\u003C\u002Fcode>、\u003Ccode>EventService\u002FSubscriptions\u003C\u002Fcode>；輪詢 \u003Cstrong>15～60 秒\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>不需把 MQTT 包成 Redfish、DCIM 不必接 MQTT、不必實作 SSE。詳見 MQTT \u002F WebSocket。\u003C\u002Fp>\n\u003Ch2 id=\"section-7\">整合流程\u003C\u002Fh2>\n\u003Cpre>\u003Ccode>flowchart TB\n  subgraph core[OCP 必填 — 建議先打通]\n    C1[1 整合準備] --> C2[2 設備識別]\n    C2 --> C3[3 即時監控]\n    C3 --> C4[4 電源控制]\n    C2 --> C5[5 告警與事件]\n    C2 --> C6[6 操作與稽核日誌]\n  end\n  subgraph ops[Baseline 維運 — 依需求]\n    C8[8 韌體更新]\n    C9[9 組態備份還原]\n  end\n  subgraph ext[選配與 OEM — 非 OCP 必填]\n    C7[7 歷史趨勢]\n    C4b[4b 插座群組]\n    C10[10 進階擴充]\n    C11[11 MQTT \u002F WebSocket]\n  end\n  C2 --> C8\n  C2 --> C9\n  C3 --> C7\n  C4 --> C4b\n  C3 --> C10\n  C3 --> C11\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"section-8\">章節導讀\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>章\u003C\u002Fth>\n\u003Cth>主題\u003C\u002Fth>\n\u003Cth>整合方要做的事\u003C\u002Fth>\n\u003Cth>主要 Redfish API\u003C\u002Fth>\n\u003Cth>OCP\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>1\u003C\u002Ftd>\n\u003Ctd>整合準備\u003C\u002Ftd>\n\u003Ctd>連線、認證、探索 Service Root\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>GET \u002Fredfish\u002Fv1\u003C\u002Fcode>、\u003Ccode>SessionService\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>✅ Baseline\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>2\u003C\u002Ftd>\n\u003Ctd>設備識別\u003C\u002Ftd>\n\u003Ctd>型號、序號、機架位置\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Chassis\u003C\u002Fcode>、\u003Ccode>Managers\u003C\u002Fcode>、\u003Ccode>RackPDUs\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>✅\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>3\u003C\u002Ftd>\n\u003Ctd>即時監控\u003C\u002Ftd>\n\u003Ctd>進線／插座電力、感測器\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Mains\u003C\u002Fcode>、\u003Ccode>Outlets\u003C\u002Fcode>、\u003Ccode>Metrics\u003C\u002Fcode>、\u003Ccode>Chassis\u002FSensors\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>✅\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>4\u003C\u002Ftd>\n\u003Ctd>電源控制\u003C\u002Ftd>\n\u003Ctd>開關／重啟插座、群組控\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Outlet.PowerControl\u003C\u002Fcode>、\u003Ccode>OutletGroups\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>控制 ✅／群組非 OCP\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>5\u003C\u002Ftd>\n\u003Ctd>告警與事件\u003C\u002Ftd>\n\u003Ctd>訂閱、查目前告警\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>EventService\u002FSubscriptions\u003C\u002Fcode>、\u003Ccode>Events\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>訂閱 ✅\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>6\u003C\u002Ftd>\n\u003Ctd>操作與稽核日誌\u003C\u002Ftd>\n\u003Ctd>查操作／登入紀錄\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Managers\u002F...\u002FLogServices\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>✅ Baseline\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>7\u003C\u002Ftd>\n\u003Ctd>歷史趨勢\u003C\u002Ftd>\n\u003Ctd>圖表、時序資料\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>TelemetryService\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>DMTF 標準（非 OCP）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>8\u003C\u002Ftd>\n\u003Ctd>韌體更新\u003C\u002Ftd>\n\u003Ctd>上傳映像、查進度\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>UpdateService\u003C\u002Fcode>、\u003Ccode>TaskService\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>✅ Baseline\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>9\u003C\u002Ftd>\n\u003Ctd>組態備份還原\u003C\u002Ftd>\n\u003Ctd>匯出／還原參數\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>PelxConfiguration\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Pelx OEM\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>10\u003C\u002Ftd>\n\u003Ctd>進階擴充\u003C\u002Ftd>\n\u003Ctd>ATS、全介面、DI\u002FDO、排程、RS485／VNode／圖控／Flow\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>TransferSwitches\u003C\u002Fcode>、\u003Ccode>Oem\u002FPelx\u002F*\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>非 OCP\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>11\u003C\u002Ftd>\n\u003Ctd>MQTT \u002F WebSocket\u003C\u002Ftd>\n\u003Ctd>高頻即時推送、多點即時儀表板\u003C\u002Ftd>\n\u003Ctd>MQTT \u003Ccode>\u002Fupdate\u003C\u002Fcode>、\u003Ccode>\u002Fquery\u003C\u002Fcode>；對照 Redfish\u003C\u002Ftd>\n\u003Ctd>Pelx OEM\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch2 id=\"section-9\">上線與驗收\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>checklists — \u003Cstrong>OutboundConnection 上線\u003C\u002Fstrong>、\u003Cstrong>OCP 合規\u003C\u002Fstrong>、\u003Cstrong>DCIM 整合\u003C\u002Fstrong> 三份勾選表\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"section-10\">合規驗證\u003C\u002Fh2>\n\u003Cp>\u003Cstrong>實測進度參考\u003C\u002Fstrong>（Redfish Interop Validator，\u003Ccode>--authtype Session\u003C\u002Fcode>，2026-07-06）：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Profile\u003C\u002Fth>\n\u003Cth>Pass\u003C\u002Fth>\n\u003Cth>Fail\u003C\u002Fth>\n\u003Cth>Warning\u003C\u002Fth>\n\u003Cth>Not Tested\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>OCP Rack PDU v1.0.0\u003C\u002Ftd>\n\u003Ctd>884\u003C\u002Ftd>\n\u003Ctd>0\u003C\u002Ftd>\n\u003Ctd>0\u003C\u002Ftd>\n\u003Ctd>0\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>OCP Baseline Hardware Management v1.1.1\u003C\u002Ftd>\n\u003Ctd>271\u003C\u002Ftd>\n\u003Ctd>0\u003C\u002Ftd>\n\u003Ctd>0\u003C\u002Ftd>\n\u003Ctd>0\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>兩項皆 \u003Cstrong>Validation SUCCEEDED\u003C\u002Fstrong>。\u003C\u002Fp>\n\u003Cp>設備以 DMTF \u003Cstrong>Service Validator\u003C\u002Fstrong> 與 \u003Cstrong>Interop Validator\u003C\u002Fstrong> 驗證（詳見validation.md）。Interop：\u003Cstrong>OCP Rack PDU v1.0.0\u003C\u002Fstrong>（2026-07-06，884 Pass）與 \u003Cstrong>OCP Baseline Hardware Management v1.1.1\u003C\u002Fstrong>（2026-07-22，203 Pass），皆 0 Fail。自測指令見 「讀取流程」章節。\u003C\u002Fp>\n\u003Ch1 id=\"section-11\">第 1 章：整合準備\u003C\u002Fh1>\n\u003Col>\n\u003Cli>建立專用帳號（建議 \u003Ccode>viewer\u003C\u002Fcode> 唯讀監控、\u003Ccode>manager\u003C\u002Fcode> 含控制）\u003C\u002Fli>\n\u003Cli>選擇認證方式：\u003Cstrong>Basic Auth\u003C\u002Fstrong>（腳本／Validator）或 \u003Cstrong>Session Token\u003C\u002Fstrong>（長時間輪詢）\u003C\u002Fli>\n\u003Cli>匿名 \u003Ccode>GET \u002Fredfish\u002Fv1\u003C\u002Fcode> 應回 \u003Cstrong>200\u003C\u002Fstrong>（OCP Validator 需求）；子資源須認證\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Ch2 id=\"section-12\">主要 Redfish API\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>API\u003C\u002Fth>\n\u003Cth>用途\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>GET \u002Fredfish\u002Fv1\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Service Root，取得資源連結\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>GET \u002Fredfish\u002Fv1\u002FSessionService\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Session 設定（可匿名）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>POST \u002Fredfish\u002Fv1\u002FSessionService\u002FSessions\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>建立 Session，回傳 \u003Ccode>X-Auth-Token\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>DELETE \u002Fredfish\u002Fv1\u002FSessionService\u002FSessions\u002F{id}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>登出\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>POST \u002Fredfish\u002Fv1\u002FAccountService\u002FAccounts\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>建立整合帳號（須 Administrator）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>GET \u002Fredfish\u002Fv1\u002FAccountService\u002FAccounts\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>列出帳號\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch2 id=\"section-13\">OCP 範圍\u003C\u002Fh2>\n\u003Cp>✅ \u003Cstrong>OCP Service Baseline\u003C\u002Fstrong> 必填（Session、Account 等）\u003C\u002Fp>\n\u003Ch2 id=\"section-14\">建議流程\u003C\u002Fh2>\n\u003Cpre>\u003Ccode>GET \u002Fredfish\u002Fv1（可不帶認證）\n  → POST \u002FSessionService\u002FSessions（或全程 Basic）\n  → 後續請求帶 X-Auth-Token 或 Authorization: Basic\n  → 完成後 DELETE Session\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"section-15\">curl 範例\u003C\u002Fh2>\n\u003Cpre>\u003Ccode># Service Root（對外）\ncurl -sk https:\u002F\u002F<host>\u002Fredfish\u002Fv1\n\n# 建立 Session\ncurl -sk -u dcim-read:'<password>' -X POST \\\n  https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FSessionService\u002FSessions \\\n  -H 'Content-Type: application\u002Fjson' -d '{}'\n# 回應標頭 X-Auth-Token 用於後續請求\n\n# 或全程 Basic\ncurl -sk -u dcim-read:'<password>' https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FPowerEquipment\n\ncurl -sk -u admin:'<password>' -X POST \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -d '{\"UserName\":\"viewer1\",\"TokenLifetimeSeconds\":300,\"Language\":\"zh-TW\"}'\ncurl -sk -u admin:'<password>' -X POST \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -d '{\"UserName\":\"viewer1\",\"ClientIp\":\"203.0.113.50\",\"TokenLifetimeSeconds\":300}'\ncurl -sk -u admin:'<password>' -X POST \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -d '{\"UserName\":\"viewer1\",\"ReturnPath\":\"\u002Feng\u002FPeripheral\",\"ClientIp\":\"203.0.113.50\",\"TokenLifetimeSeconds\":300}'\n\n# 建立整合帳號（須 admin／Administrator）\ncurl -sk -u admin:'<password>' -X POST \\\n  https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FAccountService\u002FAccounts \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -d '{\"UserName\":\"dcim-read\",\"Password\":\"ChangeMe-Strong1\",\"RoleId\":\"ReadOnly\"}'\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>帳號建立見 「認證」章節 — AccountService（\u003Ccode>POST ...\u002FAccounts\u003C\u002Fcode>；\u003Ccode>RoleId\u003C\u002Fcode> 對應 \u003Ccode>ReadOnly\u003C\u002Fcode>／\u003Ccode>Operator\u003C\u002Fcode>／\u003Ccode>Administrator\u003C\u002Fcode>）。Web 管理亦可使用 auth \u003Ccode>POST \u002Fusers\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Ch1 id=\"section-16\">第 2 章：設備識別\u003C\u002Fh1>\n\u003Cp>取得設備型號、韌體版本、序號、UUID、機架位置（Rack／Row／Offset），供資產管理與告警關聯。\u003C\u002Fp>\n\u003Ch2 id=\"section-17\">主要 Redfish API\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>資源\u003C\u002Fth>\n\u003Cth>典型欄位\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>GET \u002Fredfish\u002Fv1\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Product\u003C\u002Fcode>、\u003Ccode>Vendor\u003C\u002Fcode>、\u003Ccode>RedfishVersion\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>GET \u002Fredfish\u002Fv1\u002FChassis\u002F1\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>SerialNumber\u003C\u002Fcode>、\u003Ccode>PartNumber\u003C\u002Fcode>、\u003Ccode>UUID\u003C\u002Fcode>、\u003Ccode>Location\u003C\u002Fcode>、\u003Ccode>PowerState\u003C\u002Fcode>、\u003Ccode>ThermalSubsystem\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>GET \u002Fredfish\u002Fv1\u002FManagers\u002F1\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>FirmwareVersion\u003C\u002Fcode>、\u003Ccode>DateTime\u003C\u002Fcode>、\u003Ccode>UUID\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>GET \u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>UserLabel\u003C\u002Fcode>、\u003Ccode>EquipmentType\u003C\u002Fcode>、\u003Ccode>SerialNumber\u003C\u002Fcode>、\u003Ccode>PartNumber\u003C\u002Fcode>、\u003Ccode>Branches\u003C\u002Fcode>、\u003Ccode>Location\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch2 id=\"section-18\">OCP 範圍\u003C\u002Fh2>\n\u003Cp>✅ \u003Cstrong>OCP Rack PDU Profile\u003C\u002Fstrong> 必填（Chassis、Manager、RackPDU 識別欄位）\u003C\u002Fp>\n\u003Ch2 id=\"section-19\">建議讀取順序\u003C\u002Fh2>\n\u003Cpre>\u003Ccode>GET \u002Fredfish\u002Fv1\n  → Chassis\u002F1\n  → Managers\u002F1\n  → PowerEquipment\u002FRackPDUs\u002F1\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>\u003Ccode>Chassis.Links.PowerDistribution\u003C\u002Fcode> 為\u003Cstrong>單一物件\u003C\u002Fstrong>（非陣列），與 \u003Ccode>RackPDUs\u003C\u002Fcode> 互相連結，可交叉驗證同一台 PDU。\u003C\u002Fp>\n\u003Cp>\u003Cstrong>序號／料號 fallback\u003C\u002Fstrong>：\u003Ccode>SerialNumber\u003C\u002Fcode> 優先 \u003Ccode>devinfo.serialNumber\u003C\u002Fcode>，否則以 MAC（\u003Ccode>ethaddr\u003C\u002Fcode>）填入；\u003Ccode>PartNumber\u003C\u002Fcode> 優先 \u003Ccode>devinfo.partNumber\u003C\u002Fcode>，否則以 \u003Ccode>Model\u003C\u002Fcode> 填入。兩欄位在 Chassis 與 RackPDU 上\u003Cstrong>一律輸出\u003C\u002Fstrong>（OCP Interop 必填）。\u003C\u002Fp>\n\u003Ch2 id=\"section-20\">curl 範例\u003C\u002Fh2>\n\u003Cpre>\u003Ccode>curl -sk -u dcim-read:'<password>' https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FChassis\u002F1\ncurl -sk -u dcim-read:'<password>' https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FManagers\u002F1\ncurl -sk -u dcim-read:'<password>' https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch1 id=\"section-21\">第 3 章：即時監控\u003C\u002Fh1>\n\u003Cp>輪詢進線（Mains）與插座（Outlets）之電壓、電流、功率、能耗；必要時讀取機櫃級彙總（Metrics）與標準感測器路徑（Chassis\u002FSensors）。\u003C\u002Fp>\n\u003Ch2 id=\"section-22\">主要 Redfish API\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>資源\u003C\u002Fth>\n\u003Cth>內容\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>...\u002FRackPDUs\u002F1\u002FMetrics\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>總功率 \u003Ccode>PowerWatts\u003C\u002Fcode>、能耗 \u003Ccode>EnergykWh\u003C\u002Fcode>、負載 \u003Ccode>PowerLoadPercent\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>...\u002FRackPDUs\u002F1\u002FMains\u002F{id}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>進線電壓、功率、能耗\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>...\u002FRackPDUs\u002F1\u002FOutlets\u002F{id}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>插座即時讀值、\u003Ccode>PowerState\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>GET \u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002F{id}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>OCP 驗證路徑\u003C\u002Fstrong>；\u003Ccode>Mains\u003C\u002Fcode>／\u003Ccode>Outlets\u003C\u002Fcode> 的 \u003Ccode>DataSourceUri\u003C\u002Fcode> 指向此處\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cblockquote>\n\u003Cp>Interop Validator 僅驗證 \u003Ccode>Chassis\u002F{id}\u002FSensors\u003C\u002Fcode>；\u003Ccode>PowerEquipment\u002F...\u002FSensors\u003C\u002Fcode> 為 DSP2056 快速查詢路徑，兩者成員一致。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch2 id=\"section-23\">OCP 範圍\u003C\u002Fh2>\n\u003Cp>✅ \u003Cstrong>OCP Rack PDU Profile\u003C\u002Fstrong> 必填（Mains、Outlets、Metrics、Sensor）\u003C\u002Fp>\n\u003Ch2 id=\"section-24\">建議讀取順序\u003C\u002Fh2>\n\u003Cpre>\u003Ccode>RackPDUs\u002F1\u002FMetrics          # 機櫃彙總\n  → Mains                   # 進線列表 → Mains\u002F{id}\n  → Outlets                 # 插座列表 → Outlets\u002F{id}\n  → Chassis\u002F1\u002FSensors       # 標準感測器（輪詢深度資料）\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>高頻輪詢建議 Session Token；唯讀帳號設 \u003Ccode>viewer\u003C\u002Fcode> 即可。\u003C\u002Fp>\n\u003Ch2 id=\"section-25\">減少請求次數\u003C\u002Fh2>\n\u003Cp>OCP \u003Cstrong>沒有\u003C\u002Fstrong>單一 API 一次回所有插座即時讀值，但可用下列標準方式降低往返：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>需求\u003C\u002Fth>\n\u003Cth>API\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>整機功率／能耗／負載\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>...\u002FMetrics\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>OCP 必填\u003C\u002Fstrong>；一次回 \u003Ccode>PowerWatts\u003C\u002Fcode>、\u003Ccode>EnergykWh\u003C\u002Fcode>、\u003Ccode>PowerLoadPercent\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>所有插座完整 JSON\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>...\u002FOutlets?$expand=.\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>須 Service Root 宣告 \u003Ccode>ExpandQuery\u003C\u002Fcode>；不支援則逐筆 \u003Ccode>GET Members\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>歷史多筆讀值\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>TelemetryService\u002FMetricReports\u002F{id}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>MetricValues[]\u003C\u002Fcode> 批量時序；見 歷史趨勢\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch2 id=\"section-26\">多點網頁即時監控\u003C\u002Fh2>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>多點即時\u003C\u002Fstrong>：指同時監控多個介面／量測點的即時更新（變更即推），\u003Cstrong>不限定\u003C\u002Fstrong>固定點數。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Cp>依 整合原則：\u003Cstrong>大量即時走 MQTT\u003C\u002Fstrong>；\u003Cstrong>DCIM 走 Redfish 常規輪詢\u003C\u002Fstrong>（見下表），兩者分工，不需額外擴充 API。\u003C\u002Fp>\n\u003Ch3 id=\"section-27\">方案取捨\u003C\u002Fh3>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>場景\u003C\u002Fth>\n\u003Cth>通道\u003C\u002Fth>\n\u003Cth>必要 API\u003C\u002Fth>\n\u003Cth>刷新\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>多點即時看板摘要\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>Redfish\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>...\u002FMetrics\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>5 秒\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Pelx 告警\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>Redfish\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>EventService\u002FSubscriptions\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>事件推送\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>第三方 DCIM\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>Redfish\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Metrics\u003C\u002Fcode>、\u003Ccode>Outlets\u003C\u002Fcode>、\u003Ccode>Mains\u003C\u002Fcode>、\u003Ccode>Sensors\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>15～60 秒\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>歷史趨勢\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>Redfish\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>TelemetryService\u002FMetricReports\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>≥ 5 秒\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>勿\u003C\u002Fstrong>以 Redfish 高頻輪詢（含 100 次逐筆 GET、\u003Ccode>Interfaces\u003C\u002Fcode> 1～2 秒輪詢）取代 MQTT；\u003Ccode>Oem\u002FPelx\u002FInterfaces\u003C\u002Fcode> 集合維持 Redfish 慣例（\u003Ccode>Members\u003C\u002Fcode> 為連結），供探索與單筆讀取即可。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch3 id=\"section-28\">專屬頁（多點即時）\u003C\u002Fh3>\n\u003Cpre>\u003Ccode>① GET \u002Fredfish\u002Fv1                   # 讀 MqttEndpoint\n② GET ...\u002FMetrics                   # 頂部摘要（5 秒）\n③ MQTT 訂閱 \u002Fupdates\u002Flocal、\u002Fupdate\u002Flocal\u002F#  # 多點即時（見第 11 章）\n④ POST ...\u002FEventService\u002FSubscriptions  # 告警\n⑤ 控制 → Outlet.PowerControl        # Redfish\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch3 id=\"section-29\">第三方 DCIM\u003C\u002Fh3>\n\u003Cpre>\u003Ccode>Metrics + Outlets\u002FMains\u002FSensors（15～60 秒）\n告警 → EventService 訂閱\n歷史 → Telemetry MetricReports\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch3 id=\"section-30\">刷新頻率\u003C\u002Fh3>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>場景\u003C\u002Fth>\n\u003Cth>間隔\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>Pelx 多點即時\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>MQTT 變更即推\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>一般 DCIM 輪詢\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>15～60 秒\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Telemetry 報告\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>≥ 5 秒\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>告警\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Event 推送\u003C\u002Fstrong>，非加頻輪詢\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-31\">UI 建議\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>\u003Cstrong>Health Rollup\u003C\u002Fstrong> 摘要（如 1 Critical、99 OK），點擊再展開明細\u003C\u002Fli>\n\u003Cli>\u003Cstrong>虛擬捲動\u003C\u002Fstrong>：大量列僅渲染可見區域\u003C\u002Fli>\n\u003Cli>依 \u003Ccode>Status.Health\u003C\u002Fcode> 綠／黃／紅標色\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>詳見 「總覽與合規」章節 — 一次回應多筆資料、「OEM 介面」章節。\u003C\u002Fp>\n\u003Cpre>\u003Ccode># 彙總量測（推薦：監控儀表板首選）\ncurl -sk -u dcim-read:'<password>' \\\n  https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FMetrics\n\n# 展開所有插座（若設備支援 $expand）\ncurl -sk -u dcim-read:'<password>' \\\n  'https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets?$expand=.'\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"section-32\">curl 範例\u003C\u002Fh2>\n\u003Cpre>\u003Ccode>curl -sk -u dcim-read:'<password>' \\\n  https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FMetrics\n\ncurl -sk -u dcim-read:'<password>' \\\n  https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets\u002F1\n\ncurl -sk -u dcim-read:'<password>' \\\n  https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FOutlet1Current\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch1 id=\"section-33\">第 4 章：電源控制\u003C\u002Fh1>\n\u003Col>\n\u003Cli>單路插座：開、關、重啟（\u003Ccode>PowerCycle\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>（選用）插座群組：一次控制多路插座\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>需 \u003Cstrong>manager\u003C\u002Fstrong> 或以上角色（Operator）。\u003C\u002Fp>\n\u003Ch2 id=\"section-34\">主要 Redfish API\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>API\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003Cth>OCP\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>POST ...\u002FOutlets\u002F{id}\u002FActions\u002FOutlet.PowerControl\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>單路控制\u003C\u002Ftd>\n\u003Ctd>✅\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>GET ...\u002FOutlet.PowerControlActionInfo\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>允許參數（\u003Ccode>On\u003C\u002Fcode>／\u003Ccode>Off\u003C\u002Fcode>／\u003Ccode>PowerCycle\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003Ctd>✅\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>POST ...\u002FOutletGroups\u002F{id}\u002FActions\u002FOutletGroup.PowerControl\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>群組批次控制\u003C\u002Ftd>\n\u003Ctd>DSP2056（非 OCP 必填）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch2 id=\"section-35\">請求範例\u003C\u002Fh2>\n\u003Cpre>\u003Ccode>{\n  \"PowerState\": \"On\"\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>重啟：\u003Ccode>\"PowerState\": \"PowerCycle\"\u003C\u002Fcode>。可選延遲：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"PowerState\": \"On\",\n  \"Oem\": { \"Pelx\": { \"OnDelaySec\": 10, \"OffDelaySec\": 10 } }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"section-36\">建議流程\u003C\u002Fh2>\n\u003Cpre>\u003Ccode>GET Outlets\u002F{id}                    # 確認 PowerState\n  → GET Outlet.PowerControlActionInfo\n  → POST Outlet.PowerControl\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>群組控制：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>GET RackPDUs\u002F1\u002FOutletGroups\n  → GET OutletGroups\u002F{id}（確認 Links.Outlets）\n  → POST OutletGroup.PowerControl\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"section-37\">curl 範例\u003C\u002Fh2>\n\u003Cpre>\u003Ccode># 關閉插座 1\ncurl -sk -u dcim-ctrl:'<password>' -X POST \\\n  https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets\u002F1\u002FActions\u002FOutlet.PowerControl \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -d '{\"PowerState\":\"Off\"}'\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch1 id=\"section-38\">第 5 章：告警與事件\u003C\u002Fh1>\n\u003Col>\n\u003Cli>\u003Cstrong>訂閱\u003C\u002Fstrong>（OCP）：建立 \u003Ccode>EventService\u002FSubscriptions\u003C\u002Fcode>，指定主機 \u003Ccode>Destination\u003C\u002Fcode> URL\u003C\u002Fli>\n\u003Cli>\u003Cstrong>查目前告警\u003C\u002Fstrong>（Pelx 擴充）：輪詢 \u003Ccode>EventService\u002FEvents\u003C\u002Fcode> 快照\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cblockquote>\n\u003Cp>訂閱持久化於設備本機；告警狀態變更時會 POST Redfish Event 至 \u003Ccode>Destination\u003C\u002Fcode>（含重試）。若需僅查目前告警而不訂閱，可輪詢 \u003Ccode>Events\u003C\u002Fcode>。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch2 id=\"section-39\">主要 Redfish API\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>API\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003Cth>OCP\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>GET \u002Fredfish\u002Fv1\u002FEventService\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>服務能力、\u003Ccode>Subscriptions\u003C\u002Fcode> 連結\u003C\u002Ftd>\n\u003Ctd>✅\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>POST \u002Fredfish\u002Fv1\u002FEventService\u002FSubscriptions\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>建立訂閱\u003C\u002Ftd>\n\u003Ctd>✅ Baseline\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>GET ...\u002FSubscriptions\u002F{id}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>查訂閱\u003C\u002Ftd>\n\u003Ctd>✅\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>DELETE ...\u002FSubscriptions\u002F{id}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>刪除訂閱\u003C\u002Ftd>\n\u003Ctd>✅\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>GET \u002Fredfish\u002Fv1\u002FEventService\u002FEvents\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>目前告警列表\u003C\u002Ftd>\n\u003Ctd>Pelx 擴充\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch2 id=\"section-40\">建議流程\u003C\u002Fh2>\n\u003Cp>\u003Cstrong>標準訂閱（OCP）\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cpre>\u003Ccode>GET EventService\n  → POST Subscriptions（Destination、EventTypes、Context）\n  → 主機接收 POST 事件（格式依 Redfish Event）\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>\u003Cstrong>僅需目前告警快照\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cpre>\u003Ccode>GET EventService\u002FEvents\n  → 必要時 GET Events\u002F{eventId}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"section-41\">OEM 擴充做法（建議）\u003C\u002Fh2>\n\u003Cp>若需兼容舊版事件欄位，請維持標準 \u003Ccode>POST \u002FEventService\u002FSubscriptions\u003C\u002Fcode>，並在 request body 加入 \u003Ccode>Oem.Pelx\u003C\u002Fcode> 參數；未來啟用實際推送時，事件 payload 也以 \u003Ccode>Oem.Pelx\u003C\u002Fcode> 附帶相容欄位。\u003Cbr>重點是：\u003Cstrong>擴充標準訂閱，不另開一套取代 \u003Ccode>Subscriptions\u003C\u002Fcode> 的私有 API\u003C\u002Fstrong>。\u003C\u002Fp>\n\u003Ch2 id=\"section-42\">curl 範例\u003C\u002Fh2>\n\u003Cpre>\u003Ccode># 建立訂閱（範例）\ncurl -sk -u dcim-ctrl:'<password>' -X POST \\\n  https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FEventService\u002FSubscriptions \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -d '{\n    \"Destination\": \"https:\u002F\u002Fdcim.example.com\u002Fredfish\u002Fevents\",\n    \"EventTypes\": [\"Alert\"],\n    \"Context\": \"dcim-prod\"\n  }'\n\n# 查目前告警\ncurl -sk -u dcim-read:'<password>' \\\n  https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FEventService\u002FEvents\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch1 id=\"section-43\">第 6 章：操作與稽核日誌\u003C\u002Fh1>\n\u003Cp>查詢設備上的\u003Cstrong>操作紀錄\u003C\u002Fstrong>（插座控制、參數變更等）與\u003Cstrong>登入／稽核紀錄\u003C\u002Fstrong>，供合規與故障追溯。\u003Cstrong>統一中控\u003C\u002Fstrong>補同步缺失事件時，另用 \u003Cstrong>seq 區間\u003C\u002Fstrong> API（見下表）。\u003C\u002Fp>\n\u003Ch2 id=\"section-44\">主要 Redfish API\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>API\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>GET \u002Fredfish\u002Fv1\u002FManagers\u002F1\u002FLogServices\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>日誌服務列表\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>GET ...\u002FLogServices\u002FOperational\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>操作日誌\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>GET ...\u002FLogServices\u002FAudit\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>稽核／登入日誌\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>GET ...\u002FLogServices\u002F{logId}\u002FEntries\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>日誌條目集合\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>GET ...\u002FEntries\u002F{entryId}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>單筆詳情\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>GET ...\u002FLogServices\u002FOem\u002FPelx\u002FMaxSeq\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>設備事件最大 \u003Ccode>seq\u003C\u002Fcode>（主機補同步用）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>GET ...\u002FLogServices\u002FOem\u002FPelx\u002FLogSync?fromSeq=&toSeq=&lang=\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>依 seq 區間拉回事件（單次最多 100 筆）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch2 id=\"section-45\">OCP 範圍\u003C\u002Fh2>\n\u003Cp>✅ \u003Cstrong>OCP Service Baseline\u003C\u002Fstrong>（Manager \u003Ccode>LogServices\u003C\u002Fcode>）\u003C\u002Fp>\n\u003Ch2 id=\"section-46\">建議流程\u003C\u002Fh2>\n\u003Cp>\u003Cstrong>OCP 日誌查詢\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cpre>\u003Ccode>GET Managers\u002F1\u002FLogServices\n  → GET LogServices\u002FOperational\u002FEntries（或 Audit）\n  → 依 Created 時間篩選；大量條目僅取最近 N 筆\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>\u003Cstrong>主機補同步缺失事件\u003C\u002Fstrong>（Pelx OEM，非 OCP 必填）\u003C\u002Fp>\n\u003Cpre>\u003Ccode>GET ...\u002FLogServices\u002FOem\u002FPelx\u002FMaxSeq\n  → 若主機 syncSeq < maxSeq\n  → GET ...\u002FLogSync?fromSeq=syncSeq+1&toSeq=min(syncSeq+100, maxSeq)&lang=zh-hant\n  → 重複直到追上 maxSeq\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"section-47\">curl 範例\u003C\u002Fh2>\n\u003Cpre>\u003Ccode>curl -sk -u dcim-read:'<password>' \\\n  https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FManagers\u002F1\u002FLogServices\u002FOperational\u002FEntries\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch1 id=\"section-48\">第 7 章：歷史趨勢\u003C\u002Fh1>\n\u003Cp>取得電力等量測的\u003Cstrong>時序資料\u003C\u002Fstrong>，繪製趨勢圖或做容量分析。Redfish 標準以 \u003Cstrong>\u003Ccode>MetricReport\u003C\u002Fcode> 的 \u003Ccode>MetricValues\u003C\u002Fcode> 陣列\u003C\u002Fstrong>提供批量讀值：一次 \u003Ccode>GET ...\u002FMetricReports\u002F{id}\u003C\u002Fcode> 可取得多筆 \u003Ccode>MetricId\u003C\u002Fcode>／\u003Ccode>MetricValue\u003C\u002Fcode>／\u003Ccode>Timestamp\u003C\u002Fcode>，無須對每個感測器逐筆輪詢歷史點。\u003Cstrong>統一中控\u003C\u002Fstrong>補同步缺失分鐘統計時，另用 \u003Cstrong>addr ＋時間區間\u003C\u002Fstrong> API（見下表）。\u003C\u002Fp>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>非 OCP 必填\u003C\u002Fstrong> — DMTF 標準 \u003Ccode>TelemetryService\u003C\u002Fcode>；僅需 OCP 合規的整合方可略過本章。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch2 id=\"section-49\">主要 Redfish API\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>API\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>GET \u002Fredfish\u002Fv1\u002FTelemetryService\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>服務入口\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>GET ...\u002FMetricReportDefinitions\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>報表定義（取樣間隔、指標）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>GET ...\u002FMetricReports\u002F{reportId}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>時序資料點（\u003Ccode>MetricValues[]\u003C\u002Fcode> 批量）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>GET ...\u002FMetricDefinitions\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>指標定義\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>GET ...\u002FOem\u002FPelx\u002FRollupRange\u002F{addr}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>各粒度保存區間（主機補同步用）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>GET ...\u002FOem\u002FPelx\u002FInterfaceRollup\u002F{addr}?startTime=&endTime=&by=\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>依時間區間拉回統計（\u003Ccode>by=1min\u003C\u002Fcode> 單次最多 120 筆）；趨勢圖加 \u003Ccode>&fill=null\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch2 id=\"section-50\">OCP 範圍\u003C\u002Fh2>\n\u003Cp>DMTF 標準（\u003Cstrong>非 OCP 必填\u003C\u002Fstrong>）\u003C\u002Fp>\n\u003Ch2 id=\"section-51\">建議流程\u003C\u002Fh2>\n\u003Cpre>\u003Ccode>GET TelemetryService\n  → MetricReportDefinitions        # RecurrenceInterval PT1M、AppendLimit 120\n  → MetricReports\u002F{id}             # MetricValues[]；可選 ?$filter=Timestamp ge ...\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cpre>\u003Ccode>curl -sk -u dcim-read:'<password>' \\\n  https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FTelemetryService\u002FMetricReports\u002FVoltageA\n\ncurl -sk -u dcim-read:'<password>' \\\n  'https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FTelemetryService\u002FMetricReports\u002FVoltageA?$filter=Timestamp%20ge%202026-06-10T07:00:00Z'\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>\u003Cstrong>主機補同步缺失分鐘統計\u003C\u002Fstrong>（Pelx OEM，非 OCP 必填）\u003C\u002Fp>\n\u003Cpre>\u003Ccode>GET ...\u002FMains\u002F{mainId} 或 ...\u002FOutlets\u002F{outletId}\n  → Oem.Pelx.Interfaces.CurrentAmps（等）.@odata.id → 取出 addr\nGET ...\u002FOem\u002FPelx\u002FRollupRange\u002F{addr}\n  → 比對設備 latest.1min 與主機 syncMinTime\n  → GET ...\u002FInterfaceRollup\u002F{addr}?startTime=syncMinTime+60&endTime=...&by=1min\n  → 單次最多 120 筆；下一批 startTime = 本批最末 time + 60\n  → 主機補件不要帶 fill\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>設備 Web 趨勢圖：同一支 \u003Ccode>InterfaceRollup\u003C\u002Fcode> 加 \u003Ccode>&fill=null\u003C\u002Fcode>，缺採樣的時間格值為 \u003Ccode>null\u003C\u002Fcode>，前端斷線。\u003C\u002Fp>\n\u003Cblockquote>\n\u003Cp>不需在 \u003Ccode>Mains\u003C\u002Fcode>／\u003Ccode>Outlets\u003C\u002Fcode> 另設 Rollup API；詳見 「歷史趨勢」章節 — 從 Mains／Outlet 取得 addr。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch1 id=\"section-52\">第 8 章：韌體更新\u003C\u002Fh1>\n\u003Cp>上傳整機設備映像（\u003Ccode>.swu\u003C\u002Fcode>）並執行 OTA，查詢 \u003Ccode>TaskService\u003C\u002Fcode> 進度。需 \u003Cstrong>admin\u003C\u002Fstrong> 或具升級權限帳號。\u003C\u002Fp>\n\u003Ch2 id=\"section-53\">主要 Redfish API\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>API\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>GET \u002Fredfish\u002Fv1\u002FUpdateService\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>服務狀態、\u003Ccode>upload\u003C\u002Fcode> 路徑\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>GET ...\u002FFirmwareInventory\u002FImage\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>目前映像版本\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>POST \u002Fredfish\u002Fv1\u002FUpdateService\u002Fupload\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>上傳映像（\u003Ccode>application\u002Foctet-stream\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>POST ...\u002FActions\u002FUpdateService.SimpleUpdate\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>從遠端 URI 拉取映像（可選）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>GET \u002Fredfish\u002Fv1\u002FTaskService\u002FTasks\u002F{id}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>升級任務進度\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cblockquote>\n\u003Cp>上傳格式：\u003Cstrong>僅\u003C\u002Fstrong> \u003Ccode>application\u002Foctet-stream\u003C\u002Fcode> 本體，\u003Cstrong>不支援\u003C\u002Fstrong> \u003Ccode>multipart\u002Fform-data\u003C\u002Fcode>。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch2 id=\"section-54\">OCP 範圍\u003C\u002Fh2>\n\u003Cp>✅ \u003Cstrong>OCP Service Baseline\u003C\u002Fstrong>（\u003Ccode>UpdateService\u003C\u002Fcode>、\u003Ccode>TaskService\u003C\u002Fcode>）\u003C\u002Fp>\n\u003Ch2 id=\"section-55\">建議流程\u003C\u002Fh2>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>Recovery 模式\u003C\u002Fstrong>：韌體更新為\u003Cstrong>停機作業\u003C\u002Fstrong>，執行期間 Redfish 可能短暫不可用。設備僅有一組可更新映像，\u003Cstrong>非\u003C\u002Fstrong>雙映像熱切換。若更新過程意外斷電，電力恢復後設備會\u003Cstrong>自動續跑\u003C\u002Fstrong>更新流程。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Cp>\u003Cstrong>本地上傳\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cpre>\u003Ccode>GET UpdateService\u002FFirmwareInventory\u002FImage   # 記錄升級前版本\n  → POST UpdateService\u002Fupload（octet-stream 寫入暫存）\n  → 設備驗證並套用韌體映像（非同步 Task）\n  → GET TaskService\u002FTasks 查進度\n  → 設備重啟後再 GET FirmwareInventory\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>\u003Cstrong>遠端 URI\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cpre>\u003Ccode>POST ...\u002FActions\u002FUpdateService.SimpleUpdate\n  Body: { \"ImageURI\": \"https:\u002F\u002F...\" }\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"section-56\">curl 範例\u003C\u002Fh2>\n\u003Cpre>\u003Ccode># 上傳映像\ncurl -sk -u admin:'<password>' -X POST \\\n  https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FUpdateService\u002Fupload \\\n  -H 'Content-Type: application\u002Foctet-stream' \\\n  --data-binary @rpm6_upgrade.swu\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch1 id=\"section-57\">第 9 章：組態備份還原\u003C\u002Fh1>\n\u003Cp>匯出設備組態檔（cfg）備份，或上傳組態還原參數（插座名稱、閾值等）。\u003Cstrong>不替換韌體映像\u003C\u002Fstrong>。\u003C\u002Fp>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>Pelx 擴充\u003C\u002Fstrong> — 非 OCP Profile 必填；OCP 合規整合若只需監控／控制可略過。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch2 id=\"section-58\">主要 Redfish API\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>API\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>GET ...\u002FUpdateService\u002FOem\u002FPelx\u002FConfiguration\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>組態服務入口\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>POST ...\u002FActions\u002FPelxConfiguration.Download\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>下載備份檔\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>POST ...\u002FActions\u002FPelxConfiguration.Upload\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>上傳還原（\u003Ccode>octet-stream\u003C\u002Fcode>，回 \u003Cstrong>202\u003C\u002Fstrong>）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>與韌體流程\u003Cstrong>分開\u003C\u002Fstrong>：勿對 \u003Ccode>UpdateService\u002Fupload\u003C\u002Fcode> 上傳組態檔。\u003C\u002Fp>\n\u003Ch2 id=\"section-59\">建議流程\u003C\u002Fh2>\n\u003Cp>\u003Cstrong>備份\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cpre>\u003Ccode>POST PelxConfiguration.Download\n  → 回應為組態二進位或導向下載\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>\u003Cstrong>還原\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cpre>\u003Ccode>POST PelxConfiguration.Upload（octet-stream）\n  → 202 已接受；背景 restore\u002Fapply\n  → 設備可能重啟，預留 rebootWaitTime\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>個別參數亦可 \u003Ccode>PATCH\u003C\u002Fcode> 各資源（如 ATS \u003Ccode>Parameters\u003C\u002Fcode>），與整包 cfg 互補。\u003C\u002Fp>\n\u003Ch1 id=\"section-60\">第 10 章：進階擴充\u003C\u002Fh1>\n\u003Cp>存取 \u003Cstrong>非 OCP 必填\u003C\u002Fstrong>能力：ATS（DMTF \u003Ccode>TransferSwitches\u003C\u002Fcode>）、Pelx OEM 介面列表（含 DI\u002FDO、E-Port 等）、排程管理，以及工程組態（RS485、VNode、圖控、自動化流程）。\u003C\u002Fp>\n\u003Cblockquote>\n\u003Cp>下列資源\u003Cstrong>不計入\u003C\u002Fstrong> OCP Rack PDU Profile 合規；整合方若只需 DCIM 標準監控／控制，可完全忽略本章。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>同一套入口\u003C\u002Fstrong>：工程組態對外只走 \u003Ccode>https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002F...\u003C\u002Fcode>，沿用 Redfish Session／Basic 與 auth.md RBAC（工程寫入須 \u003Cstrong>Administrator\u003C\u002Fstrong>）。\u003Cstrong>不\u003C\u002Fstrong>另開對外 REST。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch2 id=\"section-61\">主要 Redfish API\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>資源\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003Cth>條件\u003C\u002Fth>\n\u003Cth>最低角色\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>PowerEquipment\u002FTransferSwitches\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>ATS 狀態、Feeder A\u002FB（DMTF 標準）\u003C\u002Ftd>\n\u003Ctd>設備支援 ATS\u003C\u002Ftd>\n\u003Ctd>讀：ReadOnly；寫參數：Operator\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>...\u002FTransferSwitches\u002F{id}\u002FFeeders\u002F{A|B}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>各路進線詳情\u003C\u002Ftd>\n\u003Ctd>同上\u003C\u002Ftd>\n\u003Ctd>讀：ReadOnly\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Oem\u002FPelx\u002FInterfaces\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>完整介面列表\u003C\u002Ftd>\n\u003Ctd>永遠提供\u003C\u002Ftd>\n\u003Ctd>讀：ReadOnly\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Oem\u002FPelx\u002FInterfaces\u002F{addr}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>單一介面即時值\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>addr\u003C\u002Fcode> 見 \u003Ccode>Oem\u002FPelx\u002FInterfaces\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>讀：ReadOnly\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Oem\u002FPelx\u002FSchedules\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>排程 CRUD 與啟用\u002F停用\u003C\u002Ftd>\n\u003Ctd>有可排程輸出點\u003C\u002Ftd>\n\u003Ctd>寫：Operator\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Oem\u002FPelx\u002FSerialBuses\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>RS485 通訊參數\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>devinfo.rs485\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Administrator\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Oem\u002FPelx\u002FVNodes\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>VNode 組態／讀取測試\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>devinfo.vnode\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Administrator\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Oem\u002FPelx\u002FHmiScreens\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>圖控畫面 YAML、樣版匯出／載入\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>devinfo.hmi\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Administrator\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Oem\u002FPelx\u002FHmiImageLibraries\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>圖控圖庫 zip／圖片上傳\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>devinfo.hmi\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Administrator\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Oem\u002FPelx\u002FAutomations\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Flow DSL 佈署／啟停\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>devinfo.autoBuilder\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Administrator\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>電子鎖\u003C\u002Fstrong>為 iLock 獨立產品，非 PDU 功能；整合請見 「iLock 電子鎖」章節。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch2 id=\"section-62\">OCP 範圍\u003C\u002Fh2>\n\u003Cp>\u003Cstrong>非 OCP 必填\u003C\u002Fstrong>（含 DMTF 標準選配與 Pelx OEM）\u003C\u002Fp>\n\u003Ch2 id=\"section-63\">建議流程\u003C\u002Fh2>\n\u003Cp>\u003Cstrong>ATS\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cpre>\u003Ccode>GET PowerEquipment\u002FTransferSwitches\n  → GET TransferSwitches\u002F1\n  → GET Feeders\u002FA、Feeders\u002FB\n  → PATCH Parameters（切換參數，需權限）\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>\u003Cstrong>非標準週邊／DI\u002FDO\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cpre>\u003Ccode>GET Oem\u002FPelx\u002FInterfaces\n  → GET Oem\u002FPelx\u002FInterfaces\u002F{addr}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>\u003Cstrong>排程\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cp>控制目標以 \u003Ccode>Links.Outlets\u003C\u002Fcode>（OCP 插座）或 \u003Ccode>Links.Interfaces\u003C\u002Fcode>（\u003Ccode>DO\u003C\u002Fcode> 開頭位址，如 E-Port 等外接輸出週邊）的 \u003Ccode>@odata.id\u003C\u002Fcode> 指定。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>GET Oem\u002FPelx\u002FInterfaces（篩選 addr 以 DO 開頭）\nGET Oem\u002FPelx\u002FSchedules\n  → POST Oem\u002FPelx\u002FSchedules（新增；Links + Arg.Action）\n  → PATCH Oem\u002FPelx\u002FSchedules\u002F{id}（修改）\n  → POST ...\u002FActions\u002FPelxSchedule.SetEnabled（啟用\u002F停用）\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>\u003Cstrong>工程組態（Administrator）\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cp>建機／AI 佈署建議順序：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>GET \u002Fredfish\u002Fv1（確認 Oem.Pelx 連結）\n  → PATCH Oem\u002FPelx\u002FSerialBuses\u002F{id}（RS485）\n  → PATCH Oem\u002FPelx\u002FVNodes\u002F{id}（對應暫存器 → 介面）\n  → POST\u002FPATCH Oem\u002FPelx\u002FHmiScreens（圖控 YAML）\n  → GET ...\u002FHmiScreens\u002F{id}\u002FExport 或 POST ...\u002FImportTemplate（樣版 ZIP）\n  → POST Oem\u002FPelx\u002FHmiImageLibraries\u002FActions\u002FPelxHmiImageLibrary.Import（圖庫 zip）\n  → POST\u002FPATCH Oem\u002FPelx\u002FAutomations（Flow YAML）\n  → POST ...\u002FAutomations\u002F{id}\u002FActions\u002FPelxAutomation.SetRun\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>即時點值仍用 \u003Ccode>Oem\u002FPelx\u002FInterfaces\u003C\u002Fcode>；Flow \u003Cstrong>執行\u003C\u002Fstrong>在設備本地，Redfish 只負責組態。\u003C\u002Fp>\n\u003Ch1 id=\"section-64\">第 11 章：MQTT \u002F WebSocket（高效即時通道）\u003C\u002Fh1>\n\u003Cp>除 \u003Cstrong>OCP Redfish REST\u003C\u002Fstrong> 外，Pelx 設備另提供 \u003Cstrong>MQTT over WebSocket\u003C\u002Fstrong>，供高頻即時監控、狀態推送。本章說明與 Redfish 的\u003Cstrong>分工\u003C\u002Fstrong>、Topic 對照，以及多點網頁即時監控的建議架構。\u003C\u002Fp>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>非 OCP 標準協議\u003C\u002Fstrong>。DMTF Redfish（DSP0266）與 OCP Rack PDU Profile \u003Cstrong>未定義\u003C\u002Fstrong> MQTT 或 WebSocket；設備同時提供 Redfish 與 MQTT \u003Cstrong>不影響\u003C\u002Fstrong> OCP 合規（Redfish 資源樹須完整通過 Interop Validator）。MQTT 列為 Pelx \u003Cstrong>平行增值通道\u003C\u002Fstrong>（Sidecar Protocol）。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch2 id=\"section-65\">與 Redfish 的分工（雙軌架構）\u003C\u002Fh2>\n\u003Cp>業界慣例建議 \u003Cstrong>Redfish + MQTT 並用\u003C\u002Fstrong>，而非把 MQTT「包裝成 Redfish」：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>通道\u003C\u002Fth>\n\u003Cth>協議\u003C\u002Fth>\n\u003Cth>用途\u003C\u002Fth>\n\u003Cth>OCP\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>Redfish REST\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>HTTPS\u003C\u002Ftd>\n\u003Ctd>Discovery、Inventory、配置（PATCH）、標準告警訂閱、第三方 DCIM\u003C\u002Ftd>\n\u003Ctd>✅ 主線\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>MQTT over WS\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>WebSocket\u003C\u002Ftd>\n\u003Ctd>多點即時儀表板、變更推送、心跳\u003C\u002Ftd>\n\u003Ctd>Pelx OEM\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>EventService\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>HTTP POST 至 Destination\u003C\u002Ftd>\n\u003Ctd>低頻告警／狀態變更（OCP Baseline）\u003C\u002Ftd>\n\u003Ctd>✅\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>OutboundConnection\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>設備 → 外部 WebSocket\u003C\u002Ftd>\n\u003Ctd>防火牆後設備主動連雲端；Redfish over WS\u003C\u002Ftd>\n\u003Ctd>已實作（2023.2+）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>TelemetryService\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>REST 輪詢\u003C\u002Ftd>\n\u003Ctd>5～15 秒批量時序、歷史趨勢\u003C\u002Ftd>\n\u003Ctd>DMTF 標準（非 OCP 必填）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>\u003Cstrong>不建議\u003C\u002Fstrong>在閘道把 MQTT 逐筆轉成 Redfish Event——增加延遲與 Gateway 負擔。網頁或 BFF 可同時持有 \u003Cstrong>REST Client\u003C\u002Fstrong>（控制、探索）與 \u003Cstrong>MQTT Client\u003C\u002Fstrong>（即時顯示）。\u003C\u002Fp>\n\u003Ch3 id=\"section-66\">MQTT 能否取代 EventService？\u003C\u002Fh3>\n\u003Cp>\u003Cstrong>不能取代，應分工並用：\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>機制\u003C\u002Fth>\n\u003Cth>角色\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>EventService\u003C\u002Fstrong>（DMTF\u002FOCP）\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>標準互通告警\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>HTTP POST JSON 至 \u003Ccode>Destination\u003C\u002Fcode>；OCP Baseline；第三方 DCIM 通用\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>MQTT \u003Ccode>\u002Fupdate\u003C\u002Fcode>\u003C\u002Fstrong>（Pelx）\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>高頻 telemetry + UI 狀態\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>含 \u003Ccode>status\u003C\u002Fcode> 但語意為介面狀態碼，非 Redfish Event 格式\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cul>\n\u003Cli>\u003Cstrong>Critical／Warning 告警\u003C\u002Fstrong> → \u003Ccode>EventService\u002FSubscriptions\u003C\u002Fcode>（OCP 主線）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>儀表板數值跳動、多點同步更新\u003C\u002Fstrong> → MQTT 訂閱\u003C\u002Fli>\n\u003Cli>MQTT \u003Ccode>\u002Fupdate\u003C\u002Fcode> 的 \u003Ccode>status\u003C\u002Fcode> 可驅動 UI 變色，\u003Cstrong>不可\u003C\u002Fstrong>當作 DCIM 標準告警通道\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3 id=\"section-67\">推送機制對照\u003C\u002Fh3>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>機制\u003C\u002Fth>\n\u003Cth>傳輸\u003C\u002Fth>\n\u003Cth>標準地位\u003C\u002Fth>\n\u003Cth>適用\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>EventService\u002FSubscriptions\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>HTTP POST\u003C\u002Ftd>\n\u003Ctd>OCP Baseline\u003C\u002Ftd>\n\u003Ctd>告警、插座跳脫、標準 DCIM 事件接收\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>AccountService\u002FOutboundConnections\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>WebSocket（\u003Ccode>wss\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003Ctd>DMTF 2023.2+ 選配\u003C\u002Ftd>\n\u003Ctd>設備主動連雲端；已實作\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>SSE（\u003Ccode>EventService\u002FSSE\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003Ctd>HTTP 長連線\u003C\u002Ftd>\n\u003Ctd>DMTF 選配\u003C\u002Ftd>\n\u003Ctd>瀏覽器單向串流；連線管理不如 MQTT\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>MQTT \u003Ccode>\u002Fupdate\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>WebSocket\u003C\u002Ftd>\n\u003Ctd>Pelx 實務\u003C\u002Ftd>\n\u003Ctd>介面 value\u002Fstatus \u003Cstrong>變更即推\u003C\u002Fstrong>；多點即時儀表板首選\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch2 id=\"section-68\">連線方式\u003C\u002Fh2>\n\u003Ch3 id=\"section-69\">透過 Redfish Discovery（建議，DCIM）\u003C\u002Fh3>\n\u003Cp>整合方先讀 Redfish OEM 取得 MQTT URL，再以 \u003Cstrong>Redfish Session\u003C\u002Fstrong> 或 \u003Cstrong>Basic Auth\u003C\u002Fstrong> 連 WebSocket：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>GET \u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FMqtt   → Endpoint、MqttAuth\nPOST ...\u002FSessionService\u002FSessions   → X-Auth-Token（或 Basic Auth）\nWebSocket connect Endpoint         → 帶 X-Auth-Token 或 Authorization\nsubscribe \u002Fupdates\u002Flocal、\u002Fupdate\u002Flocal\u002F#\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>欄位定義見 「MQTT Discovery」章節。\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>欄位\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>Endpoint\u003C\u002Fstrong> \u002F \u003Cstrong>MqttEndpoint\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>wss:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FMqtt\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>MqttAuth\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>RedfishSession\u003C\u002Fcode>（\u003Ccode>X-Auth-Token\u003C\u002Fcode> 或 Basic Auth）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>\u003Cstrong>工具測試\u003C\u002Fstrong>：完整 MQTT 訂閱請用 \u003Cstrong>MQTTX CLI ≥ 1.11\u003C\u002Fstrong>（\u003Ccode>-wh\u003C\u002Fcode> 帶 HTTP Header、\u003Ccode>--insecure\u003C\u002Fcode> 略過自簽憑證）或 \u003Cstrong>mqtt.js\u003C\u002Fstrong>；MQTTX Desktop／Postman MQTT Request \u003Cstrong>無法\u003C\u002Fstrong>設定 WebSocket 握手 Header。curl 可驗 HTTP 401／WebSocket 101。範例見 「MQTT Discovery」章節。\u003C\u002Fp>\n\u003Cp>\u003Cstrong>Postman\u003C\u002Fstrong>：HTTP GET 與 \u003Cstrong>WebSocket\u003C\u002Fstrong> Request 可在 Headers 手動加 \u003Ccode>X-Auth-Token\u003C\u002Fcode> 或 \u003Ccode>Authorization: Basic ...\u003C\u002Fcode>；\u003Cstrong>MQTT\u003C\u002Fstrong> Request 的 Authorization 分頁會變成 \u003Cstrong>MQTT CONNECT 帳密\u003C\u002Fstrong>，不可用於 Redfish 路徑。\u003C\u002Fp>\n\u003Ch2 id=\"section-70\">Topic ↔ Redfish 對照\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>MQTT Topic\u003C\u002Fth>\n\u003Cth>方向\u003C\u002Fth>\n\u003Cth>對應 Redfish\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>\u003Ccode>\u002Fupdates\u002Flocal\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>設備 → 客戶端\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Oem\u002FPelx\u002FInterfaces\u003C\u002Fcode> 批量\u003C\u002Ftd>\n\u003Ctd>每秒 \u003Ccode>value\u003C\u002Fcode> 物件；\u003Ccode>local\u003C\u002Fcode> = \u003Cstrong>本機週邊\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>\u003Ccode>\u002Fupdate\u002Flocal\u002F{addr}\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>設備 → 客戶端\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Oem\u002FPelx\u002FInterfaces\u002F{addr}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>單點 \u003Ccode>value\u003C\u002Fcode>／\u003Ccode>status\u003C\u002Fcode> 變更\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>\u003Ccode>\u002Fupdates\u002FePort\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>設備 → 客戶端\u003C\u002Ftd>\n\u003Ctd>E-Port 相關\u003C\u002Ftd>\n\u003Ctd>若有 E-Port\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-71\">控制與寫入\u003C\u002Fh3>\n\u003Cp>\u003Cstrong>新整合的控制一律走 Redfish\u003C\u002Fstrong>：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>需求\u003C\u002Fth>\n\u003Cth>Redfish\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>插座開／關／重啟\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>POST ...\u002FOutlets\u002F{id}\u002FActions\u002FOutlet.PowerControl\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>DO／E-Port／DI 等\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>PATCH ...\u002FOem\u002FPelx\u002FInterfaces\u002F{addr}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>批量讀即時值\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>GET ...\u002FOem\u002FPelx\u002FInterfaces\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>告警門檻\u003C\u002Ftd>\n\u003Ctd>Sensor／Outlet 閾值\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch2 id=\"section-72\">多點網頁即時監控\u003C\u002Fh2>\n\u003Cp>與 第 3 章 互補：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>方案\u003C\u002Fth>\n\u003Cth>請求／連線\u003C\u002Fth>\n\u003Cth>刷新\u003C\u002Fth>\n\u003Cth>適用\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>MQTT 訂閱 \u003Ccode>\u002Fupdates\u002Flocal\u003C\u002Fcode>、\u003Ccode>\u002Fupdate\u002Flocal\u002F#\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>1 條 WS 長連線\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>變更即推\u003C\u002Fstrong>（≈1～2 秒級）\u003C\u002Ftd>\n\u003Ctd>Pelx \u003Cstrong>專屬\u003C\u002Fstrong>監控頁、多點即時儀表板\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>\u003Ccode>TelemetryService\u002FMetricReports\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>HTTP 輪詢\u003C\u002Ftd>\n\u003Ctd>≥ 5 秒\u003C\u002Ftd>\n\u003Ctd>OCP／第三方 DCIM、歷史趨勢\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>\u003Ccode>EventService\u002FSubscriptions\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>HTTP POST 推送\u003C\u002Ftd>\n\u003Ctd>事件驅動\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>告警\u003C\u002Fstrong>，非連續數值\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>依 整合原則：\u003Cstrong>Pelx 多點即時看板只用 MQTT\u003C\u002Fstrong>；DCIM 只用 Redfish 常規輪詢，兩者不混用、不需額外 API。\u003C\u002Fp>\n\u003Ch3 id=\"section-73\">建議前端流程\u003C\u002Fh3>\n\u003Cpre>\u003Ccode>① Redfish GET \u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FMqtt  # Endpoint、MqttAuth\n② POST SessionService\u002FSessions              # X-Auth-Token（DCIM）\n③ MQTT connect Endpoint                     # 訂閱 \u002Fupdates\u002Flocal、\u002Fupdate\u002Flocal\u002F#\n④ Redfish GET ...\u002FMetrics                   # 頂部摘要（5 秒）\n⑤ Redfish POST ...\u002FEventService\u002FSubscriptions  # 告警\n⑥ 控制 → Outlet.PowerControl                # Redfish\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2 id=\"section-74\">OCP 合規與文件位置\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Cp>MQTT \u003Cstrong>不寫入\u003C\u002Fstrong> OCP 必填 spec 章節；連線資訊見 「MQTT Discovery」章節\u003C\u002Fp>\n\u003C\u002Fli>\n\u003Cli>\u003Cp>Topic 定義見 「MQTT Discovery」章節\u003C\u002Fp>\n\u003C\u002Fli>\n\u003Cli>\u003Cp>告警與事件\u003C\u002Fp>\n\u003C\u002Fli>\n\u003Cli>\u003Cp>進階擴充\u003C\u002Fp>\n\u003C\u002Fli>\n\u003Cli>\u003Cp>「MQTT Discovery」章節\u003C\u002Fp>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch1 id=\"section-75\">第二部分 API 規格\u003C\u002Fh1>\n\u003Cp>本部分為各 Redfish 資源的完整欄位定義、JSON 範例與 Pelx OEM 擴充說明。\u003C\u002Fp>\n\u003Ch1 id=\"section-76\">API 規格索引\u003C\u002Fh1>\n\u003Cp>下列為 Redfish API 規格章節索引。\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>模組\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>總覽與合規\u003C\u002Ftd>\n\u003Ctd>協議範圍、OCP Profile 對照、服務資訊、通用欄位\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>驗證紀錄\u003C\u002Ftd>\n\u003Ctd>Redfish 版本、Profile、Service／Interop Validator、日期與範圍\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>設施 Redfish 落地契約\u003C\u002Ftd>\n\u003Ctd>LeakZone／CDU URI 定稿、必填欄位、分期驗收\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>CDU 共通介面\u003C\u002Ftd>\n\u003Ctd>角色鍵→Sensor；對上 Redfish；一個 CDU 畫面\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>AI 機房資源樹（說明）\u003C\u002Ftd>\n\u003Ctd>圖解；衝突時以契約為準\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>認證\u003C\u002Ftd>\n\u003Ctd>SessionService、AccountService（帳號 CRUD、密碼政策、LDAP／RADIUS／TACACS+）、CertificateService（含 UACME）、Basic／Token、\u003Cstrong>RBAC 與文件撰寫慣例\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>探索與識別\u003C\u002Ftd>\n\u003Ctd>Service Root、Chassis、Managers、RackPDUs\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>網路協定\u003C\u002Ftd>\n\u003Ctd>NetworkProtocol（NTP、SNMP、SSH、ICMP）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>電力與配電\u003C\u002Ftd>\n\u003Ctd>PowerEquipment、Mains、Metrics、Sensors\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>ATS 轉換開關\u003C\u002Ftd>\n\u003Ctd>TransferSwitches、Feeders（DSP2056；設備支援 ATS 時）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>插座\u003C\u002Ftd>\n\u003Ctd>Outlets、PowerControl\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>插座群組\u003C\u002Ftd>\n\u003Ctd>OutletGroups（DSP2056）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>環境感測\u003C\u002Ftd>\n\u003Ctd>Chassis Thermal\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>告警與事件\u003C\u002Ftd>\n\u003Ctd>EventService、Subscriptions\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>出站連線\u003C\u002Ftd>\n\u003Ctd>AccountService\u002FOutboundConnections（WebSocket）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>歷史訊息\u003C\u002Ftd>\n\u003Ctd>Managers LogServices\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>歷史趨勢\u003C\u002Ftd>\n\u003Ctd>TelemetryService\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>韌體與組態\u003C\u002Ftd>\n\u003Ctd>UpdateService、TaskService、PelxConfiguration\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>讀取流程\u003C\u002Ftd>\n\u003Ctd>curl、redfishtool、OCP Interop Validator\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>錯誤回應\u003C\u002Ftd>\n\u003Ctd>通用 HTTP／Redfish 錯誤格式\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch2 id=\"section-77\">其他產品（非 PDU）\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>模組\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>iLock 電子鎖主機\u003C\u002Ftd>\n\u003Ctd>門禁控制、卡號、參數（iLock 電子鎖主機）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch2 id=\"section-78\">Pelx 擴充\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>模組\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>擴充總覽\u003C\u002Ftd>\n\u003Ctd>OEM 路徑說明（含工程組態同一入口）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>OEM 介面\u003C\u002Ftd>\n\u003Ctd>Oem\u002FPelx\u002FInterfaces\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>週邊樹\u003C\u002Ftd>\n\u003Ctd>Oem\u002FPelx\u002FPeripheralTree\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>MQTT Discovery\u003C\u002Ftd>\n\u003Ctd>Oem.Pelx.MqttEndpoint\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>排程\u003C\u002Ftd>\n\u003Ctd>Oem\u002FPelx\u002FSchedules\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>RS485\u003C\u002Ftd>\n\u003Ctd>Oem\u002FPelx\u002FSerialBuses\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>VNode\u003C\u002Ftd>\n\u003Ctd>Oem\u002FPelx\u002FVNodes\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>圖控\u003C\u002Ftd>\n\u003Ctd>Oem\u002FPelx\u002FHmiScreens（含樣版 Export／ImportTemplate）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>圖庫\u003C\u002Ftd>\n\u003Ctd>Oem\u002FPelx\u002FHmiImageLibraries\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>自動化流程\u003C\u002Ftd>\n\u003Ctd>Oem\u002FPelx\u002FAutomations\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>E-Port 週邊\u003C\u002Ftd>\n\u003Ctd>內部 \u003Ccode>GET\u002FPATCH \u002Fe-ports\u002F{port}\u002Fperipherals\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch1 id=\"section-79\">Redfish API 總覽\u003C\u002Fh1>\n\u003Cp>以下 API 皆以對外入口 \u003Ccode>https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002F...\u003C\u002Fcode> 撰寫。\u003C\u002Fp>\n\u003Ch2 id=\"section-80\">協議範圍\u003C\u002Fh2>\n\u003Cp>本文件描述 \u003Cstrong>OCP Rack PDU Profile v1.0.0\u003C\u002Fstrong>（\u003Ca rel=\"noopener noreferrer\" href=\"https:\u002F\u002Fgithub.com\u002Fopencomputeproject\u002FHWMgmt-OCP-Profiles\u002Fblob\u002Fmaster\u002FRackAndPower\u002FOCPRackPDU.v1_0_0.json\">OCPRackPDU.v1_0_0.json\u003C\u002Fa>）及相依的 \u003Cstrong>OCP Service Baseline v1.0.0\u003C\u002Fstrong> 所要求的 Redfish REST API，並以 \u003Ca rel=\"noopener noreferrer\" href=\"https:\u002F\u002Fwww.dmtf.org\u002Fsites\u002Fdefault\u002Ffiles\u002Fstandards\u002Fdocuments\u002FDSP2056_1.1.0.pdf\">DMTF DSP2056\u003C\u002Fa> 為資源模型基礎。Pelx OEM 路徑（\u003Ccode>Oem\u002FPelx\u002F*\u003C\u002Fcode>）列於 Pelx 擴充 章節，\u003Cstrong>不計入\u003C\u002Fstrong> OCP Profile 合規範圍。\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>項目\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>介面風格\u003C\u002Ftd>\n\u003Ctd>HTTP RESTful，\u003Ccode>GET\u003C\u002Fcode> \u002F \u003Ccode>POST\u003C\u002Fcode> \u002F \u003Ccode>PATCH\u003C\u002Fcode> \u002F \u003Ccode>DELETE\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>資料格式\u003C\u002Ftd>\n\u003Ctd>JSON，含 \u003Ccode>@odata.id\u003C\u002Fcode>、\u003Ccode>@odata.type\u003C\u002Fcode> 等 Redfish 標準欄位\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>根路徑\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>\u002Fredfish\u002Fv1\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>認證\u003C\u002Ftd>\n\u003Ctd>HTTP Basic Auth，或 \u003Ccode>SessionService\u003C\u002Fcode> + \u003Ccode>X-Auth-Token\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Profile\u003C\u002Ftd>\n\u003Ctd>OCP Rack PDU 1.0.0 + OCP Service Baseline 1.0.0（RequiredProfiles）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch2 id=\"section-81\">設計依據\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>來源\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ca rel=\"noopener noreferrer\" href=\"https:\u002F\u002Fgithub.com\u002Fopencomputeproject\u002FHWMgmt-OCP-Profiles\u002Fblob\u002Fmaster\u002FRackAndPower\u002FOCPRackPDU.v1_0_0.json\">OCP Rack PDU Profile v1.0.0\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>主要合規依據\u003C\u002Fstrong>；PDU 量測、插座、Metrics、Circuit 等必填欄位\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca rel=\"noopener noreferrer\" href=\"https:\u002F\u002Fgithub.com\u002Fopencomputeproject\u002FHWMgmt-OCP-Profiles\u002Fblob\u002Fmaster\u002FOCPServiceBaseline.v1_0_0.json\">OCP Service Baseline v1.0.0\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>ServiceRoot、Manager、Session、Account、UpdateService、TaskService\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>OCP Rack PDU Usage Guide\u003C\u002Ftd>\n\u003Ctd>Profile 使用案例與 JSON 範例\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca rel=\"noopener noreferrer\" href=\"https:\u002F\u002Fwww.dmtf.org\u002Fsites\u002Fdefault\u002Ffiles\u002Fstandards\u002Fdocuments\u002FDSP2056_1.1.0.pdf\">DMTF DSP2056 — Redfish for Power Distribution Equipment\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Rack PDU 資源樹、Circuit、Outlet、PowerEquipment 標準模型\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ca rel=\"noopener noreferrer\" href=\"https:\u002F\u002Fredfish.redoc.ly\u002Fdocs\u002Fconcepts\u002Fredfishauthentication\u002F\">Redfish Authentication\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Session Token 與 \u003Ccode>X-Auth-Token\u003C\u002Fcode> 使用方式\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch2 id=\"section-82\">OCP Rack PDU Profile 對照\u003C\u002Fh2>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>驗證故事總表\u003C\u002Fstrong>（版本、兩種 Validator、日期、範圍）：見 validation。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Cp>Profile 定義 \u003Cstrong>Mandatory\u003C\u002Fstrong> 資源與欄位；實作須通過 \u003Ca rel=\"noopener noreferrer\" href=\"https:\u002F\u002Fgithub.com\u002FDMTF\u002FRedfish-Interop-Validator\">Redfish Interop Validator\u003C\u002Fa> 搭配下列兩份 JSON 驗證：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>路徑（HWMgmt-OCP-Profiles 倉庫）\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>RackAndPower\u002FOCPRackPDU.v1_0_0.json\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>OCPServiceBaseline.v1_0_0.json\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cpre>\u003Ccode>git clone https:\u002F\u002Fgithub.com\u002Fopencomputeproject\u002FHWMgmt-OCP-Profiles.git\npipx install redfish-interop-validator\n\nrf_interop_validator \\\n  -r https:\u002F\u002F<host> \\\n  -u admin -p '<password>' \\\n  --authtype Basic \\\n  --required_profiles_dir .\u002FHWMgmt-OCP-Profiles \\\n  .\u002FHWMgmt-OCP-Profiles\u002FRackAndPower\u002FOCPRackPDU.v1_0_0.json\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cblockquote>\n\u003Cp>Profile 目前為 \u003Cstrong>Draft\u003C\u002Fstrong>（\u003Ccode>RackAndPower\u002F\u003C\u002Fcode> 子目錄）。本文件 JSON 範例以通過上述 Validator 為目標撰寫。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Cp>\u003Cstrong>實測進度參考\u003C\u002Fstrong>（Redfish Interop Validator，\u003Ccode>--authtype Session\u003C\u002Fcode>，2026-07-06）：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Profile\u003C\u002Fth>\n\u003Cth>Pass\u003C\u002Fth>\n\u003Cth>Fail\u003C\u002Fth>\n\u003Cth>Warning\u003C\u002Fth>\n\u003Cth>Not Tested\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>OCP Rack PDU v1.0.0\u003C\u002Ftd>\n\u003Ctd>884\u003C\u002Ftd>\n\u003Ctd>0\u003C\u002Ftd>\n\u003Ctd>0\u003C\u002Ftd>\n\u003Ctd>0\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>OCP Baseline Hardware Management v1.1.1\u003C\u002Ftd>\n\u003Ctd>271\u003C\u002Ftd>\n\u003Ctd>0\u003C\u002Ftd>\n\u003Ctd>0\u003C\u002Ftd>\n\u003Ctd>0\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>兩項皆 \u003Cstrong>Validation SUCCEEDED\u003C\u002Fstrong>。\u003C\u002Fp>\n\u003Ch3 id=\"section-83\">Profile 必填資源（摘要）\u003C\u002Fh3>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Schema\u003C\u002Fth>\n\u003Cth>URI 範例\u003C\u002Fth>\n\u003Cth>Profile 重點\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>ServiceRoot\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>\u002Fredfish\u002Fv1\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>PowerEquipment\u003C\u002Fcode>（PDU Profile）；Baseline 另須 \u003Ccode>CertificateService\u003C\u002Fcode>、\u003Ccode>Product\u003C\u002Fcode>、\u003Ccode>Vendor\u003C\u002Fcode>、\u003Ccode>ProtocolFeaturesSupported\u003C\u002Fcode>、\u003Ccode>UpdateService\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>PowerEquipment\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>\u002Fredfish\u002Fv1\u002FPowerEquipment\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>須含 \u003Ccode>RackPDUs\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>PowerDistribution\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>...\u002FRackPDUs\u002F{rackId}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>EquipmentType=RackPDU\u003C\u002Fcode>、\u003Ccode>UserLabel\u003C\u002Fcode>、\u003Ccode>Metrics\u003C\u002Fcode>、\u003Ccode>Mains\u003C\u002Fcode>、\u003Ccode>Branches\u003C\u002Fcode>、\u003Ccode>Outlets\u003C\u002Fcode>、\u003Ccode>Links\u003C\u002Fcode>、\u003Ccode>Location\u003C\u002Fcode>、\u003Ccode>UUID\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>PowerDistributionMetrics\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>...\u002FRackPDUs\u002F{rackId}\u002FMetrics\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>PowerWatts\u003C\u002Fcode>、\u003Ccode>EnergykWh\u003C\u002Fcode>、\u003Ccode>PowerLoadPercent\u003C\u002Fcode>；Action \u003Ccode>ResetMetrics\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Circuit（Mains）\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>...\u002FMains\u002F{id}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>CircuitType=Mains\u003C\u002Fcode>、\u003Ccode>UserLabel\u003C\u002Fcode>、\u003Ccode>ElectricalContext\u003C\u002Fcode>、\u003Ccode>PowerWatts\u003C\u002Fcode>、\u003Ccode>EnergykWh\u003C\u002Fcode>、\u003Ccode>Voltage\u003C\u002Fcode> 或 \u003Ccode>PolyPhaseVoltage\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Circuit（Branch）\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>...\u002FBranches\u002F{id}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>集合必須存在（可為空）；\u003Ccode>Links.Outlets\u003C\u002Fcode> 映射插座\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Outlet\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>...\u002FOutlets\u002F{id}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>ElectricalContext\u003C\u002Fcode>（\u003Ccode>Line1\u003C\u002Fcode>／\u003Ccode>Line2\u003C\u002Fcode>／\u003Ccode>Line3\u003C\u002Fcode>）、\u003Ccode>PowerRestorePolicy\u003C\u002Fcode>、\u003Ccode>Links.BranchCircuit\u003C\u002Fcode>（Mandatory）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Sensor\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>\u003Ccode>\u002Fredfish\u002Fv1\u002FChassis\u002F{id}\u002FSensors\u002F{sensorId}\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Reading\u003C\u002Fcode>、\u003Ccode>ReadingType\u003C\u002Fcode>、\u003Ccode>ReadingTime\u003C\u002Fcode>、\u003Ccode>SensingInterval\u003C\u002Fcode>；電氣量測須 \u003Ccode>ElectricalContext\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Chassis\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>\u002Fredfish\u002Fv1\u002FChassis\u002F{id}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>SerialNumber\u003C\u002Fcode>、\u003Ccode>PartNumber\u003C\u002Fcode>、\u003Ccode>Links.PowerDistribution\u003C\u002Fcode>（\u003Cstrong>物件\u003C\u002Fstrong>，非陣列）、\u003Ccode>Links.ManagedBy\u003C\u002Fcode>、\u003Ccode>Sensors\u003C\u002Fcode>、\u003Ccode>ThermalSubsystem\u003C\u002Fcode>、\u003Ccode>Location\u003C\u002Fcode>、\u003Ccode>PowerState\u003C\u002Fcode>、\u003Ccode>UUID\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>EventService\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>\u002Fredfish\u002Fv1\u002FEventService\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Subscriptions\u003C\u002Fcode>（Baseline）；\u003Ccode>RegistryPrefixes\u003C\u002Fcode> 建議含 \u003Ccode>Power\u003C\u002Fcode>、\u003Ccode>SensorEvent\u003C\u002Fcode>、\u003Ccode>Update\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Registries\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>\u002Fredfish\u002Fv1\u002FRegistries\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>標準錯誤訊息註冊表（DMTF 建議）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Manager\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>\u002Fredfish\u002Fv1\u002FManagers\u002F{id}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>DateTime\u003C\u002Fcode>、\u003Ccode>UUID\u003C\u002Fcode>、\u003Ccode>FirmwareVersion\u003C\u002Fcode>、\u003Ccode>EthernetInterfaces\u003C\u002Fcode>、\u003Ccode>LogServices\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Session \u002F Account \u002F Certificate \u002F Update \u002F Task\u003C\u002Ftd>\n\u003Ctd>見各章節\u003C\u002Ftd>\n\u003Ctd>依 OCP Service Baseline\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-84\">管理與安全 API OCP 合規對照\u003C\u002Fh3>\n\u003Cp>下列為近期補強的 \u003Cstrong>AccountService\u003C\u002Fstrong>、\u003Cstrong>CertificateService\u003C\u002Fstrong>、\u003Cstrong>NetworkProtocol\u003C\u002Fstrong> 等管理面 API。OCP \u003Cstrong>Mandatory\u003C\u002Fstrong> 表示 Interop Validator（搭配 Service Baseline）會檢查；\u003Cstrong>Recommended\u003C\u002Fstrong> 為建議實作；\u003Cstrong>Oem\u003C\u002Fstrong> 為 Pelx 擴充，\u003Cstrong>不計入\u003C\u002Fstrong> Profile 合規，但符合 DMTF「標準路徑 + Oem 延伸」慣例（參考 Vertiv 等 PDU Redfish 實務）。\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>功能\u003C\u002Fth>\n\u003Cth>Redfish 路徑\u003C\u002Fth>\n\u003Cth>OCP／DMTF\u003C\u002Fth>\n\u003Cth>規格\u003C\u002Fth>\n\u003Cth>備註\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>帳號 CRUD\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>AccountService\u002FAccounts\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Mandatory\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>認證\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>POST\u003C\u002Fcode> 須 201 + \u003Ccode>Location\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>角色三類\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>AccountService\u002FRoles\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Mandatory\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>認證\u003C\u002Ftd>\n\u003Ctd>Administrator／Operator／ReadOnly\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>密碼長度\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>AccountService\u003C\u002Fcode> \u003Ccode>MinPasswordLength\u003C\u002Fcode> 等\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Mandatory\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>認證\u003C\u002Ftd>\n\u003Ctd>Vertiv 等皆有\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>密碼複雜度\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Oem.Pelx.PasswordPolicy\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Oem\u003C\u002Ftd>\n\u003Ctd>認證\u003C\u002Ftd>\n\u003Ctd>複雜度規則放 Oem\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>LDAP\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>AccountService.LDAP\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Recommended\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>認證\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>PATCH AccountService\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>RADIUS\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Oem.Pelx.Radius\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Oem\u003C\u002Ftd>\n\u003Ctd>認證\u003C\u002Ftd>\n\u003Ctd>DMTF 無單一標準屬性\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>TACACS+\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Oem.Pelx.Tacacs\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Oem\u003C\u002Ftd>\n\u003Ctd>認證\u003C\u002Ftd>\n\u003Ctd>Pelx OEM\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>LDAP／RADIUS／TACACS+ 測試\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Actions\u002FPelxAccountService.Test*\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Oem\u003C\u002Ftd>\n\u003Ctd>認證\u003C\u002Ftd>\n\u003Ctd>廠商加值 Action\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>OutboundConnection\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>AccountService\u002FOutboundConnections\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>選配（2023.2+）\u003C\u002Ftd>\n\u003Ctd>outbound connection\u003C\u002Ftd>\n\u003Ctd>設備主動 WebSocket 連雲端\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>手動憑證 CSR\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>CertificateService.GenerateCSR\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Mandatory\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>認證\u003C\u002Ftd>\n\u003Ctd>須 \u003Ccode>CertificateMode=manual\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>NTP\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>NetworkProtocol.NTP\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Mandatory\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>網路協定\u003C\u002Ftd>\n\u003Ctd>Vertiv：可 PATCH \u003Ccode>NTPServers\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>SNMP\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>NetworkProtocol.SNMP\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Mandatory\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>網路協定\u003C\u002Ftd>\n\u003Ctd>基本開關；v3 細節放 Oem\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>SSH\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>NetworkProtocol.SSH\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Mandatory\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>網路協定\u003C\u002Ftd>\n\u003Ctd>生產預設可 \u003Ccode>false\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>ICMP ping\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Oem.Pelx.ICMPEchoReply\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Oem\u003C\u002Ftd>\n\u003Ctd>網路協定\u003C\u002Ftd>\n\u003Ctd>DMTF 無標準屬性\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>SNMP Agent 細節\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Oem.Pelx.SNMPAgent\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Oem\u003C\u002Ftd>\n\u003Ctd>網路協定\u003C\u002Ftd>\n\u003Ctd>GET 不回傳 community 明文\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>\u003Cstrong>Validator 額外檢查點\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cul>\n\u003Cli>密碼不符政策：回傳標準 \u003Ccode>error\u003C\u002Fcode>（如 \u003Ccode>PropertyValueIncorrect\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Ccode>NetworkProtocol\u003C\u002Fcode>：\u003Ccode>ProtocolEnabled\u003C\u002Fcode>、\u003Ccode>Port\u003C\u002Fcode> 型別正確；非法 NTP 伺服器回 \u003Cstrong>400\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>\u003Ccode>CertificateService\u003C\u002Fcode>：建議提供 \u003Ccode>GenerateCSRActionInfo\u003C\u002Fcode>（\u003Ccode>@Redfish.ActionInfo\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>所有資源須含 \u003Ccode>@odata.type\u003C\u002Fcode>；可寫資源建議含 \u003Ccode>Allow\u003C\u002Fcode> 與 \u003Ccode>@Redfish.WriteableProperties\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3 id=\"section-85\">Sensor 雙路徑說明\u003C\u002Fh3>\n\u003Cp>OCP Profile 規定 Sensor 資源 URI 為 \u003Cstrong>\u003Ccode>Chassis\u002F{chassisId}\u002FSensors\u002F{sensorId}\u003C\u002Fcode>\u003C\u002Fstrong>。Pelx 另於 \u003Ccode>PowerEquipment\u002FRackPDUs\u002F{rackId}\u002FSensors\u003C\u002Fcode> 暴露相同量測（DSP2056 配電模型）；\u003Cstrong>Interop Validator 僅驗證 Chassis 路徑\u003C\u002Fstrong>。實作須：\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Ccode>Chassis\u002F1\u002FSensors\u003C\u002Fcode> 列出所有電氣與環境溫度感測器（與 RackPDU \u003Ccode>Sensors\u003C\u002Fcode> 成員一致；溫度 \u003Ccode>{id}\u003C\u002Fcode> 如 \u003Ccode>Temp1\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Ccode>Mains\u003C\u002Fcode>／\u003Ccode>Outlets\u003C\u002Fcode>／\u003Ccode>Metrics\u003C\u002Fcode> 的 \u003Ccode>DataSourceUri\u003C\u002Fcode> 指向 \u003Ccode>Chassis\u002F1\u002FSensors\u002F...\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Ccode>PowerEquipment\u002F...\u002FSensors\u003C\u002Fcode> 保留供配電整合快速查詢（非 OCP 驗證路徑）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3 id=\"section-86\">一次回應多筆資料\u003C\u002Fh3>\n\u003Cp>Redfish／OCP \u003Cstrong>沒有\u003C\u002Fstrong>獨立的「bulk read」端點，但 DMTF 標準提供多種機制，讓 DCIM 客戶端\u003Cstrong>減少 HTTP 往返\u003C\u002Fstrong>、一次取得多筆讀值或多個子資源。整合方應依場景選擇：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>機制\u003C\u002Fth>\n\u003Cth>一次取得什麼\u003C\u002Fth>\n\u003Cth>OCP／Baseline\u003C\u002Fth>\n\u003Cth>典型 URL\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>資源內多欄位\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>單一資源含多個即時量測\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Metrics Mandatory\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>GET ...\u002FRackPDUs\u002F1\u002FMetrics\u003C\u002Fcode> → \u003Ccode>PowerWatts\u003C\u002Fcode>、\u003Ccode>EnergykWh\u003C\u002Fcode>、\u003Ccode>PowerLoadPercent\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Collection \u003Ccode>Members\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>多筆子資源\u003Cstrong>連結\u003C\u002Fstrong>（\u003Ccode>@odata.id\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003Ctd>各集合 \u003Cstrong>Mandatory\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>GET ...\u002FOutlets\u003C\u002Fcode> → 所有插座 URI 列表\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>\u003Ccode>$expand\u003C\u002Fcode> 查詢\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>集合＋各成員\u003Cstrong>完整 JSON\u003C\u002Fstrong> 內嵌\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>ExpandQuery\u003C\u002Fcode> \u003Cstrong>Recommended\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>GET ...\u002FOutlets?$expand=.\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>\u003Ccode>$expand\u003C\u002Fcode> 多層\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>PDU 與下層子資源一次展開\u003C\u002Ftd>\n\u003Ctd>同上（須服務支援）\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>GET ...\u002FRackPDUs\u002F1?$expand=.($levels=2)\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>\u003Ccode>TelemetryService\u003C\u002Fcode> \u003Ccode>MetricReports\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>歷史量測\u003Cstrong>陣列\u003C\u002Fstrong>（多時間點、可多 Metric）\u003C\u002Ftd>\n\u003Ctd>DMTF 標準；\u003Cstrong>非 OCP 必填\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>GET ...\u002FMetricReports\u002F{id}\u003C\u002Fcode> → \u003Ccode>MetricValues[]\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>\u003Ccode>OutletGroup.PowerControl\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>一次 Action \u003Cstrong>控制\u003C\u002Fstrong>群組內多插座（寫入）\u003C\u002Ftd>\n\u003Ctd>DSP2056；\u003Cstrong>非 OCP 必填\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>POST ...\u002FOutletGroups\u002F{id}\u002FActions\u002FOutletGroup.PowerControl\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Event 推送\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>設備主動 POST 多筆 \u003Ccode>Events[]\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Subscriptions\u003C\u002Fcode> Baseline\u003C\u002Ftd>\n\u003Ctd>告警狀態變更 → \u003Ccode>Destination\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>\u003Cstrong>重點區分\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Collection 預設只回連結\u003C\u002Fstrong>，不含各成員的 \u003Ccode>Reading\u003C\u002Fcode>、\u003Ccode>PowerState\u003C\u002Fcode> 等即時值。要一次拿所有插座狀態，須用 \u003Cstrong>\u003Ccode>$expand\u003C\u002Fcode>\u003C\u002Fstrong>（若設備支援，見 Service Root \u003Ccode>ProtocolFeaturesSupported.ExpandQuery\u003C\u002Fcode>），或對 \u003Ccode>Members\u003C\u002Fcode> 逐筆 \u003Ccode>GET\u003C\u002Fcode>。\u003C\u002Fli>\n\u003Cli>\u003Cstrong>沒有\u003C\u002Fstrong>「單一 GET 回傳所有插座即時讀值」的 OCP 必填資源；\u003Ccode>Metrics\u003C\u002Fcode> 僅提供\u003Cstrong>整機彙總\u003C\u002Fstrong>，非逐路明細。\u003C\u002Fli>\n\u003Cli>\u003Cstrong>歷史／趨勢批量讀值\u003C\u002Fstrong>的標準路徑是 \u003Cstrong>\u003Ccode>TelemetryService\u002FMetricReports\u002F{id}\u003C\u002Fcode>\u003C\u002Fstrong>：回應內 \u003Ccode>MetricValues\u003C\u002Fcode> 陣列，每筆含 \u003Ccode>MetricId\u003C\u002Fcode>、\u003Ccode>MetricValue\u003C\u002Fcode>、\u003Ccode>Timestamp\u003C\u002Fcode>（見 歷史趨勢）。\u003C\u002Fli>\n\u003Cli>\u003Cstrong>即時監控\u003C\u002Fstrong> OCP 主線：\u003Ccode>Metrics\u003C\u002Fcode>（彙總）＋必要時 \u003Ccode>$expand\u003C\u002Fcode> 或輪詢 \u003Ccode>Outlets\u003C\u002Fcode>／\u003Ccode>Chassis\u002FSensors\u003C\u002Fcode>（見 第 3 章）。\u003C\u002Fli>\n\u003Cli>\u003Cstrong>同時多點網頁即時顯示\u003C\u002Fstrong>：多點即時看板用 \u003Cstrong>MQTT\u003C\u002Fstrong> \u003Ccode>\u002Fupdate\u003C\u002Fcode>；第三方 DCIM 用 Redfish 常規輪詢（\u003Ccode>Metrics\u003C\u002Fcode>、\u003Ccode>Outlets\u003C\u002Fcode>、\u003Ccode>Sensors\u003C\u002Fcode>，15～60 秒）；見 integration 整合原則。\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>\u003Ccode>ProtocolFeaturesSupported\u003C\u002Fcode> 宣告與 \u003Ccode>$expand\u003C\u002Fcode> 範例見 探索與識別；curl 範例見 讀取流程。\u003C\u002Fp>\n\u003Ch3 id=\"section-87\">選配資源（DMTF 標準，非 OCP 必填）\u003C\u002Fh3>\n\u003Cp>下列為 DMTF Redfish 標準資源，Pelx 產品依機型或功能提供；OCP Rack PDU Profile 驗證\u003Cstrong>不要求\u003C\u002Fstrong>，整合若僅需 OCP 合規可忽略：\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Ccode>PowerEquipment\u002FTransferSwitches\u003C\u002Fcode>（ATS；見 ATS 轉換開關）\u003C\u002Fli>\n\u003Cli>\u003Ccode>PowerEquipment\u002FRackPDUs\u002F{id}\u002FOutletGroups\u003C\u002Fcode>（插座群組；見 插座群組）\u003C\u002Fli>\n\u003Cli>\u003Ccode>TelemetryService\u003C\u002Fcode>（歷史趨勢；見 歷史趨勢）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3 id=\"section-88\">Pelx 擴充（OEM，非 OCP 必填）\u003C\u002Fh3>\n\u003Cp>下列為 Pelx OEM 路徑，\u003Cstrong>非\u003C\u002Fstrong> DMTF 標準資源模型：\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cp>\u003Ccode>Oem\u002FPelx\u002FInterfaces\u003C\u002Fcode>（完整介面；大量即時請用 MQTT，見 第 11 章）\u003C\u002Fp>\n\u003C\u002Fli>\n\u003Cli>\u003Cp>\u003Ccode>Oem\u002FPelx\u002FPeripheralTree\u003C\u002Fcode>（週邊結構樹；設備週邊結構服務，見 週邊樹）\u003C\u002Fp>\n\u003C\u002Fli>\n\u003Cli>\u003Cp>\u003Ccode>Oem.Pelx.MqttEndpoint\u003C\u002Fcode>（MQTT 連線 URL；Redfish Discovery，見 MQTT Discovery）\u003C\u002Fp>\n\u003C\u002Fli>\n\u003Cli>\u003Cp>\u003Ccode>Oem\u002FPelx\u002FConfiguration\u003C\u002Fcode>（組態檔單獨上傳／下載）\u003C\u002Fp>\n\u003C\u002Fli>\n\u003Cli>\u003Cp>\u003Ccode>Oem\u002FPelx\u002FSchedules\u003C\u002Fcode>（排程）\u003C\u002Fp>\n\u003C\u002Fli>\n\u003Cli>\u003Cp>\u003Ccode>EventService\u002FEvents\u003C\u002Fcode>（目前告警快照；OCP 標準事件訂閱見 \u003Ccode>Subscriptions\u003C\u002Fcode>）\u003C\u002Fp>\n\u003C\u002Fli>\n\u003Cli>\u003Cp>\u003Ccode>GET \u002Fredfish\u002Fv1\u003C\u002Fcode> 與 \u003Ccode>GET \u002Fredfish\u002Fv1\u002F\u003C\u002Fcode> 皆應 \u003Cstrong>200\u003C\u002Fstrong>（勿對 \u003Ccode>\u002Fredfish\u002Fv1\u002F\u003C\u002Fcode> 做 301 轉址）。\u003C\u002Fp>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3 id=\"section-89\">資源樹概覽（OCP Rack PDU Profile）\u003C\u002Fh3>\n\u003Cpre>\u003Ccode>\u002Fredfish\u002Fv1                          ServiceRoot（OCP Baseline + PowerEquipment）\n├── SessionService\u002FSessions          認證工作階段（Baseline）\n├── AccountService\u002FAccounts          帳號（Baseline）\n├── AccountService\u002FRoles             角色（Baseline）\n├── AccountService\u002FOutboundConnections  出站 WebSocket（2023.2+ 選配；已實作）\n├── CertificateService               憑證服務（Baseline）\n├── Managers\u002F1                       管理控制器（Baseline）\n│   ├── EthernetInterfaces\u002F{id}      網路介面（Baseline Mandatory）\n│   ├── NetworkProtocol              通訊協定設定（Baseline）\n│   └── LogServices\u002F{logId}\u002FEntries  日誌（Baseline）\n├── Chassis\u002F1                        機箱（OCP PDU Profile）\n│   ├── Sensors\u002F{id}                 感測器（OCP Profile Mandatory URI）\n│   ├── Thermal                      溫濕度（建議）\n│   └── Power                        電源（可選）\n├── PowerEquipment                   PDU 配電（OCP Profile 核心）\n│   ├── TransferSwitches\u002F{id}        ATS（DSP2056；設備支援 ATS 時）\n│   └── RackPDUs\u002F{id}                PowerDistribution\n│       ├── Metrics                  PowerDistributionMetrics（Profile Mandatory）\n│       ├── Mains\u002F{id}               進線 Circuit\n│       ├── Branches\u002F{id}            分支 Circuit（集合必須存在；可為空）\n│       ├── Outlets\u002F{id}             插座 Outlet\n│       ├── OutletGroups\u002F{id}        插座群組（DSP2056）\n│       └── Sensors\u002F{id}             感測器 Sensor\n├── TelemetryService                 歷史趨勢（DMTF 標準；非 OCP 必填）\n├── EventService                     事件服務（Baseline + Profile）\n│   ├── Subscriptions\u002F{id}           事件訂閱（Usage Guide 建議）\n│   └── Events                       目前告警快照（Pelx OEM）\n├── UpdateService                    韌體更新（Baseline Mandatory）\n│   ├── FirmwareInventory\u002FImage      設備映像\n│   ├── SimpleUpdateActionInfo       SimpleUpdate 參數定義\n│   ├── upload                       上傳映像\n│   └── Oem\u002FPelx\u002FConfiguration    組態備份／還原（Pelx OEM）\n├── TaskService\u002FTasks\u002F{taskId}       非同步任務（Baseline）\n└── Oem\u002FPelx\u002F*                    Interfaces、PeripheralTree、Schedules 等（Pelx OEM；PDU 選用）\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>iLock 電子鎖主機之 Service Root \u003Cstrong>不含\u003C\u002Fstrong> \u003Ccode>PowerEquipment\u003C\u002Fcode>；門禁 API 見 iLock 電子鎖。\u003C\u002Fp>\n\u003Chr>\n\u003Ch2 id=\"section-90\">通用 JSON 欄位\u003C\u002Fh2>\n\u003Cp>各 API 回應格式如下所示：先列 JSON 範例，再以「#### 欄位說明如下」\u003Cstrong>逐欄、逐層\u003C\u002Fstrong>說明（含巢狀子物件與陣列元素）。下列為常見欄位語意速查，各 API 章節仍會完整列出該回應的所有欄位。\u003C\u002Fp>\n\u003Ch3 id=\"section-91\">Redfish 標準欄位\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 資源 URI（如 \u003Ccode>\u002Fredfish\u002Fv1\u002FChassis\u002F1\u003C\u002Fcode>），後續請求可直接使用\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，對應 DMTF Schema 版本（\u003Cstrong>Mandatory\u003C\u002Fstrong>；缺此欄位 Interop Validator 報 \u003Ccode>Missing Type Error\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 資源識別碼，通常與 URI 最後一段相同\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 顯示名稱\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Members\u003C\u002Fstrong>: 集合成員連結陣列，元素為 \u003Ccode>{ \"@odata.id\": \"...\" }\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ca>Members@odata.count\u003C\u002Fa>\u003C\u002Fstrong>: \u003Ccode>Members\u003C\u002Fcode> 筆數\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Status\u003C\u002Fstrong>: 狀態物件\u003Cul>\n\u003Cli>\u003Cstrong>State\u003C\u002Fstrong>: 運作狀態，如 \u003Ccode>Enabled\u003C\u002Fcode>（正常）、\u003Ccode>Disabled\u003C\u002Fcode>（停用）、\u003Ccode>Absent\u003C\u002Fcode>（不存在）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Health\u003C\u002Fstrong>: 健康狀態，\u003Ccode>OK\u003C\u002Fcode> \u002F \u003Ccode>Warning\u003C\u002Fcode> \u002F \u003Ccode>Critical\u003C\u002Fcode>，由介面狀態碼轉換，見文末「狀態對照」\u003C\u002Fli>\n\u003Cli>\u003Cstrong>HealthRollup\u003C\u002Fstrong>: 子資源健康彙整（Chassis 等上層資源使用）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3 id=\"section-92\">HTTP 回應標頭與可寫屬性標註\u003C\u002Fh3>\n\u003Cp>含可寫屬性（\u003Ccode>UserLabel\u003C\u002Fcode>、\u003Ccode>Location\u003C\u002Fcode> 等）的資源，\u003Ccode>GET\u003C\u002Fcode> 回應須同時提供：\u003C\u002Fp>\n\u003Col>\n\u003Cli>\u003Cstrong>\u003Ccode>Allow\u003C\u002Fcode> 標頭\u003C\u002Fstrong> — 供 Validator 確認支援 \u003Ccode>PATCH\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ccode>@Redfish.WriteableProperties\u003C\u002Fcode>\u003C\u002Fstrong> — 標示可 \u003Ccode>PATCH\u003C\u002Fcode> 的屬性；\u003Ccode>Location\u003C\u002Fcode>：\u003Ccode>Contacts\u003C\u002Fcode>；\u003Ccode>Location.Placement\u003C\u002Fcode>：\u003Ccode>Rack\u003C\u002Fcode>、\u003Ccode>Row\u003C\u002Fcode>、\u003Ccode>RackOffset\u003C\u002Fcode>、\u003Ccode>RackOffsetUnits\u003C\u002Fcode> |\n| RackPDU | \u003Ccode>GET, PATCH\u003C\u002Fcode> | 根層：\u003Ccode>AssetTag\u003C\u002Fcode>、\u003Ccode>UserLabel\u003C\u002Fcode>、\u003Ccode>LocationIndicatorActive\u003C\u002Fcode>；\u003Ccode>Location\u003C\u002Fcode>／\u003Ccode>Placement\u003C\u002Fcode> 同 Chassis |\n| Mains | \u003Ccode>GET, PATCH\u003C\u002Fcode> | \u003Ccode>UserLabel\u003C\u002Fcode>、\u003Ccode>ElectricalSourceManagerURI\u003C\u002Fcode>、\u003Ccode>ElectricalSourceName\u003C\u002Fcode> |\n| Outlet | \u003Ccode>GET, PATCH\u003C\u002Fcode> | \u003Ccode>UserLabel\u003C\u002Fcode>、\u003Ccode>ElectricalConsumerNames\u003C\u002Fcode>、\u003Ccode>LocationIndicatorActive\u003C\u002Fcode> |\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>PATCH 持久化\u003C\u002Fstrong>：部分可寫欄位重啟後還原；長期保存請用組態備份／還原。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Cp>範例（Chassis）：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\",\n  \"@odata.type\": \"#Chassis.v1_22_0.Chassis\",\n  \"@Redfish.WriteableProperties\": [\n    \"AssetTag\"\n  ],\n  \"Id\": \"1\",\n  \"Location\": {\n    \"@Redfish.WriteableProperties\": [\n      \"Contacts\"\n    ],\n    \"Placement\": {\n      \"@Redfish.WriteableProperties\": [\n        \"Rack\",\n        \"Row\",\n        \"RackOffset\",\n        \"RackOffsetUnits\"\n      ],\n      \"Rack\": \"Rack-01\"\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>對應回應標頭：\u003Ccode>Allow: GET, PATCH\u003C\u002Fcode>\u003C\u002Fp>\n\u003Cp>缺 \u003Ccode>@Redfish.WriteableProperties\u003C\u002Fcode> 時，Validator 報 \u003Ccode>WriteableProperties Warning\u003C\u002Fcode>（即使已有 \u003Ccode>Allow\u003C\u002Fcode> 標頭）。\u003C\u002Fp>\n\u003Ch3 id=\"section-93\">量測與閾值欄位\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>\u003Cstrong>Reading\u003C\u002Fstrong>: 即時數值，對應 \u003Ccode>GET \u002Finterfaces\u003C\u002Fcode> 的 \u003Cstrong>value\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ReadingVolts\u003C\u002Fstrong> \u002F \u003Cstrong>ReadingCelsius\u003C\u002Fstrong> \u002F \u003Cstrong>ReadingAmps\u003C\u002Fstrong> 等: 具單位語意的讀值（部分資源直接放在物件頂層）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>DataSourceUri\u003C\u002Fstrong>: 指向 \u003Ccode>Sensors\u002F{id}\u003C\u002Fcode> 的連結，供進一步查詢感測器細項\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Thresholds\u003C\u002Fstrong> \u002F \u003Cstrong>UpperThresholdCritical\u003C\u002Fstrong> 等: 閾值，對應 \u003Ccode>interfaces\u003C\u002Fcode> 的 \u003Cstrong>params\u003C\u002Fstrong>\u003Cul>\n\u003Cli>\u003Cstrong>hc\u003C\u002Fstrong> → \u003Ccode>UpperThresholdCritical\u003C\u002Fcode> \u002F \u003Ccode>UpperCritical\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>hw\u003C\u002Fstrong> → \u003Ccode>UpperThresholdNonCritical\u003C\u002Fcode> \u002F \u003Ccode>UpperCaution\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>lw\u003C\u002Fstrong> → \u003Ccode>LowerThresholdNonCritical\u003C\u002Fcode> \u002F \u003Ccode>LowerCaution\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>lc\u003C\u002Fstrong> → \u003Ccode>LowerThresholdCritical\u003C\u002Fcode> \u002F \u003Ccode>LowerCritical\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3 id=\"section-94\">Oem.Pelx 擴充欄位\u003C\u002Fh3>\n\u003Cp>、\u003Ccode>interfaces\u003C\u002Fcode>；\u003Cstrong>對外一律以 \u003Ccode>@odata.id\u003C\u002Fcode> 資源連結表示\u003C\u002Fstrong>，以 \u003Ccode>@odata.id\u003C\u002Fcode> 表示。自 hwctrl 2026 合規版起，\u003Cstrong>不再使用\u003C\u002Fstrong> \u003Ccode>Oem.Pelx.Links\u003C\u002Fcode> 包裝：\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 固定 \u003Ccode>#Pelx.v1_0_0.Pelx\u003C\u002Fcode>（DMTF Service Validator 必填）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Interface\u003C\u002Fstrong>: 單一 Pelx 介面資源連結（\u003Ccode>Pelx.InterfaceLink\u003C\u002Fcode>，僅 \u003Ccode>@odata.id\u003C\u002Fcode>）；用於 Sensor、Event、Thermal 等\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Interfaces\u003C\u002Fstrong>: 多個量測／控制對應之介面連結物件（如 \u003Ccode>Voltage\u003C\u002Fcode>、\u003Ccode>CurrentAmps\u003C\u002Fcode>、\u003Ccode>PowerState\u003C\u002Fcode>）；用於 Mains、Outlet、Branch\u003C\u002Fli>\n\u003Cli>\u003Cstrong>InterfaceGroups\u003C\u002Fstrong>: 三相等巢狀量測對照（如 \u003Ccode>PolyPhaseVoltage.Line1ToNeutral\u003C\u002Fcode>）；用於 \u003Ccode>INFEED3P\u003C\u002Fcode> 進線\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>CSDL 定義內嵌於 \u003Ccode>GET \u002Fredfish\u002Fv1\u002F$metadata\u003C\u002Fcode>，亦可 \u003Ccode>GET \u002Fredfish\u002Fv1\u002Fschemas\u002FPelx_v1.xml\u003C\u002Fcode>（部署路徑：\u003Ccode>\u002Froot\u002Frpm6\u002Fshare\u002Frpm6\u002Fredfish\u002Fschemas\u002FPelx_v1.xml\u003C\u002Fcode>）。執行 DMTF Service Validator 時，本機 \u003Ccode>csdl\u002FPelx_v1.xml\u003C\u002Fcode> 須與設備同步。\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>MqttAuth\u003C\u002Fstrong>: MQTT 認證方式（Redfish：\u003Ccode>RedfishSession\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ElementId\u003C\u002Fstrong> \u002F \u003Cstrong>elementId\u003C\u002Fstrong>: 週邊路數，對應週邊路數\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Alias\u003C\u002Fstrong> \u002F \u003Cstrong>alias\u003C\u002Fstrong>: 介面別名（如 \u003Ccode>V\u003C\u002Fcode>、\u003Ccode>FREQ\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>peripheralAlias\u003C\u002Fstrong>: 週邊分類別名（如 \u003Ccode>INFEED\u003C\u002Fcode>、\u003Ccode>OUTLET\u003C\u002Fcode>、\u003Ccode>TEMPRH\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Unit\u003C\u002Fstrong> \u002F \u003Cstrong>unit\u003C\u002Fstrong>: 資料單位（如 \u003Ccode>V\u003C\u002Fcode>、\u003Ccode>°C\u003C\u002Fcode>、\u003Ccode>kWh\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>type\u003C\u002Fstrong>: 資料型別，如 \u003Ccode>FLOAT\u003C\u002Fcode>、\u003Ccode>BOOL\u003C\u002Fcode>、\u003Ccode>STRING\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>value\u003C\u002Fstrong>: 即時讀值，同即時讀值欄位\u003C\u002Fli>\n\u003Cli>\u003Cstrong>status\u003C\u002Fstrong>: 介面狀態碼（如 \u003Ccode>ok\u003C\u002Fcode>、\u003Ccode>hw\u003C\u002Fcode>、\u003Ccode>hc\u003C\u002Fcode>），見 mqtt-topic\u003C\u002Fli>\n\u003Cli>\u003Cstrong>params\u003C\u002Fstrong>: 閾值參數，欄位同 \u003Ccode>GET \u002Finterfaces\u003C\u002Fcode> 的 \u003Cstrong>params\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>health\u003C\u002Fstrong>: 已由 \u003Ccode>status\u003C\u002Fcode> 轉換的 Redfish \u003Ccode>Health\u003C\u002Fcode> 值\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Chr>\n\u003Ch1 id=\"section-95\">認證\u003C\u002Fh1>\n\u003Cp>支援兩種方式，與多數 PDU 廠商（Vertiv、eConnect 等）一致：\u003C\u002Fp>\n\u003Col>\n\u003Cli>\u003Cstrong>HTTP Basic Auth\u003C\u002Fstrong> — 適合單次查詢、腳本測試；每次請求帶 \u003Ccode>Authorization: Basic ...\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Session Token\u003C\u002Fstrong> — 適合長時間輪詢；先 \u003Ccode>POST \u002Fredfish\u002Fv1\u002FSessionService\u002FSessions\u003C\u002Fcode> 取得 \u003Ccode>X-Auth-Token\u003C\u002Fcode>，後續請求帶此標頭\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Ch3 id=\"section-96\">認證架構\u003C\u002Fh3>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>項目\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>帳號來源\u003C\u002Ftd>\n\u003Ctd>與 Web 登入共用，\u003Cstrong>不需\u003C\u002Fstrong>另建 Redfish 專用帳號庫\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Redfish 協議\u003C\u002Ftd>\n\u003Ctd>Basic Auth、\u003Ccode>SessionService\u003C\u002Fcode>、\u003Ccode>X-Auth-Token\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>\u003Ccode>POST \u002Fredfish\u002Fv1\u002FSessionService\u002FSessions\u003C\u002Fcode> 建立 Redfish Session 並回傳 \u003Ccode>X-Auth-Token\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Cp>Redfish 服務依 auth \u003Cstrong>role\u003C\u002Fstrong> 映射權限如下：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>auth role\u003C\u002Fth>\n\u003Cth>Web UI 名稱\u003C\u002Fth>\n\u003Cth>Redfish \u003Ccode>RoleId\u003C\u002Fcode>\u003C\u002Fth>\n\u003Cth>摘要\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>admin\u003C\u002Ftd>\n\u003Ctd>系統管理員\u003C\u002Ftd>\n\u003Ctd>Administrator\u003C\u002Ftd>\n\u003Ctd>讀寫全部資源；\u003Cstrong>工程模式\u003C\u002Fstrong>讀寫；帳號 CRUD（含同級系統管理員）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>manager\u003C\u002Ftd>\n\u003Ctd>管理員\u003C\u002Ftd>\n\u003Ctd>Operator\u003C\u002Ftd>\n\u003Ctd>讀取全部；\u003Cstrong>控制\u003C\u002Fstrong>與一般選單寫入；帳號 CRUD 僅限 Operator／ReadOnly\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>viewer\u003C\u002Ftd>\n\u003Ctd>檢視者\u003C\u002Ftd>\n\u003Ctd>ReadOnly\u003C\u002Ftd>\n\u003Ctd>OCP 基礎角色：可登入、可改自己密碼、可讀監測；\u003Cstrong>嚴禁\u003C\u002Fstrong>配置修改與控制\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>app\u003C\u002Ftd>\n\u003Ctd>—\u003C\u002Ftd>\n\u003Ctd>—\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>不開放\u003C\u002Fstrong> Redfish 登入\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch4 id=\"section-97\">ReadOnly（OCP Baseline 基礎角色）\u003C\u002Fh4>\n\u003Cp>\u003Cstrong>ReadOnly\u003C\u002Fstrong> 為 OCP Service Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong> 三角色之一（與 \u003Ccode>Administrator\u003C\u002Fcode>、\u003Ccode>Operator\u003C\u002Fcode> 並列），DMTF 預設 \u003Ccode>AssignedPrivileges\u003C\u002Fcode> 為 \u003Cstrong>\u003Ccode>Login\u003C\u002Fcode>\u003C\u002Fstrong>、\u003Cstrong>\u003Ccode>ConfigureSelf\u003C\u002Fcode>\u003C\u002Fstrong>（\u003Cstrong>不含\u003C\u002Fstrong> \u003Ccode>ConfigureComponents\u003C\u002Fcode>、\u003Ccode>ConfigureManager\u003C\u002Fcode>、\u003Ccode>ConfigureUsers\u003C\u002Fcode>）。\u003C\u002Fp>\n\u003Cp>核心規範（Pelx 實作須符合）：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>允許\u003C\u002Fth>\n\u003Cth>禁止\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>登入\u003C\u002Fstrong> Redfish（Basic／Session）\u003C\u002Ftd>\n\u003Ctd>任何 \u003Cstrong>控制 Action\u003C\u002Fstrong>（\u003Ccode>POST ...\u002FActions\u002F*\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>修改自己的密碼\u003C\u002Fstrong>（\u003Ccode>ConfigureSelf\u003C\u002Fcode>；\u003Ccode>PATCH ...\u002FAccounts\u002F{id}\u003C\u002Fcode> 僅 \u003Ccode>Password\u003C\u002Fcode> 且為本人）\u003C\u002Ftd>\n\u003Ctd>任何\u003Cstrong>配置修改\u003C\u002Fstrong>（\u003Ccode>PATCH\u003C\u002Fcode>／\u003Ccode>POST\u003C\u002Fcode>／\u003Ccode>DELETE\u003C\u002Fcode> 其他資源或欄位）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>讀取監測與 Inventory\u003C\u002Fstrong>（\u003Ccode>GET\u003C\u002Fcode>：Outlets、Metrics、Sensors、Events 等）\u003C\u002Ftd>\n\u003Ctd>管理他人帳號、LDAP／SNMP 等工程模式讀寫\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>Pelx 追加限制\u003C\u002Fstrong>（嚴於部分廠商慣例，不違反 OCP）：\u003Ccode>GET ...\u002FAccountService\u002FAccounts\u003C\u002Fcode> 須 \u003Cstrong>Operator 以上\u003C\u002Fstrong>；工程模式資源之 \u003Ccode>GET\u003C\u002Fcode>／寫入須 \u003Cstrong>Administrator\u003C\u002Fstrong>。其餘監測類 \u003Ccode>GET\u003C\u002Fcode> 依預設，ReadOnly 可讀。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch3 id=\"section-98\">角色與權限模型（RBAC）\u003C\u002Fh3>\n\u003Cp>與 Web UI 選單對齊。\u003C\u002Fp>\n\u003Ch4 id=\"section-99\">權限層級\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>層級\u003C\u002Fth>\n\u003Cth>適用角色\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>讀取\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>ReadOnly 以上\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>GET\u003C\u002Fcode> 監測、Inventory、事件列表等\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>控制\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Operator 以上\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>POST ...\u002FActions\u002F*\u003C\u002Fcode>：插座開關／重啟、群組控制、電子鎖、能耗重設、排程 Run 等\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>一般寫入\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Operator 以上\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>PATCH\u003C\u002Fcode>／\u003Ccode>POST\u003C\u002Fcode>／\u003Ccode>DELETE\u003C\u002Fcode>（非工程模式）：排程 CRUD、ATS 參數、NTP／SSH 等\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>工程模式\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Administrator 專屬\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>週邊診斷、RS485／VNode／圖控／Flow、帳號服務、憑證、SNMP Agent、韌體／組態、告警通道設定等\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>\u003Cstrong>ReadOnly\u003C\u002Fstrong> 僅能 \u003Cstrong>登入\u003C\u002Fstrong>、\u003Cstrong>改自己密碼\u003C\u002Fstrong>、\u003Cstrong>GET 監測數據\u003C\u002Fstrong>；\u003Cstrong>嚴禁\u003C\u002Fstrong>任何配置修改與控制 Action。\u003Cstrong>Administrator\u003C\u002Fstrong> 涵蓋 Operator 全部權限（含控制）。\u003C\u002Fp>\n\u003Ch4 id=\"section-100\">Web「工程模式」↔ Redfish API\u003C\u002Fh4>\n\u003Cp>工程模式選單（週邊資訊、密碼政策、LDAP、RADIUS／TACACS+、SNMP Agent、告警服務、韌體更新）對外整合時對應下列 Redfish；\u003Cstrong>讀寫皆須 Administrator\u003C\u002Fstrong>（\u003Ccode>403\u003C\u002Fcode> 若為 Operator／ReadOnly）：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Web 工程模式\u003C\u002Fth>\n\u003Cth>Redfish API（摘要）\u003C\u002Fth>\n\u003Cth>備註\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>週邊資訊\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>GET\u002FPATCH ...\u002FOem\u002FPelx\u002FInterfaces\u002F{addr}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>診斷用介面\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>RS485／UART\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>GET\u002FPATCH ...\u002FOem\u002FPelx\u002FSerialBuses\u002F{id}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>見 oem serial buses；\u003Ccode>devinfo.rs485\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>VNode\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>GET\u002FPATCH ...\u002FOem\u002FPelx\u002FVNodes\u002F{id}\u003C\u002Fcode>、\u003Ccode>PelxVNode.Test\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>見 oem vnodes；\u003Ccode>devinfo.vnode\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>圖控 HMI\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>GET\u002FPOST\u002FPATCH\u002FDELETE ...\u002FOem\u002FPelx\u002FHmiScreens\u003C\u002Fcode>、\u003Ccode>...\u002FExport\u003C\u002Fcode>、\u003Ccode>PelxHmiScreen.ExportTemplate\u003C\u002Fcode>／\u003Ccode>ImportTemplate\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>見 oem hmi screens；含樣版匯出／載入；\u003Ccode>devinfo.hmi\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>圖控圖庫\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>...\u002FOem\u002FPelx\u002FHmiImageLibraries\u003C\u002Fcode>、\u003Ccode>PelxHmiImageLibrary.Import\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>見 oem hmi image libraries；\u003Ccode>devinfo.hmi\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>自動化流程\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>GET\u002FPOST\u002FPATCH\u002FDELETE ...\u002FOem\u002FPelx\u002FAutomations\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>見 oem automations；\u003Ccode>devinfo.autoBuilder\u003C\u002Fcode>；聯鎖執行仍在本地\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>密碼政策\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>PATCH ...\u002FAccountService\u003C\u002Fcode>（密碼政策欄位）\u003C\u002Ftd>\n\u003Ctd>見本文 AccountService\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>LDAP\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>PATCH ...\u002FAccountService\u003C\u002Fcode>（\u003Ccode>LDAP\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>RADIUS\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>PATCH ...\u002FAccountService\u003C\u002Fcode>（\u003Ccode>Oem.Pelx.Radius\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>TACACS+\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>PATCH ...\u002FAccountService\u003C\u002Fcode>（\u003Ccode>Oem.Pelx.Tacacs\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003Ctd>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>SNMP Agent\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>PATCH ...\u002FManagers\u002F1\u002FNetworkProtocol\u003C\u002Fcode>（\u003Ccode>SNMP\u003C\u002Fcode>、\u003Ccode>Oem.Pelx.SNMPAgent\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003Ctd>見 網路協定\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>告警服務\u003C\u002Ftd>\n\u003Ctd>notify／\u003Ccode>EventService\u003C\u002Fcode> 設定\u003C\u002Ftd>\n\u003Ctd>訂閱建立見 告警與事件\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>韌體更新\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>UpdateService\u002Fupload\u003C\u002Fcode>、\u003Ccode>SimpleUpdate\u003C\u002Fcode>、\u003Ccode>PelxConfiguration\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>見 韌體與組態\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>HTTPS／UACME\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>CertificateService\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>見本文 CertificateService\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>同一資源內若混有工程與一般欄位（如 \u003Ccode>NetworkProtocol\u003C\u002Fcode>），依欄位路徑分別檢查：SNMP 區塊須 Administrator；NTP／SSH／ICMP 區塊須 Operator 以上（見 網路協定）。\u003C\u002Fp>\n\u003Ch4 id=\"section-101\">一般選單（非工程模式）控制與寫入\u003C\u002Fh4>\n\u003Cp>\u003Cstrong>控制 Action\u003C\u002Fstrong> 與一般寫入皆須 \u003Cstrong>Operator 以上\u003C\u002Fstrong>；\u003Cstrong>ReadOnly\u003C\u002Fstrong> 回 \u003Ccode>403\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Cp>\u003Cstrong>控制\u003C\u002Fstrong>（\u003Ccode>POST ...\u002FActions\u002F*\u003C\u002Fcode>）：\u003C\u002Fp>\n\u003Cul>\n\u003Cli>插座／插座群組：\u003Ccode>Outlet.PowerControl\u003C\u002Fcode>、\u003Ccode>OutletGroup.PowerControl\u003C\u002Fcode>、\u003Ccode>Outlet.ResetMetrics\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>電子鎖：\u003Ccode>PelxElectronicLock.Control\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>電力：\u003Ccode>ResetMetrics\u003C\u002Fcode>（Rack PDU／Mains）\u003C\u002Fli>\n\u003Cli>排程：\u003Ccode>Schedules\u002F{id}\u002FActions\u002F...Run\u003C\u002Fcode> 等\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>\u003Cstrong>一般寫入\u003C\u002Fstrong>（\u003Ccode>PATCH\u003C\u002Fcode>／\u003Ccode>POST\u003C\u002Fcode>／\u003Ccode>DELETE\u003C\u002Fcode>）：\u003C\u002Fp>\n\u003Cul>\n\u003Cli>排程 CRUD、ATS 參數、電子鎖白名單／卡號\u003C\u002Fli>\n\u003Cli>\u003Ccode>Managers\u002F1\u002FNetworkProtocol\u003C\u002Fcode> 之 NTP、SSH、ICMP（非 SNMP Agent）\u003C\u002Fli>\n\u003Cli>\u003Ccode>EventService\u002FSubscriptions\u003C\u002Fcode> 建立／修改（若產品政策允許 Operator 管理訂閱）\u003C\u002Fli>\n\u003Cli>\u003Ccode>AccountService\u002FOutboundConnections\u003C\u002Fcode> 建立／修改／刪除（\u003Cstrong>Administrator\u003C\u002Fstrong>；見 outbound connection）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-102\">帳號 CRUD 授權矩陣\u003C\u002Fh4>\n\u003Cp>\u003Ccode>POST\u003C\u002Fcode>／\u003Ccode>PATCH\u003C\u002Fcode>／\u003Ccode>DELETE\u003C\u002Fcode> \u003Ccode>AccountService\u002FAccounts\u003C\u002Fcode> 依\u003Cstrong>呼叫者角色\u003C\u002Fstrong>與\u003Cstrong>目標帳號 RoleId\u003C\u002Fstrong> 決定：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>操作\u003C\u002Fth>\n\u003Cth>目標 \u003Ccode>RoleId\u003C\u002Fcode>\u003C\u002Fth>\n\u003Cth>允許的呼叫者\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>POST\u003C\u002Fcode> 建立\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Administrator\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>僅\u003C\u002Fstrong> Administrator（系統管理員）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>POST\u003C\u002Fcode> 建立\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Operator\u003C\u002Fcode>、\u003Ccode>ReadOnly\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Administrator \u003Cstrong>或\u003C\u002Fstrong> Operator（管理員）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>PATCH\u003C\u002Fcode> 修改\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Administrator\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>僅\u003C\u002Fstrong> Administrator\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>PATCH\u003C\u002Fcode> 修改\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Operator\u003C\u002Fcode>、\u003Ccode>ReadOnly\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Administrator \u003Cstrong>或\u003C\u002Fstrong> Operator\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>DELETE\u003C\u002Fcode> 刪除\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Administrator\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>僅\u003C\u002Fstrong> Administrator\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>DELETE\u003C\u002Fcode> 刪除\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Operator\u003C\u002Fcode>、\u003Ccode>ReadOnly\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Administrator \u003Cstrong>或\u003C\u002Fstrong> Operator\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>附加規則：\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Operator \u003Cstrong>不可\u003C\u002Fstrong>將既有帳號之 \u003Ccode>RoleId\u003C\u002Fcode> 改為 \u003Ccode>Administrator\u003C\u002Fcode>，\u003Cstrong>不可\u003C\u002Fstrong>修改或刪除 \u003Ccode>RoleId\u003C\u002Fcode> 為 \u003Ccode>Administrator\u003C\u002Fcode> 的帳號\u003C\u002Fli>\n\u003Cli>不可刪除\u003Cstrong>最後一個\u003C\u002Fstrong> \u003Ccode>Administrator\u003C\u002Fcode> 帳號\u003C\u002Fli>\n\u003Cli>\u003Ccode>GET ...\u002FAccounts\u003C\u002Fcode>／\u003Ccode>{id}\u003C\u002Fcode>：\u003Cstrong>Operator 以上\u003C\u002Fstrong>；ReadOnly 回 \u003Ccode>403\u003C\u002Fcode>（帳號清單屬敏感資訊）\u003C\u002Fli>\n\u003Cli>Operator 建立／管理之帳號，\u003Ccode>RoleId\u003C\u002Fcode> 僅能為 \u003Ccode>Operator\u003C\u002Fcode> 或 \u003Ccode>ReadOnly\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>\u003Ccode>403\u003C\u002Fcode> 回應時 \u003Ccode>Message\u003C\u002Fcode> 宜註明「權限不足」或「不可管理系統管理員帳號」。\u003C\u002Fp>\n\u003Ch4 id=\"section-103\">Role 資源與 OemPrivileges\u003C\u002Fh4>\n\u003Cp>\u003Ccode>GET ...\u002FAccountService\u002FRoles\u002F{RoleId}\u003C\u002Fcode> 之 \u003Cstrong>OemPrivileges\u003C\u002Fstrong> 反映 Pelx 工程模式（非 DMTF 標準必填）：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>\u003Ccode>RoleId\u003C\u002Fcode>\u003C\u002Fth>\n\u003Cth>\u003Ccode>OemPrivileges\u003C\u002Fcode>（Pelx）\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>Administrator\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>[\"ConfigureEngineering\"]\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Operator\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>[]\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>ReadOnly\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>[]\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>整合方可先 \u003Ccode>GET ...\u002FRoles\u002F{RoleId}\u003C\u002Fcode> 判斷是否具工程模式寫入資格。\u003C\u002Fp>\n\u003Ch3 id=\"section-104\">文件撰寫慣例（各 spec 章節）\u003C\u002Fh3>\n\u003Cp>各 API 章節\u003Cstrong>不必\u003C\u002Fstrong>逐條重複最低角色；以本文「角色與權限模型」為\u003Cstrong>唯一權威來源\u003C\u002Fstrong>。\u003C\u002Fp>\n\u003Ch4 id=\"section-105\">預設規則\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>HTTP 方法\u003C\u002Fth>\n\u003Cth>最低 \u003Ccode>RoleId\u003C\u002Fcode>\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>GET\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>ReadOnly\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>監測、Inventory、韌體版本等\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>POST ...\u002FActions\u002F*\u003C\u002Fcode>（\u003Cstrong>控制\u003C\u002Fstrong>）\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Operator\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>插座開關、群組控制、電子鎖、能耗重設等\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>POST\u003C\u002Fcode>／\u003Ccode>PATCH\u003C\u002Fcode>／\u003Ccode>DELETE\u003C\u002Fcode>（設定）\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Operator\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>排程 CRUD、NTP／SSH 等一般寫入\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>工程模式 API\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Administrator\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>見上方工程模式對照表\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>帳號 CRUD\u003C\u002Ftd>\n\u003Ctd>依矩陣\u003C\u002Ftd>\n\u003Ctd>見「帳號 CRUD 授權矩陣」\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch4 id=\"section-106\">僅在下列情況於 API 段落\u003Cstrong>額外\u003C\u002Fstrong>標註\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>情況\u003C\u002Fth>\n\u003Cth>寫法\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>須 \u003Cstrong>Administrator\u003C\u002Fstrong>（Operator 不可）\u003C\u002Ftd>\n\u003Ctd>段落開頭或 \u003Ccode>403\u003C\u002Fcode> 註明「須 Administrator（工程模式）」\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>混合資源\u003C\u002Fstrong>（同 \u003Ccode>PATCH\u003C\u002Fcode> 欄位分級）\u003C\u002Ftd>\n\u003Ctd>該章節寫欄位級對照表（如 網路協定）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>帳號 CRUD\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>寫「依帳號 CRUD 授權矩陣」；不重複整張表\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>\u003Ccode>GET\u003C\u002Fcode> 比 ReadOnly 更嚴\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>標註例外（如 \u003Ccode>GET ...\u002FAccounts\u003C\u002Fcode> 須 Operator）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>符合預設的控制 Action 與 \u003Ccode>POST\u003C\u002Fcode>／\u003Ccode>PATCH\u003C\u002Fcode>（如 \u003Ccode>Outlet.PowerControl\u003C\u002Fcode>、排程 CRUD）\u003Cstrong>不必\u003C\u002Fstrong>再寫「須 Operator 以上」。各章可在標題下加一行：「權限預設見 認證（\u003Cstrong>控制 Action 至少 Operator\u003C\u002Fstrong>）。」\u003C\u002Fp>\n\u003Ch4 id=\"section-107\">\u003Ccode>403\u003C\u002Fcode> 撰寫\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>情境\u003C\u002Fth>\n\u003Cth>狀態表寫法\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>ReadOnly 嘗試控制或寫入\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>403 | 權限不足\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>工程模式\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>403 | 須 Administrator\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>帳號矩陣\u003C\u002Ftd>\n\u003Ctd>具體說明（如不可管理系統管理員帳號）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>整合方應以 \u003Cstrong>Redfish \u003Ccode>AccountService\u002FAccounts\u003C\u002Fcode>\u003C\u002Fstrong> 建立專用帳號（OCP Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>），例如 \u003Ccode>dcim-read\u003C\u002Fcode> 設 \u003Ccode>RoleId: ReadOnly\u003C\u002Fcode>、\u003Ccode>dcim-ctrl\u003C\u002Fcode> 設 \u003Ccode>Operator\u003C\u002Fcode>，與管理員 \u003Ccode>admin\u003C\u002Fcode> 分離。與 Web UI 共用帳號庫。。\u003C\u002Fp>\n\u003Ch3 id=\"section-108\">OCP AccountService 要求（摘要）\u003C\u002Fh3>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>操作\u003C\u002Fth>\n\u003Cth>HTTP\u003C\u002Fth>\n\u003Cth>OCP Baseline\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>列出／查詢帳號\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>GET ...\u002FAccounts\u003C\u002Fcode>、\u003Ccode>GET ...\u002FAccounts\u002F{id}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Mandatory\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>新增帳號\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>POST ...\u002FAccountService\u002FAccounts\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Mandatory\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>修改帳號\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>PATCH ...\u002FAccounts\u002F{id}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Mandatory\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>刪除帳號\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>DELETE ...\u002FAccounts\u002F{id}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Mandatory\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>角色定義\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>GET ...\u002FAccountService\u002FRoles\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Mandatory\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>標準角色 \u003Cstrong>Administrator\u003C\u002Fstrong>、\u003Cstrong>Operator\u003C\u002Fstrong>、\u003Cstrong>ReadOnly\u003C\u002Fstrong> 為 OCP 必填；\u003Ccode>app\u003C\u002Fcode> 角色\u003Cstrong>不\u003C\u002Fstrong>經 Redfish 暴露。\u003C\u002Fp>\n\u003Ch3 id=\"section-109\">外部帳號提供者（LDAP／RADIUS／TACACS+）\u003C\u002Fh3>\n\u003Cp>OCP PDU 對 LDAP、RADIUS 為 \u003Cstrong>Recommended\u003C\u002Fstrong>（非 Baseline Mandatory）。TACACS+ 為 Pelx OEM 擴充：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>協定\u003C\u002Fth>\n\u003Cth>Redfish 路徑\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>LDAP\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>PATCH \u002FAccountService\u003C\u002Fcode> 之 \u003Ccode>LDAP\u003C\u002Fcode> 物件\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>RADIUS\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>PATCH \u002FAccountService\u003C\u002Fcode> 之 \u003Ccode>Oem.Pelx.Radius\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>TACACS+\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>PATCH \u002FAccountService\u003C\u002Fcode> 之 \u003Ccode>Oem.Pelx.Tacacs\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>LDAP 連線測試\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>POST ...\u002FActions\u002FPelxAccountService.TestLDAPConnection\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>RADIUS 連線測試\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>POST ...\u002FActions\u002FPelxAccountService.TestRADIUSConnection\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>TACACS+ 連線測試\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>POST ...\u002FActions\u002FPelxAccountService.TestTACACSConnection\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-110\">密碼強度政策\u003C\u002Fh3>\n\u003Cp>本地帳號密碼須符合 \u003Ccode>AccountService\u003C\u002Fcode> 內嵌政策（OCP \u003Cstrong>Recommended\u003C\u002Fstrong>）。透過 AccountService 設定。\u003C\u002Fp>\n\u003Cp>建立或修改帳號（\u003Ccode>POST\u003C\u002Fcode>／\u003Ccode>PATCH Accounts\u003C\u002Fcode>）時，依此政策驗證 \u003Ccode>Password\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Ch3 id=\"section-111\">Interop Validator 與認證\u003C\u002Fh3>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>模式\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>Basic\u003C\u002Fstrong>（建議）\u003C\u002Ftd>\n\u003Ctd>Validator 對 \u003Ccode>GET \u002Fredfish\u002Fv1\u003C\u002Fcode> \u003Cstrong>不帶\u003C\u002Fstrong>認證；子資源請求帶 Basic。Service Root 須允許匿名讀取。\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Session\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>Validator 自 Service Root 讀取 \u003Ccode>Links.Sessions.@odata.id\u003C\u002Fcode> 後 \u003Ccode>POST\u003C\u002Fcode> 建立 Token。若 Service Root 無 \u003Ccode>Links.Sessions\u003C\u002Fcode>，Session 無法建立。\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>對外須轉送 \u003Ccode>Authorization\u003C\u002Fcode>、\u003Ccode>X-Auth-Token\u003C\u002Fcode>（見「服務資訊」）。\u003C\u002Fp>\n\u003Ch3 id=\"section-112\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>取得 Session 服務能力與逾時設定。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FSessionService\",\n  \"@odata.type\": \"#SessionService.v1_1_1.SessionService\",\n  \"Id\": \"SessionService\",\n  \"Name\": \"Session Service\",\n  \"ServiceEnabled\": true,\n  \"SessionTimeout\": 1800,\n  \"Sessions\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FSessionService\u002FSessions\"\n  },\n  \"Actions\": {\n      }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-113\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: Session 服務 URI\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#SessionService.v1_1_1.SessionService\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 固定為 \u003Ccode>SessionService\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 顯示名稱\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ServiceEnabled\u003C\u002Fstrong>: Session 服務是否啟用，\u003Ccode>true\u003C\u002Fcode> 表示可建立工作階段\u003C\u002Fli>\n\u003Cli>\u003Cstrong>SessionTimeout\u003C\u002Fstrong>: 工作階段逾時（秒），預設 \u003Ccode>1800\u003C\u002Fcode>（30 分鐘），可 \u003Ccode>PATCH\u003C\u002Fcode> 調整（範圍 30–86400）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Sessions\u003C\u002Fstrong>: Session 集合連結物件\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: Session 列表 URI，固定 \u003Ccode>\u002Fredfish\u002Fv1\u002FSessionService\u002FSessions\u003C\u002Fcode>；\u003Ccode>GET\u003C\u002Fcode> 可列出有效 Session，\u003Ccode>POST\u003C\u002Fcode> 可建立新 Session\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Actions\u003C\u002Fstrong>: Pelx 擴充 Action\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-114\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-115\">PATCH https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>修改 Session 逾時。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"SessionTimeout\": 3600\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-116\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>SessionTimeout\u003C\u002Fstrong>: 工作階段逾時（秒），範圍 30–86400\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-117\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>參數錯誤\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-118\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>列出目前有效 Session。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FSessionService\u002FSessions\",\n  \"@odata.type\": \"#SessionCollection.SessionCollection\",\n  \"Members\": [\n    {\n      \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FSessionService\u002FSessions\u002Fa1b2c3d4\"\n    }\n  ],\n  \"Members@odata.count\": 1\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-119\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: Session 集合資源 URI，固定 \u003Ccode>\u002Fredfish\u002Fv1\u002FSessionService\u002FSessions\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#SessionCollection.SessionCollection\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Members\u003C\u002Fstrong>: 目前有效 Session 連結陣列，元素為 \u003Ccode>{ \"@odata.id\": \"...\" }\u003C\u002Fcode>\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 單一 Session 資源 URI，如 \u003Ccode>\u002Fredfish\u002Fv1\u002FSessionService\u002FSessions\u002Fa1b2c3d4\u003C\u002Fcode>；\u003Ccode>GET\u003C\u002Fcode> 可查詳情，\u003Ccode>DELETE\u003C\u002Fcode> 可登出終止\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ca>Members@odata.count\u003C\u002Fa>\u003C\u002Fstrong>: \u003Ccode>Members\u003C\u002Fcode> 陣列筆數，即目前有效 Session 數量\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-120\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-121\">POST https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>建立認證工作階段。請求需帶 Basic Auth 或 JSON 帳密（二擇一，建議 Basic Auth）。\u003C\u002Fp>\n\u003Cp>\u003Cstrong>方式 A — Basic Auth 標頭 + 空 body\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cpre>\u003Ccode>POST \u002Fredfish\u002Fv1\u002FSessionService\u002FSessions HTTP\u002F1.1\nAuthorization: Basic YWRtaW46cGFzc3dvcmQ=\nContent-Type: application\u002Fjson\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>\u003Cstrong>方式 B — JSON body\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"UserName\": \"admin\",\n  \"Password\": \"password\"\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-122\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>UserName\u003C\u002Fstrong>: 登入帳號，對應 auth 使用者名稱\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Password\u003C\u002Fstrong>: 登入密碼\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-123\">回傳資料格式如下:\u003C\u002Fh4>\n\u003Cp>回應標頭：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>HTTP\u002F1.1 201 Created\nLocation: \u002Fredfish\u002Fv1\u002FSessionService\u002FSessions\u002Fa1b2c3d4\nX-Auth-Token: 7c3f8a2b9e1d4f6a8c0b2d4e6f8a0c2\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>回應 body：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FSessionService\u002FSessions\u002Fa1b2c3d4\",\n  \"@odata.type\": \"#Session.v1_7_2.Session\",\n  \"Id\": \"a1b2c3d4\",\n  \"Name\": \"admin\",\n  \"UserName\": \"admin\",\n  \"Description\": \"User Session\"\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-124\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>X-Auth-Token\u003C\u002Fstrong>（回應標頭）: 後續 API 請求須帶此標頭，取代 Basic Auth\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Location\u003C\u002Fstrong>（回應標頭）: Session 資源 URI，登出時對此 URI 執行 \u003Ccode>DELETE\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 新建 Session 的資源 URI\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#Session.v1_7_2.Session\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: Session 識別碼，與 URI 最後一段相同\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 通常為登入帳號名稱\u003C\u002Fli>\n\u003Cli>\u003Cstrong>UserName\u003C\u002Fstrong>: 登入帳號\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Description\u003C\u002Fstrong>: 工作階段說明\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-125\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>201\u003C\u002Ftd>\n\u003Ctd>建立成功\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>請求格式錯誤\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>帳密錯誤\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>帳號鎖定或權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-126\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>查詢指定 Session 資訊。請求須帶 \u003Ccode>X-Auth-Token\u003C\u002Fcode> 或 Basic Auth。\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>id\u003C\u002Fstrong>（路徑參數）: Session 識別碼，與 \u003Ccode>POST \u002FSessionService\u002FSessions\u003C\u002Fcode> 回應的 \u003Cstrong>Id\u003C\u002Fstrong> 相同\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-127\">回傳資料格式如下:\u003C\u002Fh4>\n\u003Cp>回應標頭：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>HTTP\u002F1.1 200 OK\nContent-Type: application\u002Fjson\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>回應 body：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FSessionService\u002FSessions\u002Fa1b2c3d4\",\n  \"@odata.type\": \"#Session.v1_7_2.Session\",\n  \"Id\": \"a1b2c3d4\",\n  \"Name\": \"admin\",\n  \"UserName\": \"admin\",\n  \"Description\": \"User Session\"\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-128\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: Session 資源 URI\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#Session.v1_7_2.Session\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: Session 識別碼，與 URI 最後一段相同\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 通常為登入帳號名稱\u003C\u002Fli>\n\u003Cli>\u003Cstrong>UserName\u003C\u002Fstrong>: 登入帳號\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Description\u003C\u002Fstrong>: 工作階段說明\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-129\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常，回傳上述 Session 資源 body\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證（未帶 \u003Ccode>X-Auth-Token\u003C\u002Fcode> 或 Basic Auth）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>Session 不存在或已過期\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-130\">DELETE https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>登出並終止 Session。請求須帶對應的 \u003Ccode>X-Auth-Token\u003C\u002Fcode>。無請求 body。\u003C\u002Fp>\n\u003Ch4 id=\"section-131\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>id\u003C\u002Fstrong>（路徑參數）: 要終止的 Session 識別碼\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-132\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>已終止\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>Session 不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>curl -sk -u admin:'\u003C\u002Fp>\n\u003Cp>curl -sk -u admin:'\u003C\u002Fp>\n\u003Cp>curl -sk -u admin:'\u003C\u002Fp>\n\u003Cpre>\u003Ccode>\n#### 回傳資料狀態\n\n狀態碼 | 說明\n----- | -------------\n200   | 成功\n400   | JSON 錯誤、參數超出範圍，或 `ReturnPath` 格式／白名單不符\n401   | 未認證\n403   | 權限不足、帳號停用，或 Operator 試圖為他人簽發\n404   | 指定 UserName 不存在\n\n### GET https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FAccountService\n\n查詢帳號服務資訊。本地帳號集合為唯讀探索連結；LDAP／RADIUS／TACACS+ 設定內嵌於本資源。\n\n```json\n{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FAccountService\",\n  \"@odata.type\": \"#AccountService.v1_15_0.AccountService\",\n  \"Id\": \"AccountService\",\n  \"Name\": \"Account Service\",\n  \"ServiceEnabled\": true,\n  \"MinPasswordLength\": 8,\n  \"MaxPasswordLength\": 16,\n  \"Accounts\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FAccountService\u002FAccounts\"\n  },\n  \"Roles\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FAccountService\u002FRoles\"\n  },\n  \"OutboundConnections\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FAccountService\u002FOutboundConnections\"\n  },\n  \"LDAP\": {\n    \"ServiceEnabled\": false,\n    \"ServiceAddresses\": [],\n    \"Authentication\": {\n      \"AuthenticationType\": \"UsernameAndPassword\",\n      \"Username\": null,\n      \"Password\": null\n    },\n    \"LDAPService\": {\n      \"SearchSettings\": {\n        \"BaseDistinguishedNames\": [],\n        \"UsernameAttribute\": \"uid\"\n      }\n    },\n    \"Oem\": {\n      \"Pelx\": {\n        \"FallbackLocal\": true\n      }\n    }\n  },\n  \"Oem\": {\n    \"Pelx\": {\n      \"PasswordPolicy\": {\n        \"RequireUppercase\": true,\n        \"RequireLowercase\": true,\n        \"RequireNumbers\": true,\n        \"RequireSpecialChars\": true\n      },\n      \"Radius\": {\n        \"ServiceEnabled\": false,\n        \"ServiceAddress\": \"\",\n        \"ServicePort\": 1812,\n        \"TimeoutSec\": 5,\n        \"MaxRetries\": 3,\n        \"FallbackLocal\": true,\n        \"Secret\": null\n      },\n      \"Tacacs\": {\n        \"ServiceEnabled\": false,\n        \"ServiceAddress\": \"\",\n        \"ServicePort\": 49,\n        \"TimeoutSec\": 5,\n        \"FallbackLocal\": true,\n        \"Secret\": null\n      }\n    }\n  },\n  \"Actions\": {\n    \"#PelxAccountService.TestLDAPConnection\": {\n      \"target\": \"\u002Fredfish\u002Fv1\u002FAccountService\u002FActions\u002FPelxAccountService.TestLDAPConnection\"\n    },\n    \"#PelxAccountService.TestRADIUSConnection\": {\n      \"target\": \"\u002Fredfish\u002Fv1\u002FAccountService\u002FActions\u002FPelxAccountService.TestRADIUSConnection\"\n    },\n    \"#PelxAccountService.TestTACACSConnection\": {\n      \"target\": \"\u002Fredfish\u002Fv1\u002FAccountService\u002FActions\u002FPelxAccountService.TestTACACSConnection\"\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-133\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: AccountService 資源 URI，固定 \u003Ccode>\u002Fredfish\u002Fv1\u002FAccountService\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#AccountService.v1_15_0.AccountService\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 資源識別碼，固定 \u003Ccode>AccountService\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 顯示名稱，固定 \u003Ccode>Account Service\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ServiceEnabled\u003C\u002Fstrong>: 帳號服務是否啟用，\u003Ccode>true\u003C\u002Fcode> 表示可透過 Redfish 查詢帳號資訊\u003C\u002Fli>\n\u003Cli>\u003Cstrong>MinPasswordLength\u003C\u002Fstrong>／\u003Cstrong>MaxPasswordLength\u003C\u002Fstrong>: 密碼長度上下限（DMTF 標準欄位）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem.Pelx.PasswordPolicy\u003C\u002Fstrong>: 複雜度要求（大寫、小寫、數字、特殊字元）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Accounts\u003C\u002Fstrong>: 帳號集合連結物件\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 帳號列表 URI（\u003Ccode>\u002Fredfish\u002Fv1\u002FAccountService\u002FAccounts\u003C\u002Fcode>）；支援 \u003Ccode>GET\u003C\u002Fcode>／\u003Ccode>POST\u003C\u002Fcode>；單筆支援 \u003Ccode>GET\u003C\u002Fcode>／\u003Ccode>PATCH\u003C\u002Fcode>／\u003Ccode>DELETE\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Roles\u003C\u002Fstrong>: 角色定義集合連結物件\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 角色列表 URI（\u003Ccode>\u002Fredfish\u002Fv1\u002FAccountService\u002FRoles\u003C\u002Fcode>）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>OutboundConnections\u003C\u002Fstrong>: 出站 WebSocket 連線集合（DMTF 2023.2+；見 outbound connection）\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 出站連線列表 URI（\u003Ccode>\u002Fredfish\u002Fv1\u002FAccountService\u002FOutboundConnections\u003C\u002Fcode>）；\u003Ccode>GET\u003C\u002Fcode>／\u003Ccode>POST\u003C\u002Fcode>；單筆支援 \u003Ccode>GET\u003C\u002Fcode>／\u003Ccode>PATCH\u003C\u002Fcode>／\u003Ccode>DELETE\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>LDAP\u003C\u002Fstrong>: 標準 LDAP 外部帳號提供者（DMTF \u003Ccode>LDAPService\u003C\u002Fcode>）；\u003Ccode>PATCH\u003C\u002Fcode> 本資源之 \u003Ccode>LDAP\u003C\u002Fcode> 區塊更新\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem.Pelx.Radius\u003C\u002Fstrong>: RADIUS 伺服器設定（DMTF 無單一標準屬性，以 OEM 表示）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem.Pelx.Tacacs\u003C\u002Fstrong>: TACACS+ 伺服器設定（Pelx OEM）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Actions\u003C\u002Fstrong>: LDAP／RADIUS／TACACS+ 連線測試 Action\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-134\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-135\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>列出帳號（不回傳密碼）。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FAccountService\u002FAccounts\",\n  \"@odata.type\": \"#ManagerAccountCollection.ManagerAccountCollection\",\n  \"Members\": [\n    {\n      \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FAccountService\u002FAccounts\u002F1\"\n    }\n  ],\n  \"Members@odata.count\": 1\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-136\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 帳號集合資源 URI，固定 \u003Ccode>\u002Fredfish\u002Fv1\u002FAccountService\u002FAccounts\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#ManagerAccountCollection.ManagerAccountCollection\u003C\u002Fcode>（\u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Members\u003C\u002Fstrong>: 帳號資源連結陣列，元素為 \u003Ccode>{ \"@odata.id\": \"...\" }\u003C\u002Fcode>，不含密碼\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 單一帳號資源 URI，如 \u003Ccode>\u002Fredfish\u002Fv1\u002FAccountService\u002FAccounts\u002F1\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ca>Members@odata.count\u003C\u002Fa>\u003C\u002Fstrong>: \u003Ccode>Members\u003C\u002Fcode> 陣列筆數，即帳號數量\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-137\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-138\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>查詢單一帳號詳細資訊（不回傳密碼）。\u003C\u002Fp>\n\u003Cp>\u003Ccode>{id}\u003C\u002Fcode> 為帳號資源識別碼，對應上一節 \u003Ccode>Members\u003C\u002Fcode> 中 \u003Ccode>@odata.id\u003C\u002Fcode> 的最後一段路徑，例如 \u003Ccode>\u002Fredfish\u002Fv1\u002FAccountService\u002FAccounts\u002F1\u003C\u002Fcode> 的 \u003Ccode>{id}\u003C\u002Fcode> 為 \u003Ccode>1\u003C\u002Fcode>。\u003Ccode>{id}\u003C\u002Fcode> 與 \u003Ccode>UserName\u003C\u002Fcode> 不一定相同；登入名稱請讀回應中的 \u003Ccode>UserName\u003C\u002Fcode> 欄位。\u003C\u002Fp>\n\u003Ch4 id=\"section-139\">回傳資料格式如下:\u003C\u002Fh4>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FAccountService\u002FAccounts\u002F1\",\n  \"@odata.type\": \"#ManagerAccount.v1_12_0.ManagerAccount\",\n  \"Id\": \"1\",\n  \"UserName\": \"admin\",\n  \"RoleId\": \"Administrator\",\n  \"Enabled\": true,\n  \"Locked\": false,\n  \"@Redfish.WriteableProperties\": [\"RoleId\", \"Password\", \"Enabled\", \"Locked\"]\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-140\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 帳號資源 URI，如 \u003Ccode>\u002Fredfish\u002Fv1\u002FAccountService\u002FAccounts\u002F1\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#ManagerAccount.v1_12_0.ManagerAccount\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 帳號資源識別碼，與 URI 路徑參數 \u003Ccode>{id}\u003C\u002Fcode> 相同\u003C\u002Fli>\n\u003Cli>\u003Cstrong>UserName\u003C\u002Fstrong>: 登入帳號名稱，對應 auth 使用者名稱\u003C\u002Fli>\n\u003Cli>\u003Cstrong>RoleId\u003C\u002Fstrong>: Redfish 角色識別碼，如 \u003Ccode>Administrator\u003C\u002Fcode>、\u003Ccode>Operator\u003C\u002Fcode>、\u003Ccode>ReadOnly\u003C\u002Fcode>；由 auth \u003Cstrong>role\u003C\u002Fstrong> 映射，見本文「認證」章節\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Enabled\u003C\u002Fstrong>: 帳號是否啟用，\u003Ccode>false\u003C\u002Fcode> 時無法登入\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Locked\u003C\u002Fstrong>: 帳號是否鎖定（如多次登入失敗），\u003Ccode>true\u003C\u002Fcode> 時無法登入直至解鎖\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@Redfish.WriteableProperties\u003C\u002Fstrong>: 可 \u003Ccode>PATCH\u003C\u002Fcode> 欄位陣列（須 \u003Cstrong>Administrator\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-141\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>查詢成功\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未登入或 Token 無效\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{id}\u003C\u002Fcode> 不存在或帳號已刪除\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>\u003Ccode>{id}\u003C\u002Fcode> 不存在時不會回傳其他帳號內容，請重新 \u003Ccode>GET \u002FAccountService\u002FAccounts\u003C\u002Fcode> 從 \u003Ccode>Members\u003C\u002Fcode> 取得有效 id。\u003C\u002Fp>\n\u003Cp>404 回應範例：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"error\": {\n    \"@Message.ExtendedInfo\": [\n      {\n        \"Message\": \"The resource at the URI \u002Fredfish\u002Fv1\u002FAccountService\u002FAccounts\u002F999 was not found.\",\n        \"MessageId\": \"Base.1.18.ResourceNotFound\",\n        \"Severity\": \"Critical\",\n        \"Resolution\": \"Place a valid resource URI in the request.\"\n      }\n    ]\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-142\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>error\u003C\u002Fstrong>: 錯誤物件\u003Cul>\n\u003Cli>\u003Cstrong>@Message.ExtendedInfo\u003C\u002Fstrong>: 延伸錯誤資訊陣列\u003Cul>\n\u003Cli>\u003Cstrong>Message\u003C\u002Fstrong>: 詳細說明\u003C\u002Fli>\n\u003Cli>\u003Cstrong>MessageId\u003C\u002Fstrong>: 訊息識別碼，如 \u003Ccode>Base.1.18.ResourceNotFound\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Severity\u003C\u002Fstrong>: 嚴重程度，如 \u003Ccode>Critical\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Resolution\u003C\u002Fstrong>: 建議處理方式\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3 id=\"section-143\">POST https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>建立本地帳號（OCP Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）。須 \u003Cstrong>Operator 以上\u003C\u002Fstrong>；依 \u003Ca href=\"#%E5%B8%B3%E8%99%9F-crud-%E6%8E%88%E6%AC%8A%E7%9F%A9%E9%99%A3\">帳號 CRUD 授權矩陣\u003C\u002Fa> 檢查 \u003Ccode>RoleId\u003C\u002Fcode>。閘道轉呼叫 auth \u003Ccode>POST \u002Fusers\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Cp>請求 body 範例：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"UserName\": \"dcim-read\",\n  \"Password\": \"ChangeMe-Strong1\",\n  \"RoleId\": \"ReadOnly\",\n  \"Enabled\": true\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-144\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>UserName\u003C\u002Fstrong>: 登入帳號名稱（必填）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Password\u003C\u002Fstrong>: 登入密碼（必填）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>RoleId\u003C\u002Fstrong>: Redfish 角色，須為 \u003Ccode>Administrator\u003C\u002Fcode>、\u003Ccode>Operator\u003C\u002Fcode> 或 \u003Ccode>ReadOnly\u003C\u002Fcode>（\u003Cstrong>不可\u003C\u002Fstrong> \u003Ccode>app\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Enabled\u003C\u002Fstrong>: 是否啟用，預設 \u003Ccode>true\u003C\u002Fcode>；\u003Ccode>false\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-145\">欄位對照（Redfish → auth）\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Redfish\u003C\u002Fth>\n\u003Cth>auth \u003Ccode>POST \u002Fusers\u003C\u002Fcode>\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>UserName\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>username\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Password\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>password\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>RoleId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>role\u003C\u002Fcode>（見下表）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Enabled: false\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>deactivate: true\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Redfish \u003Ccode>RoleId\u003C\u002Fcode>\u003C\u002Fth>\n\u003Cth>auth \u003Ccode>role\u003C\u002Fcode>\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>Administrator\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>admin\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Operator\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>manager\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>ReadOnly\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>viewer\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cblockquote>\n\u003Cp>Redfish 建立帳號\u003Cstrong>不\u003C\u002Fstrong>接受 \u003Ccode>outlets\u003C\u002Fcode>、\u003Ccode>notifications\u003C\u002Fcode> 等 Web 專用欄位；插座權限請用 Web 或 auth API 另行設定。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch4 id=\"section-146\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>201\u003C\u002Ftd>\n\u003Ctd>建立成功；\u003Ccode>Location\u003C\u002Fcode> 指向 \u003Ccode>\u002Fredfish\u002Fv1\u002FAccountService\u002FAccounts\u002F{id}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>請求格式錯誤（缺欄位、RoleId 無效）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足（ReadOnly 不可建立；Operator 不可建立 \u003Ccode>Administrator\u003C\u002Fcode>；Operator 僅能建立 \u003Ccode>Operator\u003C\u002Fcode>／\u003Ccode>ReadOnly\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>409\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>UserName\u003C\u002Fcode> 已存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-147\">PATCH https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>修改帳號（OCP Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）。須 \u003Cstrong>Operator 以上\u003C\u002Fstrong>；依 \u003Ca href=\"#%E5%B8%B3%E8%99%9F-crud-%E6%8E%88%E6%AC%8A%E7%9F%A9%E9%99%A3\">帳號 CRUD 授權矩陣\u003C\u002Fa> 檢查目標帳號之 \u003Ccode>RoleId\u003C\u002Fcode> 與變更後 \u003Ccode>RoleId\u003C\u002Fcode>。閘道轉呼叫 auth \u003Ccode>PATCH \u002Fusers\u002F{username}\u003C\u002Fcode>（\u003Ccode>username\u003C\u002Fcode> 由資源 \u003Ccode>{id}\u003C\u002Fcode> 查得）。\u003C\u002Fp>\n\u003Cp>請求 body 範例（僅送要變更的欄位）：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"RoleId\": \"Operator\",\n  \"Password\": \"NewPassword-Strong1\",\n  \"Enabled\": true\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-148\">可寫欄位\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>欄位\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>Password\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>新密碼\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>RoleId\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>變更角色\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Enabled\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>false\u003C\u002Fcode> 停用帳號\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Locked\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>解鎖／鎖定（若 auth 支援）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch4 id=\"section-149\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>修改成功\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>請求格式錯誤\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足（ReadOnly 不可修改；Operator 不可修改 \u003Ccode>Administrator\u003C\u002Fcode> 或將 \u003Ccode>RoleId\u003C\u002Fcode> 改為 \u003Ccode>Administrator\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{id}\u003C\u002Fcode> 不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-150\">DELETE https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>刪除帳號（OCP Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）。須 \u003Cstrong>Operator 以上\u003C\u002Fstrong>；依 \u003Ca href=\"#%E5%B8%B3%E8%99%9F-crud-%E6%8E%88%E6%AC%8A%E7%9F%A9%E9%99%A3\">帳號 CRUD 授權矩陣\u003C\u002Fa> 檢查目標帳號。閘道轉呼叫 auth \u003Ccode>DELETE \u002Fusers\u002F{username}\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Cp>無請求 body。\u003C\u002Fp>\n\u003Ch4 id=\"section-151\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>刪除成功\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足（ReadOnly 不可刪除；Operator 不可刪除 \u003Ccode>Administrator\u003C\u002Fcode>），或不可刪除最後一個 \u003Ccode>Administrator\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{id}\u003C\u002Fcode> 不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-152\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>角色集合（OCP Service Baseline）。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FAccountService\u002FRoles\",\n  \"@odata.type\": \"#RoleCollection.RoleCollection\",\n  \"Members\": [\n    { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FAccountService\u002FRoles\u002FAdministrator\" },\n    { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FAccountService\u002FRoles\u002FOperator\" },\n    { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FAccountService\u002FRoles\u002FReadOnly\" }\n  ],\n  \"Members@odata.count\": 3\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-153\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 角色集合 URI，固定 \u003Ccode>\u002Fredfish\u002Fv1\u002FAccountService\u002FRoles\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#RoleCollection.RoleCollection\u003C\u002Fcode>（\u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Members\u003C\u002Fstrong>: 角色資源連結陣列\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ca>Members@odata.count\u003C\u002Fa>\u003C\u002Fstrong>: 角色數量\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-154\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-155\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>查詢單一角色定義（OCP Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）。\u003Cstrong>RoleId\u003C\u002Fstrong> 為 \u003Ccode>Administrator\u003C\u002Fcode>、\u003Ccode>Operator\u003C\u002Fcode> 或 \u003Ccode>ReadOnly\u003C\u002Fcode>。預設角色 \u003Ccode>IsPredefined: true\u003C\u002Fcode>，\u003Ccode>AssignedPrivileges\u003C\u002Fcode> 不可 \u003Ccode>PATCH\u003C\u002Fcode> 修改。\u003C\u002Fp>\n\u003Cp>\u003Cstrong>Administrator\u003C\u002Fstrong> 範例：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FAccountService\u002FRoles\u002FAdministrator\",\n  \"@odata.type\": \"#Role.v1_3_0.Role\",\n  \"Id\": \"Administrator\",\n  \"Name\": \"Administrator\",\n  \"IsPredefined\": true,\n  \"AssignedPrivileges\": [\"Login\", \"ConfigureManager\", \"ConfigureUsers\", \"ConfigureSelf\", \"ConfigureComponents\"],\n  \"OemPrivileges\": [\"ConfigureEngineering\"]\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>\u003Cstrong>ReadOnly\u003C\u002Fstrong> 範例（OCP 基礎角色）：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FAccountService\u002FRoles\u002FReadOnly\",\n  \"@odata.type\": \"#Role.v1_3_0.Role\",\n  \"Id\": \"ReadOnly\",\n  \"Name\": \"Read Only\",\n  \"IsPredefined\": true,\n  \"AssignedPrivileges\": [\"Login\", \"ConfigureSelf\"],\n  \"OemPrivileges\": []\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>RoleId\u003C\u002Fth>\n\u003Cth>典型權限\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>Administrator\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>讀寫全部資源、工程模式、帳號 CRUD（含系統管理員）、Session 管理\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Operator\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>讀取全部、\u003Cstrong>控制 Action\u003C\u002Fstrong> 與一般選單寫入；帳號 CRUD 僅限 Operator／ReadOnly\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>ReadOnly\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>可登入\u003C\u002Fstrong>、\u003Cstrong>可改自己密碼\u003C\u002Fstrong>、\u003Cstrong>可讀監測\u003C\u002Fstrong>；\u003Cstrong>嚴禁\u003C\u002Fstrong>配置修改與控制\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch4 id=\"section-156\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>RoleId 不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-157\">PATCH https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>修改帳號服務設定（密碼政策、LDAP、RADIUS、TACACS+）。須 \u003Cstrong>Administrator\u003C\u002Fstrong>（工程模式）。僅送要變更的區塊。\u003C\u002Fp>\n\u003Ch4 id=\"section-158\">密碼強度政策範例\u003C\u002Fh4>\n\u003Cpre>\u003Ccode>{\n  \"MinPasswordLength\": 10,\n  \"MaxPasswordLength\": 32,\n  \"Oem\": {\n    \"Pelx\": {\n      \"PasswordPolicy\": {\n        \"RequireUppercase\": true,\n        \"RequireLowercase\": true,\n        \"RequireNumbers\": true,\n        \"RequireSpecialChars\": true\n      }\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-159\">LDAP 範例\u003C\u002Fh4>\n\u003Cpre>\u003Ccode>{\n  \"LDAP\": {\n    \"ServiceEnabled\": true,\n    \"ServiceAddresses\": [\"ldap:\u002F\u002Fldap.example.com:389\"],\n    \"Authentication\": {\n      \"AuthenticationType\": \"UsernameAndPassword\",\n      \"Username\": \"cn=admin,dc=example,dc=com\",\n      \"Password\": \"bind-secret\"\n    },\n    \"LDAPService\": {\n      \"SearchSettings\": {\n        \"BaseDistinguishedNames\": [\"dc=example,dc=com\"],\n        \"UsernameAttribute\": \"uid\"\n      }\n    },\n    \"Oem\": {\n      \"Pelx\": {\n        \"FallbackLocal\": true\n      }\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-160\">RADIUS 範例\u003C\u002Fh4>\n\u003Cpre>\u003Ccode>{\n  \"Oem\": {\n    \"Pelx\": {\n      \"Radius\": {\n        \"ServiceEnabled\": true,\n        \"ServiceAddress\": \"radius.example.com\",\n        \"ServicePort\": 1812,\n        \"Secret\": \"radius_secret\",\n        \"TimeoutSec\": 5,\n        \"MaxRetries\": 3,\n        \"FallbackLocal\": true\n      }\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-161\">TACACS+ 範例\u003C\u002Fh4>\n\u003Cpre>\u003Ccode>{\n  \"Oem\": {\n    \"Pelx\": {\n      \"Tacacs\": {\n        \"ServiceEnabled\": true,\n        \"ServiceAddress\": \"tacacs.example.com\",\n        \"ServicePort\": 49,\n        \"Secret\": \"tacacs_secret\",\n        \"TimeoutSec\": 5,\n        \"FallbackLocal\": true\n      }\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-162\">欄位對照（Redfish → auth）\u003C\u002Fh4>\n\u003Cp>\u003Cstrong>LDAP\u003C\u002Fstrong> → \u003Ccode>PATCH \u002Fconfig\u002Fldap\u003C\u002Fcode>：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Redfish \u003Ccode>LDAP\u003C\u002Fcode>\u003C\u002Fth>\n\u003Cth>auth\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>ServiceEnabled\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>enabled\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>ServiceAddresses[0]\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>host\u003C\u002Fcode>、\u003Ccode>port\u003C\u002Fcode>、\u003Ccode>sslEnabled\u003C\u002Fcode>（\u003Ccode>ldaps:\u002F\u002F\u003C\u002Fcode> → \u003Ccode>sslEnabled: true\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Authentication.Username\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>bindDN\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Authentication.Password\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>password\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>LDAPService.SearchSettings.BaseDistinguishedNames[0]\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>base\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>LDAPService.SearchSettings.UsernameAttribute\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>uid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Oem.Pelx.FallbackLocal\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>fallbackLocal\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>\u003Cstrong>RADIUS\u003C\u002Fstrong> → \u003Ccode>PATCH \u002Fconfig\u002Fradius\u003C\u002Fcode>：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Redfish \u003Ccode>Oem.Pelx.Radius\u003C\u002Fcode>\u003C\u002Fth>\n\u003Cth>auth\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>ServiceEnabled\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>enabled\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>ServiceAddress\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>host\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>ServicePort\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>port\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Secret\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>secret\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>TimeoutSec\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>timeout\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>MaxRetries\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>maxRetries\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>FallbackLocal\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>fallbackLocal\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>\u003Cstrong>TACACS+\u003C\u002Fstrong> → \u003Ccode>PATCH \u002Fconfig\u002Ftacacs\u003C\u002Fcode>：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Redfish \u003Ccode>Oem.Pelx.Tacacs\u003C\u002Fcode>\u003C\u002Fth>\n\u003Cth>auth\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>ServiceEnabled\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>enabled\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>ServiceAddress\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>host\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>ServicePort\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>port\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Secret\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>secret\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>TimeoutSec\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>timeout\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>FallbackLocal\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>fallbackLocal\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>\u003Cstrong>密碼強度\u003C\u002Fstrong> → \u003Ccode>PATCH \u002Fconfig\u002Fpassword-policy\u003C\u002Fcode>：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Redfish\u003C\u002Fth>\n\u003Cth>auth\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>MinPasswordLength\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>minLength\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>MaxPasswordLength\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>maxLength\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Oem.Pelx.PasswordPolicy.RequireUppercase\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>requireUppercase\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Oem.Pelx.PasswordPolicy.RequireLowercase\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>requireLowercase\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Oem.Pelx.PasswordPolicy.RequireNumbers\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>requireNumbers\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Oem.Pelx.PasswordPolicy.RequireSpecialChars\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>requireSpecialChars\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>GET 回應\u003Cstrong>不回傳\u003C\u002Fstrong> \u003Ccode>Authentication.Password\u003C\u002Fcode>、\u003Ccode>Radius.Secret\u003C\u002Fcode>、\u003Ccode>Tacacs.Secret\u003C\u002Fcode>（\u003Ccode>null\u003C\u002Fcode> 或省略）。\u003C\u002Fp>\n\u003Ch4 id=\"section-163\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>修改成功\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>請求格式錯誤\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>須 Administrator（工程模式）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>503\u003C\u002Ftd>\n\u003Ctd>無法連線 auth\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-164\">POST https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>測試 LDAP 連線。須 \u003Cstrong>Administrator\u003C\u002Fstrong>。。\u003C\u002Fp>\n\u003Cp>請求 body 範例（可省略已儲存於 \u003Ccode>LDAP\u003C\u002Fcode> 的欄位，改送測試帳密）：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"ServiceAddresses\": [\"ldap:\u002F\u002Fldap.example.com:389\"],\n  \"Authentication\": {\n    \"Username\": \"cn=admin,dc=example,dc=com\",\n    \"Password\": \"bind-secret\"\n  },\n  \"LDAPService\": {\n    \"SearchSettings\": {\n      \"BaseDistinguishedNames\": [\"dc=example,dc=com\"],\n      \"UsernameAttribute\": \"uid\"\n    }\n  },\n  \"TestUserName\": \"testuser\",\n  \"TestPassword\": \"testpassword\"\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Redfish\u003C\u002Fth>\n\u003Cth>auth \u003Ccode>\u002Ftest\u002Fldap\u003C\u002Fcode>\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>ServiceAddresses\u003C\u002Fcode> → host\u002Fport\u002Fssl\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>host\u003C\u002Fcode>、\u003Ccode>port\u003C\u002Fcode>、\u003Ccode>sslEnabled\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Authentication.Username\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>bindDN\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Authentication.Password\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>password\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>LDAPService.SearchSettings.BaseDistinguishedNames[0]\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>base\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>LDAPService.SearchSettings.UsernameAttribute\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>uid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>TestUserName\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>testUsername\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>TestPassword\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>testPassword\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch4 id=\"section-165\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>測試成功\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>請求格式錯誤\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>LDAP 認證失敗\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>須 Administrator（工程模式）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-166\">POST https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>測試 RADIUS 連線。須 \u003Cstrong>Administrator\u003C\u002Fstrong>。。\u003C\u002Fp>\n\u003Cp>請求 body 範例：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"ServiceAddress\": \"radius.example.com\",\n  \"ServicePort\": 1812,\n  \"Secret\": \"radius_secret\",\n  \"TimeoutSec\": 5,\n  \"MaxRetries\": 3,\n  \"TestUserName\": \"testuser\",\n  \"TestPassword\": \"testpassword\"\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Redfish\u003C\u002Fth>\n\u003Cth>auth \u003Ccode>\u002Ftest\u002Fradius\u003C\u002Fcode>\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>ServiceAddress\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>host\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>ServicePort\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>port\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Secret\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>secret\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>TimeoutSec\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>timeout\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>MaxRetries\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>maxRetries\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>TestUserName\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>testUsername\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>TestPassword\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>testPassword\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch4 id=\"section-167\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>測試成功\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>請求格式錯誤\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>RADIUS 認證失敗\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>須 Administrator（工程模式）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-168\">POST https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>測試 TACACS+ 連線。須 \u003Cstrong>Administrator\u003C\u002Fstrong>。。\u003C\u002Fp>\n\u003Cp>請求 body 範例：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"ServiceAddress\": \"tacacs.example.com\",\n  \"ServicePort\": 49,\n  \"Secret\": \"tacacs_secret\",\n  \"TimeoutSec\": 5,\n  \"TestUserName\": \"testuser\",\n  \"TestPassword\": \"testpassword\"\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Redfish\u003C\u002Fth>\n\u003Cth>auth \u003Ccode>\u002Ftest\u002Ftacacs\u003C\u002Fcode>\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>ServiceAddress\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>host\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>ServicePort\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>port\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Secret\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>secret\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>TimeoutSec\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>timeout\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>TestUserName\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>testUsername\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>TestPassword\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>testPassword\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch4 id=\"section-169\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>測試成功\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>請求格式錯誤\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>TACACS+ 認證失敗\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>須 Administrator（工程模式）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>\u003Cstrong>實作狀態\u003C\u002Fstrong>：LDAP／RADIUS／TACACS+ 為規格定義。\u003C\u002Fp>\n\u003Ch3 id=\"section-170\">HTTPS 憑證（實際作業方式）\u003C\u002Fh3>\n\u003Cp>設備對外 HTTPS（Web 管理介面、Redfish over HTTPS）支援兩種模式：\u003C\u002Fp>\n\u003Cp>|------|--------------------------------------|-------------|\n| \u003Cstrong>uacme\u003C\u002Fstrong>（預設） | \u003Ccode>uacme\u003C\u002Fcode> | \u003Ccode>CertificateService\u003C\u002Fcode> 與 \u003Ccode>PelxCertificateService.TestUacme\u003C\u002Fcode> |\n| \u003Cstrong>manual\u003C\u002Fstrong> | \u003Ccode>manual\u003C\u002Fcode> | \u003Ccode>GET\u002FPATCH \u002Ftls\u003C\u002Fcode>、\u003Ccode>POST \u002Ftls\u002Fcsr\u003C\u002Fcode>、\u003Ccode>POST \u002Ftls\u002Fcertificates\u002Freplace\u003C\u002Fcode> |\u003C\u002Fp>\n\u003Ch3 id=\"section-171\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>憑證服務（OCP Service Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FCertificateService\",\n  \"@odata.type\": \"#CertificateService.v1_0_1.CertificateService\",\n  \"Id\": \"CertificateService\",\n  \"Name\": \"Certificate Service\",\n  \"ServiceEnabled\": true,\n  \"CertificateLocations\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FCertificateService\u002FCertificateLocations\"\n  },\n  \"Oem\": {\n    \"Pelx\": {\n      \"CertificateMode\": \"uacme\",\n      \"Uacme\": {\n        \"ServiceEnabled\": true,\n        \"Domain\": \"pdu.example.com\",\n        \"ContactEmail\": \"admin@example.com\"\n      }\n    }\n  },\n  \"Actions\": {\n    \"#CertificateService.GenerateCSR\": {\n      \"target\": \"\u002Fredfish\u002Fv1\u002FCertificateService\u002FActions\u002FCertificateService.GenerateCSR\"\n    },\n    \"#CertificateService.ReplaceCertificate\": {\n      \"target\": \"\u002Fredfish\u002Fv1\u002FCertificateService\u002FActions\u002FCertificateService.ReplaceCertificate\"\n    },\n    \"#PelxCertificateService.TestUacme\": {\n      \"target\": \"\u002Fredfish\u002Fv1\u002FCertificateService\u002FActions\u002FPelxCertificateService.TestUacme\"\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-172\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: CertificateService 資源 URI，固定 \u003Ccode>\u002Fredfish\u002Fv1\u002FCertificateService\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ServiceEnabled\u003C\u002Fstrong>: 服務是否啟用（Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>CertificateLocations\u003C\u002Fstrong>: 憑證存放位置集合（Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem.Pelx.CertificateMode\u003C\u002Fstrong>: \u003Ccode>manual\u003C\u002Fcode> 或 \u003Ccode>uacme\u003C\u002Fcode>（。須 \u003Cstrong>Administrator\u003C\u002Fstrong>。 與／或 \u003Ccode>PATCH \u002Fuacme\u003C\u002Fcode>。\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>切換為 uacme（預設生產模式）：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"Oem\": {\n    \"Pelx\": {\n      \"CertificateMode\": \"uacme\",\n      \"Uacme\": {\n        \"ServiceEnabled\": true,\n        \"Domain\": \"pdu.example.com\",\n        \"ContactEmail\": \"admin@example.com\"\n      }\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>切換為手動憑證（企業 CA／CSR）：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"Oem\": {\n    \"Pelx\": {\n      \"CertificateMode\": \"manual\",\n      \"Uacme\": {\n        \"ServiceEnabled\": false\n      }\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-173\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>修改成功\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>請求格式錯誤\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>須 Administrator（工程模式）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>409\u003C\u002Ftd>\n\u003Ctd>切換條件不符（例如憑證更新中）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>502\u003C\u002Ftd>\n\u003Ctd>uacme／CA 連線失敗\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>503\u003C\u002Ftd>\n\u003Ctd>服務暫不可用\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-174\">POST https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>測試 uacme 申請條件（不實際簽發）。須 \u003Cstrong>Administrator\u003C\u002Fstrong>。。\u003C\u002Fp>\n\u003Cp>請求 body 範例：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"Domain\": \"pdu.example.com\",\n  \"ContactEmail\": \"admin@example.com\"\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>|---------|----------------------|\n| \u003Ccode>Domain\u003C\u002Fcode> | \u003Ccode>domain\u003C\u002Fcode> |\n| \u003Ccode>ContactEmail\u003C\u002Fcode> | \u003Ccode>mail\u003C\u002Fcode> |\u003C\u002Fp>\n\u003Ch4 id=\"section-175\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>測試成功\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>請求格式錯誤\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>須 Administrator（工程模式）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>502\u003C\u002Ftd>\n\u003Ctd>CA 連線或驗證失敗\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>503\u003C\u002Ftd>\n\u003Ctd>服務暫不可用\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-176\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>列出可管理的憑證位置（OCP Service Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FCertificateService\u002FCertificateLocations\",\n  \"@odata.type\": \"#CertificateLocations.v1_0_2.CertificateLocations\",\n  \"Id\": \"CertificateLocations\",\n  \"Links\": {\n    \"Certificates\": [\n      { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FCertificateService\u002FCertificates\u002Fhttps-server\" }\n    ]\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-177\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: CertificateLocations 資源 URI，固定 \u003Ccode>\u002Fredfish\u002Fv1\u002FCertificateService\u002FCertificateLocations\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#CertificateLocations.v1_0_2.CertificateLocations\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 資源識別碼，固定 \u003Ccode>CertificateLocations\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Links.Certificates\u003C\u002Fstrong>: 憑證資源連結陣列；有 HTTPS 憑證時指向 \u003Ccode>...\u002FCertificateService\u002FCertificates\u002Fhttps-server\u003C\u002Fcode>（含 \u003Ccode>certMode=uacme\u003C\u002Fcode> 時使用自動憑證）；無憑證時為空陣列 \u003Ccode>[]\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-178\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>503\u003C\u002Ftd>\n\u003Ctd>服務暫不可用\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-179\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>憑證集合。。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FCertificateService\u002FCertificates\",\n  \"@odata.type\": \"#CertificateCollection.CertificateCollection\",\n  \"Members\": [\n    { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FCertificateService\u002FCertificates\u002Fhttps-server\" }\n  ],\n  \"Members@odata.count\": 1\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-180\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>503\u003C\u002Ftd>\n\u003Ctd>服務暫不可用\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-181\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>查詢指定憑證 slot 的 PEM 公開資訊（不含私鑰）。\u003Cstrong>id\u003C\u002Fstrong> 固定為 \u003Ccode>https-server\u003C\u002Fcode>（別名 \u003Ccode>1\u003C\u002Fcode>）。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FCertificateService\u002FCertificates\u002Fhttps-server\",\n  \"@odata.type\": \"#Certificate.v1_8_0.Certificate\",\n  \"Id\": \"https-server\",\n  \"Name\": \"HTTPS Server Certificate\",\n  \"CertificateType\": \"PEM\",\n  \"CertificateString\": \"-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----\",\n  \"Issuer\": { \"CommonName\": \"Example CA\" },\n  \"Subject\": { \"CommonName\": \"CN=pdu.example.com\" },\n  \"ValidNotBefore\": \"2026-06-01T00:00:00Z\",\n  \"ValidNotAfter\": \"2027-06-01T00:00:00Z\"\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-182\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>slot 不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>503\u003C\u002Ftd>\n\u003Ctd>服務暫不可用\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-183\">POST https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>產生 CSR（DMTF Redfish 標準 Action）。（須 \u003Ccode>certMode=manual\u003C\u002Fcode>）。\u003C\u002Fp>\n\u003Cp>請求 body 範例：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"Country\": \"TW\",\n  \"State\": \"Taipei\",\n  \"City\": \"Taipei\",\n  \"Organization\": \"Example Corp\",\n  \"OrganizationalUnit\": \"IT\",\n  \"CommonName\": \"pdu.example.com\",\n  \"Email\": \"admin@example.com\",\n  \"AlternativeNames\": [\"pdu.example.com\", \"192.168.1.100\"],\n  \"KeyBitLength\": 2048\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>成功回應：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"CSRString\": \"-----BEGIN CERTIFICATE REQUEST-----\\n...\\n-----END CERTIFICATE REQUEST-----\"\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-184\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>成功\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>409\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>certMode=uacme\u003C\u002Fcode>，須先切換為 \u003Ccode>manual\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>503\u003C\u002Ftd>\n\u003Ctd>服務暫不可用\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-185\">POST https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>更換憑證。。\u003C\u002Fp>\n\u003Cp>請求 body 範例：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"CertificateUri\": \"\u002Fredfish\u002Fv1\u002FCertificateService\u002FCertificates\u002Fhttps-server\",\n  \"CertificateType\": \"PEM\",\n  \"CertificateString\": \"-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----\"\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>亦可附 \u003Ccode>CertificateChain\u003C\u002Fcode> 陣列（中繼憑證 PEM）。\u003C\u002Fp>\n\u003Ch4 id=\"section-186\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>成功\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>409\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>certMode=uacme\u003C\u002Fcode>，或憑證與私鑰不匹配\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>503\u003C\u002Ftd>\n\u003Ctd>服務暫不可用\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Chr>\n\u003Ch1 id=\"section-187\">探索與識別\u003C\u002Fh1>\n\u003Cp>Redfish Service Root，作為所有資源的入口。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\",\n  \"@odata.type\": \"#ServiceRoot.v1_16_0.ServiceRoot\",\n  \"Id\": \"RootService\",\n  \"Name\": \"Root Service\",\n  \"RedfishVersion\": \"1.16.0\",\n  \"UUID\": \"00000000-0000-0000-0000-000000000001\",\n  \"Vendor\": \"Pelx\",\n  \"SessionService\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FSessionService\"\n  },\n  \"AccountService\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FAccountService\"\n  },\n  \"CertificateService\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FCertificateService\"\n  },\n  \"Chassis\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FChassis\"\n  },\n  \"Managers\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FManagers\"\n  },\n  \"PowerEquipment\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\"\n  },\n  \"EventService\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FEventService\"\n  },\n  \"UpdateService\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FUpdateService\"\n  },\n  \"TaskService\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FTaskService\"\n  },\n  \"Product\": {\n    \"Vendor\": \"Pelx\",\n    \"Name\": \"Rack PDU\"\n  },\n  \"ProtocolFeaturesSupported\": {\n    \"ExpandQuery\": {\n      \"ExpandAll\": true,\n      \"Levels\": true\n    },\n    \"FilterQuery\": true,\n    \"OnlyMemberQuery\": true\n  },\n  \"Links\": {\n    \"Sessions\": {\n      \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FSessionService\u002FSessions\"\n    }\n  },\n  \"Oem\": {\n    \"Pelx\": {\n      \"Interfaces\": {\n        \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\"\n      },\n      \"PeripheralTree\": {\n        \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FPeripheralTree\"\n      },\n      \"TelemetryService\": {\n        \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FTelemetryService\"\n      },\n      \"Mqtt\": {\n        \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FMqtt\"\n      },\n      \"MqttEndpoint\": \"wss:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FMqtt\",\n      \"MqttAuth\": \"RedfishSession\",\n      \"SerialBuses\": {\n        \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FSerialBuses\"\n      },\n      \"VNodes\": {\n        \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FVNodes\"\n      },\n      \"HmiScreens\": {\n        \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FHmiScreens\"\n      },\n      \"HmiImageLibraries\": {\n        \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FHmiImageLibraries\"\n      },\n      \"Automations\": {\n        \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FAutomations\"\n      }\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-188\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: Service Root 資源 URI，固定 \u003Ccode>\u002Fredfish\u002Fv1\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#ServiceRoot.v1_16_0.ServiceRoot\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 資源識別碼，固定 \u003Ccode>RootService\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 顯示名稱，固定 \u003Ccode>Root Service\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>RedfishVersion\u003C\u002Fstrong>: Redfish 協議版本（OCP Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>UUID\u003C\u002Fstrong>: 設備唯一識別碼（OCP Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Vendor\u003C\u002Fstrong>: 廠商名稱（OCP Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>），固定 \u003Ccode>Pelx\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>SessionService\u003C\u002Fstrong>: Session 服務連結（Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>AccountService\u003C\u002Fstrong>: 帳號服務連結（Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>CertificateService\u003C\u002Fstrong>: 憑證服務連結（Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Chassis\u003C\u002Fstrong>: 機箱集合連結（Baseline）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Managers\u003C\u002Fstrong>: 管理控制器集合連結（Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PowerEquipment\u003C\u002Fstrong>: 配電設備連結（\u003Cstrong>OCP Rack PDU Profile Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>EventService\u003C\u002Fstrong>: 事件服務連結（Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>UpdateService\u003C\u002Fstrong>: 韌體更新服務連結（Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>TaskService\u003C\u002Fstrong>: 任務服務連結（Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Product\u003C\u002Fstrong>: 產品識別物件（Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003Cul>\n\u003Cli>\u003Cstrong>Vendor\u003C\u002Fstrong>: 廠商名稱\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 產品名稱\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ProtocolFeaturesSupported\u003C\u002Fstrong>: 協定能力（Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003Cul>\n\u003Cli>\u003Cstrong>ExpandQuery\u003C\u002Fstrong>: 支援 \u003Ccode>$expand\u003C\u002Fcode>（Baseline \u003Cstrong>Recommended\u003C\u002Fstrong>）；\u003Ccode>ExpandAll\u003C\u002Fcode>、\u003Ccode>Levels\u003C\u002Fcode> 為 true 時可用 \u003Ccode>$expand=.\u003C\u002Fcode>、\u003Ccode>$expand=.($levels=N)\u003C\u002Fcode> 一次展開子資源\u003C\u002Fli>\n\u003Cli>\u003Cstrong>FilterQuery\u003C\u002Fstrong>: 支援 \u003Ccode>$filter\u003C\u002Fcode>（Baseline \u003Cstrong>Recommended\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>OnlyMemberQuery\u003C\u002Fstrong>: 支援 \u003Ccode>$only\u003C\u002Fcode>（Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）；如 \u003Ccode>GET ...\u002FOutlets?$only\u003C\u002Fcode> 僅回 \u003Ccode>Members\u003C\u002Fcode> 陣列\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Links\u003C\u002Fstrong>: 服務層連結（Session 建立所需）\u003Cul>\n\u003Cli>\u003Cstrong>Sessions\u003C\u002Fstrong>: Session 集合 URI（\u003Cstrong>Interop Validator Session 模式 Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem.Pelx\u003C\u002Fstrong>: Pelx 擴充連結（非 OCP 必填）\u003Cul>\n\u003Cli>\u003Cstrong>Interfaces\u003C\u002Fstrong>: 介面列表\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PeripheralTree\u003C\u002Fstrong>: 週邊結構樹\u003C\u002Fli>\n\u003Cli>\u003Cstrong>TelemetryService\u003C\u002Fstrong>: 歷史趨勢服務\u003C\u002Fli>\n\u003Cli>\u003Cstrong>MqttEndpoint\u003C\u002Fstrong>: MQTT over WebSocket URL（Redfish 整合：\u003Ccode>\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FMqtt\u003C\u002Fcode>；見 MQTT Discovery）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>MqttAuth\u003C\u002Fstrong>: MQTT 認證方式；Redfish 整合為 \u003Ccode>RedfishSession\u003C\u002Fcode>（X-Auth-Token 或 Basic Auth）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>SerialBuses\u003C\u002Fstrong>: RS485 參數（僅 \u003Ccode>devinfo.rs485\u003C\u002Fcode>；見 oem serial buses）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>VNodes\u003C\u002Fstrong>: VNode 組態（僅 \u003Ccode>devinfo.vnode\u003C\u002Fcode>；見 oem vnodes）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>HmiScreens\u003C\u002Fstrong>: 圖控畫面與樣版匯出／載入（僅 \u003Ccode>devinfo.hmi\u003C\u002Fcode>；見 oem hmi screens）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>HmiImageLibraries\u003C\u002Fstrong>: 圖控圖庫（僅 \u003Ccode>devinfo.hmi\u003C\u002Fcode>；見 oem hmi image libraries）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Automations\u003C\u002Fstrong>: 自動化流程（僅 \u003Ccode>devinfo.autoBuilder\u003C\u002Fcode>；見 oem automations）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cblockquote>\n\u003Cp>\u003Ccode>SerialBuses\u003C\u002Fcode>／\u003Ccode>VNodes\u003C\u002Fcode>／\u003Ccode>HmiScreens\u003C\u002Fcode>／\u003Ccode>HmiImageLibraries\u003C\u002Fcode>／\u003Ccode>Automations\u003C\u002Fcode> 依能力旗標\u003Cstrong>條件出現\u003C\u002Fstrong>；未支援時省略該連結（客戶端勿假設永遠存在）。讀寫皆須 \u003Cstrong>Administrator\u003C\u002Fstrong>（工程模式）。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch4 id=\"section-189\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常（\u003Cstrong>允許匿名\u003C\u002Fstrong>；Interop Validator 掃描 Service Root 時需要）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證（子資源；根路徑 \u003Ccode>GET \u002Fredfish\u002Fv1\u003C\u002Fcode> 匿名仍回 200）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch4 id=\"section-190\">\u003Ccode>$expand\u003C\u002Fcode> 與 \u003Ccode>$only\u003C\u002Fcode> 範例\u003C\u002Fh4>\n\u003Cp>Service Root 宣告 \u003Ccode>ProtocolFeaturesSupported.ExpandQuery\u003C\u002Fcode> 時，可用 OData 查詢\u003Cstrong>減少往返\u003C\u002Fstrong>（不支援時回 \u003Cstrong>501\u003C\u002Fstrong>）：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>需求\u003C\u002Fth>\n\u003Cth>範例 URL\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>所有插座完整 body\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>GET ...\u002FRackPDUs\u002F1\u002FOutlets?$expand=.\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>PDU 與下兩層子資源\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>GET ...\u002FRackPDUs\u002F1?$expand=.($levels=2)\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>僅要集合成員連結\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>GET ...\u002FOutlets?$only\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cblockquote>\n\u003Cp>Collection \u003Cstrong>未加\u003C\u002Fstrong> \u003Ccode>$expand\u003C\u002Fcode> 時，\u003Ccode>Members\u003C\u002Fcode> 僅含 \u003Ccode>@odata.id\u003C\u002Fcode> 連結，不含各插座 \u003Ccode>Reading\u003C\u002Fcode>／\u003Ccode>PowerState\u003C\u002Fcode>。詳見 「總覽與合規」章節 — 一次回應多筆資料。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch3 id=\"section-191\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FManagers\",\n  \"@odata.type\": \"#ManagerCollection.ManagerCollection\",\n  \"Members\": [\n    { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FManagers\u002F1\" }\n  ],\n  \"Members@odata.count\": 1\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-192\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: Manager 集合資源 URI，固定 \u003Ccode>\u002Fredfish\u002Fv1\u002FManagers\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#ManagerCollection.ManagerCollection\u003C\u002Fcode>（Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Members\u003C\u002Fstrong>: Manager 資源連結陣列，元素為 \u003Ccode>{ \"@odata.id\": \"...\" }\u003C\u002Fcode>\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 單一 Manager 資源 URI，如 \u003Ccode>\u002Fredfish\u002Fv1\u002FManagers\u002F1\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ca>Members@odata.count\u003C\u002Fa>\u003C\u002Fstrong>: \u003Ccode>Members\u003C\u002Fcode> 陣列筆數；本機單台產品通常為 \u003Ccode>1\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-193\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-194\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>管理控制器識別，韌體版本見 \u003Ccode>FirmwareVersion\u003C\u002Fcode>。路徑參數 \u003Ccode>{id}\u003C\u002Fcode> 為 Manager 資源識別碼；\u003Cstrong>本機單台 PDU 產品通常僅一筆，id 為 \u003Ccode>1\u003C\u002Fcode>\u003C\u002Fstrong>。整合方應先 \u003Ccode>GET \u002FManagers\u003C\u002Fcode>，從 \u003Ccode>Members\u003C\u002Fcode> 的 \u003Ccode>@odata.id\u003C\u002Fcode> 取得有效 id，勿寫死。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FManagers\u002F1\",\n  \"@odata.type\": \"#Manager.v1_19_0.Manager\",\n  \"Id\": \"1\",\n  \"Name\": \"Manager\",\n  \"ManagerType\": \"BMC\",\n  \"FirmwareVersion\": \"1.60.3\",\n  \"UUID\": \"00000000-0000-0000-0000-000000000001\",\n  \"DateTime\": \"2026-06-15T10:00:00+08:00\",\n  \"DateTimeLocalOffset\": \"+08:00\",\n  \"Status\": {\n    \"State\": \"Enabled\",\n    \"Health\": \"OK\"\n  },\n  \"EthernetInterfaces\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FManagers\u002F1\u002FEthernetInterfaces\"\n  },\n  \"NetworkProtocol\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FManagers\u002F1\u002FNetworkProtocol\"\n  },\n  \"Links\": {\n    \"ManagerForChassis\": [\n      { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\" }\n    ],\n    \"ManagerForPowerEquipment\": [\n      { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\" }\n    ]\n  },\n  \"LogServices\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FManagers\u002F1\u002FLogServices\"\n  },\n  \"Oem\": {\n    \"Pelx\": {\n      \"Build\": \"202301161315\",\n      \"CompanyOid\": \"26104\",\n      \"Mqtt\": {\n        \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FMqtt\"\n      },\n      \"MqttEndpoint\": \"wss:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FMqtt\",\n      \"MqttAuth\": \"RedfishSession\"\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-195\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: Manager 資源 URI，固定 \u003Ccode>\u002Fredfish\u002Fv1\u002FManagers\u002F1\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#Manager.v1_19_0.Manager\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 資源識別碼，固定 \u003Ccode>1\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 顯示名稱，固定 \u003Ccode>Manager\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ManagerType\u003C\u002Fstrong>: 管理器類型（Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>），固定 \u003Ccode>BMC\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>FirmwareVersion\u003C\u002Fstrong>: 設備映像版本（Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>），對應 \u003Ccode>Managers\u002F1.FirmwareVersion\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>UUID\u003C\u002Fstrong>: 管理器 UUID（Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>DateTime\u003C\u002Fstrong>: 管理器目前時間 ISO 8601（Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>DateTimeLocalOffset\u003C\u002Fstrong>: 時區偏移（Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>），如 \u003Ccode>+08:00\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Status\u003C\u002Fstrong>: 狀態物件（Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>EthernetInterfaces\u003C\u002Fstrong>: 網路介面集合（Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>NetworkProtocol\u003C\u002Fstrong>: 通訊協定設定（Baseline \u003Cstrong>Supported\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Links\u003C\u002Fstrong>: 關聯資源（Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003Cul>\n\u003Cli>\u003Cstrong>ManagerForChassis\u003C\u002Fstrong>: 所管理機箱\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ManagerForPowerEquipment\u003C\u002Fstrong>: 所管理配電資源\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>LogServices\u003C\u002Fstrong>: 日誌服務（Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem.Pelx\u003C\u002Fstrong>: Pelx 擴充（非 OCP 必填）\u003Cul>\n\u003Cli>\u003Cstrong>Build\u003C\u002Fstrong>: 版號（建置時間），建置版號\u003C\u002Fli>\n\u003Cli>\u003Cstrong>CompanyOid\u003C\u002Fstrong>: 公司 OID，公司 OID\u003C\u002Fli>\n\u003Cli>\u003Cstrong>MqttEndpoint\u003C\u002Fstrong>: MQTT over WebSocket URL（見 MQTT Discovery）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>MqttAuth\u003C\u002Fstrong>: \u003Ccode>RedfishSession\u003C\u002Fcode>（X-Auth-Token 或 Basic Auth）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-196\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>資源不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-197\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FManagers\u002F1\u002FEthernetInterfaces\",\n  \"@odata.type\": \"#EthernetInterfaceCollection.EthernetInterfaceCollection\",\n  \"Members\": [\n    { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FManagers\u002F1\u002FEthernetInterfaces\u002F1\" }\n  ],\n  \"Members@odata.count\": 1\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch3 id=\"section-198\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FManagers\u002F1\u002FEthernetInterfaces\u002F1\",\n  \"@odata.type\": \"#EthernetInterface.v1_12_0.EthernetInterface\",\n  \"Id\": \"1\",\n  \"Name\": \"eth0\",\n  \"MACAddress\": \"00:11:22:33:44:55\",\n  \"InterfaceEnabled\": true,\n  \"LinkStatus\": \"LinkUp\",\n  \"SpeedMbps\": 1000,\n  \"IPv4Addresses\": [\n    {\n      \"Address\": \"192.168.1.100\",\n      \"SubnetMask\": \"255.255.255.0\",\n      \"AddressOrigin\": \"Static\",\n      \"Gateway\": \"192.168.1.1\"\n    }\n  ],\n  \"Status\": {\n    \"State\": \"Enabled\",\n    \"Health\": \"OK\"\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch3 id=\"section-199\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>NTP、SNMP 設定見 網路協定。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FManagers\u002F1\u002FNetworkProtocol\",\n  \"@odata.type\": \"#ManagerNetworkProtocol.v1_9_1.ManagerNetworkProtocol\",\n  \"Id\": \"NetworkProtocol\",\n  \"HostName\": \"pdu-1\",\n  \"HTTPS\": {\n    \"ProtocolEnabled\": true,\n    \"Port\": 443\n  },\n  \"HTTP\": {\n    \"ProtocolEnabled\": false,\n    \"Port\": 80\n  },\n  \"NTP\": {\n    \"ProtocolEnabled\": true,\n    \"NTPServers\": [\"time.stdtime.gov.tw\"]\n  },\n  \"SNMP\": {\n    \"ProtocolEnabled\": true,\n    \"Port\": 161\n  },\n  \"SSH\": {\n    \"ProtocolEnabled\": false,\n    \"Port\": 22\n  },\n  \"Status\": {\n    \"State\": \"Enabled\",\n    \"Health\": \"OK\"\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch3 id=\"section-200\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FChassis\",\n  \"@odata.type\": \"#ChassisCollection.ChassisCollection\",\n  \"Members\": [\n    { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\" }\n  ],\n  \"Members@odata.count\": 1\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-201\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: Chassis 集合資源 URI，固定 \u003Ccode>\u002Fredfish\u002Fv1\u002FChassis\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#ChassisCollection.ChassisCollection\u003C\u002Fcode>（Baseline）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Members\u003C\u002Fstrong>: Chassis 資源連結陣列，元素為 \u003Ccode>{ \"@odata.id\": \"...\" }\u003C\u002Fcode>\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 單一 Chassis 資源 URI，如 \u003Ccode>\u002Fredfish\u002Fv1\u002FChassis\u002F1\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ca>Members@odata.count\u003C\u002Fa>\u003C\u002Fstrong>: \u003Ccode>Members\u003C\u002Fcode> 陣列筆數；本機單台產品通常為 \u003Ccode>1\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-202\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-203\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>機箱識別與健康彙整。路徑參數 \u003Ccode>{chassisId}\u003C\u002Fcode> 為 Chassis 資源識別碼；\u003Cstrong>本機單台 PDU 產品通常僅一筆，id 為 \u003Ccode>1\u003C\u002Fcode>\u003C\u002Fstrong>。整合方應先 \u003Ccode>GET \u002FChassis\u003C\u002Fcode>，從 \u003Ccode>Members\u003C\u002Fcode> 的 \u003Ccode>@odata.id\u003C\u002Fcode> 取得有效 id，勿寫死。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\",\n  \"@odata.type\": \"#Chassis.v1_22_0.Chassis\",\n  \"@Redfish.WriteableProperties\": [\n    \"AssetTag\"\n  ],\n  \"Id\": \"1\",\n  \"Name\": \"Chassis\",\n  \"ChassisType\": \"RackMount\",\n  \"Manufacturer\": \"Pelx\",\n  \"Model\": \"ZDL-2A-12Z\",\n  \"PartNumber\": \"ZDL-2A-12Z\",\n  \"SerialNumber\": \"001122AABBCC\",\n  \"AssetTag\": \"\",\n  \"UUID\": \"00000000-0000-0000-0000-000000000002\",\n  \"PowerState\": \"On\",\n  \"Location\": {\n    \"@Redfish.WriteableProperties\": [\n      \"Contacts\"\n    ],\n    \"Contacts\": \"\",\n    \"Placement\": {\n      \"@Redfish.WriteableProperties\": [\n        \"Rack\",\n        \"Row\",\n        \"RackOffset\",\n        \"RackOffsetUnits\"\n      ],\n      \"Rack\": \"Rack-01\",\n      \"Row\": \"Row-A\",\n      \"RackOffset\": 42,\n      \"RackOffsetUnits\": \"EIA_310\"\n    }\n  },\n  \"Status\": {\n    \"State\": \"Enabled\",\n    \"Health\": \"OK\",\n    \"HealthRollup\": \"OK\"\n  },\n  \"Links\": {\n    \"ManagedBy\": [\n      { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FManagers\u002F1\" }\n    ],\n    \"PowerDistribution\": {\n      \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\"\n    }\n  },\n  \"Sensors\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\"\n  },\n  \"ThermalSubsystem\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FThermalSubsystem\"\n  },\n  \"EnvironmentMetrics\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FEnvironmentMetrics\"\n  },\n  \"PowerSubsystem\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FPowerSubsystem\"\n  },\n  \"Power\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FPower\"\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>注意\u003C\u002Fstrong>：\u003Ccode>Links.PowerDistribution\u003C\u002Fcode> 為\u003Cstrong>單一物件\u003C\u002Fstrong> \u003Ccode>{ \"@odata.id\": \"...\" }\u003C\u002Fcode>，非陣列（DMTF Chassis schema 要求）。Chassis 不再連結已棄用之 \u003Ccode>Thermal\u003C\u002Fcode>；環境量測請用 \u003Ccode>ThermalSubsystem\u003C\u002Fcode>／\u003Ccode>ThermalMetrics\u003C\u002Fcode>（見 環境感測）。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch4 id=\"section-204\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: Chassis 資源 URI，固定 \u003Ccode>\u002Fredfish\u002Fv1\u002FChassis\u002F1\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#Chassis.v1_22_0.Chassis\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 資源識別碼，固定 \u003Ccode>1\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 顯示名稱，固定 \u003Ccode>Chassis\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ChassisType\u003C\u002Fstrong>: 機箱類型（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>），如 \u003Ccode>RackMount\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Manufacturer\u003C\u002Fstrong>: 製造商，製造商識別\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Model\u003C\u002Fstrong>: 型號，設備型號\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PartNumber\u003C\u002Fstrong>: 料號（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>）；\u003Ccode>devinfo.partNumber\u003C\u002Fcode> 為空時以 \u003Ccode>Model\u003C\u002Fcode> 填入\u003C\u002Fli>\n\u003Cli>\u003Cstrong>SerialNumber\u003C\u002Fstrong>: 序號；\u003Ccode>devinfo.serialNumber\u003C\u002Fcode> 為空時以 MAC（\u003Ccode>ethaddr\u003C\u002Fcode>，去冒號）填入\u003C\u002Fli>\n\u003Cli>\u003Cstrong>UUID\u003C\u002Fstrong>: 機箱 UUID（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PowerState\u003C\u002Fstrong>: 整機電源狀態（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>），\u003Ccode>On\u003C\u002Fcode> 或 \u003Ccode>Off\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Location\u003C\u002Fstrong>: 機架位置（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003Cul>\n\u003Cli>\u003Cstrong>Placement.Rack\u003C\u002Fstrong>: 機架名稱（\u003Cstrong>Mandatory\u003C\u002Fstrong>，可寫入）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Placement.Row\u003C\u002Fstrong>: 列／區域（Recommended）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Placement.RackOffset\u003C\u002Fstrong>: U 位偏移（Recommended）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Placement.RackOffsetUnits\u003C\u002Fstrong>: 偏移單位，如 \u003Ccode>EIA_310\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Status\u003C\u002Fstrong>: 運作與健康狀態\u003Cul>\n\u003Cli>\u003Cstrong>HealthRollup\u003C\u002Fstrong>: 整機健康彙整，依告警彙整\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Links\u003C\u002Fstrong>: 關聯資源（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003Cul>\n\u003Cli>\u003Cstrong>ManagedBy\u003C\u002Fstrong>: 管理此機箱的 Manager\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PowerDistribution\u003C\u002Fstrong>: 對應 Rack PDU 資源（\u003Cstrong>單一物件\u003C\u002Fstrong>，非陣列）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Sensors\u003C\u002Fstrong>: 機箱感測器集合（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>）；含電氣量測與 \u003Ccode>TEMPRH\u003C\u002Fcode> 溫度（\u003Ccode>Temp1\u003C\u002Fcode> 等）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ThermalSubsystem\u003C\u002Fstrong>: 環境熱管理子系統（OCP Baseline）；內含 \u003Ccode>ThermalMetrics\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>EnvironmentMetrics\u003C\u002Fstrong>: 機箱環境彙總（如 \u003Ccode>PowerWatts\u003C\u002Fcode>）；\u003Cstrong>不含\u003C\u002Fstrong> \u003Ccode>TemperatureSummaryCelsius\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PowerSubsystem\u003C\u002Fstrong> \u002F \u003Cstrong>Power\u003C\u002Fstrong>: 電源子系統與傳統 Power 資源（\u003Ccode>Power\u003C\u002Fcode> 為 deprecated，Validator 可能 WARN）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-205\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>資源不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-206\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>\u003Cstrong>OCP Profile Mandatory\u003C\u002Fstrong> 感測器集合 URI。成員與 \u003Ccode>PowerEquipment\u002FRackPDUs\u002F{rackId}\u002FSensors\u003C\u002Fcode> 相同，但 \u003Ccode>@odata.id\u003C\u002Fcode> 須在 \u003Ccode>Chassis\u003C\u002Fcode> 路徑下（Interop Validator 掃描此集合）。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\",\n  \"@odata.type\": \"#SensorCollection.SensorCollection\",\n  \"Members\": [\n    { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FCurrentA\" },\n    { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FPowerA\" },\n    { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FEnergyA\" },\n    { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FVoltageA\" },\n    { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FOutlet1Current\" },\n    { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FTemp1\" }\n  ],\n  \"Members@odata.count\": 6\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-207\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 感測器集合 URI，固定 \u003Ccode>\u002Fredfish\u002Fv1\u002FChassis\u002F{chassisId}\u002FSensors\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Members\u003C\u002Fstrong>: 感測器連結；\u003Ccode>{sensorId}\u003C\u002Fcode> 命名規則見「電力與配電」章節 Sensor 定義\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ca>Members@odata.count\u003C\u002Fa>\u003C\u002Fstrong>: 感測器數量\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-208\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-209\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>單一感測器（\u003Cstrong>OCP Profile 規定 URI\u003C\u002Fstrong>）。內容與 \u003Ccode>PowerEquipment\u002F...\u002FSensors\u002F{sensorId}\u003C\u002Fcode> 相同；\u003Ccode>DataSourceUri\u003C\u002Fcode> 須指向本 URI。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FPowerA\",\n  \"@odata.type\": \"#Sensor.v1_9_0.Sensor\",\n  \"Id\": \"PowerA\",\n  \"Name\": \"Infeed1 Power\",\n  \"Reading\": 2750.0,\n  \"ReadingUnits\": \"W\",\n  \"ReadingType\": \"Power\",\n  \"ElectricalContext\": \"Total\",\n  \"ReadingTime\": \"2026-06-15T10:00:05+08:00\",\n  \"SensingInterval\": \"PT5S\",\n  \"PeakReading\": 3100.0,\n  \"PeakReadingTime\": \"2026-06-14T18:22:00+08:00\",\n  \"Status\": {\n    \"State\": \"Enabled\",\n    \"Health\": \"OK\"\n  },\n  \"Thresholds\": {\n    \"UpperCritical\": { \"Reading\": 3500 },\n    \"UpperCaution\": { \"Reading\": 3000 }\n  },\n  \"Oem\": {\n    \"Pelx\": {\n      \"@odata.type\": \"#Pelx.v1_0_0.Pelx\",\n      \"Interface\": {\n        \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FCAI2105\"\n      },\n      \"RackPduSensorUri\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FSensors\u002FPowerA\"\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-210\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 感測器 URI，固定 \u003Ccode>\u002Fredfish\u002Fv1\u002FChassis\u002F{chassisId}\u002FSensors\u002F{sensorId}\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Reading\u003C\u002Fstrong>: 即時讀值（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ReadingType\u003C\u002Fstrong>: 量測類型（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ElectricalContext\u003C\u002Fstrong>: 電氣上下文（電氣量測 OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ReadingTime\u003C\u002Fstrong>: 讀值時間 ISO 8601（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>SensingInterval\u003C\u002Fstrong>: 取樣間隔，如 \u003Ccode>PT5S\u003C\u002Fcode>（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PeakReading\u003C\u002Fstrong> \u002F \u003Cstrong>PeakReadingTime\u003C\u002Fstrong>: 功率感測器至少一筆須提供峰值（OCP Supported）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem.Pelx.Interface\u003C\u002Fstrong>: 對應之 Pelx 介面資源連結（\u003Ccode>Pelx.InterfaceLink\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem.Pelx.RackPduSensorUri\u003C\u002Fstrong>: 對應之 DSP2056 配電路徑（選用，方便整合）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-211\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>感測器不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Chr>\n\u003Ch1 id=\"section-212\">網路協定\u003C\u002Fh1>\n\u003Cp>\u003Ccode>Managers\u002F1\u002FNetworkProtocol\u003C\u002Fcode> 彙整管理介面通訊協定。OCP Service Baseline 要求 \u003Cstrong>NetworkProtocol\u003C\u002Fstrong> 資源存在；\u003Cstrong>NTP、SNMP、SSH\u003C\u002Fstrong> 為 \u003Cstrong>Mandatory\u003C\u002Fstrong>（須支援 \u003Ccode>GET\u003C\u002Fcode>／\u003Ccode>PATCH\u003C\u002Fcode> 之 \u003Ccode>ProtocolEnabled\u003C\u002Fcode>、\u003Ccode>Port\u003C\u002Fcode>；Vertiv PDU 文件亦有 PATCH NTP／SSH 範例）。SNMP v3、ICMP 等細節以 \u003Cstrong>Oem\u003C\u002Fstrong> 延伸。\u003C\u002Fp>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>權限\u003C\u002Fstrong>：\u003Ccode>PATCH\u003C\u002Fcode> 依欄位分級（例外）；詳見下方表格與 認證。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch3 id=\"section-213\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FManagers\u002F1\u002FNetworkProtocol\",\n    \"@odata.type\": \"#ManagerNetworkProtocol.v1_10_1.ManagerNetworkProtocol\",\n  \"Id\": \"NetworkProtocol\",\n  \"HostName\": \"pdu-1\",\n  \"HTTPS\": {\n    \"ProtocolEnabled\": true,\n    \"Port\": 443\n  },\n  \"HTTP\": {\n    \"ProtocolEnabled\": false,\n    \"Port\": 80\n  },\n  \"NTP\": {\n    \"ProtocolEnabled\": true,\n    \"NTPServers\": [\"time.stdtime.gov.tw\"]\n  },\n  \"SNMP\": {\n    \"ProtocolEnabled\": true,\n    \"Port\": 161\n  },\n  \"SSH\": {\n    \"ProtocolEnabled\": false,\n    \"Port\": 22\n  },\n  \"Proxy\": {\n    \"Enabled\": false,\n    \"ProxyServerURI\": \"http:\u002F\u002Fproxy.corp.com:8080\",\n    \"Username\": \"proxyuser\",\n    \"Password\": null,\n    \"PasswordSet\": true,\n    \"ExcludeAddresses\": [\"dc.local\"],\n    \"ProxyAutoConfigURI\": null\n  },\n  \"Oem\": {\n    \"Pelx\": {\n      \"ICMPEchoReply\": {\n        \"ProtocolEnabled\": true\n      },\n      \"DateTime\": {\n        \"TimeZone\": \"Asia\u002FTaipei\",\n        \"CustomNTPServer\": false\n      },\n      \"SNMPAgent\": {\n        \"SNMPv1v2c\": {\n          \"ProtocolEnabled\": true,\n          \"ReadCommunity\": \"public\",\n          \"WriteEnabled\": true,\n          \"WriteCommunity\": \"private\"\n        },\n        \"SNMPv3\": {\n          \"ProtocolEnabled\": false,\n          \"UserName\": \"snmpuser\",\n          \"AccessMode\": \"ReadWrite\",\n          \"AuthProtocol\": \"MD5\",\n          \"PrivProtocol\": \"DES\"\n        },\n        \"SystemName\": \"ZDL-2A-12Z\",\n        \"Contact\": \"Administrator\",\n        \"Location\": \"Office\"\n      }\n    }\n  },\n  \"Status\": {\n    \"State\": \"Enabled\",\n    \"Health\": \"OK\"\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-214\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>HostName\u003C\u002Fstrong>: 設備主機名稱\u003C\u002Fli>\n\u003Cli>\u003Cstrong>HTTPS\u003C\u002Fstrong>／\u003Cstrong>HTTP\u003C\u002Fstrong>: Web 與 Redfish 對外埠（Baseline）\u003Cul>\n\u003Cli>\u003Cstrong>ProtocolEnabled\u003C\u002Fstrong>: 是否啟用\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Port\u003C\u002Fstrong>: 監聽埠\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>NTP\u003C\u002Fstrong>: 時間同步（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003Cul>\n\u003Cli>\u003Cstrong>ProtocolEnabled\u003C\u002Fstrong>: \u003C\u002Fli>\n\u003Cli>\u003Cstrong>NTPServers\u003C\u002Fstrong>: NTP 伺服器位址陣列；\u003Ccode>customTimeServer=true\u003C\u002Fcode> 時為 \u003Ccode>timeServer\u003C\u002Fcode>，否則為預設池或空陣列\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>SNMP\u003C\u002Fstrong>: Agent 是否對外提供（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003Cul>\n\u003Cli>\u003Cstrong>ProtocolEnabled\u003C\u002Fstrong>: \u003Ccode>SNMPAgent.SNMPv1v2c\u003C\u002Fcode> 或 \u003Ccode>SNMPv3\u003C\u002Fcode> 任一啟用即為 \u003Ccode>true\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Port\u003C\u002Fstrong>: UDP 161（固定）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>SSH\u003C\u002Fstrong>: 遠端 Shell（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>；生產環境預設 \u003Cstrong>停用\u003C\u002Fstrong>）\u003Cul>\n\u003Cli>\u003Cstrong>ProtocolEnabled\u003C\u002Fstrong>: ；\u003Ccode>true\u003C\u002Fcode> 表示允許 SSH 登入（搭配 sshcli）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Port\u003C\u002Fstrong>: TCP 22（固定；Cascade 轉發見 串接.md）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Proxy\u003C\u002Fstrong>: 設備\u003Cstrong>出站\u003C\u002Fstrong> HTTP\u002FHTTPS 代理（DMTF \u003Ccode>ManagerNetworkProtocol\u003C\u002Fcode> v1.8+；供 OutboundConnection 等連外使用）\u003Cul>\n\u003Cli>\u003Cstrong>Enabled\u003C\u002Fstrong>: 是否啟用\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ProxyServerURI\u003C\u002Fstrong>: 代理伺服器 URI（如 \u003Ccode>http:\u002F\u002Fproxy.corp.com:8080\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Username\u003C\u002Fstrong>／\u003Cstrong>Password\u003C\u002Fstrong>: 代理認證；\u003Ccode>Password\u003C\u002Fcode> 僅寫入，GET 固定 \u003Ccode>null\u003C\u002Fcode>，以 \u003Cstrong>PasswordSet\u003C\u002Fstrong> 表示是否已設定\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ExcludeAddresses\u003C\u002Fstrong>: 不走代理的主機名或 IP 清單（\u003Ccode>localhost\u003C\u002Fcode>、\u003Ccode>127.0.0.1\u003C\u002Fcode> 永遠排除）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ProxyAutoConfigURI\u003C\u002Fstrong>: PAC 檔 URI（\u003Cstrong>已儲存\u003C\u002Fstrong>；連線邏輯\u003Cstrong>尚未\u003C\u002Fstrong>依 PAC 自動選路）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem.Pelx.ICMPEchoReply\u003C\u002Fstrong>: ICMP Echo（ping）回應\u003Cul>\n\u003Cli>\u003Cstrong>ProtocolEnabled\u003C\u002Fstrong>: \u003Ccode>true\u003C\u002Fcode> 允許 ping；\u003Ccode>false\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem.Pelx.DateTime\u003C\u002Fstrong>: 時區等延伸欄位\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem.Pelx.SNMPAgent\u003C\u002Fstrong>: 完整 SNMP Agent 設定（；GET \u003Cstrong>不回傳\u003C\u002Fstrong> community／密碼字串，僅顯示是否已設定）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-215\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-216\">PATCH https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>修改通訊協定設定。依欄位分級（見 認證 RBAC）：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>區塊\u003C\u002Fth>\n\u003Cth>最低角色\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>SNMP\u003C\u002Fcode>、\u003Ccode>Oem.Pelx.SNMPAgent\u003C\u002Fcode>、\u003Ccode>Proxy\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Administrator\u003C\u002Fstrong>（工程模式／SNMP Agent／出站代理）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>NTP\u003C\u002Fcode>、\u003Ccode>SSH\u003C\u002Fcode>、\u003Ccode>Oem.Pelx.DateTime\u003C\u002Fcode>、\u003Ccode>Oem.Pelx.ICMPEchoReply\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Operator\u003C\u002Fstrong> 以上\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>HTTPS\u003C\u002Fcode>、\u003Ccode>HTTP\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Administrator\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>僅送要變更的區塊。若單次 \u003Ccode>PATCH\u003C\u002Fcode> 同時含 SNMP 與 NTP，須 \u003Cstrong>Administrator\u003C\u002Fstrong>。\u003C\u002Fp>\n\u003Cp>NTP 範例：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"NTP\": {\n    \"ProtocolEnabled\": true,\n    \"NTPServers\": [\"ntp.example.com\"]\n  },\n  \"Oem\": {\n    \"Pelx\": {\n      \"DateTime\": {\n        \"TimeZone\": \"Asia\u002FTaipei\",\n        \"CustomNTPServer\": true\n      }\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>SNMP v1\u002Fv2c 範例：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"SNMP\": {\n    \"ProtocolEnabled\": true\n  },\n  \"Oem\": {\n    \"Pelx\": {\n      \"SNMPAgent\": {\n        \"SNMPv1v2c\": {\n          \"ProtocolEnabled\": true,\n          \"ReadCommunity\": \"public\",\n          \"WriteEnabled\": false\n        }\n      }\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>SSH 與 ICMP 範例：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"SSH\": {\n    \"ProtocolEnabled\": true\n  },\n  \"Oem\": {\n    \"Pelx\": {\n      \"ICMPEchoReply\": {\n        \"ProtocolEnabled\": false\n      }\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>HTTP Proxy 範例（OutboundConnection 連外時經企業代理）：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"Proxy\": {\n    \"Enabled\": true,\n    \"ProxyServerURI\": \"http:\u002F\u002Fproxy.corp.com:8080\",\n    \"Username\": \"proxyuser\",\n    \"Password\": \"secret\",\n    \"ExcludeAddresses\": [\"nms.local\"]\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-217\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>修改成功\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>請求格式錯誤\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足（SNMP 區塊須 Administrator；其餘區塊須 Operator 以上）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>503\u003C\u002Ftd>\n\u003Ctd>服務暫不可用\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Chr>\n\u003Ch1 id=\"section-218\">電力與配電（PowerEquipment）\u003C\u002Fh1>\n\u003Cp>依 \u003Ca rel=\"noopener noreferrer\" href=\"https:\u002F\u002Fgithub.com\u002Fopencomputeproject\u002FHWMgmt-OCP-Profiles\u002Fblob\u002Fmaster\u002FRackAndPower\u002FOCPRackPDU.v1_0_0.json\">OCP Rack PDU Profile\u003C\u002Fa> 與 \u003Ca rel=\"noopener noreferrer\" href=\"https:\u002F\u002Fwww.dmtf.org\u002Fsites\u002Fdefault\u002Ffiles\u002Fstandards\u002Fdocuments\u002FDSP2056_1.1.0.pdf\">DMTF DSP2056\u003C\u002Fa>，Rack PDU 資源置於 \u003Ccode>PowerEquipment\u002FRackPDUs\u003C\u002Fcode>；須含 \u003Ccode>Metrics\u003C\u002Fcode>、\u003Ccode>Mains\u003C\u002Fcode>、\u003Ccode>Branches\u003C\u002Fcode>（可為空集合）、\u003Ccode>Outlets\u003C\u002Fcode> 與 \u003Ccode>Links\u003C\u002Fcode>。具 ATS 功能之機型見 ATS 轉換開關（\u003Ccode>TransferSwitches\u003C\u002Fcode>）。\u003C\u002Fp>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>權限\u003C\u002Fstrong>：預設見 認證（控制 Action 與寫入至少 \u003Cstrong>Operator\u003C\u002Fstrong>）。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch3 id=\"section-219\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\",\n  \"@odata.type\": \"#PowerEquipment.v1_2_3.PowerEquipment\",\n  \"Id\": \"PowerEquipment\",\n  \"RackPDUs\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\"\n  },\n  \"TransferSwitches\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FTransferSwitches\"\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>\u003Ccode>TransferSwitches\u003C\u002Fcode> 僅在 設備支援 ATS 時出現；無 ATS 機型省略此欄位。\u003C\u002Fp>\n\u003Ch4 id=\"section-220\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: PowerEquipment 資源 URI，固定 \u003Ccode>\u002Fredfish\u002Fv1\u002FPowerEquipment\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#PowerEquipment.v1_2_3.PowerEquipment\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 資源識別碼，固定 \u003Ccode>PowerEquipment\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>RackPDUs\u003C\u002Fstrong>: Rack PDU 集合連結物件\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: Rack PDU 列表 URI（\u003Ccode>\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u003C\u002Fcode>）；\u003Ccode>GET\u003C\u002Fcode> 進一步取得 \u003Ccode>RackPDUs\u002F{id}\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>TransferSwitches\u003C\u002Fstrong>: ATS 轉換開關集合連結物件（僅 設備支援 ATS 時）\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: ATS 列表 URI（\u003Ccode>\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FTransferSwitches\u003C\u002Fcode>）；\u003Ccode>GET\u003C\u002Fcode> 進一步取得 \u003Ccode>TransferSwitches\u002F{id}\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-221\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-222\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\",\n  \"@odata.type\": \"#PowerDistributionCollection.PowerDistributionCollection\",\n  \"Members\": [\n    { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\" }\n  ],\n  \"Members@odata.count\": 1\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-223\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: Rack PDU 集合資源 URI，固定 \u003Ccode>\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#PowerDistributionCollection.PowerDistributionCollection\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Members\u003C\u002Fstrong>: Rack PDU 資源連結陣列，元素為 \u003Ccode>{ \"@odata.id\": \"...\" }\u003C\u002Fcode>\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 單一 Rack PDU 資源 URI，如 \u003Ccode>\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ca>Members@odata.count\u003C\u002Fa>\u003C\u002Fstrong>: \u003Ccode>Members\u003C\u002Fcode> 陣列筆數，Rack PDU 數量；本機單台產品通常為 \u003Ccode>1\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-224\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-225\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>Rack PDU 主資源，彙整進線、分支、插座連結。路徑參數 \u003Ccode>{id}\u003C\u002Fcode> 為 Rack PDU 資源識別碼；\u003Cstrong>本機單台 PDU 產品通常僅一筆，id 為 \u003Ccode>1\u003C\u002Fcode>\u003C\u002Fstrong>。整合方應先 \u003Ccode>GET \u002FPowerEquipment\u002FRackPDUs\u003C\u002Fcode>，從 \u003Ccode>Members\u003C\u002Fcode> 的 \u003Ccode>@odata.id\u003C\u002Fcode> 取得有效 id，勿寫死。\u003C\u002Fp>\n\u003Cp>以下範例以 \u003Ccode>{id}\u003C\u002Fcode> = \u003Ccode>1\u003C\u002Fcode> 表示常見單機情境。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\",\n  \"@odata.type\": \"#PowerDistribution.v1_4_0.PowerDistribution\",\n  \"@Redfish.WriteableProperties\": [\n    \"AssetTag\",\n    \"UserLabel\",\n    \"LocationIndicatorActive\"\n  ],\n  \"Id\": \"1\",\n  \"Name\": \"RackPDU\",\n  \"EquipmentType\": \"RackPDU\",\n  \"UserLabel\": \"PDU-1\",\n  \"Manufacturer\": \"Pelx\",\n  \"Model\": \"ZDL-2A-12Z\",\n  \"PartNumber\": \"ZDL-2A-12Z\",\n  \"SerialNumber\": \"001122AABBCC\",\n  \"AssetTag\": \"\",\n  \"LocationIndicatorActive\": false,\n  \"FirmwareVersion\": \"1.60.3\",\n  \"UUID\": \"00000000-0000-0000-0000-000000000003\",\n  \"Location\": {\n    \"@Redfish.WriteableProperties\": [\n      \"Contacts\"\n    ],\n    \"Contacts\": \"\",\n    \"Placement\": {\n      \"@Redfish.WriteableProperties\": [\n        \"Rack\",\n        \"Row\",\n        \"RackOffset\",\n        \"RackOffsetUnits\"\n      ],\n      \"Rack\": \"Rack-01\",\n      \"Row\": \"Row-A\",\n      \"RackOffset\": 42,\n      \"RackOffsetUnits\": \"EIA_310\"\n    }\n  },\n  \"Status\": {\n    \"State\": \"Enabled\",\n    \"Health\": \"OK\"\n  },\n  \"Metrics\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FMetrics\"\n  },\n  \"Mains\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FMains\"\n  },\n  \"Branches\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FBranches\"\n  },\n  \"Outlets\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets\"\n  },\n  \"Sensors\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FSensors\"\n  },\n  \"Links\": {\n    \"Chassis\": [\n      { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\" }\n    ],\n    \"ManagedBy\": [\n      { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FManagers\u002F1\" }\n    ]\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-226\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>id\u003C\u002Fstrong>（路徑參數）: Rack PDU 資源識別碼；單機產品通常為 \u003Ccode>1\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: Rack PDU 資源 URI，如 \u003Ccode>\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#PowerDistribution.v1_4_0.PowerDistribution\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 資源識別碼，與路徑參數 \u003Ccode>{id}\u003C\u002Fcode> 相同\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 顯示名稱，固定 \u003Ccode>RackPDU\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>EquipmentType\u003C\u002Fstrong>: 設備類型（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>），固定 \u003Ccode>RackPDU\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>UserLabel\u003C\u002Fstrong>: 使用者自訂標籤（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>，可寫入）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Manufacturer\u003C\u002Fstrong>: 製造商\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Model\u003C\u002Fstrong>: 型號，設備型號\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PartNumber\u003C\u002Fstrong>: 料號；\u003Ccode>devinfo.partNumber\u003C\u002Fcode> 為空時以 \u003Ccode>Model\u003C\u002Fcode> 填入\u003C\u002Fli>\n\u003Cli>\u003Cstrong>SerialNumber\u003C\u002Fstrong>: 序號；\u003Ccode>devinfo.serialNumber\u003C\u002Fcode> 為空時以 MAC（\u003Ccode>ethaddr\u003C\u002Fcode>，去冒號）填入\u003C\u002Fli>\n\u003Cli>\u003Cstrong>FirmwareVersion\u003C\u002Fstrong>: 韌體版本\u003C\u002Fli>\n\u003Cli>\u003Cstrong>UUID\u003C\u002Fstrong>: Rack PDU UUID（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Location\u003C\u002Fstrong>: 機架位置（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>）；\u003Ccode>Placement.Rack\u003C\u002Fcode> 必填\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Status\u003C\u002Fstrong>: 運作與健康狀態\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Metrics\u003C\u002Fstrong>: 彙總量測資源（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Mains\u003C\u002Fstrong>: 電源進線集合\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Branches\u003C\u002Fstrong>: 分支電路集合（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>）；\u003Cstrong>一律提供\u003C\u002Fstrong>連結，無分支時 \u003Ccode>Members\u003C\u002Fcode> 為空\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Outlets\u003C\u002Fstrong>: 插座集合\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Sensors\u003C\u002Fstrong>: 感測器集合\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Links\u003C\u002Fstrong>: 關聯資源（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003Cul>\n\u003Cli>\u003Cstrong>Chassis\u003C\u002Fstrong>: 對應實體機箱\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ManagedBy\u003C\u002Fstrong>: 管理此 PDU 的 Manager\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>路徑說明\u003C\u002Fstrong>：\u003Ccode>GET\u002FPATCH ...\u002FRackPDUs\u002F{id}\u003C\u002Fcode> 與 \u003Ccode>GET ...\u002FRackPDUs\u002F{id}\u002FMetrics\u003C\u002Fcode>、\u003Ccode>POST ...\u002FMetrics\u002FActions\u002F...\u003C\u002Fcode> 支援變數 \u003Ccode>{id}\u003C\u002Fcode>（無效 id 回 404）。其餘子資源（\u003Ccode>Mains\u003C\u002Fcode>、\u003Ccode>Branches\u003C\u002Fcode>、\u003Ccode>Outlets\u003C\u002Fcode>、\u003Ccode>Sensors\u003C\u002Fcode>、\u003Ccode>OutletGroups\u003C\u002Fcode>）的 \u003Cstrong>GET／PATCH／Action\u003C\u002Fstrong> 路由目前實作為 \u003Ccode>...\u002FRackPDUs\u002F1\u002F...\u003C\u002Fcode>（單機產品 id 固定為 \u003Ccode>1\u003C\u002Fcode>）。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch4 id=\"section-227\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常（\u003Ccode>{id}\u003C\u002Fcode> 須存在於 \u003Ccode>GET ...\u002FRackPDUs\u003C\u002Fcode> 的 \u003Ccode>Members\u003C\u002Fcode> 中）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{id}\u003C\u002Fcode> 不存在（如單機產品請求 \u003Ccode>RackPDUs\u002F2\u003C\u002Fcode>、\u003Ccode>RackPDUs\u002F999\u003C\u002Fcode>）；\u003Cstrong>不會\u003C\u002Fstrong> fallback 回 \u003Ccode>1\u003C\u002Fcode>，也不回傳部分資料\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>\u003Ccode>{id}\u003C\u002Fcode> 無效時回傳 Redfish 標準 \u003Ccode>error\u003C\u002Fcode> 物件（格式見文末「通用錯誤回應」），例如請求 \u003Ccode>\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F999\u003C\u002Fcode>：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"error\": {\n    \"@Message.ExtendedInfo\": [\n      {\n        \"Message\": \"The resource at the URI \u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F999 was not found.\",\n        \"MessageId\": \"Base.1.18.ResourceNotFound\",\n        \"Severity\": \"Critical\",\n        \"Resolution\": \"Place a valid resource URI in the request.\"\n      }\n    ],\n    \"code\": \"Base.1.18.ResourceNotFound\",\n    \"message\": \"The resource at the URI \u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F999 was not found.\"\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch3 id=\"section-228\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>Rack PDU 彙總量測（OCP \u003Cstrong>PowerDistributionMetrics Mandatory\u003C\u002Fstrong>）。\u003Ccode>{rackId}\u003C\u002Fcode> 為 Rack PDU 路徑參數。\u003Cstrong>一次回應\u003C\u002Fstrong>含整機 \u003Ccode>PowerWatts\u003C\u002Fcode>、\u003Ccode>EnergykWh\u003C\u002Fcode>、\u003Ccode>PowerLoadPercent\u003C\u002Fcode> 三項讀值（OCP 批量即時量測的標準做法；逐路插座仍須查 \u003Ccode>Outlets\u003C\u002Fcode> 或 \u003Ccode>$expand\u003C\u002Fcode>）。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FMetrics\",\n  \"@odata.type\": \"#PowerDistributionMetrics.v1_3_0.PowerDistributionMetrics\",\n  \"Id\": \"Metrics\",\n  \"Name\": \"Rack PDU Metrics\",\n  \"PowerWatts\": {\n    \"Reading\": 2750.0,\n    \"DataSourceUri\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FPowerA\"\n  },\n  \"EnergykWh\": {\n    \"Reading\": 1523.6,\n    \"DataSourceUri\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FEnergyA\"\n  },\n  \"PowerLoadPercent\": {\n    \"Reading\": 45.2\n  },\n  \"Actions\": {\n    \"#PowerDistributionMetrics.ResetMetrics\": {\n      \"target\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FMetrics\u002FActions\u002FPowerDistributionMetrics.ResetMetrics\"\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-229\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: Metrics 資源 URI，固定 \u003Ccode>...\u002FRackPDUs\u002F{rackId}\u002FMetrics\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#PowerDistributionMetrics.v1_3_0.PowerDistributionMetrics\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PowerWatts\u003C\u002Fstrong>: 總有功功率（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>EnergykWh\u003C\u002Fstrong>: 總累計能耗（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PowerLoadPercent\u003C\u002Fstrong>: 負載百分比（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Actions.#PowerDistributionMetrics.ResetMetrics\u003C\u002Fstrong>: 重設能耗計數（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong> Action）；見下方 \u003Ccode>POST\u003C\u002Fcode> 章節\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-230\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>Rack PDU 不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-231\">POST https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>重設 Rack PDU 累計能耗。（整機能耗歸零，非逐路插座）。\u003C\u002Fp>\n\u003Cp>請求 body 可為空物件 \u003Ccode>{}\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Ch4 id=\"section-232\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>重設成功\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>Rack PDU 不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>500\u003C\u002Ftd>\n\u003Ctd>裝置不支援或內部錯誤\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-233\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>進線電路集合（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>）。依 \u003Ca rel=\"noopener noreferrer\" href=\"https:\u002F\u002Fgithub.com\u002Fopencomputeproject\u002FHWMgmt-OCP-Profiles\u002Fblob\u002Fmaster\u002FRackAndPower\u002FOCPRackPDU.v1_0_0.json\">OCP Rack PDU Profile\u003C\u002Fa> \u003Cstrong>AC Mains\u003C\u002Fstrong> use case，每筆成員須能表達整機（或該路進線）之功率／能耗與接線型態；單相與三相機型皆透過此集合暴露。\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>進線類型\u003C\u002Fth>\n\u003Cth>週邊\u003C\u002Fth>\n\u003Cth>\u003Ccode>Members\u003C\u002Fcode> 成員數\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>1\u003C\u002Fcode> Current、\u003Ccode>2\u003C\u002Fcode> WattHour\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>INFEED\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>進線路數（通常 1）\u003C\u002Ftd>\n\u003Ctd>每路單相進線一筆 \u003Ccode>Mains\u002F{id}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>3\u003C\u002Fcode> ThreePhase\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>INFEED3P\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>1\u003C\u002Ftd>\n\u003Ctd>三相整體進線一筆 \u003Ccode>Mains\u002F1\u003C\u002Fcode>，量測以 \u003Ccode>PolyPhase*\u003C\u002Fcode> 呈現\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>無進線（如 DPB）\u003C\u002Ftd>\n\u003Ctd>—\u003C\u002Ftd>\n\u003Ctd>1（合成）\u003C\u002Ftd>\n\u003Ctd>滿足 OCP 必填；見 \u003Ccode>usesSyntheticMainCircuit\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>\u003Cstrong>單相\u003C\u002Fstrong>（一進線）與\u003Cstrong>三相\u003C\u002Fstrong>（整體進線）集合結構相同；多路單相進線時 \u003Ccode>Members\u003C\u002Fcode> 可含多筆（如 \u003Ccode>Mains\u002F1\u003C\u002Fcode>、\u003Ccode>Mains\u002F2\u003C\u002Fcode>）。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FMains\",\n  \"@odata.type\": \"#CircuitCollection.CircuitCollection\",\n  \"Members\": [\n    { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FMains\u002F1\" }\n  ],\n  \"Members@odata.count\": 1\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-234\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 進線集合 URI，固定 \u003Ccode>...\u002FRackPDUs\u002F{rackId}\u002FMains\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#CircuitCollection.CircuitCollection\u003C\u002Fcode>（\u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Members\u003C\u002Fstrong>: 進線電路連結陣列；單相多進線時每路一筆，三相整體進線通常僅一筆\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ca>Members@odata.count\u003C\u002Fa>\u003C\u002Fstrong>: 進線路數（與 \u003Ccode>Members\u003C\u002Fcode> 長度相同）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-235\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-236\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>電源進線電路（\u003Ccode>CircuitType: Mains\u003C\u002Fcode>）。\u003Ccode>{mainId}\u003C\u002Fcode> 為進線路數。依 \u003Ca rel=\"noopener noreferrer\" href=\"https:\u002F\u002Fwww.dmtf.org\u002Fsites\u002Fdefault\u002Ffiles\u002Fstandards\u002Fdocuments\u002FDSP2056_1.1.0.pdf\">DMTF DSP2056\u003C\u002Fa> Circuit schema 與 OCP \u003Cstrong>AC Mains\u003C\u002Fstrong> use case：\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>單相\u003C\u002Fstrong>（單相進線）：對應單相進線週邊；使用 \u003Ccode>Voltage\u003C\u002Fcode>、\u003Ccode>CurrentAmps\u003C\u002Fcode>，\u003Ccode>PhaseWiringType\u003C\u002Fcode> 為 \u003Ccode>OnePhase3Wire\u003C\u002Fcode>。\u003C\u002Fli>\n\u003Cli>\u003Cstrong>三相\u003C\u002Fstrong>（三相進線）：對應三相進線週邊（L1／L2／L3，\u003Ccode>elements.id\u003C\u002Fcode> 1–3）；使用 \u003Ccode>PolyPhaseVoltage\u003C\u002Fcode>、\u003Ccode>PolyPhaseCurrentAmps\u003C\u002Fcode> 等，\u003Cstrong>不得\u003C\u002Fstrong>同時出現單相 \u003Ccode>Voltage\u003C\u002Fcode>／\u003Ccode>CurrentAmps\u003C\u002Fcode>（OCP Conditional：二擇一）。\u003C\u002Fli>\n\u003Cli>\u003Cstrong>無進線機型\u003C\u002Fstrong>：合成 \u003Ccode>Mains\u002F1\u003C\u002Fcode>（\u003Ccode>Oem.Pelx.Synthetic: true\u003C\u002Fcode>）。\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>OCP 量測互斥（Mains）：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>接線\u003C\u002Fth>\n\u003Cth>\u003Ccode>PhaseWiringType\u003C\u002Fcode>\u003C\u002Fth>\n\u003Cth>電壓\u003C\u002Fth>\n\u003Cth>電流\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>單相\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>OnePhase3Wire\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Voltage\u003C\u002Fcode>（\u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>CurrentAmps\u003C\u002Fcode>（\u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>三相\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>ThreePhase4Wire\u003C\u002Fcode> 或 \u003Ccode>ThreePhase5Wire\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>PolyPhaseVoltage\u003C\u002Fcode>（\u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>PolyPhaseCurrentAmps\u003C\u002Fcode>（\u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>\u003Ccode>PolyPhaseVoltage\u003C\u002Fcode>／\u003Ccode>PolyPhaseCurrentAmps\u003C\u002Fcode> 之子鍵為 \u003Ca rel=\"noopener noreferrer\" href=\"https:\u002F\u002Fredfish.dmtf.org\u002Fschemas\u002Fv1_8_1\u002FCircuit.json\">ElectricalContext\u003C\u002Fa> 列舉（如 \u003Ccode>Line1ToNeutral\u003C\u002Fcode>、\u003Ccode>Line1\u003C\u002Fcode>）；各子鍵內含 \u003Ccode>Reading\u003C\u002Fcode> 與建議之 \u003Ccode>DataSourceUri\u003C\u002Fcode>（指向 \u003Ccode>Chassis\u002F1\u002FSensors\u002F...\u003C\u002Fcode>）。\u003C\u002Fp>\n\u003Ch4 id=\"section-237\">OCP AC Mains 欄位名稱合規對照\u003C\u002Fh4>\n\u003Cp>以下對照 \u003Ca rel=\"noopener noreferrer\" href=\"https:\u002F\u002Fgithub.com\u002Fopencomputeproject\u002FHWMgmt-OCP-Profiles\u002Fblob\u002Fmaster\u002FRackAndPower\u002FOCPRackPDU.v1_0_0.json\">OCPRackPDU.v1_0_0.json\u003C\u002Fa> \u003Cstrong>Circuit → AC Mains\u003C\u002Fstrong> use case。\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>欄位\u003C\u002Fth>\n\u003Cth>OCP 要求\u003C\u002Fth>\n\u003Cth>單相\u003C\u002Fth>\n\u003Cth>三相\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>CircuitType\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Mandatory（\u003Ccode>Mains\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003Ctd>✓\u003C\u002Ftd>\n\u003Ctd>✓\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>UserLabel\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Mandatory，可寫\u003C\u002Ftd>\n\u003Ctd>✓\u003C\u002Ftd>\n\u003Ctd>✓\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>ElectricalContext\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Mandatory\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Total\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Total\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>PhaseWiringType\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Mandatory\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>OnePhase3Wire\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>ThreePhase4Wire\u003C\u002Fcode>／\u003Ccode>ThreePhase5Wire\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Voltage\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Conditional（無 \u003Ccode>PolyPhaseVoltage\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Mandatory\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>省略\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>CurrentAmps\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Conditional（無 \u003Ccode>PolyPhaseCurrentAmps\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Mandatory\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>省略\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>PolyPhaseVoltage\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Conditional（無 \u003Ccode>Voltage\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003Ctd>省略\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Mandatory\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>PolyPhaseCurrentAmps\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Conditional（無 \u003Ccode>CurrentAmps\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003Ctd>省略\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Mandatory\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>PowerWatts\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Mandatory（\u003Ccode>Reading\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003Ctd>✓\u003C\u002Ftd>\n\u003Ctd>✓（總量）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>EnergykWh\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Mandatory（\u003Ccode>Reading\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003Ctd>✓\u003C\u002Ftd>\n\u003Ctd>✓（總量）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>FrequencyHz\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Recommended\u003C\u002Ftd>\n\u003Ctd>✓\u003C\u002Ftd>\n\u003Ctd>✓\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>PolyPhasePowerWatts\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Recommended\u003C\u002Ftd>\n\u003Ctd>—\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Line1ToNeutral\u003C\u002Fcode> 等\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>PolyPhaseEnergykWh\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Recommended\u003C\u002Ftd>\n\u003Ctd>—\u003C\u002Ftd>\n\u003Ctd>各相能耗\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>NominalVoltage\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>支援\u003C\u002Ftd>\n\u003Ctd>列舉字串\u003C\u002Ftd>\n\u003Ctd>列舉字串\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>NominalFrequencyHz\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Recommended\u003C\u002Ftd>\n\u003Ctd>可選\u003C\u002Ftd>\n\u003Ctd>可選\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>VoltageType\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>支援\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>AC\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>AC\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>RatedCurrentAmps\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>支援\u003C\u002Ftd>\n\u003Ctd>✓\u003C\u002Ftd>\n\u003Ctd>✓\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>PowerState\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>支援\u003C\u002Ftd>\n\u003Ctd>✓\u003C\u002Ftd>\n\u003Ctd>✓\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Status\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Mandatory\u003C\u002Ftd>\n\u003Ctd>✓\u003C\u002Ftd>\n\u003Ctd>✓\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Links.PowerOutlet\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Recommended（Mains）\u003C\u002Ftd>\n\u003Ctd>插座連結\u003C\u002Ftd>\n\u003Ctd>插座連結\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Links.DistributionCircuits\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Recommended\u003C\u002Ftd>\n\u003Ctd>分支連結\u003C\u002Ftd>\n\u003Ctd>分支連結\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>ElectricalSourceName\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Recommended，可寫\u003C\u002Ftd>\n\u003Ctd>可選\u003C\u002Ftd>\n\u003Ctd>可選\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>ElectricalSourceManagerURI\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Recommended，可寫\u003C\u002Ftd>\n\u003Ctd>可選\u003C\u002Ftd>\n\u003Ctd>可選\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>UnbalancedCurrentPercent\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Recommended\u003C\u002Ftd>\n\u003Ctd>—\u003C\u002Ftd>\n\u003Ctd>可選\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>UnbalancedVoltagePercent\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Recommended\u003C\u002Ftd>\n\u003Ctd>—\u003C\u002Ftd>\n\u003Ctd>可選\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Actions.#Circuit.ResetMetrics\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Recommended\u003C\u002Ftd>\n\u003Ctd>✓\u003C\u002Ftd>\n\u003Ctd>✓\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>\u003Cstrong>命名與型別注意\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>\u003Ccode>NominalVoltage\u003C\u002Fcode>\u003C\u002Fstrong>：DMTF 為 \u003Ccode>NominalVoltageType\u003C\u002Fcode> \u003Cstrong>列舉字串\u003C\u002Fstrong>（如 \u003Ccode>AC230V\u003C\u002Fcode>、\u003Ccode>AC100To240V\u003C\u002Fcode>），\u003Cstrong>不是\u003C\u002Fstrong> \u003Ccode>{ \"Reading\": … }\u003C\u002Fcode> 物件；即時電壓請用 \u003Ccode>Voltage\u003C\u002Fcode> 或 \u003Ccode>PolyPhaseVoltage\u003C\u002Fcode>。\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ccode>Links\u003C\u002Fcode>\u003C\u002Fstrong>：OCP Mains 建議 \u003Ccode>Links.PowerOutlet\u003C\u002Fcode>；DMTF Circuit 亦支援 \u003Ccode>Links.Outlets\u003C\u002Fcode>（與 Branches 相同結構），實作可擇一或並列。\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Sensor \u003Ccode>{id}\u003C\u002Fcode>\u003C\u002Fstrong>（如 \u003Ccode>VoltageA\u003C\u002Fcode>）：Pelx 命名，非 OCP 標準；OCP 僅要求 \u003Ccode>DataSourceUri\u003C\u002Fcode> 指向 \u003Ccode>Chassis\u002F…\u002FSensors\u002F{sensorId}\u003C\u002Fcode>。\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ccode>Oem.Pelx\u003C\u002Fcode>\u003C\u002Fstrong>：廠商擴充，不計入 OCP 合規。\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>\u003Cstrong>\u003Ccode>PolyPhaseVoltage\u003C\u002Fcode> 子鍵\u003C\u002Fstrong>（OCP IfImplemented，依機型擇一或多個）：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>子鍵\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>Line1ToNeutral\u003C\u002Fcode>、\u003Ccode>Line2ToNeutral\u003C\u002Fcode>、\u003Ccode>Line3ToNeutral\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>相對中性線電壓（Pelx 三相常用）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Line1ToLine2\u003C\u002Fcode>、\u003Ccode>Line2ToLine3\u003C\u002Fcode>、\u003Ccode>Line3ToLine1\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>線間電壓\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>\u003Cstrong>\u003Ccode>PolyPhaseCurrentAmps\u003C\u002Fcode> 子鍵\u003C\u002Fstrong>：\u003Ccode>Line1\u003C\u002Fcode>、\u003Ccode>Line2\u003C\u002Fcode>、\u003Ccode>Line3\u003C\u002Fcode>、\u003Ccode>Neutral\u003C\u002Fcode>（IfImplemented）。\u003C\u002Fp>\n\u003Ch4 id=\"section-238\">單相進線範例（\u003Ccode>INFEED\u003C\u002Fcode>）\u003C\u002Fh4>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F{rackId}\u002FMains\u002F{mainId}\",\n  \"@odata.type\": \"#Circuit.v1_8_1.Circuit\",\n  \"Id\": \"{mainId}\",\n  \"Name\": \"Infeed1\",\n  \"UserLabel\": \"Main Input\",\n  \"CircuitType\": \"Mains\",\n  \"ElectricalContext\": \"Total\",\n  \"NominalVoltage\": \"AC230V\",\n  \"VoltageType\": \"AC\",\n  \"PhaseWiringType\": \"OnePhase3Wire\",\n  \"RatedCurrentAmps\": 32,\n  \"PowerState\": \"On\",\n  \"Voltage\": {\n    \"Reading\": 220.4,\n    \"DataSourceUri\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FVoltageA\"\n  },\n  \"CurrentAmps\": {\n    \"Reading\": 12.5,\n    \"DataSourceUri\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FCurrentA\"\n  },\n  \"PowerWatts\": {\n    \"Reading\": 2750.0,\n    \"DataSourceUri\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FPowerA\"\n  },\n  \"EnergykWh\": {\n    \"Reading\": 1523.6,\n    \"DataSourceUri\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FEnergyA\"\n  },\n  \"FrequencyHz\": {\n    \"Reading\": 60.0,\n    \"DataSourceUri\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FFrequencyA\"\n  },\n  \"Links\": {\n    \"Outlets\": [\n      { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets\u002F1\" },\n      { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets\u002F2\" }\n    ]\n  },\n  \"Status\": {\n    \"State\": \"Enabled\",\n    \"Health\": \"OK\"\n  },\n  \"Actions\": {\n    \"#Circuit.ResetMetrics\": {\n      \"target\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FMains\u002F1\u002FActions\u002FCircuit.ResetMetrics\"\n    }\n  },\n  \"Oem\": {\n    \"Pelx\": {\n      \"@odata.type\": \"#Pelx.v1_0_0.Pelx\",\n      \"ElementId\": 1,\n      \"Alias\": \"INFEED\",\n      \"Interfaces\": {\n        \"Voltage\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FAI2101\" },\n        \"CurrentAmps\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FAI2103\" },\n        \"PowerWatts\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FCAI2105\" },\n        \"FrequencyHz\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FAI2102\" }\n      }\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-239\">三相進線範例（\u003Ccode>INFEED3P\u003C\u002Fcode>，\u003Ccode>infeedKind=ThreePhase\u003C\u002Fcode>）\u003C\u002Fh4>\n\u003Cp>三相機型以\u003Cstrong>單一\u003C\u002Fstrong> \u003Ccode>Mains\u002F1\u003C\u002Fcode> 表示整體 AC 進線；各相量測彙整至 \u003Ccode>PolyPhase*\u003C\u002Fcode>。\u003Ccode>INFEED3P\u003C\u002Fcode> 的 \u003Ccode>elements.id\u003C\u002Fcode> 1／2／3 分別對應 L1（X）／L2（Y）／L3（Z）。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FMains\u002F1\",\n  \"@odata.type\": \"#Circuit.v1_8_1.Circuit\",\n  \"Id\": \"1\",\n  \"Name\": \"Main Input\",\n  \"UserLabel\": \"Main Input\",\n  \"CircuitType\": \"Mains\",\n  \"ElectricalContext\": \"Total\",\n  \"NominalVoltage\": \"AC230V\",\n  \"VoltageType\": \"AC\",\n  \"PhaseWiringType\": \"ThreePhase4Wire\",\n  \"RatedCurrentAmps\": 32,\n  \"PowerState\": \"On\",\n  \"PolyPhaseVoltage\": {\n    \"Line1ToNeutral\": {\n      \"Reading\": 220.1,\n      \"DataSourceUri\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FVoltageA\"\n    },\n    \"Line2ToNeutral\": {\n      \"Reading\": 219.8,\n      \"DataSourceUri\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FVoltageB\"\n    },\n    \"Line3ToNeutral\": {\n      \"Reading\": 220.4,\n      \"DataSourceUri\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FVoltageC\"\n    }\n  },\n  \"PolyPhaseCurrentAmps\": {\n    \"Line1\": {\n      \"Reading\": 12.5,\n      \"DataSourceUri\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FCurrentA\"\n    },\n    \"Line2\": {\n      \"Reading\": 11.8,\n      \"DataSourceUri\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FCurrentB\"\n    },\n    \"Line3\": {\n      \"Reading\": 12.1,\n      \"DataSourceUri\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FCurrentC\"\n    }\n  },\n  \"PolyPhasePowerWatts\": {\n    \"Line1ToNeutral\": {\n      \"Reading\": 2750.0,\n      \"DataSourceUri\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FPowerA\"\n    },\n    \"Line2ToNeutral\": {\n      \"Reading\": 2594.0,\n      \"DataSourceUri\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FPowerB\"\n    },\n    \"Line3ToNeutral\": {\n      \"Reading\": 2666.0,\n      \"DataSourceUri\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FPowerC\"\n    }\n  },\n  \"PowerWatts\": {\n    \"Reading\": 8010.0,\n    \"DataSourceUri\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FPowerTotal\"\n  },\n  \"EnergykWh\": {\n    \"Reading\": 4521.3,\n    \"DataSourceUri\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FEnergyTotal\"\n  },\n  \"FrequencyHz\": {\n    \"Reading\": 60.0,\n    \"DataSourceUri\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FFrequencyA\"\n  },\n  \"Links\": {\n    \"Outlets\": [\n      { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets\u002F1\" },\n      { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets\u002F2\" }\n    ]\n  },\n  \"Status\": {\n    \"State\": \"Enabled\",\n    \"Health\": \"OK\"\n  },\n  \"Actions\": {\n    \"#Circuit.ResetMetrics\": {\n      \"target\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FMains\u002F1\u002FActions\u002FCircuit.ResetMetrics\"\n    }\n  },\n  \"Oem\": {\n    \"Pelx\": {\n      \"@odata.type\": \"#Pelx.v1_0_0.Pelx\",\n      \"Alias\": \"INFEED3P\",\n      \"InterfaceGroups\": {\n        \"PolyPhaseVoltage\": {\n          \"Line1ToNeutral\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FAI1B201\" },\n          \"Line2ToNeutral\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FAI1B202\" },\n          \"Line3ToNeutral\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FAI1B203\" }\n        },\n        \"PolyPhaseCurrentAmps\": {\n          \"Line1\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FAI1B401\" },\n          \"Line2\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FAI1B402\" },\n          \"Line3\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FAI1B403\" }\n        },\n        \"PolyPhasePowerWatts\": {\n          \"Line1ToNeutral\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FCAI1B501\" }\n        }\n      }\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>介面 alias 對照（\u003Ccode>INFEED3P\u003C\u002Fcode> 每相元素）：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Redfish 欄位\u003C\u002Fth>\n\u003Cth>\u003Ccode>INFEED3P\u003C\u002Fcode> 介面 alias\u003C\u002Fth>\n\u003Cth>Sensor \u003Ccode>{id}\u003C\u002Fcode>（相別 A\u002FB\u002FC）\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>PolyPhaseVoltage.Line1ToNeutral\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>V\u003C\u002Fcode>（id=1）\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>VoltageA\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>PolyPhaseVoltage.Line2ToNeutral\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>V\u003C\u002Fcode>（id=2）\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>VoltageB\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>PolyPhaseVoltage.Line3ToNeutral\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>V\u003C\u002Fcode>（id=3）\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>VoltageC\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>PolyPhaseCurrentAmps.Line1\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>CUR\u003C\u002Fcode>（id=1）\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>CurrentA\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>PolyPhaseCurrentAmps.Line2\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>CUR\u003C\u002Fcode>（id=2）\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>CurrentB\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>PolyPhaseCurrentAmps.Line3\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>CUR\u003C\u002Fcode>（id=3）\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>CurrentC\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>PolyPhasePowerWatts.Line1ToNeutral\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>AP\u003C\u002Fcode>（id=1）\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>PowerA\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>FrequencyHz\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>FREQ\u003C\u002Fcode>（id=1）\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>FrequencyA\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>EnergykWh\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>各相 \u003Ccode>UWH\u003C\u002Fcode> 彙總\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>EnergyTotal\u003C\u002Fcode> 或各相 \u003Ccode>EnergyA\u003C\u002Fcode>…\u003Ccode>C\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch4 id=\"section-240\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>id\u003C\u002Fstrong>（路徑參數）: 進線路數；單相對應 \u003Ccode>INFEED.elements.id\u003C\u002Fcode>，三相整體進線固定 \u003Ccode>1\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 進線電路資源 URI，如 \u003Ccode>\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FMains\u002F1\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#Circuit.v1_8_1.Circuit\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 資源識別碼，與路徑參數 \u003Ccode>{mainId}\u003C\u002Fcode> 相同\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 顯示名稱；單相如 \u003Ccode>Infeed1\u003C\u002Fcode>，三相如 \u003Ccode>Main Input\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>CircuitType\u003C\u002Fstrong>: 電路類型，進線固定 \u003Ccode>Mains\u003C\u002Fcode>（OCP AC Mains use case）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>UserLabel\u003C\u002Fstrong>: 使用者標籤（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>，可寫入）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ElectricalContext\u003C\u002Fstrong>: 電氣上下文（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>），進線總量為 \u003Ccode>Total\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>VoltageType\u003C\u002Fstrong>: 電壓類型，如 \u003Ccode>AC\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PhaseWiringType\u003C\u002Fstrong>: 相線接線類型（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>）；單相 \u003Ccode>OnePhase3Wire\u003C\u002Fcode>，三相 \u003Ccode>ThreePhase4Wire\u003C\u002Fcode> 或 \u003Ccode>ThreePhase5Wire\u003C\u002Fcode>（依機型中性線配置）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>RatedCurrentAmps\u003C\u002Fstrong>: 額定電流（A），額定電流設定\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PowerState\u003C\u002Fstrong>: 進線供電狀態，\u003Ccode>On\u003C\u002Fcode> 或 \u003Ccode>Off\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>NominalVoltage\u003C\u002Fstrong>: 額定電壓類型（DMTF \u003Ccode>NominalVoltageType\u003C\u002Fcode> \u003Cstrong>字串列舉\u003C\u002Fstrong>，如 \u003Ccode>AC230V\u003C\u002Fcode>、\u003Ccode>AC100To240V\u003C\u002Fcode>）；由即時讀值或機型預設推斷，\u003Cstrong>非\u003C\u002Fstrong>量測 excerpt 物件\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Voltage\u003C\u002Fstrong>: 單相即時電壓（OCP Conditional：無 \u003Ccode>PolyPhaseVoltage\u003C\u002Fcode> 時 \u003Cstrong>Mandatory\u003C\u002Fstrong>）；三相機型\u003Cstrong>省略\u003C\u002Fstrong>\u003Cul>\n\u003Cli>\u003Cstrong>DataSourceUri\u003C\u002Fstrong>: 須指向 \u003Ccode>Chassis\u002F{chassisId}\u002FSensors\u002F{sensorId}\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>CurrentAmps\u003C\u002Fstrong>: 單相電流量測（OCP Conditional：無 \u003Ccode>PolyPhaseCurrentAmps\u003C\u002Fcode> 時 \u003Cstrong>Mandatory\u003C\u002Fstrong>）；三相機型\u003Cstrong>省略\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PolyPhaseVoltage\u003C\u002Fstrong>: 三相線對中性點／線間電壓（OCP Conditional：無 \u003Ccode>Voltage\u003C\u002Fcode> 時 \u003Cstrong>Mandatory\u003C\u002Fstrong>）；子鍵為 \u003Ccode>Line1ToNeutral\u003C\u002Fcode>、\u003Ccode>Line2ToNeutral\u003C\u002Fcode>、\u003Ccode>Line3ToNeutral\u003C\u002Fcode> 等\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PolyPhaseCurrentAmps\u003C\u002Fstrong>: 三相各相電流（OCP Conditional：無 \u003Ccode>CurrentAmps\u003C\u002Fcode> 時 \u003Cstrong>Mandatory\u003C\u002Fstrong>）；子鍵為 \u003Ccode>Line1\u003C\u002Fcode>、\u003Ccode>Line2\u003C\u002Fcode>、\u003Ccode>Line3\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PolyPhasePowerWatts\u003C\u002Fstrong>: 各相有功功率（OCP \u003Cstrong>Recommended\u003C\u002Fstrong>）；子鍵為 \u003Ccode>Line1ToNeutral\u003C\u002Fcode> 等\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PolyPhaseEnergykWh\u003C\u002Fstrong>: 各相累計能耗（OCP \u003Cstrong>Recommended\u003C\u002Fstrong>）；若僅回報總量可省略，改以 \u003Ccode>EnergykWh\u003C\u002Fcode> 表示\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PowerWatts\u003C\u002Fstrong>: 有功功率總量（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>）；三相為各相 \u003Ccode>AP\u003C\u002Fcode> 彙總或晶片總功率\u003C\u002Fli>\n\u003Cli>\u003Cstrong>EnergykWh\u003C\u002Fstrong>: 累計能耗總量（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>FrequencyHz\u003C\u002Fstrong>: 頻率（OCP \u003Cstrong>Recommended\u003C\u002Fstrong>）；三相通常取 L1 之 \u003Ccode>FREQ\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Links\u003C\u002Fstrong>: 電路關聯（OCP \u003Cstrong>Recommended\u003C\u002Fstrong>）\u003Cul>\n\u003Cli>\u003Cstrong>PowerOutlet\u003C\u002Fstrong> \u002F \u003Cstrong>Outlets\u003C\u002Fstrong>: 此進線供電之插座列表（OCP Mains 建議 \u003Ccode>PowerOutlet\u003C\u002Fcode>；DMTF 亦支援 \u003Ccode>Outlets\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>DistributionCircuits\u003C\u002Fstrong>: 下層分支／配電電路（OCP Recommended）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Actions.#Circuit.ResetMetrics\u003C\u002Fstrong>: 重設進線能耗計數（OCP \u003Cstrong>Recommended\u003C\u002Fstrong>）；見下方 \u003Ccode>POST\u003C\u002Fcode> 章節\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Status\u003C\u002Fstrong>: 運作與健康狀態物件\u003Cul>\n\u003Cli>\u003Cstrong>State\u003C\u002Fstrong>: 運作狀態，固定 \u003Ccode>Enabled\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Health\u003C\u002Fstrong>: 健康狀態，由相關介面 \u003Cstrong>status\u003C\u002Fstrong> 彙整\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem\u003C\u002Fstrong>: 廠商擴充欄位容器\u003Cul>\n\u003Cli>\u003Cstrong>Pelx\u003C\u002Fstrong>: Pelx OEM 命名空間\u003Cul>\n\u003Cli>\u003Cstrong>ElementId\u003C\u002Fstrong>: 週邊路數（單相 \u003Ccode>INFEED\u003C\u002Fcode>）；三相整體進線可省略或標示主相\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Alias\u003C\u002Fstrong>: 週邊別名；單相 \u003Ccode>INFEED\u003C\u002Fcode>，三相 \u003Ccode>INFEED3P\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Synthetic\u003C\u002Fstrong>: \u003Ccode>true\u003C\u002Fcode> 表示無實體進線之合成資源（如 DPB）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Interfaces\u003C\u002Fstrong>: 各量測對應之 Pelx 介面資源連結（單相 \u003Ccode>INFEED\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>InterfaceGroups\u003C\u002Fstrong>: 三相巢狀量測對照（\u003Ccode>INFEED3P\u003C\u002Fcode>）；結構與 \u003Ccode>PolyPhaseVoltage\u003C\u002Fcode> 等欄位對應\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>若機型無某量測（如瓦時），該欄位省略\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-241\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>進線不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-242\">POST https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>重設進線能耗計數。重設該插座能耗計數。\u003C\u002Fp>\n\u003Cp>請求 body 可為空物件 \u003Ccode>{}\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Ch4 id=\"section-243\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>重設成功\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>進線不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>500\u003C\u002Ftd>\n\u003Ctd>裝置不支援或內部錯誤\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-244\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>分支電路集合（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>；無實體分支時 \u003Ccode>Members\u003C\u002Fcode> 為空陣列）。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FBranches\",\n  \"@odata.type\": \"#CircuitCollection.CircuitCollection\",\n  \"Members\": [\n    { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FBranches\u002F1\" }\n  ],\n  \"Members@odata.count\": 1\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>無分支時 \u003Ccode>Members\u003C\u002Fcode> 為 \u003Ccode>[]\u003C\u002Fcode>，\u003Ccode>Members@odata.count\u003C\u002Fcode> 為 \u003Ccode>0\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Ch4 id=\"section-245\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 分支集合 URI，固定 \u003Ccode>...\u002FRackPDUs\u002F{rackId}\u002FBranches\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Members\u003C\u002Fstrong>: 分支電路連結陣列；無分支時為 \u003Ccode>[]\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ca>Members@odata.count\u003C\u002Fa>\u003C\u002Fstrong>: 分支數量\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-246\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-247\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>分支電路（\u003Ccode>CircuitType: Branch\u003C\u002Fcode>）。若無分支進線 且無分支，集合為空。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FBranches\u002F1\",\n  \"@odata.type\": \"#Circuit.v1_8_1.Circuit\",\n  \"Id\": \"1\",\n  \"Name\": \"Branch1\",\n  \"UserLabel\": \"Branch 1\",\n  \"CircuitType\": \"Branch\",\n  \"ElectricalContext\": \"Line1\",\n  \"NominalVoltage\": \"AC230V\",\n  \"VoltageType\": \"AC\",\n  \"PhaseWiringType\": \"OnePhase3Wire\",\n  \"CurrentAmps\": {\n    \"Reading\": 8.2,\n    \"DataSourceUri\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FBranch1Current\"\n  },\n  \"PowerWatts\": {\n    \"Reading\": 1804.0,\n    \"DataSourceUri\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FBranch1Power\"\n  },\n  \"Links\": {\n    \"SourceCircuit\": {\n      \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FMains\u002F1\"\n    },\n    \"Outlets\": [\n      { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets\u002F1\" },\n      { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets\u002F2\" }\n    ]\n  },\n  \"Status\": {\n    \"State\": \"Enabled\",\n    \"Health\": \"OK\"\n  },\n  \"Oem\": {\n    \"Pelx\": {\n      \"@odata.type\": \"#Pelx.v1_0_0.Pelx\",\n      \"ElementId\": 1,\n      \"Alias\": \"BRANCH\",\n      \"Interfaces\": {\n        \"CurrentAmps\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FAI2203\" },\n        \"PowerWatts\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FCAI2205\" }\n      }\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-248\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>id\u003C\u002Fstrong>（路徑參數）: 分支路數\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 分支電路資源 URI，如 \u003Ccode>\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FBranches\u002F1\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#Circuit.v1_8_1.Circuit\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 資源識別碼，與路徑參數 \u003Ccode>{id}\u003C\u002Fcode> 相同\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 顯示名稱，如 \u003Ccode>Branch1\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>CircuitType\u003C\u002Fstrong>: 電路類型，固定 \u003Ccode>Branch\u003C\u002Fcode> 或 \u003Ccode>Bus\u003C\u002Fcode>（OCP Branches use case）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>UserLabel\u003C\u002Fstrong>: 使用者標籤（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>，可寫入）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ElectricalContext\u003C\u002Fstrong>: 電氣上下文；分支 1／2／3 分別為 \u003Ccode>Line1\u003C\u002Fcode>／\u003Ccode>Line2\u003C\u002Fcode>／\u003Ccode>Line3\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Links\u003C\u002Fstrong>: 電路關聯（OCP Branches use case）\u003Cul>\n\u003Cli>\u003Cstrong>SourceCircuit\u003C\u002Fstrong>: 上層進線電路\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Outlets\u003C\u002Fstrong>: 此分支下屬插座列表\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>CurrentAmps\u003C\u002Fstrong>: 電流量測物件\u003Cul>\n\u003Cli>\u003Cstrong>Reading\u003C\u002Fstrong>: 分支電流（A）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>DataSourceUri\u003C\u002Fstrong>: 電流感測器資源 URI\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PowerWatts\u003C\u002Fstrong>: 功率量測物件\u003Cul>\n\u003Cli>\u003Cstrong>Reading\u003C\u002Fstrong>: 分支功率（W）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>DataSourceUri\u003C\u002Fstrong>: 功率感測器資源 URI\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Status\u003C\u002Fstrong>: 運作與健康狀態物件\u003Cul>\n\u003Cli>\u003Cstrong>State\u003C\u002Fstrong>: 運作狀態，固定 \u003Ccode>Enabled\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Health\u003C\u002Fstrong>: 健康狀態，由相關介面 \u003Cstrong>status\u003C\u002Fstrong> 彙整\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem\u003C\u002Fstrong>: 廠商擴充欄位容器\u003Cul>\n\u003Cli>\u003Cstrong>Pelx\u003C\u002Fstrong>: Pelx OEM 命名空間\u003Cul>\n\u003Cli>\u003Cstrong>ElementId\u003C\u002Fstrong>: 週邊路數\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Alias\u003C\u002Fstrong>: 週邊別名，通常為 \u003Ccode>BRANCH\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Interfaces\u003C\u002Fstrong>: 各量測對應之 Pelx 介面資源連結\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-249\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>分支不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-250\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>列出本 Rack PDU 下所有感測器資源（\u003Cstrong>DSP2056 配電路徑\u003C\u002Fstrong>）。成員與 \u003Ccode>Chassis\u002F1\u002FSensors\u003C\u002Fcode> 相同；\u003Cstrong>OCP Interop Validator 驗證 \u003Ccode>Chassis\u002F...\u002FSensors\u003C\u002Fcode>\u003C\u002Fstrong>，\u003Ccode>DataSourceUri\u003C\u002Fcode> 須使用 Chassis URI。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FSensors\",\n  \"@odata.type\": \"#SensorCollection.SensorCollection\",\n  \"Members\": [\n    { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FSensors\u002FCurrentA\" },\n    { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FSensors\u002FPowerA\" },\n    { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FSensors\u002FEnergyA\" },\n    { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FSensors\u002FOutlet1Current\" }\n  ],\n  \"Members@odata.count\": 4\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-251\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 感測器集合 URI，固定 \u003Ccode>...\u002FRackPDUs\u002F{rackId}\u002FSensors\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#SensorCollection.SensorCollection\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Members\u003C\u002Fstrong>: 感測器資源連結陣列\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 單一感測器 URI；\u003Ccode>{id}\u003C\u002Fcode> 見下節命名規則\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ca>Members@odata.count\u003C\u002Fa>\u003C\u002Fstrong>: 感測器數量\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-252\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-253\">Sensor \u003Ccode>{id}\u003C\u002Fcode> 定義\u003C\u002Fh3>\n\u003Cp>\u003Cstrong>一筆 Sensor = 一個可讀取的 AI／CAI 量測介面\u003C\u002Fstrong>（可讀取之量測介面），來源週邊限於 Rack PDU 配電範圍：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>來源週邊（\u003Ccode>peripheralAlias\u003C\u002Fcode>）\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>INFEED\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>單相進線電壓、電流、功率、能耗、頻率等（\u003Ccode>infeedKind\u003C\u002Fcode> = Current \u002F WattHour）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>INFEED3P\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>三相進線各相電壓、電流、功率、能耗、頻率等（\u003Ccode>infeedKind\u003C\u002Fcode> = ThreePhase）；Sensor \u003Ccode>{id}\u003C\u002Fcode> 以 A\u002FB\u002FC 表相別\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>OUTLET\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>插座電壓、電流、功率、能耗等\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>BRANCH\u003C\u002Fcode> \u002F \u003Ccode>INFEED3PB\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>分支電流、功率等（若有分支進線）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>不納入 Sensor 集合者：\u003Ccode>DI\u003C\u002Fcode>／\u003Ccode>DO\u003C\u002Fcode> 狀態位、其餘週邊（改走 \u003Ccode>Oem\u002FPelx\u002FInterfaces\u003C\u002Fcode>）。\u003Ccode>TEMPRH\u003C\u002Fcode> 溫度同時出現在 \u003Ccode>Chassis\u002F1\u002FSensors\u002FTemp{n}\u003C\u002Fcode> 與 \u003Ccode>ThermalSubsystem\u002FThermalMetrics\u003C\u002Fcode>；濕度等若無標準欄位請查 \u003Ccode>Oem\u002FPelx\u002FInterfaces\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Cp>\u003Cstrong>\u003Ccode>{id}\u003C\u002Fcode> 命名規則\u003C\u002Fstrong>（字串，URI 區分大小寫）：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{週邊縮寫}{路數}{量測別名}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>片段\u003C\u002Fth>\n\u003Cth>來源\u003C\u002Fth>\n\u003Cth>範例\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>週邊縮寫\u003C\u002Ftd>\n\u003Ctd>週邊類型\u003C\u002Ftd>\n\u003Ctd>進線用 \u003Ccode>Infeed\u003C\u002Fcode> 或單進線簡寫 \u003Ccode>A\u003C\u002Fcode>\u002F\u003Ccode>B\u003C\u002Fcode>；插座 \u003Ccode>Outlet\u003C\u002Fcode>；分支 \u003Ccode>Branch\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>路數\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>elements.id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>1\u003C\u002Fcode>、\u003Ccode>2\u003C\u002Fcode>…\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>量測別名\u003C\u002Ftd>\n\u003Ctd>介面 \u003Ccode>alias\u003C\u002Fcode> 轉 Redfish\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>V\u003C\u002Fcode>→\u003Ccode>Voltage\u003C\u002Fcode>、\u003Ccode>A\u003C\u002Fcode>\u002F\u003Ccode>CUR\u003C\u002Fcode>→\u003Ccode>Current\u003C\u002Fcode>、\u003Ccode>W\u003C\u002Fcode>→\u003Ccode>Power\u003C\u002Fcode>、\u003Ccode>WH\u003C\u002Fcode>→\u003Ccode>Energy\u003C\u002Fcode>、\u003Ccode>FREQ\u003C\u002Fcode>→\u003Ccode>Frequency\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>\u003Cstrong>常見 \u003Ccode>{id}\u003C\u002Fcode> 範例\u003C\u002Fstrong>（依 \u003Ccode>Mains\u003C\u002Fcode>／\u003Ccode>Outlets\u003C\u002Fcode> 內 \u003Ccode>DataSourceUri\u003C\u002Fcode> 與 \u003Ccode>Oem.Pelx.Interfaces\u003C\u002Fcode> 互相對照）：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>位置\u003C\u002Fth>\n\u003Cth>介面 alias\u003C\u002Fth>\n\u003Cth>Sensor \u003Ccode>{id}\u003C\u002Fcode> 範例\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>INFEED 1 電流\u003C\u002Ftd>\n\u003Ctd>TC \u002F A\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>CurrentA\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>INFEED 1 功率\u003C\u002Ftd>\n\u003Ctd>AP \u002F W\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>PowerA\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>INFEED 1 能耗\u003C\u002Ftd>\n\u003Ctd>UWH \u002F WH\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>EnergyA\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>INFEED 1 電壓\u003C\u002Ftd>\n\u003Ctd>V\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>VoltageA\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>INFEED3P L1 電壓\u003C\u002Ftd>\n\u003Ctd>V（id=1）\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>VoltageA\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>INFEED3P L2 電流\u003C\u002Ftd>\n\u003Ctd>CUR（id=2）\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>CurrentB\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>INFEED3P L3 功率\u003C\u002Ftd>\n\u003Ctd>AP（id=3）\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>PowerC\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>OUTLET 1 電流\u003C\u002Ftd>\n\u003Ctd>C \u002F CUR\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Outlet1Current\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>BRANCH 1 電流\u003C\u002Ftd>\n\u003Ctd>TC \u002F CUR\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Branch1Current\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>整合方應以 \u003Cstrong>\u003Ccode>GET ...\u002FChassis\u002F1\u002FSensors\u003C\u002Fcode> 的 \u003Ccode>Members\u003C\u002Fcode>\u003C\u002Fstrong>（OCP）或 \u003Ccode>GET ...\u002FRackPDUs\u002F...\u002FSensors\u003C\u002Fcode>（DSP2056）取得有效 \u003Ccode>{id}\u003C\u002Fcode>，並以 \u003Ccode>Mains\u003C\u002Fcode>／\u003Ccode>Outlets\u003C\u002Fcode> 的 \u003Cstrong>\u003Ccode>DataSourceUri\u003C\u002Fcode>\u003C\u002Fstrong> 交叉對照。\u003C\u002Fp>\n\u003Cp>與 \u003Ca rel=\"noopener noreferrer\" href=\"https:\u002F\u002Fwww.dmtf.org\u002Fsites\u002Fdefault\u002Ffiles\u002Fstandards\u002Fdocuments\u002FDSP2056_1.1.0.pdf\">DSP2056\u003C\u002Fa> 一致：\u003Ccode>Mains\u003C\u002Fcode>／\u003Ccode>Outlets\u003C\u002Fcode> 上可內嵌 \u003Cstrong>Reading\u003C\u002Fstrong> 做快速瀏覽；\u003Ccode>Sensors\u002F{id}\u003C\u002Fcode> 提供完整 \u003Cstrong>Reading\u003C\u002Fstrong>、\u003Cstrong>Thresholds\u003C\u002Fstrong> 與 \u003Cstrong>Status\u003C\u002Fstrong>，供監控系統深入輪詢。\u003C\u002Fp>\n\u003Ch3 id=\"section-254\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>單一感測器讀值與閾值。\u003Ccode>{sensorId}\u003C\u002Fcode> 見上節。\u003Ccode>{rackId}\u003C\u002Fcode> 為 Rack PDU 路徑參數。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F{rackId}\u002FSensors\u002F{sensorId}\",\n  \"@odata.type\": \"#Sensor.v1_9_0.Sensor\",\n  \"Id\": \"{sensorId}\",\n  \"Name\": \"Infeed1 Voltage\",\n  \"Reading\": 220.4,\n  \"ReadingUnits\": \"V\",\n  \"ReadingType\": \"Voltage\",\n  \"ElectricalContext\": \"Line1ToNeutral\",\n  \"ReadingTime\": \"2026-06-15T10:00:05+08:00\",\n  \"SensingInterval\": \"PT5S\",\n  \"Status\": {\n    \"State\": \"Enabled\",\n    \"Health\": \"OK\"\n  },\n  \"Thresholds\": {\n    \"UpperCritical\": { \"Reading\": 250 },\n    \"UpperCaution\": { \"Reading\": 240 },\n    \"LowerCaution\": { \"Reading\": 200 },\n    \"LowerCritical\": { \"Reading\": 190 }\n  },\n  \"Oem\": {\n    \"Pelx\": {\n      \"@odata.type\": \"#Pelx.v1_0_0.Pelx\",\n      \"Interface\": {\n        \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FAI2101\"\n      }\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-255\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>id\u003C\u002Fstrong>（路徑參數）: 感測器識別碼（如 \u003Ccode>VoltageA\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 感測器資源 URI，如 \u003Ccode>\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FSensors\u002FVoltageA\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#Sensor.v1_9_0.Sensor\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 資源識別碼，與路徑參數 \u003Ccode>{id}\u003C\u002Fcode> 相同\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 顯示名稱，如 \u003Ccode>Infeed1 Voltage\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Reading\u003C\u002Fstrong>: 即時讀值，對應 \u003Ccode>interfaces\u003C\u002Fcode> 的 \u003Cstrong>value\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ReadingUnits\u003C\u002Fstrong>: 單位（如 \u003Ccode>V\u003C\u002Fcode>、\u003Ccode>A\u003C\u002Fcode>、\u003Ccode>W\u003C\u002Fcode>、\u003Ccode>kWh\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ReadingType\u003C\u002Fstrong>: 量測類型（如 \u003Ccode>Voltage\u003C\u002Fcode>、\u003Ccode>Current\u003C\u002Fcode>、\u003Ccode>Power\u003C\u002Fcode>、\u003Ccode>Energy\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ElectricalContext\u003C\u002Fstrong>: 電氣上下文（OCP 電氣感測器 \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ReadingTime\u003C\u002Fstrong>: 讀值時間 ISO 8601（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>SensingInterval\u003C\u002Fstrong>: 取樣間隔 ISO 8601 duration（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>），如 \u003Ccode>PT5S\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Status\u003C\u002Fstrong>: 運作與健康狀態物件\u003Cul>\n\u003Cli>\u003Cstrong>State\u003C\u002Fstrong>: 運作狀態，固定 \u003Ccode>Enabled\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Health\u003C\u002Fstrong>: 健康狀態，由對應介面 \u003Cstrong>status\u003C\u002Fstrong> 轉換\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Thresholds\u003C\u002Fstrong>: 閾值物件，對應 \u003Ccode>interfaces\u003C\u002Fcode> 的 \u003Cstrong>params\u003C\u002Fstrong>\u003Cul>\n\u003Cli>\u003Cstrong>UpperCritical\u003C\u002Fstrong>: 過高異常閾值物件\u003Cul>\n\u003Cli>\u003Cstrong>Reading\u003C\u002Fstrong>: 閾值數值（過高異常閾值）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>UpperCaution\u003C\u002Fstrong>: 過高警告閾值物件\u003Cul>\n\u003Cli>\u003Cstrong>Reading\u003C\u002Fstrong>: 閾值數值（過高警告閾值）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>LowerCaution\u003C\u002Fstrong>: 過低警告閾值物件\u003Cul>\n\u003Cli>\u003Cstrong>Reading\u003C\u002Fstrong>: 閾值數值（過低警告閾值）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>LowerCritical\u003C\u002Fstrong>: 過低異常閾值物件\u003Cul>\n\u003Cli>\u003Cstrong>Reading\u003C\u002Fstrong>: 閾值數值（過低異常閾值）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem\u003C\u002Fstrong>: 廠商擴充欄位容器\u003Cul>\n\u003Cli>\u003Cstrong>Pelx\u003C\u002Fstrong>: Pelx OEM 命名空間\u003Cul>\n\u003Cli>\u003Cstrong>Interface\u003C\u002Fstrong>: 對應之 Pelx 介面資源連結（\u003Ccode>\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002F{addr}\u003C\u002Fcode>）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-256\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>感測器不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Chr>\n\u003Ch1 id=\"section-257\">ATS 轉換開關（TransferSwitches）\u003C\u002Fh1>\n\u003Cp>Redfish 標準以 \u003Cstrong>Transfer Switch\u003C\u002Fstrong> 表示 ATS（非字串 \u003Ccode>ATS\u003C\u002Fcode>）。僅當設備支援 ATS 時提供下列資源；否則 \u003Ccode>GET ...\u002FTransferSwitches\u003C\u002Fcode> 回傳空集合 \u003Ccode>Members: []\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>權限\u003C\u002Fstrong>：預設見 認證（控制 Action 與寫入至少 \u003Cstrong>Operator\u003C\u002Fstrong>）。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch3 id=\"section-258\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FTransferSwitches\",\n  \"@odata.type\": \"#PowerDistributionCollection.PowerDistributionCollection\",\n  \"Members\": [\n    { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FTransferSwitches\u002F1\" }\n  ],\n  \"Members@odata.count\": 1\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>無 ATS 時 \u003Ccode>Members\u003C\u002Fcode> 為空陣列，\u003Ccode>Members@odata.count\u003C\u002Fcode> 為 \u003Ccode>0\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Ch4 id=\"section-259\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: ATS 集合資源 URI，固定 \u003Ccode>\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FTransferSwitches\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#PowerDistributionCollection.PowerDistributionCollection\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Members\u003C\u002Fstrong>: ATS 資源連結陣列，元素為 \u003Ccode>{ \"@odata.id\": \"...\" }\u003C\u002Fcode>\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 單一 ATS 資源 URI，如 \u003Ccode>\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FTransferSwitches\u002F1\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ca>Members@odata.count\u003C\u002Fa>\u003C\u002Fstrong>: \u003Ccode>Members\u003C\u002Fcode> 陣列筆數；有 ATS 時通常為 \u003Ccode>1\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-260\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常（無 ATS 時為空集合）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-261\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>ATS 主資源。路徑參數 \u003Ccode>{atsId}\u003C\u002Fcode> 通常為 \u003Ccode>1\u003C\u002Fcode>；應自 \u003Ccode>Members\u003C\u002Fcode> 探索，無效 id 回 \u003Ccode>404\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Cp>\u003Cstrong>本回應是否要有 A、B 廻路資料？\u003C\u002Fstrong> 依 \u003Ca rel=\"noopener noreferrer\" href=\"https:\u002F\u002Fwww.dmtf.org\u002Fsites\u002Fdefault\u002Ffiles\u002Fstandards\u002Fdocuments\u002FDSP2056_1.1.0.pdf\">DSP2056\u003C\u002Fa> 與一般 PDU 實作：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>內容\u003C\u002Fth>\n\u003Cth>是否在 \u003Ccode>{atsId}\u003C\u002Fcode> 主資源 body 內\u003C\u002Fth>\n\u003Cth>取得方式\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>目前供電廻路（A 或 B）\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>要\u003C\u002Fstrong>，在 \u003Ccode>TransferConfiguration.ActiveMainsId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>本 API\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>A／B 連結\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>要\u003C\u002Fstrong>，\u003Ccode>Feeders.@odata.id\u003C\u002Fcode> 指向集合\u003C\u002Ftd>\n\u003Ctd>本 API（連結）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>A／B 電壓、頻率、有電等量測\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>不要\u003C\u002Fstrong>內嵌\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>GET ...\u002FFeeders\u002FA\u003C\u002Fcode>、\u003Ccode>GET ...\u002FFeeders\u002FB\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>切換參數（基準電壓等）\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>不要\u003C\u002Fstrong>內嵌\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>GET ...\u002FOem\u002FPelx\u002FParameters\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>亦即：主資源只回答「現在走 A 還是 B、切換設定為何」；兩路詳細讀值需再請求 \u003Ccode>Feeders\u003C\u002Fcode> 子資源。你實機 Postman 看到的結構（\u003Ccode>ActiveMainsId: \"A\"\u003C\u002Fcode> + \u003Ccode>Feeders\u003C\u002Fcode> 連結、無內嵌 V\u002FHz）\u003Cstrong>符合設計\u003C\u002Fstrong>。\u003C\u002Fp>\n\u003Cp>\u003Cstrong>使用者怎麼知道要打 \u003Ccode>...\u002FFeeders\u002FB\u003C\u002Fcode>？\u003C\u002Fstrong> Redfish 不應猜 URL，依 \u003Cstrong>\u003Ccode>@odata.id\u003C\u002Fcode> 連結逐層探索\u003C\u002Fstrong>：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>① GET \u002Fredfish\u002Fv1\u002FPowerEquipment\n      → 若有 TransferSwitches，取 TransferSwitches.@odata.id\n\n② GET ...\u002FTransferSwitches          （或 ① 已含 Members）\n      → Members[].@odata.id → ...\u002FTransferSwitches\u002F1\n\n③ GET ...\u002FTransferSwitches\u002F1\n      → Feeders.@odata.id → ...\u002FTransferSwitches\u002F1\u002FFeeders\n      → TransferConfiguration.ActiveMainsId → 目前 \"A\" 或 \"B\"（僅狀態，非完整 URI）\n\n④ GET ...\u002FTransferSwitches\u002F1\u002FFeeders\n      → Members[] 列出每一廻路完整 URI，例如：\n         ...\u002FFeeders\u002FA\n         ...\u002FFeeders\u002FB\n\n⑤ GET Members 中的 @odata.id        （整合程式對 Members 逐筆 GET 即可）\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>整合程式\u003Cstrong>只需跟著 JSON 裡的 \u003Ccode>@odata.id\u003C\u002Fcode> 走\u003C\u002Fstrong>，不必事先知道廻路叫 \u003Ccode>A\u003C\u002Fcode>\u002F\u003Ccode>B\u003C\u002Fcode> 還是數字。若略過 ④ 直接猜 \u003Ccode>Feeders\u002F1\u003C\u002Fcode>，會得到 404。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FTransferSwitches\u002F1\",\n  \"@odata.type\": \"#PowerDistribution.v1_4_0.PowerDistribution\",\n  \"Id\": \"1\",\n  \"Name\": \"ATS\",\n  \"EquipmentType\": \"AutomaticTransferSwitch\",\n  \"Manufacturer\": \"Pelx\",\n  \"Model\": \"ZDL-2A-12Z\",\n  \"Status\": {\n    \"State\": \"Enabled\",\n    \"Health\": \"OK\"\n  },\n  \"Feeders\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FTransferSwitches\u002F1\u002FFeeders\"\n  },\n  \"Mains\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FTransferSwitches\u002F1\u002FMains\"\n  },\n  \"TransferConfiguration\": {\n    \"ActiveMainsId\": \"A\",\n    \"AutoTransferEnabled\": true,\n    \"TransferSensitivity\": \"Medium\"\n  },\n  \"Oem\": {\n    \"Pelx\": {\n      \"AtsKind\": 1,\n      \"Parameters\": {\n        \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FTransferSwitches\u002F1\u002FOem\u002FPelx\u002FParameters\"\n      }\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-262\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>atsId\u003C\u002Fstrong>（路徑參數）: ATS 資源識別碼；有 ATS 時通常為 \u003Ccode>1\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: ATS 資源 URI，如 \u003Ccode>\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FTransferSwitches\u002F1\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#PowerDistribution.v1_4_0.PowerDistribution\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 資源識別碼，與路徑參數 \u003Ccode>{atsId}\u003C\u002Fcode> 相同\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 顯示名稱，固定 \u003Ccode>ATS\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>EquipmentType\u003C\u002Fstrong>: 設備類型，固定 \u003Ccode>AutomaticTransferSwitch\u003C\u002Fcode>（自動轉換開關）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Manufacturer\u003C\u002Fstrong>: 製造商，製造商識別\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Model\u003C\u002Fstrong>: 型號，設備型號\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Status\u003C\u002Fstrong>: 運作與健康狀態物件\u003Cul>\n\u003Cli>\u003Cstrong>State\u003C\u002Fstrong>: 運作狀態，固定 \u003Ccode>Enabled\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Health\u003C\u002Fstrong>: 健康狀態，由 ATS 廻路與告警彙整\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Feeders\u003C\u002Fstrong>: 輸入廻路集合連結物件（A／B 源）\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 廻路列表 URI（\u003Ccode>...\u002FFeeders\u003C\u002Fcode>）；\u003Ccode>GET ...\u002FFeeders\u002FA\u003C\u002Fcode>、\u003Ccode>...\u002FFeeders\u002FB\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Mains\u003C\u002Fstrong>: 輸出側電路集合連結物件（ATS 切換後輸出）\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 輸出列表 URI（\u003Ccode>...\u002FMains\u003C\u002Fcode>）；\u003Ccode>GET ...\u002FMains\u002F1\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>TransferConfiguration\u003C\u002Fstrong>: ATS 切換組態（對應 DSP2056）；\u003Cstrong>本資源內表示 A\u002FB 的唯一即時欄位為 ActiveMainsId\u003C\u002Fstrong>\u003Cul>\n\u003Cli>\u003Cstrong>ActiveMainsId\u003C\u002Fstrong>: 目前供電廻路，\u003Ccode>A\u003C\u002Fcode> 或 \u003Ccode>B\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>AutoTransferEnabled\u003C\u002Fstrong>: 是否啟用自動切換\u003C\u002Fli>\n\u003Cli>\u003Cstrong>TransferSensitivity\u003C\u002Fstrong>: 切換靈敏度，\u003Ccode>High\u003C\u002Fcode> \u002F \u003Ccode>Medium\u003C\u002Fcode> \u002F \u003Ccode>Low\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem\u003C\u002Fstrong>: 廠商擴充欄位容器\u003Cul>\n\u003Cli>\u003Cstrong>Pelx\u003C\u002Fstrong>: Pelx OEM 命名空間\u003Cul>\n\u003Cli>\u003Cstrong>AtsKind\u003C\u002Fstrong>: ATS 種類，ATS 種類（\u003Ccode>1\u003C\u002Fcode>=110V、\u003Ccode>2\u003C\u002Fcode>=220V）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Parameters\u003C\u002Fstrong>: ATS 參數資源連結物件\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 完整參數 URI\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-263\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>{atsId}\u003C\u002Fcode> 不存在，或本機無 ATS（設備不支援 ATS 時）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-264\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>列出 ATS 兩路輸入源。廻路識別碼為 \u003Cstrong>\u003Ccode>A\u003C\u002Fcode>、\u003Ccode>B\u003C\u002Fcode>（字串）\u003C\u002Fstrong>，不是數字 \u003Ccode>1\u003C\u002Fcode>、\u003Ccode>2\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FTransferSwitches\u002F1\u002FFeeders\",\n  \"@odata.type\": \"#CircuitCollection.CircuitCollection\",\n  \"Members\": [\n    { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FTransferSwitches\u002F1\u002FFeeders\u002FA\" },\n    { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FTransferSwitches\u002F1\u002FFeeders\u002FB\" }\n  ],\n  \"Members@odata.count\": 2\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-265\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>atsId\u003C\u002Fstrong>（路徑參數）: ATS 資源識別碼，通常為 \u003Ccode>1\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 廻路集合 URI，如 \u003Ccode>...\u002FTransferSwitches\u002F1\u002FFeeders\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#CircuitCollection.CircuitCollection\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Members\u003C\u002Fstrong>: 輸入廻路連結陣列，固定兩筆 \u003Ccode>A\u003C\u002Fcode>、\u003Ccode>B\u003C\u002Fcode>\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 單一廻路 URI；\u003Ccode>...\u002FFeeders\u002FA\u003C\u002Fcode> 或 \u003Ccode>...\u002FFeeders\u002FB\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ca>Members@odata.count\u003C\u002Fa>\u003C\u002Fstrong>: 固定 \u003Ccode>2\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-266\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>ATS 不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-267\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>輸入廻路量測。\u003Ccode>feederId\u003C\u002Fcode> \u003Cstrong>僅允許\u003C\u002Fstrong> \u003Ccode>A\u003C\u002Fcode> 或 \u003Ccode>B\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Cp>\u003Cstrong>常見誤用\u003C\u002Fstrong>：\u003Ccode>GET ...\u002FFeeders\u002F1\u003C\u002Fcode> 或 \u003Ccode>...\u002FFeeders\u002F2\u003C\u002Fcode> 會回 \u003Cstrong>404\u003C\u002Fstrong>——廻路不是用數字路數編號，請改請求 \u003Ccode>...\u002FFeeders\u002FA\u003C\u002Fcode>、\u003Ccode>...\u002FFeeders\u002FB\u003C\u002Fcode>，或先 \u003Ccode>GET ...\u002FFeeders\u003C\u002Fcode> 從 \u003Ccode>Members\u003C\u002Fcode> 取得 URI。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FTransferSwitches\u002F1\u002FFeeders\u002FA\",\n  \"@odata.type\": \"#Circuit.v1_8_1.Circuit\",\n  \"Id\": \"A\",\n  \"Name\": \"Source A\",\n  \"CircuitType\": \"Mains\",\n  \"NominalVoltage\": {\n    \"Reading\": 110.2\n  },\n  \"FrequencyHz\": {\n    \"Reading\": 60.0\n  },\n  \"Status\": {\n    \"State\": \"Enabled\",\n    \"Health\": \"OK\"\n  },\n  \"Oem\": {\n    \"Pelx\": {\n      \"Alias\": \"ATS\",\n      \"Links\": {\n        \"Interfaces\": {\n          \"Voltage\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FAI0E201\" },\n          \"FrequencyHz\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FAI0E301\" },\n          \"Present\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FDI0E401\" }\n        }\n      }\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-268\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>atsId\u003C\u002Fstrong>（路徑參數）: ATS 資源識別碼\u003C\u002Fli>\n\u003Cli>\u003Cstrong>feederId\u003C\u002Fstrong>（路徑參數）: 廻路識別碼，\u003Cstrong>僅\u003C\u002Fstrong> \u003Ccode>A\u003C\u002Fcode> 或 \u003Ccode>B\u003C\u002Fcode>（非 \u003Ccode>1\u003C\u002Fcode>／\u003Ccode>2\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 廻路電路資源 URI，如 \u003Ccode>...\u002FFeeders\u002FA\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#Circuit.v1_8_1.Circuit\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 資源識別碼，與 \u003Ccode>feederId\u003C\u002Fcode> 相同\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 顯示名稱，如 \u003Ccode>Source A\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>CircuitType\u003C\u002Fstrong>: 電路類型，輸入廻路固定 \u003Ccode>Mains\u003C\u002Fcode>（DSP2056 對 Transfer Switch 之輸入源）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>NominalVoltage\u003C\u002Fstrong>: 電壓量測物件\u003Cul>\n\u003Cli>\u003Cstrong>Reading\u003C\u002Fstrong>: 廻路電壓（V），對應 \u003Cstrong>ATAV\u003C\u002Fstrong>（A）或 \u003Cstrong>ATBV\u003C\u002Fstrong>（B）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>FrequencyHz\u003C\u002Fstrong>: 頻率量測物件\u003Cul>\n\u003Cli>\u003Cstrong>Reading\u003C\u002Fstrong>: 廻路頻率（Hz），對應 \u003Cstrong>ATAF\u003C\u002Fstrong>（A）或 \u003Cstrong>ATBF\u003C\u002Fstrong>（B）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Status\u003C\u002Fstrong>: 運作與健康狀態物件\u003Cul>\n\u003Cli>\u003Cstrong>State\u003C\u002Fstrong>: 運作狀態\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Health\u003C\u002Fstrong>: 健康狀態；廻路有電／電壓頻率告警由 \u003Cstrong>ATAI\u003C\u002Fstrong>、\u003Cstrong>ATAVH\u003C\u002Fstrong> 等 DI 彙整\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem\u003C\u002Fstrong>: 廠商擴充欄位容器\u003Cul>\n\u003Cli>\u003Cstrong>Pelx\u003C\u002Fstrong>: Pelx OEM 命名空間\u003Cul>\n\u003Cli>\u003Cstrong>Alias\u003C\u002Fstrong>: 週邊別名，固定 \u003Ccode>ATS\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Interfaces\u003C\u002Fstrong>: 各量測對應之 Pelx 介面資源連結（\u003Ccode>\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002F{addr}\u003C\u002Fcode>）\u003Cul>\n\u003Cli>\u003Cstrong>Voltage\u003C\u002Fstrong>: 電壓介面\u003C\u002Fli>\n\u003Cli>\u003Cstrong>FrequencyHz\u003C\u002Fstrong>: 頻率介面\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Present\u003C\u002Fstrong>: 有電狀態介面（\u003Cstrong>ATAI\u003C\u002Fstrong> \u002F \u003Cstrong>ATBI\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-269\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>ATS 不存在，或 \u003Ccode>feederId\u003C\u002Fcode> 非 \u003Ccode>A\u003C\u002Fcode>／\u003Ccode>B\u003C\u002Fcode>（如誤用 \u003Ccode>Feeders\u002F1\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>ATS 切換參數。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FTransferSwitches\u002F1\u002FOem\u002FPelx\u002FParameters\",\n  \"@odata.type\": \"#Pelx.AtsParameters\",\n  \"Id\": \"Parameters\",\n  \"brownOutHighA\": 120,\n  \"brownOutHighB\": 120,\n  \"brownOutLowA\": 100,\n  \"brownOutLowB\": 80,\n  \"frequencyHighA\": 65,\n  \"frequencyHighB\": 65,\n  \"frequencyLowA\": 55,\n  \"frequencyLowB\": 55,\n  \"frequencyNominal\": 60,\n  \"frequencyTolerance\": 5,\n  \"voltageNominal\": 110,\n  \"voltageTolerance\": 10\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-270\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>id\u003C\u002Fstrong>（路徑參數）: ATS 資源識別碼\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 參數資源 URI\u003C\u002Fli>\n\u003Cli>\u003Cstrong>brownOutHighA\u003C\u002Fstrong> \u002F \u003Cstrong>brownOutHighB\u003C\u002Fstrong>: A／B 廻路過高電壓閾值（V）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>brownOutLowA\u003C\u002Fstrong> \u002F \u003Cstrong>brownOutLowB\u003C\u002Fstrong>: A／B 廻路過低電壓閾值（V）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>frequencyHighA\u003C\u002Fstrong> \u002F \u003Cstrong>frequencyHighB\u003C\u002Fstrong>: A／B 廻路過高頻率閾值（Hz）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>frequencyLowA\u003C\u002Fstrong> \u002F \u003Cstrong>frequencyLowB\u003C\u002Fstrong>: A／B 廻路過低頻率閾值（Hz）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>frequencyNominal\u003C\u002Fstrong>: 基準頻率（Hz）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>frequencyTolerance\u003C\u002Fstrong>: 頻率容許範圍（Hz）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>voltageNominal\u003C\u002Fstrong>: 基準電壓（V）；110V 系統可為 100／110／120，220V 系統可為 200／210／220／230\u003C\u002Fli>\n\u003Cli>\u003Cstrong>voltageTolerance\u003C\u002Fstrong>: 電壓容許範圍；110V：10–23，220V：15–25\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-271\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>本機無 ATS\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-272\">PATCH https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>設定 ATS 參數。；可部分更新。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"voltageNominal\": 110,\n  \"voltageTolerance\": 10,\n  \"frequencyTolerance\": 5\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-273\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>id\u003C\u002Fstrong>（路徑參數）: ATS 資源識別碼\u003C\u002Fli>\n\u003Cli>\u003Cstrong>voltageNominal\u003C\u002Fstrong>: 基準電壓，合法值依 ATS 機型 見上節\u003C\u002Fli>\n\u003Cli>\u003Cstrong>voltageTolerance\u003C\u002Fstrong>: 電壓容許範圍\u003C\u002Fli>\n\u003Cli>\u003Cstrong>frequencyTolerance\u003C\u002Fstrong>: 頻率容許範圍（3–10）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-274\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>設定成功\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>參數錯誤\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>本機無 ATS\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Chr>\n\u003Ch1 id=\"section-275\">插座（Outlets）\u003C\u002Fh1>\n\u003Cp>依 DSP2056，所有插座集中於單一 \u003Ccode>Outlets\u003C\u002Fcode> 集合，無需先查分支電路即可定位。\u003C\u002Fp>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>權限\u003C\u002Fstrong>：預設見 認證（\u003Ccode>GET\u003C\u002Fcode> ReadOnly 以上；\u003Cstrong>控制 Action\u003C\u002Fstrong> 與寫入至少 \u003Cstrong>Operator\u003C\u002Fstrong>）。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch3 id=\"section-276\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets\",\n  \"@odata.type\": \"#OutletCollection.OutletCollection\",\n  \"Members\": [\n    { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets\u002F1\" },\n    { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets\u002F2\" }\n  ],\n  \"Members@odata.count\": 2\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-277\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 插座集合資源 URI，固定 \u003Ccode>\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#OutletCollection.OutletCollection\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Members\u003C\u002Fstrong>: 插座資源連結陣列，元素為 \u003Ccode>{ \"@odata.id\": \"...\" }\u003C\u002Fcode>\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 單一插座資源 URI，如 \u003Ccode>\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets\u002F1\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ca>Members@odata.count\u003C\u002Fa>\u003C\u002Fstrong>: \u003Ccode>Members\u003C\u002Fcode> 陣列筆數，插座數量，插座總數\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-278\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-279\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>單路插座詳細資料。\u003Ccode>id\u003C\u002Fcode> 對應插座路數。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets\u002F1\",\n  \"@odata.type\": \"#Outlet.v1_4_4.Outlet\",\n  \"Id\": \"1\",\n  \"Name\": \"Outlet1\",\n  \"UserLabel\": \"Server-1\",\n  \"OutletType\": \"NEMA_5_20R\",\n  \"ElectricalContext\": \"Line1\",\n  \"NominalVoltage\": {\n    \"Reading\": 220\n  },\n  \"VoltageType\": \"AC\",\n  \"PhaseWiringType\": \"OnePhase3Wire\",\n  \"RatedCurrentAmps\": 20,\n  \"PowerState\": \"On\",\n  \"PowerEnabled\": true,\n  \"PowerRestorePolicy\": \"AlwaysOn\",\n  \"Voltage\": {\n    \"Reading\": 220.1,\n    \"DataSourceUri\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FOutlet1Voltage\"\n  },\n  \"CurrentAmps\": {\n    \"Reading\": 4.2,\n    \"DataSourceUri\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FOutlet1Current\"\n  },\n  \"PowerWatts\": {\n    \"Reading\": 924.4,\n    \"DataSourceUri\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FOutlet1Power\"\n  },\n  \"EnergykWh\": {\n    \"Reading\": 128.5,\n    \"DataSourceUri\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FOutlet1Energy\"\n  },\n  \"Status\": {\n    \"State\": \"Enabled\",\n    \"Health\": \"OK\"\n  },\n  \"Links\": {\n    \"BranchCircuit\": {\n      \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FBranches\u002F1\"\n    }\n  },\n  \"Actions\": {\n    \"#Outlet.PowerControl\": {\n      \"target\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets\u002F1\u002FActions\u002FOutlet.PowerControl\",\n      \"@Redfish.ActionInfo\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets\u002F1\u002FOutlet.PowerControlActionInfo\"\n    },\n    \"#Outlet.ResetMetrics\": {\n      \"target\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets\u002F1\u002FActions\u002FOutlet.ResetMetrics\"\n    }\n  },\n  \"Oem\": {\n    \"Pelx\": {\n      \"@odata.type\": \"#Pelx.v1_0_0.Pelx\",\n      \"ElementId\": 1,\n      \"Alias\": \"OUTLET\",\n      \"Interfaces\": {\n        \"PowerState\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FDO00101\" },\n        \"Voltage\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FAI00101\" },\n        \"CurrentAmps\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FAI00102\" },\n        \"PowerWatts\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FAI00103\" },\n        \"EnergykWh\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FCAI00104\" }\n      }\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-280\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>id\u003C\u002Fstrong>（路徑參數）: 插座路數，對應插座路數\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 插座資源 URI，如 \u003Ccode>\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets\u002F1\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#Outlet.v1_4_4.Outlet\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 資源識別碼，與路徑參數 \u003Ccode>{id}\u003C\u002Fcode> 相同\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 顯示名稱，如 \u003Ccode>Outlet1\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>UserLabel\u003C\u002Fstrong>: 使用者標籤（OCP Recommended，可寫入）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>OutletType\u003C\u002Fstrong>: 插座實體規格（如 \u003Ccode>NEMA_5_20R\u003C\u002Fcode>），依產品規格填入\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ElectricalContext\u003C\u002Fstrong>: 電氣上下文（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>）；依插座所屬相別為 \u003Ccode>Line1\u003C\u002Fcode>、\u003Ccode>Line2\u003C\u002Fcode> 或 \u003Ccode>Line3\u003C\u002Fcode>（由 \u003Ccode>relayBoardMap\u003C\u002Fcode> 推斷；預設 \u003Ccode>Line1\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>NominalVoltage\u003C\u002Fstrong>: 額定電壓\u003C\u002Fli>\n\u003Cli>\u003Cstrong>VoltageType\u003C\u002Fstrong>: 電壓類型，如 \u003Ccode>AC\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PhaseWiringType\u003C\u002Fstrong>: 相線接線類型\u003C\u002Fli>\n\u003Cli>\u003Cstrong>RatedCurrentAmps\u003C\u002Fstrong>: 額定電流（A）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PowerRestorePolicy\u003C\u002Fstrong>: 斷電恢復策略（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>），\u003Ccode>AlwaysOn\u003C\u002Fcode> \u002F \u003Ccode>AlwaysOff\u003C\u002Fcode> \u002F \u003Ccode>LastState\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PowerState\u003C\u002Fstrong>: 目前電源狀態（\u003Cstrong>讀取\u003C\u002Fstrong>）；僅 \u003Ccode>On\u003C\u002Fcode> 或 \u003Ccode>Off\u003C\u002Fcode>，由 DO 介面 \u003Cstrong>value\u003C\u002Fstrong> 轉換（\u003Ccode>true\u003C\u002Fcode> → \u003Ccode>On\u003C\u002Fcode>）。\u003Cstrong>不含\u003C\u002Fstrong> \u003Ccode>PowerCycle\u003C\u002Fcode>——重啟為控制指令，見 \u003Ccode>POST ...\u002FOutlet.PowerControl\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PowerEnabled\u003C\u002Fstrong>: 插座輸出是否啟用，\u003Ccode>true\u003C\u002Fcode> 表示允許供電\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Voltage\u003C\u002Fstrong> \u002F \u003Cstrong>CurrentAmps\u003C\u002Fstrong> \u002F \u003Cstrong>PowerWatts\u003C\u002Fstrong> \u002F \u003Cstrong>EnergykWh\u003C\u002Fstrong>: 量測物件（OCP Recommended）\u003Cul>\n\u003Cli>\u003Cstrong>Reading\u003C\u002Fstrong>: 即時讀值\u003C\u002Fli>\n\u003Cli>\u003Cstrong>DataSourceUri\u003C\u002Fstrong>: 須指向 \u003Ccode>Chassis\u002F{chassisId}\u002FSensors\u002F{sensorId}\u003C\u002Fcode>（OCP Profile）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Status\u003C\u002Fstrong>: 運作與健康狀態物件\u003Cul>\n\u003Cli>\u003Cstrong>State\u003C\u002Fstrong>: 運作狀態，固定 \u003Ccode>Enabled\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Health\u003C\u002Fstrong>: 健康狀態，由相關介面 \u003Cstrong>status\u003C\u002Fstrong> 彙整\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Links\u003C\u002Fstrong>: 關聯資源連結物件\u003Cul>\n\u003Cli>\u003Cstrong>BranchCircuit\u003C\u002Fstrong>: 所屬分支電路（OCP \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 分支 URI；\u003Cstrong>無實體分支時\u003C\u002Fstrong>指向對應 \u003Ccode>Mains\u002F{mainId}\u003C\u002Fcode>（OCP Usage Guide）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Actions\u003C\u002Fstrong>: 可執行操作物件\u003Cul>\n\u003Cli>\u003Cstrong>#Outlet.PowerControl\u003C\u002Fstrong>: 電源控制；須含 \u003Ccode>@Redfish.ActionInfo\u003C\u002Fcode> 指向 ActionInfo 資源\u003C\u002Fli>\n\u003Cli>\u003Cstrong>#Outlet.ResetMetrics\u003C\u002Fstrong>: 重設插座能耗計數（OCP Recommended）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem\u003C\u002Fstrong>: 廠商擴充欄位容器\u003Cul>\n\u003Cli>\u003Cstrong>Pelx\u003C\u002Fstrong>: Pelx OEM 命名空間\u003Cul>\n\u003Cli>\u003Cstrong>ElementId\u003C\u002Fstrong>: 週邊路數\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Alias\u003C\u002Fstrong>: 週邊別名，通常為 \u003Ccode>OUTLET\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Interfaces\u003C\u002Fstrong>: 各量測／控制對應之 Pelx 介面資源連結（\u003Ccode>\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002F{addr}\u003C\u002Fcode>）\u003Cul>\n\u003Cli>\u003Cstrong>PowerState\u003C\u002Fstrong>: DO 輸出控制介面（\u003Ccode>DO…\u003C\u002Fcode>）；\u003Ccode>Outlet.PowerControl\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Voltage\u003C\u002Fstrong> \u002F \u003Cstrong>CurrentAmps\u003C\u002Fstrong> \u002F \u003Cstrong>PowerWatts\u003C\u002Fstrong> \u002F \u003Cstrong>EnergykWh\u003C\u002Fstrong>: 量測介面連結\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>若機型無某量測，該欄位省略\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-281\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>插座不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-282\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>\u003Ccode>Outlet.PowerControl\u003C\u002Fcode> 的參數定義（Interop Validator \u003Cstrong>Mandatory\u003C\u002Fstrong> 驗證 \u003Ccode>PowerState\u003C\u002Fcode> 允許值）。\u003Cstrong>每個插座\u003C\u002Fstrong>各有一筆 ActionInfo，URI 在對應 Outlet 路徑下（非 RackPDU 根層）。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets\u002F1\u002FOutlet.PowerControlActionInfo\",\n  \"@odata.type\": \"#ActionInfo.v1_4_2.ActionInfo\",\n  \"Id\": \"OutletPowerControlActionInfo\",\n  \"Name\": \"Outlet Power Control Action Info\",\n  \"Parameters\": [\n    {\n      \"Name\": \"PowerState\",\n      \"Required\": true,\n      \"DataType\": \"String\",\n      \"AllowableValues\": [\"On\", \"Off\", \"PowerCycle\"]\n    }\n  ]\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch3 id=\"section-283\">POST https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>控制插座電源。。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"PowerState\": \"On\"\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>\u003Ccode>PowerState\u003C\u002Fcode> 可選值：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>值\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>On\u003C\u002Ftd>\n\u003Ctd>開啟\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Off\u003C\u002Ftd>\n\u003Ctd>關閉\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>PowerCycle\u003C\u002Ftd>\n\u003Ctd>重啟\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>可選延遲參數（對應 \u003Ccode>onDelay\u003C\u002Fcode> \u002F \u003Ccode>offDelay\u003C\u002Fcode>）：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"PowerState\": \"On\",\n  \"Oem\": {\n    \"Pelx\": {\n      \"OnDelaySec\": 10,\n      \"OffDelaySec\": 10\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-284\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>id\u003C\u002Fstrong>（路徑參數）: 插座路數，對應 \u003Ccode>Outlets\u002F{id}\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PowerState\u003C\u002Fstrong>: 目標電源狀態，\u003Ccode>On\u003C\u002Fcode> \u002F \u003Ccode>Off\u003C\u002Fcode> \u002F \u003Ccode>PowerCycle\u003C\u002Fcode>（重啟），見上表\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem\u003C\u002Fstrong>: 廠商擴充欄位容器（可選）\u003Cul>\n\u003Cli>\u003Cstrong>Pelx\u003C\u002Fstrong>: Pelx OEM 命名空間\u003Cul>\n\u003Cli>\u003Cstrong>OnDelaySec\u003C\u002Fstrong>: 開啟延遲（秒），即 \u003Cstrong>OnDelaySec\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>OffDelaySec\u003C\u002Fstrong>: 關閉延遲（秒），即 \u003Cstrong>OffDelaySec\u003C\u002Fstrong>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-285\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>控制成功\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>202\u003C\u002Ftd>\n\u003Ctd>已接受，延遲執行中\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>參數錯誤\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>插座不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>409\u003C\u002Ftd>\n\u003Ctd>插座操作中\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-286\">POST https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>重設插座能耗計數。重設該插座能耗計數。\u003C\u002Fp>\n\u003Cp>請求 body 可為空物件 \u003Ccode>{}\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Ch4 id=\"section-287\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>重設成功\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>插座不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>500\u003C\u002Ftd>\n\u003Ctd>裝置不支援或內部錯誤\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Chr>\n\u003Ch1 id=\"section-288\">插座群組（OutletGroups）\u003C\u002Fh1>\n\u003Cp>DMTF DSP2056 標準資源。依資料庫群組定義，一次控制多個插座。路徑固定於 \u003Ccode>RackPDUs\u002F1\u002FOutletGroups\u003C\u002Fcode>（非 OCP Rack PDU Profile 必填）。\u003C\u002Fp>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>權限\u003C\u002Fstrong>：預設見 認證（控制 Action 與寫入至少 \u003Cstrong>Operator\u003C\u002Fstrong>）。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch3 id=\"section-289\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutletGroups\",\n  \"Members\": [\n    { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutletGroups\u002F1\" }\n  ],\n  \"Members@odata.count\": 1\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cblockquote>\n\u003Cp>集合回應目前\u003Cstrong>未含\u003C\u002Fstrong> \u003Ccode>@odata.type\u003C\u002Fcode>。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch3 id=\"section-290\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutletGroups\u002F1\",\n  \"@odata.type\": \"#OutletGroup.v1_2_0.OutletGroup\",\n  \"Id\": \"1\",\n  \"Name\": \"Group A\",\n  \"PowerState\": \"On\",\n  \"Status\": { \"State\": \"Enabled\", \"Health\": \"OK\" },\n  \"Links\": {\n    \"Outlets\": [\n      { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets\u002F1\" },\n      { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets\u002F2\" }\n    ]\n  },\n  \"Actions\": {\n    \"#OutletGroup.PowerControl\": {\n      \"target\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutletGroups\u002F1\u002FActions\u002FOutletGroup.PowerControl\"\n    }\n  },\n  \"Oem\": { \"Pelx\": { \"uId\": 1 } }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cul>\n\u003Cli>\u003Cstrong>PowerState\u003C\u002Fstrong>：群組內任一插座為 \u003Ccode>Off\u003C\u002Fcode> 時為 \u003Ccode>Off\u003C\u002Fcode>，否則為 \u003Ccode>On\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Links.Outlets\u003C\u002Fstrong>：群組成員插座連結\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Actions.#OutletGroup.PowerControl\u003C\u002Fstrong>：批次電源控制（參數同 \u003Ccode>Outlet.PowerControl\u003C\u002Fcode>）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3 id=\"section-291\">POST https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>對群組內所有插座執行電源控制。請求 body 同 \u003Ccode>Outlet.PowerControl\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Ch4 id=\"section-292\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>控制成功\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>參數錯誤\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>群組不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Chr>\n\u003Ch1 id=\"section-293\">環境感測（Thermal）\u003C\u002Fh1>\n\u003Cp>環境溫度資料來源為溫濕度感測週邊。OCP Baseline 與 DMTF Service Validator 以 \u003Cstrong>\u003Ccode>ThermalSubsystem\u003C\u002Fcode>／\u003Ccode>ThermalMetrics\u003C\u002Fcode>\u003C\u002Fstrong> 為主路徑；\u003Ccode>Chassis\u002F1\u002FThermal\u003C\u002Fcode> 仍保留相容舊整合，但 Chassis 資源已不再連結 \u003Ccode>Thermal\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Ch3 id=\"section-294\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>熱管理子系統（OCP Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FThermalSubsystem\",\n  \"@odata.type\": \"#ThermalSubsystem.v1_3_0.ThermalSubsystem\",\n  \"Id\": \"ThermalSubsystem\",\n  \"Name\": \"Thermal Subsystem\",\n  \"Status\": {\n    \"State\": \"Enabled\",\n    \"Health\": \"OK\"\n  },\n  \"Fans\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FThermalSubsystem\u002FFans\"\n  },\n  \"ThermalMetrics\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FThermalSubsystem\u002FThermalMetrics\"\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-295\">欄位說明\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>Fans\u003C\u002Fstrong>: 風扇集合（本設備通常為空集合）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ThermalMetrics\u003C\u002Fstrong>: 溫度彙總與讀值連結\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3 id=\"section-296\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>溫度讀值與摘要（DMTF \u003Ccode>ThermalMetrics\u003C\u002Fcode> excerpt 格式）。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FThermalSubsystem\u002FThermalMetrics\",\n  \"@odata.type\": \"#ThermalMetrics.v1_3_0.ThermalMetrics\",\n  \"Id\": \"ThermalMetrics\",\n  \"Name\": \"Thermal Metrics\",\n  \"TemperatureReadingsCelsius\": [\n    {\n      \"DataSourceUri\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FTemp1\",\n      \"Reading\": 26.5,\n      \"PhysicalContext\": \"Room\"\n    }\n  ],\n  \"TemperatureSummaryCelsius\": {\n    \"Ambient\": {\n      \"Reading\": 26.5,\n      \"DataSourceUri\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FTemp1\"\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-297\">欄位說明\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>TemperatureReadingsCelsius\u003C\u002Fstrong>: 溫度讀值陣列（\u003Cstrong>excerpt\u003C\u002Fstrong> 格式）\u003Cul>\n\u003Cli>\u003Cstrong>DataSourceUri\u003C\u002Fstrong>: 指向 \u003Ccode>Chassis\u002F1\u002FSensors\u002FTemp{n}\u003C\u002Fcode>（OCP Sensor 路徑）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Reading\u003C\u002Fstrong>: 溫度（°C）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PhysicalContext\u003C\u002Fstrong>: 物理情境，如 \u003Ccode>Room\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>TemperatureSummaryCelsius\u003C\u002Fstrong>: 摘要物件（\u003Cstrong>非\u003C\u002Fstrong> \u003Ccode>AverageReading\u003C\u002Fcode>／\u003Ccode>MaxReading\u003C\u002Fcode>／\u003Ccode>MinReading\u003C\u002Fcode>）\u003Cul>\n\u003Cli>\u003Cstrong>Ambient\u003C\u002Fstrong>: 第一個感測點讀值\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Internal\u003C\u002Fstrong>: 多感測點時為平均值（僅一點時省略）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cblockquote>\n\u003Cp>\u003Ccode>EnvironmentMetrics\u003C\u002Fcode> \u003Cstrong>不含\u003C\u002Fstrong> \u003Ccode>TemperatureSummaryCelsius\u003C\u002Fcode>；溫度摘要僅在 \u003Ccode>ThermalMetrics\u003C\u002Fcode> 提供。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch3 id=\"section-298\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>溫度感測器與電氣 Sensor 共用 \u003Ccode>Chassis\u002F1\u002FSensors\u003C\u002Fcode> 集合；\u003Ccode>{id}\u003C\u002Fcode> 為 \u003Ccode>Temp\u003C\u002Fcode> + \u003Ccode>TEMPRH.elements.id\u003C\u002Fcode>（如 \u003Ccode>Temp1\u003C\u002Fcode>）。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FSensors\u002FTemp1\",\n  \"@odata.type\": \"#Sensor.v1_9_0.Sensor\",\n  \"Id\": \"Temp1\",\n  \"Name\": \"Temp1 Temperature\",\n  \"Reading\": 26.5,\n  \"ReadingUnits\": \"C\",\n  \"ReadingType\": \"Temperature\",\n  \"ReadingTime\": \"2026-06-15T10:00:05+08:00\",\n  \"SensingInterval\": \"PT5S\",\n  \"Status\": {\n    \"State\": \"Enabled\",\n    \"Health\": \"OK\"\n  },\n  \"Oem\": {\n    \"Pelx\": {\n      \"@odata.type\": \"#Pelx.v1_0_0.Pelx\",\n      \"Interface\": {\n        \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FAI00301\"\n      },\n      \"RackPduSensorUri\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FSensors\u002FTemp1\"\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch3 id=\"section-299\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>機箱環境彙總（可含進線功率 \u003Ccode>PowerWatts\u003C\u002Fcode>）；\u003Cstrong>不含\u003C\u002Fstrong>溫度摘要欄位。\u003C\u002Fp>\n\u003Ch3 id=\"section-300\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>舊版 \u003Ccode>Thermal.v1_7_3\u003C\u002Fcode> 資源，仍可直接 \u003Ccode>GET\u003C\u002Fcode> 取得 \u003Ccode>Temperatures[]\u003C\u002Fcode> 與 \u003Ccode>ReadingCelsius\u003C\u002Fcode>。\u003Cstrong>不含\u003C\u002Fstrong> \u003Ccode>Oem.Pelx\u003C\u002Fcode> 連結；新整合請改用 \u003Ccode>ThermalSubsystem\u003C\u002Fcode>／\u003Ccode>Sensors\u002FTemp{n}\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\u002FThermal\",\n  \"@odata.type\": \"#Thermal.v1_7_3.Thermal\",\n  \"Id\": \"Thermal\",\n  \"Temperatures\": [\n    {\n      \"MemberId\": \"1\",\n      \"Name\": \"Temp1\",\n      \"ReadingCelsius\": 26.5,\n      \"Status\": {\n        \"State\": \"Enabled\",\n        \"Health\": \"OK\"\n      }\n    }\n  ],\n  \"Fans\": []\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cul>\n\u003Cli>濕度等量測若無標準 \u003Ccode>Thermal\u003C\u002Fcode>／\u003Ccode>ThermalMetrics\u003C\u002Fcode> 欄位，請改查 \u003Ccode>Oem\u002FPelx\u002FInterfaces\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-301\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>資源不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Chr>\n\u003Ch1 id=\"section-302\">告警與事件（EventService）\u003C\u002Fh1>\n\u003Cp>OCP Rack PDU Profile 要求提供 \u003Ccode>EventService\u003C\u002Fcode>；標準事件訂閱見 \u003Ccode>Subscriptions\u003C\u002Fcode>。Pelx 另提供 \u003Ccode>Events\u003C\u002Fcode> 作為目前告警快照（非 OCP 必填，見「Pelx 擴充」）。\u003C\u002Fp>\n\u003Cblockquote>\n\u003Cp>若整合環境中設備無法被外部主動連線（防火牆／NAT），可採 DMTF \u003Cstrong>OutboundConnection\u003C\u002Fstrong>（設備主動 WebSocket 連至雲端）；見 outbound connection。告警推送仍建議用本章 \u003Ccode>Subscriptions\u003C\u002Fcode>。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch3 id=\"section-303\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FEventService\",\n  \"@odata.type\": \"#EventService.v1_11_0.EventService\",\n  \"Id\": \"EventService\",\n  \"ServiceEnabled\": true,\n  \"DeliveryRetryAttempts\": 3,\n  \"DeliveryRetryIntervalSeconds\": 60,\n  \"RegistryPrefixes\": [\n    \"Power\",\n    \"SensorEvent\",\n    \"Update\"\n  ],\n  \"Subscriptions\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FEventService\u002FSubscriptions\"\n  },\n  \"Events\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FEventService\u002FEvents\"\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-304\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: EventService 資源 URI，固定 \u003Ccode>\u002Fredfish\u002Fv1\u002FEventService\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#EventService.v1_11_0.EventService\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 資源識別碼，固定 \u003Ccode>EventService\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ServiceEnabled\u003C\u002Fstrong>: 事件服務是否啟用（Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>DeliveryRetryAttempts\u003C\u002Fstrong>: 訂閱投遞重試次數（Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>DeliveryRetryIntervalSeconds\u003C\u002Fstrong>: 重試間隔秒數（Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>RegistryPrefixes\u003C\u002Fstrong>: 支援的 Registry 前綴（OCP \u003Cstrong>Recommended\u003C\u002Fstrong>）；PDU 建議含 \u003Ccode>Power\u003C\u002Fcode>、\u003Ccode>SensorEvent\u003C\u002Fcode>、\u003Ccode>Update\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Subscriptions\u003C\u002Fstrong>: 事件訂閱集合（Baseline \u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Events\u003C\u002Fstrong>: 目前告警快照（Pelx 擴充；對應 \u003Ccode>interfaces\u002Falarms\u003C\u002Fcode>）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-305\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-306\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FEventService\u002FSubscriptions\",\n  \"@odata.type\": \"#EventDestinationCollection.EventDestinationCollection\",\n  \"Members\": [],\n  \"Members@odata.count\": 0\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-307\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 訂閱集合 URI，固定 \u003Ccode>\u002Fredfish\u002Fv1\u002FEventService\u002FSubscriptions\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Members\u003C\u002Fstrong>: 訂閱資源連結陣列；\u003Ccode>POST\u003C\u002Fcode> 此集合建立新訂閱\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ca>Members@odata.count\u003C\u002Fa>\u003C\u002Fstrong>: 訂閱數量\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-308\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-309\">POST https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>建立事件訂閱。訂閱持久化於設備本機，重啟後自動載入。告警狀態變更時，設備會以 Redfish Event 格式 \u003Cstrong>POST\u003C\u002Fstrong> 至各訂閱的 \u003Ccode>Destination\u003C\u002Fcode>（依 \u003Ccode>DeliveryRetryAttempts\u003C\u002Fcode>／\u003Ccode>DeliveryRetryIntervalSeconds\u003C\u002Fcode> 重試）。若 \u003Ccode>Managers\u002F1\u002FNetworkProtocol.Proxy.Enabled\u003C\u002Fcode> 為 \u003Ccode>true\u003C\u002Fcode> 且 \u003Ccode>Destination\u003C\u002Fcode> 主機不在 \u003Ccode>ExcludeAddresses\u003C\u002Fcode>，投遞會經 HTTP\u002FHTTPS 代理（與 OutboundConnection 共用設定）。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"Destination\": \"https:\u002F\u002Fexample.com\u002Fredfish\u002Fevents\",\n  \"Protocol\": \"Redfish\",\n  \"Context\": \"Pelx monitoring\"\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-310\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>Destination\u003C\u002Fstrong>: 事件接收 URL（\u003Cstrong>Mandatory\u003C\u002Fstrong>）；須為有效 \u003Ccode>http:\u002F\u002F\u003C\u002Fcode> 或 \u003Ccode>https:\u002F\u002F\u003C\u002Fcode> URL\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Protocol\u003C\u002Fstrong>: 協定，預設 \u003Ccode>Redfish\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Context\u003C\u002Fstrong>: 訂閱識別字串，預設 \u003Ccode>Pelx\u003C\u002Fcode>；會附在推送 payload 的 \u003Ccode>Context\u003C\u002Fcode> 欄位\u003C\u002Fli>\n\u003Cli>\u003Cstrong>EventTypes\u003C\u002Fstrong>: 可選；如 \u003Ccode>[\"Alert\"]\u003C\u002Fcode> 僅推送告警，\u003Ccode>[\"StatusChange\"]\u003C\u002Fcode> 僅推送恢復／狀態變更；未指定則推送所有支援類型\u003C\u002Fli>\n\u003Cli>\u003Cstrong>HttpHeaders\u003C\u002Fstrong>: 可選；POST 至 \u003Ccode>Destination\u003C\u002Fcode> 時附加的 HTTP 標頭（如 \u003Ccode>Authorization\u003C\u002Fcode>）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>成功時回 \u003Ccode>201 Created\u003C\u002Fcode>，\u003Ccode>Location\u003C\u002Fcode> 指向 \u003Ccode>\u002Fredfish\u002Fv1\u002FEventService\u002FSubscriptions\u002F{id}\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Ch4 id=\"section-311\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>201\u003C\u002Ftd>\n\u003Ctd>建立成功\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>參數錯誤（缺 \u003Ccode>Destination\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-312\">OEM 擴充（Pelx）— 訂閱與推送 payload\u003C\u002Fh3>\n\u003Cp>為兼容既有整合欄位，可在\u003Cstrong>不改變標準 \u003Ccode>Subscriptions\u003C\u002Fcode> 路徑\u003C\u002Fstrong>的前提下，於請求與事件內容加上 \u003Ccode>Oem.Pelx\u003C\u002Fcode>。此作法不影響 OCP Baseline 必填欄位。\u003C\u002Fp>\n\u003Cp>建立訂閱（含 OEM 參數）範例：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"Destination\": \"https:\u002F\u002Fexample.com\u002Fredfish\u002Fevents\",\n  \"Protocol\": \"Redfish\",\n  \"Context\": \"Pelx monitoring\",\n  \"Oem\": {\n    \"Pelx\": {\n      \"DeliveryMode\": \"EventOnly\",\n      \"IncludeAlarmSeries\": false,\n      \"IncludeInterfaceSnapshot\": false\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-313\">OEM 欄位建議如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>Oem\u003C\u002Fstrong>: 廠商擴充欄位容器（可選）\u003Cul>\n\u003Cli>\u003Cstrong>Pelx\u003C\u002Fstrong>: Pelx OEM 命名空間（可選）\u003Cul>\n\u003Cli>\u003Cstrong>DeliveryMode\u003C\u002Fstrong>: 推送模式，建議值 \u003Ccode>EventOnly\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>IncludeAlarmSeries\u003C\u002Fstrong>: 是否附帶趨勢摘要（布林）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>IncludeInterfaceSnapshot\u003C\u002Fstrong>: 是否附帶介面快照（布林）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>若未指定 \u003Ccode>Oem.Pelx\u003C\u002Fcode>，推送 payload 仍含標準 Redfish Event 欄位；啟用 \u003Ccode>IncludeAlarmSeries\u003C\u002Fcode>／\u003Ccode>IncludeInterfaceSnapshot\u003C\u002Fcode> 時，於事件 payload 的 \u003Ccode>Oem.Pelx\u003C\u002Fcode> 附上 \u003Ccode>AlarmSeries\u003C\u002Fcode> 或 \u003Ccode>InterfaceSnapshot\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Cp>推送 payload 範例（POST 至 \u003Ccode>Destination\u003C\u002Fcode>）：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.type\": \"#Event.v1_7_0.Event\",\n  \"Name\": \"Event Array\",\n  \"Context\": \"Pelx monitoring\",\n  \"Events\": [\n    {\n      \"@odata.type\": \"#Event.v1_11_0.Event\",\n      \"Id\": \"1\",\n      \"Name\": \"High Warning\",\n      \"EventType\": \"Alert\",\n      \"Severity\": \"Warning\",\n      \"Message\": \"Infeed1 V High Warning\",\n      \"MessageId\": \"Pelx.1.0.highWarningAlarm\",\n      \"EventTimestamp\": \"2026-06-10T08:30:00Z\",\n      \"OriginOfCondition\": {\n        \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FAI2101\"\n      },\n      \"Oem\": {\n        \"Pelx\": {\n          \"@odata.type\": \"#Pelx.v1_0_0.Pelx\",\n          \"Interface\": {\n            \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FAI2101\"\n          },\n          \"Name\": \"Infeed1\",\n          \"Alias\": \"V\",\n          \"Value\": 241.2,\n          \"Unit\": \"V\",\n          \"Status\": \"hw\",\n          \"Seq\": 1\n        }\n      }\n    }\n  ]\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch3 id=\"section-314\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>查詢單一訂閱。\u003C\u002Fp>\n\u003Ch4 id=\"section-315\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>訂閱不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-316\">DELETE https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>刪除訂閱。\u003C\u002Fp>\n\u003Ch4 id=\"section-317\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>已刪除\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>訂閱不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-318\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>目前告警快照（\u003Cstrong>Pelx 擴充\u003C\u002Fstrong>。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FEventService\u002FEvents\",\n  \"Members\": [\n    {\n      \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FEventService\u002FEvents\u002F1\"\n    }\n  ],\n  \"Members@odata.count\": 1\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-319\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 事件集合資源 URI，固定 \u003Ccode>\u002Fredfish\u002Fv1\u002FEventService\u002FEvents\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Members\u003C\u002Fstrong>: 告警事件連結陣列，元素為 \u003Ccode>{ \"@odata.id\": \"...\" }\u003C\u002Fcode>\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 單一事件資源 URI，如 \u003Ccode>\u002Fredfish\u002Fv1\u002FEventService\u002FEvents\u002F1\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ca>Members@odata.count\u003C\u002Fa>\u003C\u002Fstrong>: \u003Ccode>Members\u003C\u002Fcode> 陣列筆數，目前告警事件數量\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-320\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-321\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FEventService\u002FEvents\u002F1\",\n  \"@odata.type\": \"#Event.v1_11_0.Event\",\n  \"Id\": \"1\",\n  \"Name\": \"High Warning\",\n  \"EventType\": \"Alert\",\n  \"Severity\": \"Warning\",\n  \"Message\": \"Infeed1 Voltage high warning\",\n  \"MessageId\": \"Pelx.1.0.VoltageHighWarning\",\n  \"Created\": \"2026-06-10T08:30:00Z\",\n  \"Oem\": {\n    \"Pelx\": {\n      \"@odata.type\": \"#Pelx.v1_0_0.Pelx\",\n      \"Interface\": {\n        \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FAI2101\"\n      },\n      \"Name\": \"Infeed1\",\n      \"Alias\": \"V\",\n      \"Value\": 241.2,\n      \"Unit\": \"V\",\n      \"Status\": \"hw\"\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-322\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>id\u003C\u002Fstrong>（路徑參數）: 事件識別碼\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 事件資源 URI，如 \u003Ccode>\u002Fredfish\u002Fv1\u002FEventService\u002FEvents\u002F1\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#Event.v1_11_0.Event\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 資源識別碼，與路徑參數 \u003Ccode>{id}\u003C\u002Fcode> 相同\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 事件顯示名稱，如 \u003Ccode>High Warning\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>EventType\u003C\u002Fstrong>: 事件類型，告警固定 \u003Ccode>Alert\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Severity\u003C\u002Fstrong>: 嚴重程度，\u003Ccode>Warning\u003C\u002Fcode> 對應 \u003Ccode>GET \u002Finterfaces\u002Falarms?kind=warnings\u003C\u002Fcode>；\u003Ccode>Critical\u003C\u002Fcode> 對應 \u003Ccode>kind=critical\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Message\u003C\u002Fstrong>: 人可讀告警訊息\u003C\u002Fli>\n\u003Cli>\u003Cstrong>MessageId\u003C\u002Fstrong>: 告警訊息識別碼，如 \u003Ccode>Pelx.1.0.VoltageHighWarning\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Created\u003C\u002Fstrong>: 事件時間（ISO 8601 UTC），如 \u003Ccode>2026-06-10T08:30:00Z\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem\u003C\u002Fstrong>: 廠商擴充欄位容器\u003Cul>\n\u003Cli>\u003Cstrong>Pelx\u003C\u002Fstrong>: Pelx OEM 命名空間\u003Cul>\n\u003Cli>\u003Cstrong>Interface\u003C\u002Fstrong>: 觸發告警的 Pelx 介面資源連結\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 週邊名稱\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Alias\u003C\u002Fstrong>: 介面別名\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Value\u003C\u002Fstrong>: 觸發時讀值\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Unit\u003C\u002Fstrong>: 單位\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Status\u003C\u002Fstrong>: 介面狀態碼（如 \u003Ccode>hw\u003C\u002Fcode>、\u003Ccode>hc\u003C\u002Fcode>）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-323\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>事件不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Chr>\n\u003Ch1 id=\"section-324\">OutboundConnection（出站 WebSocket 連線）\u003C\u002Fh1>\n\u003Cp>DMTF \u003Cstrong>Redfish 2023.2\u003C\u002Fstrong> 起新增 \u003Cstrong>OutboundConnection\u003C\u002Fstrong> schema（\u003Ccode>OutboundConnection.v1_0_2\u003C\u002Fcode>）：設備在防火牆或 NAT 後方時，可\u003Cstrong>主動\u003C\u002Fstrong>以 \u003Cstrong>WebSocket（\u003Ccode>wss:\u002F\u002F\u003C\u002Fcode>）\u003C\u002Fstrong> 連至外部服務（雲端 DCIM、事件閘道等），由遠端接收 Redfish 請求／回應，無須對設備開放 inbound 連線。\u003C\u002Fp>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>實作狀態\u003C\u002Fstrong>：\u003Cstrong>已實作\u003C\u002Fstrong>（hwctrl）。REST 設定／憑證管理、WebSocket 出站連線、Session 與 Redfish over WebSocket 隧道轉發均已支援。若僅需事件推送，仍可使用 告警與事件 之 \u003Ccode>EventService\u002FSubscriptions\u003C\u002Fcode>；高頻即時監控見 MQTT Discovery。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch3 id=\"section-325\">與其他推送機制的分工\u003C\u002Fh3>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>機制\u003C\u002Fth>\n\u003Cth>連線方向\u003C\u002Fth>\n\u003Cth>協議\u003C\u002Fth>\n\u003Cth>用途\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>OutboundConnection\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>設備 → 外部\u003C\u002Ftd>\n\u003Ctd>WebSocket（\u003Ccode>wss\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003Ctd>防火牆後設備主動連雲端；遠端以 Redfish over WS 操作\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>EventService\u002FSubscriptions\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>設備 → 外部\u003C\u002Ftd>\n\u003Ctd>HTTP POST\u003C\u002Ftd>\n\u003Ctd>OCP 標準告警／事件推送\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>MQTT over WebSocket\u003C\u002Fstrong>（Pelx OEM）\u003C\u002Ftd>\n\u003Ctd>外部 → 設備\u003C\u002Ftd>\n\u003Ctd>WebSocket + MQTT\u003C\u002Ftd>\n\u003Ctd>高頻即時監控；非 DMTF OutboundConnection\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-326\">資源路徑\u003C\u002Fh3>\n\u003Cp>OutboundConnection 掛於 \u003Cstrong>AccountService\u003C\u002Fstrong> 下（DMTF 慣例）：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>\u002Fredfish\u002Fv1\u002FAccountService\n└── OutboundConnections\u002F{id}     出站連線設定與狀態\n    ├── Certificates               遠端伺服器憑證（MTLS 驗證用）\n    └── ClientCertificates         設備端憑證（MTLS 用）\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>連線建立後，hwctrl 建立對應 \u003Cstrong>Session\u003C\u002Fstrong> 資源（\u003Ccode>Outbound-{id}\u003C\u002Fcode>）；\u003Ccode>Links.Session\u003C\u002Fcode> 指向該 Session。連線關閉時 Session 刪除。\u003C\u002Fp>\n\u003Ch3 id=\"section-327\">Web UI 與 sysctrl 對應\u003C\u002Fh3>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>項目\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>Web UI「Redfish 出站連線」\u003C\u002Ftd>\n\u003Ctd>僅管理 id=\u003Ccode>1\u003C\u002Fcode>；\u003Ccode>enabled\u003C\u002Fcode> 對應 \u003Ccode>ConnectionEnabled\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>多筆連線並存\u003C\u002Ftd>\n\u003Ctd>各 id 獨立；\u003Ccode>ConnectionEnabled: true\u003C\u002Fcode> 者重啟後皆會自動連線\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>詳見 modules\u002Fsysctrl\u002Fweb.md。\u003C\u002Fp>\n\u003Ch3 id=\"section-328\">使用限制\u003C\u002Fh3>\n\u003Cp>整合方與操作人員須注意下列限制（與 DMTF schema 不可變欄位及 Pelx id 保留策略有關）：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>限制\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>PATCH 不可改端點\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>EndpointURI\u003C\u002Fcode>、\u003Ccode>Authentication\u003C\u002Fcode>、\u003Ccode>Roles\u003C\u002Fcode>、\u003Ccode>PreUpgradeHTTPHeaders\u003C\u002Fcode> 建立後\u003Cstrong>不可\u003C\u002Fstrong>以 Redfish PATCH 修改；嘗試 PATCH 上述欄位回 \u003Cstrong>400\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>id≥\u003Ccode>2\u003C\u002Fcode> 改端點\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>須 Redfish \u003Cstrong>DELETE + POST\u003C\u002Fstrong> 重建（新 id 由伺服器自動分配，可能與刪除前不同）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>多筆連線並存\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>各 id 獨立運作、各自連線；\u003Ccode>ConnectionEnabled: true\u003C\u002Fcode> 者\u003Cstrong>重啟後皆會自動連線\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Redfish 須認證\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>GET\u003C\u002Fcode> 須 \u003Cstrong>Operator 以上\u003C\u002Fstrong>；\u003Ccode>POST\u003C\u002Fcode>／\u003Ccode>PATCH\u003C\u002Fcode>／\u003Ccode>DELETE\u003C\u002Fcode> 須 \u003Cstrong>Administrator\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>EndpointURI 須 wss\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>僅支援 \u003Ccode>wss:\u002F\u002F\u003C\u002Fcode>；\u003Ccode>ws:\u002F\u002F\u003C\u002Fcode> 或非 WebSocket URI 建立時回 \u003Cstrong>400\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>MTLS 憑證\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>須分別 \u003Ccode>POST\u003C\u002Fcode> 至 \u003Ccode>Certificates\u003C\u002Fcode>／\u003Ccode>ClientCertificates\u003C\u002Fcode>；Client 須含私鑰；GET 不回傳私鑰\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch4 id=\"section-329\">常見操作對照\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>目的\u003C\u002Fth>\n\u003Cth>建議做法\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>變更 id≥\u003Ccode>2\u003C\u002Fcode> 的遠端位址\u003C\u002Ftd>\n\u003Ctd>Redfish \u003Ccode>DELETE\u003C\u002Fcode> 後 \u003Ccode>POST\u003C\u002Fcode> 重建\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>額外雲端連線（非 Web UI）\u003C\u002Ftd>\n\u003Ctd>Redfish \u003Ccode>POST\u003C\u002Fcode>（得 id≥\u003Ccode>2\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-330\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>列出出站連線設定。\u003Cstrong>須 Operator 以上\u003C\u002Fstrong>。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FAccountService\u002FOutboundConnections\",\n  \"@odata.type\": \"#OutboundConnectionCollection.OutboundConnectionCollection\",\n  \"Members\": [],\n  \"Members@odata.count\": 0\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-331\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 集合 URI，固定 \u003Ccode>\u002Fredfish\u002Fv1\u002FAccountService\u002FOutboundConnections\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Members\u003C\u002Fstrong>: 各 OutboundConnection 資源連結\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ca>Members@odata.count\u003C\u002Fa>\u003C\u002Fstrong>: 連線設定數量\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-332\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足（ReadOnly）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-333\">POST https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>建立出站連線。\u003Cstrong>須 Administrator\u003C\u002Fstrong>。若 \u003Ccode>ConnectionEnabled\u003C\u002Fcode> 為 \u003Ccode>true\u003C\u002Fcode>，建立後即嘗試連線。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"Name\": \"cloud-dcim\",\n  \"Description\": \"Primary cloud gateway\",\n  \"EndpointURI\": \"wss:\u002F\u002Fdcim.example.com\u002Fredfish\u002Fws\",\n  \"Authentication\": \"MTLS\",\n  \"ConnectionEnabled\": true,\n  \"WebSocketPingIntervalMinutes\": 5,\n  \"Roles\": [\"Operator\"],\n  \"RetryPolicy\": {\n    \"ConnectionRetryPolicy\": \"RetryForever\",\n    \"RetryIntervalMinutes\": 5\n  },\n  \"PreUpgradeHTTPHeaders\": {\n    \"Authorization\": \"Bearer <token>\"\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-334\">請求欄位（\u003Ccode>requiredOnCreate\u003C\u002Fcode> 摘要）\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>EndpointURI\u003C\u002Fstrong>（必填）: 遠端 WebSocket URI；\u003Cstrong>須為 \u003Ccode>wss:\u002F\u002F\u003C\u002Fcode>\u003C\u002Fstrong>（RFC6455）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Authentication\u003C\u002Fstrong>（必填）: \u003Ccode>None\u003C\u002Fcode>｜\u003Ccode>MTLS\u003C\u002Fcode>｜\u003Ccode>JWT\u003C\u002Fcode>｜\u003Ccode>OEM\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Roles\u003C\u002Fstrong>（必填）: 遠端客戶端在此連線上擁有的 Redfish 角色（如 \u003Ccode>Operator\u003C\u002Fcode>）；hwctrl 以\u003Cstrong>第一個\u003C\u002Fstrong>角色建立 Session\u003C\u002Fli>\n\u003Cli>\u003Cstrong>WebSocketPingIntervalMinutes\u003C\u002Fstrong>（必填）: WebSocket ping 間隔（分）；\u003Ccode>0\u003C\u002Fcode> 表示不送 ping\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ConnectionEnabled\u003C\u002Fstrong>: 是否啟用；省略時預設 \u003Ccode>true\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PreUpgradeHTTPHeaders\u003C\u002Fstrong>: WebSocket 升級前送出的 HTTP 標頭（如 JWT 的 \u003Ccode>Authorization: Bearer ...\u003C\u002Fcode>）；儲存於設定檔，\u003Cstrong>GET 回應固定為空物件\u003C\u002Fstrong>（不洩漏敏感標頭）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>RetryPolicy\u003C\u002Fstrong>: 重連策略（\u003Ccode>None\u003C\u002Fcode>｜\u003Ccode>RetryForever\u003C\u002Fcode>｜\u003Ccode>RetryCount\u003C\u002Fcode>）及 \u003Ccode>RetryIntervalMinutes\u003C\u002Fcode>、\u003Ccode>RetryCount\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>成功時回 \u003Ccode>201 Created\u003C\u002Fcode>，\u003Ccode>Location\u003C\u002Fcode> 指向 \u003Ccode>\u002Fredfish\u002Fv1\u002FAccountService\u002FOutboundConnections\u002F{id}\u003C\u002Fcode>。\u003Ccode>{id}\u003C\u002Fcode> 由伺服器自動分配，\u003Cstrong>從 \u003Ccode>2\u003C\u002Fcode> 起\u003C\u002Fstrong>（\u003Ccode>1\u003C\u002Fcode> 保留給 sysctrl／Web UI）。\u003C\u002Fp>\n\u003Ch4 id=\"section-335\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>201\u003C\u002Ftd>\n\u003Ctd>已建立\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>參數錯誤（如 EndpointURI 非 \u003Ccode>wss:\u002F\u002F\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-336\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>查詢單一出站連線。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FAccountService\u002FOutboundConnections\u002F1\",\n  \"@odata.type\": \"#OutboundConnection.v1_0_2.OutboundConnection\",\n  \"Id\": \"1\",\n  \"Name\": \"cloud-dcim\",\n  \"Description\": \"Primary cloud gateway\",\n  \"EndpointURI\": \"wss:\u002F\u002Fdcim.example.com\u002Fredfish\u002Fws\",\n  \"Authentication\": \"MTLS\",\n  \"ConnectionEnabled\": true,\n  \"WebSocketPingIntervalMinutes\": 5,\n  \"Roles\": [\"Operator\"],\n  \"Status\": {\n    \"State\": \"Enabled\",\n    \"Health\": \"OK\"\n  },\n  \"RetryPolicy\": {\n    \"ConnectionRetryPolicy\": \"RetryForever\",\n    \"RetryIntervalMinutes\": 5\n  },\n  \"Certificates\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FAccountService\u002FOutboundConnections\u002F1\u002FCertificates\"\n  },\n  \"ClientCertificates\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FAccountService\u002FOutboundConnections\u002F1\u002FClientCertificates\"\n  },\n  \"Links\": {\n    \"Session\": {\n      \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FSessionService\u002FSessions\u002FOutbound-1\"\n    }\n  },\n  \"PreUpgradeHTTPHeaders\": {}\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-337\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>EndpointURI\u003C\u002Fstrong>: 遠端 WebSocket 端點（唯讀；建立後不可改）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Authentication\u003C\u002Fstrong>: 認證機制（唯讀）\u003Cul>\n\u003Cli>\u003Cstrong>MTLS\u003C\u002Fstrong>: 雙向 TLS；使用 \u003Ccode>Certificates\u003C\u002Fcode>／\u003Ccode>ClientCertificates\u003C\u002Fcode> 內 PEM\u003C\u002Fli>\n\u003Cli>\u003Cstrong>JWT\u003C\u002Fstrong>: 以 \u003Ccode>PreUpgradeHTTPHeaders\u003C\u002Fcode> 帶 Bearer Token（握手時送出）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>None\u003C\u002Fstrong>: 不帶客戶端憑證；\u003Ccode>wss\u003C\u002Fcode> 時若未上傳 \u003Ccode>Certificates\u003C\u002Fcode> 則不驗證伺服器憑證\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ConnectionEnabled\u003C\u002Fstrong>: 是否啟用；\u003Ccode>false\u003C\u002Fcode> 時關閉既有連線\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Roles\u003C\u002Fstrong>: 遠端客戶端權限角色（唯讀）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Status\u003C\u002Fstrong>: 連線狀態（唯讀）\u003Cul>\n\u003Cli>\u003Cstrong>State\u003C\u002Fstrong>: \u003Ccode>Enabled\u003C\u002Fcode>（\u003Ccode>ConnectionEnabled=true\u003C\u002Fcode>）或 \u003Ccode>Disabled\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Health\u003C\u002Fstrong>: 已連線為 \u003Ccode>OK\u003C\u002Fcode>；啟用但未連上為 \u003Ccode>Warning\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Links.Session\u003C\u002Fstrong>: 作用中 WebSocket 對應的 Session（\u003Ccode>Outbound-{id}\u003C\u002Fcode>）；無連線時為 \u003Ccode>null\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Certificates\u003C\u002Fstrong>／\u003Cstrong>ClientCertificates\u003C\u002Fstrong>: MTLS 憑證集合連結\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-338\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-339\">PATCH https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>更新可寫欄位。\u003Cstrong>須 Administrator\u003C\u002Fstrong>。變更後若連線已啟用，hwctrl 會重新套用設定（可能重連）。\u003C\u002Fp>\n\u003Cp>可 PATCH 欄位：\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>ConnectionEnabled\u003C\u002Fstrong>: 啟用／停用連線\u003C\u002Fli>\n\u003Cli>\u003Cstrong>WebSocketPingIntervalMinutes\u003C\u002Fstrong>: ping 間隔\u003C\u002Fli>\n\u003Cli>\u003Cstrong>RetryPolicy\u003C\u002Fstrong>: 重連策略（\u003Ccode>RetryIntervalMinutes\u003C\u002Fcode>、\u003Ccode>RetryCount\u003C\u002Fcode> 等）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>／\u003Cstrong>Description\u003C\u002Fstrong>: 顯示名稱（Pelx 延伸）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>\u003Ccode>EndpointURI\u003C\u002Fcode>、\u003Ccode>Authentication\u003C\u002Fcode>、\u003Ccode>Roles\u003C\u002Fcode>、\u003Ccode>PreUpgradeHTTPHeaders\u003C\u002Fcode> 建立後不可變更；須刪除後重建（id=\u003Ccode>1\u003C\u002Fcode> 見上方\u003Ca href=\"#%E4%BD%BF%E7%94%A8%E9%99%90%E5%88%B6\">使用限制\u003C\u002Fa>）。\u003C\u002Fp>\n\u003Ch4 id=\"section-340\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>已更新；body 為完整資源\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>參數錯誤\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-341\">DELETE https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>刪除出站連線設定並關閉作用中連線。\u003Cstrong>須 Administrator\u003C\u002Fstrong>。\u003C\u002Fp>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>id=\u003Ccode>1\u003C\u002Fcode> 注意\u003C\u002Fstrong>：可刪除，但 Redfish \u003Ccode>POST\u003C\u002Fcode> \u003Cstrong>無法\u003C\u002Fstrong>再建立 id=\u003Ccode>1\u003C\u002Fcode>；Web UI 連線須改由 sysctrl \u003Ccode>PATCH \u002Fredfish-outbound\u003C\u002Fcode> 恢復。見\u003Ca href=\"#%E4%BD%BF%E7%94%A8%E9%99%90%E5%88%B6\">使用限制\u003C\u002Fa>。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch4 id=\"section-342\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>204\u003C\u002Ftd>\n\u003Ctd>已刪除\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-343\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>列出遠端伺服器信任憑證（MTLS 驗證遠端用）。\u003Cstrong>須 Operator 以上\u003C\u002Fstrong>。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FAccountService\u002FOutboundConnections\u002F1\u002FCertificates\",\n  \"@odata.type\": \"#CertificateCollection.CertificateCollection\",\n  \"Members\": [\n    { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FAccountService\u002FOutboundConnections\u002F1\u002FCertificates\u002F1\" }\n  ],\n  \"Members@odata.count\": 1\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch3 id=\"section-344\">POST https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>上傳信任憑證 PEM。\u003Cstrong>須 Administrator\u003C\u002Fstrong>。成功回 \u003Ccode>201 Created\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"Name\": \"Remote CA\",\n  \"CertificateType\": \"PEM\",\n  \"CertificateString\": \"-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----\"\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>上傳後若連線已啟用，hwctrl 會重連以套用新憑證。\u003C\u002Fp>\n\u003Ch3 id=\"section-345\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>查詢單筆信任憑證（\u003Ccode>Certificate.v1_8_0\u003C\u002Fcode>）。\u003Cstrong>須 Operator 以上\u003C\u002Fstrong>。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FAccountService\u002FOutboundConnections\u002F1\u002FCertificates\u002F1\",\n  \"@odata.type\": \"#Certificate.v1_8_0.Certificate\",\n  \"Id\": \"1\",\n  \"Name\": \"Remote CA\",\n  \"CertificateType\": \"PEM\",\n  \"CertificateString\": \"-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----\",\n  \"Issuer\": { \"CommonName\": \"\" },\n  \"Subject\": { \"CommonName\": \"\" },\n  \"ValidNotBefore\": \"\",\n  \"ValidNotAfter\": \"\"\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch3 id=\"section-346\">DELETE https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>刪除信任憑證。\u003Cstrong>須 Administrator\u003C\u002Fstrong>。回 \u003Ccode>204 No Content\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Ch3 id=\"section-347\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>列出設備客戶端憑證。\u003Cstrong>須 Operator 以上\u003C\u002Fstrong>。格式同 \u003Ccode>Certificates\u003C\u002Fcode> 集合。\u003C\u002Fp>\n\u003Ch3 id=\"section-348\">POST https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>上傳客戶端憑證與私鑰。\u003Cstrong>須 Administrator\u003C\u002Fstrong>。\u003Cstrong>須同時提供\u003C\u002Fstrong> \u003Ccode>CertificateString\u003C\u002Fcode> 與 \u003Ccode>PrivateKeyString\u003C\u002Fcode>（PEM）。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"Name\": \"Device Client Cert\",\n  \"CertificateType\": \"PEM\",\n  \"CertificateString\": \"-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----\",\n  \"PrivateKeyString\": \"-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----\"\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>\u003Ccode>GET\u003C\u002Fcode> 單筆客戶端憑證時\u003Cstrong>不回傳\u003C\u002Fstrong> \u003Ccode>PrivateKeyString\u003C\u002Fcode>（僅內部儲存供 MTLS 握手）。\u003C\u002Fp>\n\u003Ch3 id=\"section-349\">GET／DELETE \u003Ccode>...\u002FClientCertificates\u002F{certId}\u003C\u002Fcode>\u003C\u002Fh3>\n\u003Cp>語意同 \u003Ccode>Certificates\u002F{certId}\u003C\u002Fcode>；DELETE 回 \u003Ccode>204\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>與 CertificateService 的差異\u003C\u002Fstrong>：\u003Ccode>CertificateService\u003C\u002Fcode> 管理設備\u003Cstrong>入站\u003C\u002Fstrong> HTTPS（\u003Ccode>https-server\u003C\u002Fcode>）；OutboundConnection 底下集合為\u003Cstrong>出站\u003C\u002Fstrong> MTLS 專用，路徑與儲存皆獨立。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch3 id=\"section-350\">Session（\u003Ccode>Outbound-{id}\u003C\u002Fcode>）\u003C\u002Fh3>\n\u003Cp>WebSocket 連線成功後，hwctrl 建立 Session：\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: \u003Ccode>Outbound-{id}\u003C\u002Fcode>（例如連線 \u003Ccode>1\u003C\u002Fcode> → \u003Ccode>Outbound-1\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>URI\u003C\u002Fstrong>: \u003Ccode>\u002Fredfish\u002Fv1\u002FSessionService\u002FSessions\u002FOutbound-{id}\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>權限\u003C\u002Fstrong>: 取自該連線 \u003Ccode>Roles[0]\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>隧道請求\u003C\u002Fstrong>: 遠端經 WebSocket 送出的 Redfish HTTP 請求，hwctrl 以該 Session 的 \u003Ccode>X-Auth-Token\u003C\u002Fcode> 轉發至本機 Redfish（\u003Ccode>127.0.0.1\u003C\u002Fcode>）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>刪除 \u003Ccode>Sessions\u002FOutbound-{id}\u003C\u002Fcode> 會關閉 WebSocket 並將 \u003Ccode>ConnectionEnabled\u003C\u002Fcode> 設為 \u003Ccode>false\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Ch3 id=\"section-351\">連線行為（hwctrl 實作）\u003C\u002Fh3>\n\u003Col>\n\u003Cli>\u003Ccode>ConnectionEnabled\u003C\u002Fcode> 為 \u003Ccode>true\u003C\u002Fcode> 時，向 \u003Ccode>EndpointURI\u003C\u002Fcode> 發起 WebSocket 握手；帶 \u003Ccode>Sec-WebSocket-Protocol: Redfish\u003C\u002Fcode> 及 \u003Ccode>PreUpgradeHTTPHeaders\u003C\u002Fcode>。\u003C\u002Fli>\n\u003Cli>若 \u003Ccode>Managers\u002F1\u002FNetworkProtocol.Proxy.Enabled\u003C\u002Fcode> 為 \u003Ccode>true\u003C\u002Fcode> 且目標主機不在 \u003Ccode>ExcludeAddresses\u003C\u002Fcode>，先對代理伺服器發 \u003Cstrong>HTTP CONNECT\u003C\u002Fstrong> 建立隧道，再於隧道內進行 TLS（\u003Ccode>wss\u003C\u002Fcode>）與 WebSocket 升級。\u003C\u002Fli>\n\u003Cli>握手成功後建立 \u003Ccode>Outbound-{id}\u003C\u002Fcode> Session；\u003Ccode>Links.Session\u003C\u002Fcode> 指向該資源。\u003C\u002Fli>\n\u003Cli>遠端在 WebSocket payload 送\u003Cstrong>完整 HTTP 請求\u003C\u002Fstrong>（method、path、headers、body）；hwctrl 回傳\u003Cstrong>完整 HTTP 回應\u003C\u002Fstrong>（相同 opcode）。\u003C\u002Fli>\n\u003Cli>依 \u003Ccode>WebSocketPingIntervalMinutes\u003C\u002Fcode> 送 ping；收到 ping 回 pong。\u003C\u002Fli>\n\u003Cli>斷線時依 \u003Cstrong>RetryPolicy\u003C\u002Fstrong> 重連：\u003Ccode>RetryForever\u003C\u002Fcode> 持續重試；\u003Ccode>RetryCount\u003C\u002Fcode> 超過次數或 \u003Ccode>None\u003C\u002Fcode> 時將 \u003Ccode>ConnectionEnabled\u003C\u002Fcode> 設為 \u003Ccode>false\u003C\u002Fcode>。\u003C\u002Fli>\n\u003Cli>遠端主動關閉 WebSocket 時，hwctrl 將 \u003Ccode>ConnectionEnabled\u003C\u002Fcode> 設為 \u003Ccode>false\u003C\u002Fcode> 並刪除 Session。\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Ch4 id=\"section-352\">已知限制（相對 DMTF 完整語意）\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>項目\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>ProxyAutoConfigURI\u003C\u002Fcode>（PAC）\u003C\u002Ftd>\n\u003Ctd>可儲存；連線尚未依 PAC 自動選路\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Authentication=OEM\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>接受欄位值，無額外 OEM 行為\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>多角色 \u003Ccode>Roles\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Session 僅採 \u003Ccode>Roles[0]\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>憑證中繼資料\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Issuer\u003C\u002Fcode>／\u003Ccode>Subject\u003C\u002Fcode>／有效期尚未自 PEM 解析\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>伺服器子協定\u003C\u002Ftd>\n\u003Ctd>未驗證回應 \u003Ccode>Sec-WebSocket-Protocol\u003C\u002Fcode> 是否為 \u003Ccode>Redfish\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-353\">curl 範例\u003C\u002Fh3>\n\u003Cpre>\u003Ccode># 列出出站連線\ncurl -sk -u admin:'<password>' \\\n  https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FAccountService\u002FOutboundConnections\n\n# 建立 MTLS 出站連線\ncurl -sk -u admin:'<password>' -X POST \\\n  https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FAccountService\u002FOutboundConnections \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -d '{\n    \"Name\": \"cloud-dcim\",\n    \"EndpointURI\": \"wss:\u002F\u002Fdcim.example.com\u002Fredfish\u002Fws\",\n    \"Authentication\": \"MTLS\",\n    \"ConnectionEnabled\": true,\n    \"WebSocketPingIntervalMinutes\": 5,\n    \"Roles\": [\"Operator\"],\n    \"RetryPolicy\": {\n      \"ConnectionRetryPolicy\": \"RetryForever\",\n      \"RetryIntervalMinutes\": 5\n    }\n  }'\n\n# 上傳遠端 CA\ncurl -sk -u admin:'<password>' -X POST \\\n  https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FAccountService\u002FOutboundConnections\u002F1\u002FCertificates \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -d @remote-ca.json\n\n# 上傳客戶端憑證（含私鑰）\ncurl -sk -u admin:'<password>' -X POST \\\n  https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FAccountService\u002FOutboundConnections\u002F1\u002FClientCertificates \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -d @client-cert.json\n\n# 停用連線\ncurl -sk -u admin:'<password>' -X PATCH \\\n  https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FAccountService\u002FOutboundConnections\u002F1 \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -d '{\"ConnectionEnabled\": false}'\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch3 id=\"section-354\">持久化與權限\u003C\u002Fh3>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>項目\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>GET\u003C\u002Fcode> 集合／單筆／憑證\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Operator 以上\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>POST\u003C\u002Fcode>／\u003Ccode>PATCH\u003C\u002Fcode>／\u003Ccode>DELETE\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Administrator\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>OCP Profile\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>非\u003C\u002Fstrong> Rack PDU Profile 必填；屬 DMTF Service Baseline 選配（Redfish 2023.2+）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-355\">相關章節\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>認證 — AccountService、\u003Ccode>SessionService\u003C\u002Fcode>、\u003Ccode>CertificateService\u003C\u002Fcode>（入站 HTTPS）\u003C\u002Fli>\n\u003Cli>告警與事件 — EventService\u002FSubscriptions（HTTP 事件推送）\u003C\u002Fli>\n\u003Cli>MQTT Discovery — MQTT over WebSocket（Pelx 即時監控）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch1 id=\"section-356\">歷史訊息（LogServices）\u003C\u002Fh1>\n\u003Cp>事件／操作 \u003Cstrong>Log 歷史\u003C\u002Fstrong>使用 \u003Ccode>Managers\u002F1\u002FLogServices\u003C\u002Fcode>。數值趨勢／圖表 API 見下方 \u003Cstrong>歷史趨勢（TelemetryService）\u003C\u002Fstrong>。\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>需求\u003C\u002Fth>\n\u003Cth>入口\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>插座操作、系統操作 Log\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>...\u002FLogServices\u002FOperational\u003C\u002Fcode> → \u003Ccode>Entries\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>登入／登出稽核\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>...\u002FLogServices\u002FAudit\u003C\u002Fcode> → \u003Ccode>Entries\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>主機補同步事件\u003C\u002Fstrong>（依 seq 區間）\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>...\u002FLogServices\u002FOem\u002FPelx\u002FMaxSeq\u003C\u002Fcode>、\u003Ccode>...\u002FLogServices\u002FOem\u002FPelx\u002FLogSync\u003C\u002Fcode>（見下文）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-357\">Operational 與 Audit 的區別\u003C\u002Fh3>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Log 服務\u003C\u002Fth>\n\u003Cth>內容\u003C\u002Fth>\n\u003Cth>\u003Ccode>Oem.Pelx\u003C\u002Fcode> 常見欄位\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>Operational\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>插座開關等操作（\u003Ccode>webOutletCtrl\u003C\u002Fcode> 等）\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Action\u003C\u002Fcode>、\u003Ccode>OutletId\u003C\u002Fcode>、\u003Ccode>PowerState\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Audit\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>登入、登出\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Username\u003C\u002Fcode>、\u003Ccode>Ip\u003C\u002Fcode>（\u003Cstrong>無\u003C\u002Fstrong> \u003Ccode>Action\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-358\">與 EventService、TelemetryService 的區別\u003C\u002Fh3>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>服務\u003C\u002Fth>\n\u003Cth>用途\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>TelemetryService\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>歷史量測、趨勢圖（見下方）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>LogServices\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>稽核、操作紀錄、系統 Log 流水帳\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>EventService\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>目前\u003C\u002Fstrong>告警／事件列表（見上方）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>探索時須依 \u003Ccode>Managers\u002F1\u003C\u002Fcode> 的 \u003Ccode>@odata.id\u003C\u002Fcode> 與 \u003Ccode>Members\u003C\u002Fcode> 走訪，勿猜 URL。\u003C\u002Fp>\n\u003Chr>\n\u003Ch3 id=\"section-359\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>管理器的 Log 服務集合；本文件以 \u003Ccode>Managers\u002F{managerId}\u003C\u002Fcode> 為例（路徑依 \u003Ccode>Managers\u003C\u002Fcode> 成員 \u003Ccode>@odata.id\u003C\u002Fcode> 為準）。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FManagers\u002F1\u002FLogServices\",\n  \"@odata.type\": \"#LogServiceCollection.LogServiceCollection\",\n  \"Members\": [\n    {\n      \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FManagers\u002F1\u002FLogServices\u002FOperational\"\n    },\n    {\n      \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FManagers\u002F1\u002FLogServices\u002FAudit\"\n    }\n  ],\n  \"Members@odata.count\": 2,\n  \"Oem\": {\n    \"Pelx\": {\n      \"MaxSeq\": {\n        \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FManagers\u002F1\u002FLogServices\u002FOem\u002FPelx\u002FMaxSeq\"\n      },\n      \"LogSync\": {\n        \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FManagers\u002F1\u002FLogServices\u002FOem\u002FPelx\u002FLogSync\"\n      }\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-360\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 集合 URI，如 \u003Ccode>\u002Fredfish\u002Fv1\u002FManagers\u002F1\u002FLogServices\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 集合型別\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Members\u003C\u002Fstrong>: Log 服務連結陣列\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 單一 LogService URI，如 \u003Ccode>...\u002FLogServices\u002FOperational\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ca>Members@odata.count\u003C\u002Fa>\u003C\u002Fstrong>: Log 服務數量\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem.Pelx.MaxSeq\u003C\u002Fstrong> \u002F \u003Cstrong>LogSync\u003C\u002Fstrong>: 主機依 \u003Cstrong>seq\u003C\u002Fstrong> 補同步設備事件之 OEM 資源連結（非 DMTF 標準；詳下文）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-361\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>資源不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Chr>\n\u003Ch3 id=\"section-362\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>單一 Log 服務，描述日誌容量、覆寫策略與 Entries 集合連結。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FManagers\u002F1\u002FLogServices\u002FOperational\",\n  \"@odata.type\": \"#LogService.v1_5_0.LogService\",\n  \"Id\": \"Operational\",\n  \"Name\": \"Operational Log\",\n  \"ServiceEnabled\": true,\n  \"LogEntryType\": \"Event\",\n  \"LogPurposes\": [\"Operations\"],\n  \"OverWritePolicy\": \"WrapsWhenFull\",\n  \"MaxNumberOfRecords\": 2000,\n  \"DateTime\": \"2026-06-15T10:00:00+08:00\",\n  \"DateTimeLocalOffset\": \"+08:00\",\n  \"Entries\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FManagers\u002F1\u002FLogServices\u002FOperational\u002FEntries\"\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-363\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>{logId}\u003C\u002Fstrong>（路徑參數）: Log 服務識別碼，如 \u003Ccode>Operational\u003C\u002Fcode>、\u003Ccode>Audit\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: LogService URI\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，如 \u003Ccode>#LogService.v1_5_0.LogService\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 與 \u003Ccode>{logId}\u003C\u002Fcode> 相同\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 顯示名稱\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ServiceEnabled\u003C\u002Fstrong>: 是否啟用\u003C\u002Fli>\n\u003Cli>\u003Cstrong>LogEntryType\u003C\u002Fstrong>: 日誌項目型別（\u003Ccode>Event\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>LogPurposes\u003C\u002Fstrong>: 日誌用途；\u003Ccode>Operational\u003C\u002Fcode> 為 \u003Ccode>Operations\u003C\u002Fcode>，\u003Ccode>Audit\u003C\u002Fcode> 為 \u003Ccode>Audit\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>OverWritePolicy\u003C\u002Fstrong>: 滿載策略，如 \u003Ccode>WrapsWhenFull\u003C\u002Fcode>（循環覆寫）、\u003Ccode>NeverOverWrites\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>MaxNumberOfRecords\u003C\u002Fstrong>: 最大保存筆數；依產品規格為 \u003Cstrong>2000\u003C\u002Fstrong>（小容量）或 \u003Cstrong>10000\u003C\u002Fstrong>（大容量），對應 history 事件庫容量\u003C\u002Fli>\n\u003Cli>\u003Cstrong>DateTime\u003C\u002Fstrong>: 管理器目前時間（ISO 8601）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>DateTimeLocalOffset\u003C\u002Fstrong>: 本地時區偏移（ISO 8601）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Entries\u003C\u002Fstrong>: 日誌項目集合連結\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: \u003Ccode>\u002Fredfish\u002Fv1\u002FManagers\u002F1\u002FLogServices\u002F{logId}\u002FEntries\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-364\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>Log 服務不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Chr>\n\u003Ch3 id=\"section-365\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>日誌項目集合，含歷史操作與系統事件。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FManagers\u002F1\u002FLogServices\u002FOperational\u002FEntries\",\n  \"@odata.type\": \"#LogEntryCollection.LogEntryCollection\",\n  \"Members\": [\n    {\n      \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FManagers\u002F1\u002FLogServices\u002FOperational\u002FEntries\u002F1\"\n    }\n  ],\n  \"Members@odata.count\": 1\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-366\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>{logId}\u003C\u002Fstrong>（路徑參數）: 上層 Log 服務識別碼\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: Entries 集合 URI\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Members\u003C\u002Fstrong>: 日誌項目連結陣列\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 單一 Entry URI\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ca>Members@odata.count\u003C\u002Fa>\u003C\u002Fstrong>: 日誌筆數\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-367\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>資源不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Chr>\n\u003Ch3 id=\"section-368\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>單一日誌項目。\u003Ccode>{logId}\u003C\u002Fcode> 為 \u003Ccode>Operational\u003C\u002Fcode> 或 \u003Ccode>Audit\u003C\u002Fcode> 時，\u003Cstrong>Oem.Pelx 欄位不同\u003C\u002Fstrong>（見上表）；請勿將插座操作欄位套用於 Audit。\u003C\u002Fp>\n\u003Ch4 id=\"section-369\">Operational — 插座操作範例\u003C\u002Fh4>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FManagers\u002F1\u002FLogServices\u002FOperational\u002FEntries\u002F1\",\n  \"@odata.type\": \"#LogEntry.v1_15_0.LogEntry\",\n  \"Id\": \"1\",\n  \"Name\": \"Outlet Power Control\",\n  \"EntryType\": \"Event\",\n  \"Severity\": \"OK\",\n  \"Created\": \"2026-06-10T09:15:00+08:00\",\n  \"Message\": \"Outlet %1 power turned %2 by %3\",\n  \"MessageId\": \"Pelx.1.0.OutletPowerOff\",\n  \"MessageArgs\": [\"1\", \"Off\", \"admin\"],\n  \"EventGroupId\": \"Pelx.Operational\",\n  \"Oem\": {\n    \"Pelx\": {\n      \"Action\": \"Outlet.PowerControl\",\n      \"OutletId\": \"1\",\n      \"PowerState\": \"Off\"\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-370\">Audit — 登入／登出範例\u003C\u002Fh4>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FManagers\u002F1\u002FLogServices\u002FAudit\u002FEntries\u002F1\",\n  \"@odata.type\": \"#LogEntry.v1_15_0.LogEntry\",\n  \"Id\": \"1\",\n  \"Name\": \"User Login\",\n  \"EntryType\": \"Event\",\n  \"Severity\": \"OK\",\n  \"Created\": \"2026-06-10T08:00:00+08:00\",\n  \"Message\": \"User %1 logged in from %2\",\n  \"MessageId\": \"Pelx.1.0.UserLogin\",\n  \"MessageArgs\": [\"admin\", \"192.168.1.10\"],\n  \"EventGroupId\": \"Pelx.Audit\",\n  \"Oem\": {\n    \"Pelx\": {\n      \"Username\": \"admin\",\n      \"Ip\": \"192.168.1.10\"\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-371\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>{logId}\u003C\u002Fstrong>（路徑參數）: Log 服務識別碼，\u003Ccode>Operational\u003C\u002Fcode> 或 \u003Ccode>Audit\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>{entryId}\u003C\u002Fstrong>（路徑參數）: 日誌項目識別碼\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: Entry URI\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，如 \u003Ccode>#LogEntry.v1_15_0.LogEntry\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 與 \u003Ccode>{entryId}\u003C\u002Fcode> 相同\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 事件摘要標題\u003C\u002Fli>\n\u003Cli>\u003Cstrong>EntryType\u003C\u002Fstrong>: 項目類型，如 \u003Ccode>Event\u003C\u002Fcode>、\u003Ccode>Oem\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Severity\u003C\u002Fstrong>: 嚴重程度，\u003Ccode>OK\u003C\u002Fcode> \u002F \u003Ccode>Warning\u003C\u002Fcode> \u002F \u003Ccode>Critical\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Created\u003C\u002Fstrong>: 事件時間（ISO 8601，可含時區）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Message\u003C\u002Fstrong>: 人可讀訊息；可由日誌 \u003Cstrong>template\u003C\u002Fstrong> 與參數組合（未必含 \u003Ccode>%1\u003C\u002Fcode> 占位）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>MessageId\u003C\u002Fstrong>: 訊息識別碼\u003C\u002Fli>\n\u003Cli>\u003Cstrong>MessageArgs\u003C\u002Fstrong>: 訊息參數陣列（Baseline \u003Cstrong>Recommended\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>EventGroupId\u003C\u002Fstrong>: 事件群組識別碼（Baseline \u003Cstrong>Recommended\u003C\u002Fstrong>）；固定 \u003Ccode>Pelx.Operational\u003C\u002Fcode> 或 \u003Ccode>Pelx.Audit\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem\u003C\u002Fstrong>: 廠商擴充（可選）\u003Cul>\n\u003Cli>\u003Cstrong>Pelx\u003C\u002Fstrong>:\u003Cul>\n\u003Cli>\u003Cstrong>Operational\u003C\u002Fstrong>：\u003Ccode>Action\u003C\u002Fcode>（如 \u003Ccode>Outlet.PowerControl\u003C\u002Fcode>）、\u003Ccode>OutletId\u003C\u002Fcode>、\u003Ccode>PowerState\u003C\u002Fcode>（\u003Ccode>On\u003C\u002Fcode>／\u003Ccode>Off\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Audit\u003C\u002Fstrong>：\u003Ccode>Username\u003C\u002Fcode>、\u003Ccode>Ip\u003C\u002Fcode>（登入／登出來源；\u003Cstrong>不含\u003C\u002Fstrong> \u003Ccode>Action\u003C\u002Fcode>）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-372\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>日誌項目不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Chr>\n\u003Ch2 id=\"section-373\">主機事件補同步（Pelx OEM）\u003C\u002Fh2>\n\u003Cp>設備事件平時寫入本機 \u003Cstrong>history\u003C\u002Fstrong>（``）；\u003Cstrong>統一中控／DCIM 主機\u003C\u002Fstrong>若因離線、重啟或上報失敗而缺少部分紀錄，可透過下列 Redfish API 依 \u003Cstrong>seq 流水號\u003C\u002Fstrong> 分批拉回。。\u003C\u002Fp>\n\u003Cp>事件庫保存容量：\u003Cstrong>小容量 2000 筆\u003C\u002Fstrong>、\u003Cstrong>大容量 10000 筆\u003C\u002Fstrong>（循環覆寫）。\u003C\u002Fp>\n\u003Cp>訊息 \u003Ccode>template\u003C\u002Fcode>／\u003Ccode>args\u003C\u002Fcode> 語意見 歷史訊息格式說明。\u003C\u002Fp>\n\u003Ch3 id=\"section-374\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>查詢設備事件庫目前\u003Cstrong>最大流水號\u003C\u002Fstrong>，供主機決定 \u003Ccode>LogSync\u003C\u002Fcode> 的 \u003Ccode>toSeq\u003C\u002Fcode> 或判斷是否尚有未同步紀錄。\u003C\u002Fp>\n\u003Ch4 id=\"section-375\">回傳資料格式如下:\u003C\u002Fh4>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FManagers\u002F1\u002FLogServices\u002FOem\u002FPelx\u002FMaxSeq\",\n  \"@odata.type\": \"#PelxLogMaxSeq.v1_0_0.PelxLogMaxSeq\",\n  \"maxSeq\": 5230\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-376\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>maxSeq\u003C\u002Fstrong>: 設備上最新一筆事件之 \u003Ccode>seq\u003C\u002Fcode>；尚無任何事件時為 \u003Cstrong>0\u003C\u002Fstrong>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-377\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Chr>\n\u003Ch3 id=\"section-378\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>依 \u003Cstrong>seq 區間\u003C\u002Fstrong> 拉回事件列，供主機補足缺失紀錄。單次\u003Cstrong>最多回傳 100 筆\u003C\u002Fstrong>（\u003Ccode>seq\u003C\u002Fcode> 遞增）；區間超過 100 筆時僅回傳自 \u003Ccode>fromSeq\u003C\u002Fcode> 起連續 100 筆，主機須分批再查。\u003C\u002Fp>\n\u003Ch4 id=\"section-379\">查詢參數\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>參數\u003C\u002Fth>\n\u003Cth>必填\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>fromSeq\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>是\u003C\u002Ftd>\n\u003Ctd>查詢起始流水號（\u003Cstrong>含\u003C\u002Fstrong>）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>toSeq\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>是\u003C\u002Ftd>\n\u003Ctd>查詢結束流水號（\u003Cstrong>含\u003C\u002Fstrong>）；須 \u003Ccode>toSeq >= fromSeq\u003C\u002Fcode>，且不建議大於設備 \u003Ccode>maxSeq\u003C\u002Fcode>（可先呼叫 \u003Ccode>MaxSeq\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>lang\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>是\u003C\u002Ftd>\n\u003Ctd>語系：\u003Ccode>zh-hant\u003C\u002Fcode> 或 \u003Ccode>en-us\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>單次回傳筆數：\u003Ccode>min(toSeq - fromSeq + 1, 100)\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Ch4 id=\"section-380\">回傳資料格式如下:\u003C\u002Fh4>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FManagers\u002F1\u002FLogServices\u002FOem\u002FPelx\u002FLogSync\",\n  \"@odata.type\": \"#PelxLogSync.v1_0_0.PelxLogSync\",\n  \"fromSeq\": 1001,\n  \"toSeq\": 1100,\n  \"count\": 100,\n  \"maxCount\": 100,\n  \"deviceId\": \"device1\",\n  \"columns\": [\"seq\", \"time\", \"level\", \"username\", \"template\", \"args\", \"alarmSeries\", \"msg\"],\n  \"data\": [\n    {\n      \"seq\": 1001,\n      \"time\": 1627453800000,\n      \"level\": 5,\n      \"username\": \"admin\",\n      \"template\": \"highWarningAlarm\",\n      \"args\": \"{\\\"iAValue\\\":30,\\\"iName\\\":\\\"室內溫度\\\",\\\"iUnit\\\":\\\"°C\\\",\\\"iValue\\\":50.0}\",\n      \"alarmSeries\": [\n        { \"time\": 1634114700, \"value\": 5 }\n      ],\n      \"msg\": \"[溫濕度1]濕度回覆正常[59%]\"\n    }\n  ]\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-381\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>fromSeq\u003C\u002Fstrong> \u002F \u003Cstrong>toSeq\u003C\u002Fstrong>: 本次請求之查詢區間（與查詢參數相同）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>count\u003C\u002Fstrong>: 本次實際回傳筆數\u003C\u002Fli>\n\u003Cli>\u003Cstrong>maxCount\u003C\u002Fstrong>: 單次上限，固定 \u003Cstrong>100\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>deviceId\u003C\u002Fstrong>: 設備識別（與 history 回傳一致）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>columns\u003C\u002Fstrong>: \u003Ccode>data\u003C\u002Fcode> 各列欄位順序\u003C\u002Fli>\n\u003Cli>\u003Cstrong>data\u003C\u002Fstrong>: 事件列陣列（\u003Ccode>seq\u003C\u002Fcode> 遞增）；\u003Ccode>msg\u003C\u002Fcode> 為依 \u003Ccode>lang\u003C\u002Fcode> 組出之顯示文字\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-382\">主機補足缺失記錄（建議流程）\u003C\u002Fh4>\n\u003Col>\n\u003Cli>主機保存該設備之同步游標 \u003Ccode>syncSeq\u003C\u002Fcode>（已\u003Cstrong>連續\u003C\u002Fstrong>同步到的最後 seq）。\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ccode>GET ...\u002FMaxSeq\u003C\u002Fcode>\u003C\u002Fstrong> 取得設備 \u003Ccode>maxSeq\u003C\u002Fcode>。\u003C\u002Fli>\n\u003Cli>若 \u003Ccode>syncSeq < maxSeq\u003C\u002Fcode>，以 \u003Cstrong>\u003Ccode>GET ...\u002FLogSync\u003C\u002Fcode>\u003C\u002Fstrong> 分批拉取，例如 \u003Ccode>fromSeq = syncSeq + 1\u003C\u002Fcode>、\u003Ccode>toSeq = min(fromSeq + 99, maxSeq)\u003C\u002Fcode>，直到追上 \u003Ccode>maxSeq\u003C\u002Fcode>。\u003C\u002Fli>\n\u003Cli>若主機 seq \u003Cstrong>中間不連續\u003C\u002Fstrong>，對缺口另行指定 \u003Ccode>fromSeq\u003C\u002Fcode>／\u003Ccode>toSeq\u003C\u002Fcode> 補齊。\u003C\u002Fli>\n\u003Cli>寫入主機後更新 \u003Ccode>syncSeq\u003C\u002Fcode>。\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Ch4 id=\"section-383\">curl 範例\u003C\u002Fh4>\n\u003Cpre>\u003Ccode>curl -sk -u dcim-read:'<password>' \\\n  https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FManagers\u002F1\u002FLogServices\u002FOem\u002FPelx\u002FMaxSeq\n\ncurl -sk -u dcim-read:'<password>' \\\n  'https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FManagers\u002F1\u002FLogServices\u002FOem\u002FPelx\u002FLogSync?fromSeq=1001&toSeq=1100&lang=zh-hant'\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-384\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常（含區間內 0 筆，\u003Ccode>count\u003C\u002Fcode> 為 0）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>參數錯誤（如 \u003Ccode>toSeq < fromSeq\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Chr>\n\u003Ch1 id=\"section-385\">歷史趨勢（TelemetryService）\u003C\u002Fh1>\n\u003Cp>數值趨勢、量測歷史（圖表）使用 \u003Ccode>TelemetryService\u003C\u002Fcode>。與 \u003Ccode>EventService\u003C\u002Fcode>（目前告警）、\u003Ccode>LogServices\u003C\u002Fcode>（操作 Log）不同，本節提供時間序列量測。\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>需求\u003C\u002Fth>\n\u003Cth>入口\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>DMTF 趨勢圖、批量時序（依 \u003Ccode>reportId\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>MetricReportDefinitions\u003C\u002Fcode>、\u003Ccode>MetricReports\u002F{reportId}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>主機補同步分鐘統計\u003C\u002Fstrong>（依 \u003Ccode>addr\u003C\u002Fcode>、時間區間）\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>...\u002FOem\u002FPelx\u002FRollupRange\u002F{addr}\u003C\u002Fcode>、\u003Ccode>...\u002FOem\u002FPelx\u002FInterfaceRollup\u002F{addr}\u003C\u002Fcode>（見下文）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>\u003Cstrong>批量讀值\u003C\u002Fstrong>：DMTF 設計上，\u003Ccode>MetricReport\u003C\u002Fcode> 的 \u003Cstrong>\u003Ccode>MetricValues\u003C\u002Fcode> 陣列\u003C\u002Fstrong>即為「一次 HTTP 回應取得多筆量測」的標準機制——整合方只需 \u003Ccode>GET ...\u002FMetricReports\u002F{id}\u003C\u002Fcode>，即可取得該報告定義下、一段時間內的多筆 \u003Ccode>MetricId\u003C\u002Fcode>／\u003Ccode>MetricValue\u003C\u002Fcode>／\u003Ccode>Timestamp\u003C\u002Fcode>（例如多個插座電流、多路進線電壓的歷史曲線）。詳見 「總覽與合規」章節 — 一次回應多筆資料。\u003C\u002Fp>\n\u003Cp>探索時須依 Service Root 的 \u003Ccode>TelemetryService\u003C\u002Fcode> 連結與 \u003Ccode>Members\u003C\u002Fcode> 走訪，勿猜 URL。\u003Ccode>{addr}\u003C\u002Fcode> 為週邊介面位址（與 \u003Ccode>Oem\u002FPelx\u002FInterfaces\u002F{addr}\u003C\u002Fcode> 相同字串）。\u003C\u002Fp>\n\u003Ch3 id=\"section-386\">MetricReportDefinition、MetricReport、MetricDefinition 的區別\u003C\u002Fh3>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>資源\u003C\u002Fth>\n\u003Cth>用途\u003C\u002Fth>\n\u003Cth>典型問題\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>MetricReportDefinition\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>報告\u003Cstrong>如何產生\u003C\u002Fstrong>（週期、包含哪些 Metric、寫入哪份 Report）\u003C\u002Ftd>\n\u003Ctd>「多久取樣一次？」\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>MetricReport\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>已產出\u003C\u002Fstrong>的歷史量測序列（\u003Ccode>MetricValues\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003Ctd>「過去 24 小時電壓曲線？」\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>MetricDefinition\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>單一 Metric 的\u003Cstrong>語意\u003C\u002Fstrong>（單位、型別、物理意義）\u003C\u002Ftd>\n\u003Ctd>「這個值單位是 V 還是 A？」\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>建議流程：\u003Ccode>MetricReportDefinitions\u003C\u002Fcode>（或 \u003Ccode>MetricReports\u003C\u002Fcode> 內連結）→ \u003Ccode>MetricReports\u002F{id}\u003C\u002Fcode> 取資料；需單位／型別時再查 \u003Ccode>MetricDefinitions\u002F{metricId}\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Ch3 id=\"section-387\">產品預設（MetricReports）\u003C\u002Fh3>\n\u003Cp>本產品 \u003Cstrong>\u003Ccode>MetricReports\u003C\u002Fcode>\u003C\u002Fstrong> 預設供第三方 DCIM 趨勢圖；與下方 \u003Cstrong>Pelx OEM \u003Ccode>InterfaceRollup\u003C\u002Fcode>\u003C\u002Fstrong> 分工，\u003Cstrong>不併入同一端點\u003C\u002Fstrong>（見下文 OEM 章節）。\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>項目\u003C\u002Fth>\n\u003Cth>預設值\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>\u003Ccode>RecurrenceInterval\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>\u003Ccode>PT1M\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>每 \u003Cstrong>1 分鐘\u003C\u002Fstrong>一筆；配合 DCIM 輪詢 ≥5 秒，較 \u003Ccode>PT5M\u003C\u002Fcode> 更適合短期趨勢\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>\u003Ccode>CollectionDuration\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>\u003Ccode>PT1M\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>與取樣週期一致\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>\u003Ccode>CollectionFunction\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>\u003Ccode>Average\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>單一 \u003Ccode>MetricValue\u003C\u002Fcode> 為週期內平均值\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>\u003Ccode>AppendLimit\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>\u003Ccode>120\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>報告緩衝最多 \u003Cstrong>120\u003C\u002Fstrong> 筆 ≈ \u003Cstrong>2 小時\u003C\u002Fstrong>（\u003Ccode>PT1M\u003C\u002Fcode> 時）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>\u003Ccode>ReportUpdates\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>\u003Ccode>AppendWrapsWhenFull\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>滿載後循環覆寫最舊資料\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>時間過濾\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>OData \u003Cstrong>\u003Ccode>$filter\u003C\u002Fcode>\u003C\u002Fstrong> on \u003Cstrong>\u003Ccode>Timestamp\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>須 Service Root 宣告 \u003Ccode>FilterQuery\u003C\u002Fcode>（見 探索與識別）；\u003Cstrong>勿\u003C\u002Fstrong>使用非標準 \u003Ccode>startTime\u003C\u002Fcode>／\u003Ccode>endTime\u003C\u002Fcode> query\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>對照\u003C\u002Fth>\n\u003Cth>\u003Cstrong>\u003Ccode>MetricReports\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Fth>\n\u003Cth>\u003Cstrong>\u003Ccode>InterfaceRollup\u003C\u002Fcode>\u003C\u002Fstrong>（OEM）\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>用途\u003C\u002Ftd>\n\u003Ctd>標準 DCIM 趨勢\u003C\u002Ftd>\n\u003Ctd>主機補件、\u003Ccode>avg\u003C\u002Fcode>／\u003Ccode>max\u003C\u002Fcode>／\u003Ccode>min\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>設備緩衝\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>120 筆\u003C\u002Fstrong>（≈2h）\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>1500 筆\u003C\u002Fstrong> \u003Ccode>1min\u003C\u002Fcode>（≈25h，見 history）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>查詢\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>$filter\u003C\u002Fcode>（ISO 8601）\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>startTime\u003C\u002Fcode>／\u003Ccode>endTime\u003C\u002Fcode>（Unix 秒）、\u003Ccode>by\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>單次 GET 上限\u003C\u002Ftd>\n\u003Ctd>整份緩衝（≤\u003Ccode>AppendLimit\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>by=1min\u003C\u002Fcode> 最多 \u003Cstrong>120\u003C\u002Fstrong> 筆\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-388\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>Telemetry 服務根資源，由此探索 \u003Ccode>MetricReportDefinitions\u003C\u002Fcode>、\u003Ccode>MetricReports\u003C\u002Fcode>、\u003Ccode>MetricDefinitions\u003C\u002Fcode> 等子集合。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FTelemetryService\",\n  \"@odata.type\": \"#TelemetryService.v1_3_0.TelemetryService\",\n  \"Id\": \"TelemetryService\",\n  \"Name\": \"Telemetry Service\",\n  \"ServiceEnabled\": true,\n  \"MetricReportDefinitions\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FTelemetryService\u002FMetricReportDefinitions\"\n  },\n  \"MetricReports\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FTelemetryService\u002FMetricReports\"\n  },\n  \"MetricDefinitions\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FTelemetryService\u002FMetricDefinitions\"\n  },\n  \"Triggers\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FTelemetryService\u002FTriggers\"\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-389\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 資源 URI，固定 \u003Ccode>\u002Fredfish\u002Fv1\u002FTelemetryService\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，如 \u003Ccode>#TelemetryService.v1_3_0.TelemetryService\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 資源識別碼，固定 \u003Ccode>TelemetryService\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 顯示名稱\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ServiceEnabled\u003C\u002Fstrong>: Telemetry 服務是否啟用\u003C\u002Fli>\n\u003Cli>\u003Cstrong>MetricReportDefinitions\u003C\u002Fstrong>: 報告定義集合連結（描述如何週期性產出報告）\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: \u003Ccode>\u002Fredfish\u002Fv1\u002FTelemetryService\u002FMetricReportDefinitions\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>MetricReports\u003C\u002Fstrong>: 已產出之報告集合連結\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: \u003Ccode>\u002Fredfish\u002Fv1\u002FTelemetryService\u002FMetricReports\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>MetricDefinitions\u003C\u002Fstrong>: Metric 定義集合連結\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: \u003Ccode>\u002Fredfish\u002Fv1\u002FTelemetryService\u002FMetricDefinitions\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Triggers\u003C\u002Fstrong>: 觸發條件集合連結（可選）\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: \u003Ccode>\u002Fredfish\u002Fv1\u002FTelemetryService\u002FTriggers\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-390\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>資源不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-391\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>觸發條件集合（選用；若 \u003Ccode>TelemetryService\u003C\u002Fcode> 暴露 \u003Ccode>Triggers\u003C\u002Fcode> 連結，\u003Cstrong>必須\u003C\u002Fstrong>含 \u003Ccode>@odata.type\u003C\u002Fcode>）。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FTelemetryService\u002FTriggers\",\n  \"@odata.type\": \"#TriggerCollection.TriggerCollection\",\n  \"Members\": [],\n  \"Members@odata.count\": 0\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>若尚未實作觸發條件，可回傳空集合；勿省略 \u003Ccode>@odata.type\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Ch4 id=\"section-392\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-393\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>已產出的 Metric 報告集合。每份報告含一段時間內的量測值序列，適合趨勢圖。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FTelemetryService\u002FMetricReports\",\n  \"@odata.type\": \"#MetricReportCollection.MetricReportCollection\",\n  \"Members\": [\n    {\n      \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FTelemetryService\u002FMetricReports\u002FVoltageA\"\n    }\n  ],\n  \"Members@odata.count\": 1\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-394\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 集合 URI，固定 \u003Ccode>\u002Fredfish\u002Fv1\u002FTelemetryService\u002FMetricReports\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 集合型別\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Members\u003C\u002Fstrong>: 報告連結陣列\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 單一報告 URI，如 \u003Ccode>...\u002FMetricReports\u002FVoltageA\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ca>Members@odata.count\u003C\u002Fa>\u003C\u002Fstrong>: 報告數量\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-395\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>資源不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-396\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>單一 Metric 報告，含歷史量測值陣列。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FTelemetryService\u002FMetricReports\u002FVoltageA\",\n  \"@odata.type\": \"#MetricReport.v1_4_0.MetricReport\",\n  \"Id\": \"VoltageA\",\n  \"Name\": \"Infeed1 Voltage History\",\n  \"MetricReportDefinition\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FTelemetryService\u002FMetricReportDefinitions\u002FVoltageA\"\n  },\n  \"MetricValues\": [\n    {\n      \"MetricId\": \"VoltageA\",\n      \"MetricValue\": \"113.2\",\n      \"Timestamp\": \"2026-06-10T08:00:00Z\",\n      \"MetricProperty\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FSensors\u002FVoltageA\"\n    },\n    {\n      \"MetricId\": \"VoltageA\",\n      \"MetricValue\": \"113.5\",\n      \"Timestamp\": \"2026-06-10T08:01:00Z\",\n      \"MetricProperty\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FSensors\u002FVoltageA\"\n    },\n    {\n      \"MetricId\": \"VoltageA\",\n      \"MetricValue\": \"114.0\",\n      \"Timestamp\": \"2026-06-10T08:02:00Z\",\n      \"MetricProperty\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FSensors\u002FVoltageA\"\n    }\n  ]\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>未帶查詢參數時，回傳該報告緩衝內\u003Cstrong>全部\u003C\u002Fstrong> \u003Ccode>MetricValues\u003C\u002Fcode>（最多 \u003Cstrong>\u003Ccode>AppendLimit\u003C\u002Fcode>\u003C\u002Fstrong> 筆，預設 \u003Cstrong>120\u003C\u002Fstrong>）。\u003C\u002Fp>\n\u003Ch4 id=\"section-397\">查詢參數（\u003Ccode>$filter\u003C\u002Fcode>）\u003C\u002Fh4>\n\u003Cp>依 DMTF 慣例，以 OData \u003Cstrong>\u003Ccode>$filter\u003C\u002Fcode>\u003C\u002Fstrong> 過濾 \u003Ccode>MetricValues\u003C\u002Fcode> 的 \u003Cstrong>\u003Ccode>Timestamp\u003C\u002Fcode>\u003C\u002Fstrong>（ISO 8601 UTC）。須 Service Root \u003Cstrong>\u003Ccode>ProtocolFeaturesSupported.FilterQuery\u003C\u002Fcode>\u003C\u002Fstrong> 為 \u003Ccode>true\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>參數\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>\u003Ccode>$filter\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>例如 \u003Ccode>Timestamp ge 2026-06-10T07:00:00Z\u003C\u002Fcode>（\u003Cstrong>含\u003C\u002Fstrong>該時刻起）；可組合 \u003Ccode>and Timestamp le ...\u003C\u002Fcode> 指定上界\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cpre>\u003Ccode># 自某時刻起的分鐘趨勢（預設 PT1M）\ncurl -sk -u dcim-read:'<password>' \\\n  'https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FTelemetryService\u002FMetricReports\u002FVoltageA?$filter=Timestamp%20ge%202026-06-10T07:00:00Z'\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>勿\u003C\u002Fstrong>在 \u003Ccode>MetricReports\u003C\u002Fcode> 使用 \u003Ccode>startTime\u003C\u002Fcode>／\u003Ccode>endTime\u003C\u002Fcode> query（非 DMTF 標準）。主機補件、需 \u003Ccode>avg\u003C\u002Fcode>／\u003Ccode>max\u003C\u002Fcode>／\u003Ccode>min\u003C\u002Fcode> 或 \u003Ccode>by=1h\u003C\u002Fcode>／\u003Ccode>1d\u003C\u002Fcode> 切換時，請用 \u003Cstrong>\u003Ccode>InterfaceRollup\u003C\u002Fcode>\u003C\u002Fstrong>（見下文）。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Cp>\u003Ccode>$filter\u003C\u002Fcode> 無符合資料時，\u003Ccode>MetricValues\u003C\u002Fcode> 可為空陣列 \u003Ccode>[]\u003C\u002Fcode>；結構仍為完整 \u003Ccode>MetricReport\u003C\u002Fcode> 資源。\u003C\u002Fp>\n\u003Ch4 id=\"section-398\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>{reportId}\u003C\u002Fstrong>（路徑參數）: 報告識別碼，通常與對應 \u003Ccode>MetricReportDefinition\u003C\u002Fcode>、\u003Ccode>MetricDefinition\u003C\u002Fcode> 的 \u003Ccode>Id\u003C\u002Fcode> 相同（如 \u003Ccode>VoltageA\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 報告 URI\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，如 \u003Ccode>#MetricReport.v1_4_0.MetricReport\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 與 \u003Ccode>{reportId}\u003C\u002Fcode> 相同\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 報告顯示名稱\u003C\u002Fli>\n\u003Cli>\u003Cstrong>MetricReportDefinition\u003C\u002Fstrong>: 對應之報告定義連結\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 報告定義 URI，如 \u003Ccode>...\u002FMetricReportDefinitions\u002FVoltageA\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>MetricValues\u003C\u002Fstrong>: 歷史量測值陣列；\u003Cstrong>一次回應可含多筆讀值\u003C\u002Fstrong>（同一 Metric 的多時間點，或報告定義含多個 Metric 時的多種量測）\u003Cul>\n\u003Cli>\u003Cstrong>MetricId\u003C\u002Fstrong>: Metric 識別碼\u003C\u002Fli>\n\u003Cli>\u003Cstrong>MetricValue\u003C\u002Fstrong>: 量測值（字串，依 Metric 型別解析）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Timestamp\u003C\u002Fstrong>: 取樣時間（ISO 8601 UTC）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>MetricProperty\u003C\u002Fstrong>: 對應即時感測資源 URI（如 RackPDU Sensor）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-399\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>報告不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-400\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>報告定義集合，描述各歷史報告的產生方式（取樣週期、包含的 Metric、對應 Sensor 等）。\u003Ccode>{definitionId}\u003C\u002Fcode> 通常與 \u003Ccode>MetricReports\u002F{reportId}\u003C\u002Fcode>、\u003Ccode>MetricDefinitions\u002F{metricId}\u003C\u002Fcode> 使用相同識別碼（如 \u003Ccode>VoltageA\u003C\u002Fcode>）。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FTelemetryService\u002FMetricReportDefinitions\",\n  \"@odata.type\": \"#MetricReportDefinitionCollection.MetricReportDefinitionCollection\",\n  \"Members\": [\n    {\n      \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FTelemetryService\u002FMetricReportDefinitions\u002FVoltageA\"\n    },\n    {\n      \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FTelemetryService\u002FMetricReportDefinitions\u002FCurrentA\"\n    }\n  ],\n  \"Members@odata.count\": 2\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-401\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 集合 URI，固定 \u003Ccode>\u002Fredfish\u002Fv1\u002FTelemetryService\u002FMetricReportDefinitions\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 集合型別\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Members\u003C\u002Fstrong>: 報告定義連結陣列\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 單一定義 URI，如 \u003Ccode>...\u002FMetricReportDefinitions\u002FVoltageA\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ca>Members@odata.count\u003C\u002Fa>\u003C\u002Fstrong>: 定義數量\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-402\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>資源不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-403\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>單一報告定義，說明該歷史報告如何從 Sensor 週期性彙整寫入 \u003Ccode>MetricReports\u003C\u002Fcode>。 rollup 設定。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FTelemetryService\u002FMetricReportDefinitions\u002FVoltageA\",\n  \"@odata.type\": \"#MetricReportDefinition.v1_3_0.MetricReportDefinition\",\n  \"Id\": \"VoltageA\",\n  \"Name\": \"Infeed1 Voltage History\",\n  \"MetricReportDefinitionEnabled\": true,\n  \"MetricReportDefinitionType\": \"Periodic\",\n  \"Schedule\": {\n    \"RecurrenceInterval\": \"PT1M\"\n  },\n  \"ReportActions\": [\n    \"LogToMetricReports\"\n  ],\n  \"ReportUpdates\": \"AppendWrapsWhenFull\",\n  \"AppendLimit\": 120,\n  \"Metrics\": [\n    {\n      \"MetricId\": \"VoltageA\",\n      \"MetricProperties\": [\n        \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FSensors\u002FVoltageA\"\n      ],\n      \"CollectionFunction\": \"Average\",\n      \"CollectionDuration\": \"PT1M\"\n    }\n  ],\n  \"Status\": {\n    \"State\": \"Enabled\",\n    \"Health\": \"OK\"\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-404\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>{definitionId}\u003C\u002Fstrong>（路徑參數）: 報告定義識別碼，如 \u003Ccode>VoltageA\u003C\u002Fcode>、\u003Ccode>Outlet1Current\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 定義 URI\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，如 \u003Ccode>#MetricReportDefinition.v1_3_0.MetricReportDefinition\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 與 \u003Ccode>{definitionId}\u003C\u002Fcode> 相同\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 顯示名稱\u003C\u002Fli>\n\u003Cli>\u003Cstrong>MetricReportDefinitionEnabled\u003C\u002Fstrong>: 是否啟用此報告定義\u003C\u002Fli>\n\u003Cli>\u003Cstrong>MetricReportDefinitionType\u003C\u002Fstrong>: 定義類型，本產品固定 \u003Ccode>Periodic\u003C\u002Fcode>（週期性）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Schedule\u003C\u002Fstrong>: 排程物件\u003Cul>\n\u003Cli>\u003Cstrong>RecurrenceInterval\u003C\u002Fstrong>: 取樣週期（ISO 8601 duration）；本產品預設 \u003Cstrong>\u003Ccode>PT1M\u003C\u002Fcode>\u003C\u002Fstrong>（1 分鐘）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ReportActions\u003C\u002Fstrong>: 報告動作陣列，固定含 \u003Ccode>LogToMetricReports\u003C\u002Fcode>（寫入 \u003Ccode>MetricReports\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ReportUpdates\u003C\u002Fstrong>: 報告更新策略；本產品預設 \u003Cstrong>\u003Ccode>AppendWrapsWhenFull\u003C\u002Fcode>\u003C\u002Fstrong>（滿載循環覆寫）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>AppendLimit\u003C\u002Fstrong>: 報告最多累積筆數；本產品預設 \u003Cstrong>\u003Ccode>120\u003C\u002Fcode>\u003C\u002Fstrong>（\u003Ccode>PT1M\u003C\u002Fcode> 時約 \u003Cstrong>2 小時\u003C\u002Fstrong>緩衝）。當 \u003Ccode>ReportUpdates\u003C\u002Fcode> 為 \u003Ccode>AppendWrapsWhenFull\u003C\u002Fcode> 或 \u003Ccode>AppendStopsWhenFull\u003C\u002Fcode> 時，DMTF 要求提供此欄位\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Metrics\u003C\u002Fstrong>: 本報告包含的 Metric 陣列\u003Cul>\n\u003Cli>\u003Cstrong>MetricId\u003C\u002Fstrong>: Metric 識別碼，對應 \u003Ccode>MetricDefinitions\u002F{metricId}\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>MetricProperties\u003C\u002Fstrong>: 來源感測資源 URI 陣列（通常為 RackPDU \u003Ccode>Sensors\u002F{id}\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>CollectionFunction\u003C\u002Fstrong>: 彙整函數；本產品預設 \u003Cstrong>\u003Ccode>Average\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>CollectionDuration\u003C\u002Fstrong>: 彙整時間窗（ISO 8601 duration）；本產品預設 \u003Cstrong>\u003Ccode>PT1M\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Status\u003C\u002Fstrong>: 運作與健康狀態物件\u003Cul>\n\u003Cli>\u003Cstrong>State\u003C\u002Fstrong>: 運作狀態，如 \u003Ccode>Enabled\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Health\u003C\u002Fstrong>: 健康狀態，\u003Ccode>OK\u003C\u002Fcode> 表示定義正常\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-405\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>定義不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-406\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>Metric 定義集合，描述各 Metric 的單位、資料型別與來源屬性。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FTelemetryService\u002FMetricDefinitions\",\n  \"@odata.type\": \"#MetricDefinitionCollection.MetricDefinitionCollection\",\n  \"Members\": [\n    {\n      \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FTelemetryService\u002FMetricDefinitions\u002FVoltageA\"\n    }\n  ],\n  \"Members@odata.count\": 1\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-407\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 集合 URI\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Members\u003C\u002Fstrong>: 定義連結陣列\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 單一定義 URI\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ca>Members@odata.count\u003C\u002Fa>\u003C\u002Fstrong>: 定義數量\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-408\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>資源不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-409\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FTelemetryService\u002FMetricDefinitions\u002FVoltageA\",\n  \"@odata.type\": \"#MetricDefinition.v1_3_0.MetricDefinition\",\n  \"Id\": \"VoltageA\",\n  \"Name\": \"Infeed1 Voltage\",\n  \"MetricType\": \"Numeric\",\n  \"MetricDataType\": \"Decimal\",\n  \"Units\": \"V\",\n  \"Implementation\": \"PhysicalSensor\",\n  \"PhysicalContext\": \"VoltageRegulator\",\n  \"CalculationAlgorithm\": \"Average\",\n  \"CalculationTimeInterval\": \"PT1M\"\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-410\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>{metricId}\u003C\u002Fstrong>（路徑參數）: Metric 定義識別碼\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 定義 URI\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 與 \u003Ccode>{metricId}\u003C\u002Fcode> 相同\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 顯示名稱\u003C\u002Fli>\n\u003Cli>\u003Cstrong>MetricType\u003C\u002Fstrong>: Metric 類型，如 \u003Ccode>Numeric\u003C\u002Fcode>、\u003Ccode>String\u003C\u002Fcode>、\u003Ccode>Discrete\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>MetricDataType\u003C\u002Fstrong>: 資料型別，如 \u003Ccode>Integer\u003C\u002Fcode>、\u003Ccode>Decimal\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Units\u003C\u002Fstrong>: 單位，如 \u003Ccode>W\u003C\u002Fcode>、\u003Ccode>V\u003C\u002Fcode>、\u003Ccode>A\u003C\u002Fcode>、\u003Ccode>C\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Implementation\u003C\u002Fstrong>: 實作方式，如 \u003Ccode>PhysicalSensor\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PhysicalContext\u003C\u002Fstrong>: 物理情境，如 \u003Ccode>PowerSupply\u003C\u002Fcode>、\u003Ccode>Temperature\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>CalculationAlgorithm\u003C\u002Fstrong>: 彙整演算法，如 \u003Ccode>Average\u003C\u002Fcode>、\u003Ccode>Maximum\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>CalculationTimeInterval\u003C\u002Fstrong>: 取樣間隔（ISO 8601 duration）；本產品預設 \u003Cstrong>\u003Ccode>PT1M\u003C\u002Fcode>\u003C\u002Fstrong>（1 分鐘）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-411\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>定義不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Chr>\n\u003Ch2 id=\"section-412\">主機統計補同步（Pelx OEM）\u003C\u002Fh2>\n\u003Cp>設備平時以分鐘／時／日／月統計並上送主機。若主機因離線、重啟或上送失敗而缺少部分紀錄，可透過下列 Redfish API 依 \u003Cstrong>介面位址（\u003Ccode>addr\u003C\u002Fcode>）與時間區間\u003C\u002Fstrong> 分批補齊。\u003C\u002Fp>\n\u003Ch3 id=\"section-413\">從 Mains／Outlet 取得 addr（不需專用 Rollup API）\u003C\u002Fh3>\n\u003Cp>本節 API 以 \u003Cstrong>\u003Ccode>addr\u003C\u002Fcode>\u003C\u002Fstrong> 為路徑參數，\u003Cstrong>不\u003C\u002Fstrong>在 \u003Ccode>Mains\u003C\u002Fcode>／\u003Ccode>Outlets\u003C\u002Fcode> 上另設專用 Rollup 端點，\u003Cstrong>亦不併入\u003C\u002Fstrong> DMTF \u003Cstrong>\u003Ccode>MetricReports\u003C\u002Fcode>\u003C\u002Fstrong>（標準趨勢用 \u003Ccode>$filter\u003C\u002Fcode> + \u003Ccode>PT1M\u003C\u002Fcode>／\u003Ccode>AppendLimit\u003C\u002Fcode> 120，見上文）。進線（power）與插座等各有多個量測介面（電壓、電流、功率…），補件須針對\u003Cstrong>單一量測\u003C\u002Fstrong>之 \u003Ccode>addr\u003C\u002Fcode>；整合方自 OCP 資源讀取 \u003Cstrong>\u003Ccode>Oem.Pelx.Interfaces\u003C\u002Fcode>\u003C\u002Fstrong>（三相進線用 \u003Cstrong>\u003Ccode>InterfaceGroups\u003C\u002Fcode>\u003C\u002Fstrong>）即可對照。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>GET ...\u002FRackPDUs\u002F1\u002FMains\u002F{mainId}        # 進線；見「電力與配電」章節\n  或 ...\u002FRackPDUs\u002F1\u002FOutlets\u002F{outletId}  # 插座；見「插座」章節\n  → Oem.Pelx.Interfaces.{量測名}.@odata.id\n  → 路徑最後一段即 addr（如 AI2103）\n  → GET ...\u002FRollupRange\u002F{addr}\n  → GET ...\u002FInterfaceRollup\u002F{addr}?startTime=&endTime=&by=\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>欲補之統計\u003C\u002Fth>\n\u003Cth>讀取 \u003Ccode>Interfaces\u003C\u002Fcode> 的 key\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>電壓\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Voltage\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>電流\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>CurrentAmps\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>功率\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>PowerWatts\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>電能／瓦時\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>EnergykWh\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>開關狀態\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>PowerState\u003C\u002Fcode>（\u003Ccode>DO...\u003C\u002Fcode>，通常無 rollup）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>進線 JSON 範例見 電力與配電；插座範例見 插座。亦可 \u003Ccode>GET ...\u002FOem\u002FPelx\u002FInterfaces\u002F{addr}\u003C\u002Fcode>，以 \u003Cstrong>\u003Ccode>peripheralAlias\u003C\u002Fcode>\u003C\u002Fstrong>（\u003Ccode>INFEED\u003C\u002Fcode>／\u003Ccode>OUTLET\u003C\u002Fcode>）、\u003Cstrong>\u003Ccode>elementId\u003C\u002Fcode>\u003C\u002Fstrong> 核對是否為目標路數。\u003C\u002Fp>\n\u003Ch4 id=\"section-414\">範例（插座電流）\u003C\u002Fh4>\n\u003Cpre>\u003Ccode># 1) 從 Outlet 取得電流介面 addr\ncurl -sk -u dcim-read:'<password>' \\\n  https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets\u002F1\n# → Oem.Pelx.Interfaces.CurrentAmps → ...\u002FInterfaces\u002FAI00102\n\n# 2) 查保存區間並補件\ncurl -sk -u dcim-read:'<password>' \\\n  'https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FTelemetryService\u002FOem\u002FPelx\u002FRollupRange\u002FAI00102'\n\ncurl -sk -u dcim-read:'<password>' \\\n  'https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FTelemetryService\u002FOem\u002FPelx\u002FInterfaceRollup\u002FAI00102?startTime=1627453800&endTime=1627461000&by=1min'\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch3 id=\"section-415\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>查詢該週邊介面在各時間聚合粒度下，設備目前已保存資料的\u003Cstrong>最早\u003C\u002Fstrong>與\u003Cstrong>最後\u003C\u002Fstrong>一筆時間；供 UI 設定查詢範圍，或供主機判斷 \u003Ccode>InterfaceRollup\u003C\u002Fcode> 補件時設備端可拉回之區間。\u003C\u002Fp>\n\u003Ch4 id=\"section-416\">回傳資料格式如下:\u003C\u002Fh4>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FTelemetryService\u002FOem\u002FPelx\u002FRollupRange\u002FAI2101\",\n  \"@odata.type\": \"#PelxRollupRange.v1_0_0.PelxRollupRange\",\n  \"addr\": \"AI2101\",\n  \"Interface\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FAI2101\"\n  },\n  \"earliest\": {\n    \"1min\": 1625000000,\n    \"1h\": 1625100000,\n    \"1d\": 1626000000,\n    \"1mo\": 1630000000\n  },\n  \"latest\": {\n    \"1min\": 1625100000,\n    \"1h\": 1626000000,\n    \"1d\": 1630000000,\n    \"1mo\": 1631000000\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-417\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>{addr}\u003C\u002Fstrong>（路徑參數）: 週邊介面位址\u003C\u002Fli>\n\u003Cli>\u003Cstrong>addr\u003C\u002Fstrong>: 與路徑參數相同\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Interface\u003C\u002Fstrong>: 對應 \u003Ccode>Oem\u002FPelx\u002FInterfaces\u002F{addr}\u003C\u002Fcode> 連結\u003C\u002Fli>\n\u003Cli>\u003Cstrong>earliest\u003C\u002Fstrong> \u002F \u003Cstrong>latest\u003C\u002Fstrong>: 各粒度最早／最後資料時間（Unix \u003Cstrong>秒\u003C\u002Fstrong>）\u003Cul>\n\u003Cli>\u003Cstrong>1min\u003C\u002Fstrong>: 1 分鐘\u003C\u002Fli>\n\u003Cli>\u003Cstrong>1h\u003C\u002Fstrong>: 1 小時\u003C\u002Fli>\n\u003Cli>\u003Cstrong>1d\u003C\u002Fstrong>: 1 天\u003C\u002Fli>\n\u003Cli>\u003Cstrong>1mo\u003C\u002Fstrong>: 1 個月\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-418\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>addr\u003C\u002Fstrong> 不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Chr>\n\u003Ch3 id=\"section-419\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>依 \u003Cstrong>時間區間\u003C\u002Fstrong> 拉回週邊歷史統計，供主機補足缺失之分鐘級資料，或 UI 查詢趨勢。單次 \u003Cstrong>\u003Ccode>by=1min\u003C\u002Fcode>\u003C\u002Fstrong> 時\u003Cstrong>最多回傳 120 筆\u003C\u002Fstrong>（\u003Ccode>time\u003C\u002Fcode> 遞增）；區間超過 120 筆時僅回傳自 \u003Ccode>startTime\u003C\u002Fcode> 起連續 120 筆，主機須以本批最末 \u003Ccode>time + 60\u003C\u002Fcode> 作為下一批 \u003Ccode>startTime\u003C\u002Fcode> 分批再查。\u003C\u002Fp>\n\u003Ch4 id=\"section-420\">查詢參數\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>參數\u003C\u002Fth>\n\u003Cth>必填\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>startTime\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>是\u003C\u002Ftd>\n\u003Ctd>查詢起始時間，Unix \u003Cstrong>秒\u003C\u002Fstrong>（\u003Cstrong>含\u003C\u002Fstrong>）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>endTime\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>是\u003C\u002Ftd>\n\u003Ctd>查詢結束時間，Unix \u003Cstrong>秒\u003C\u002Fstrong>（\u003Cstrong>含\u003C\u002Fstrong>）；須 \u003Ccode>endTime >= startTime\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>by\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>是\u003C\u002Ftd>\n\u003Ctd>時間聚合單位：\u003Ccode>1min\u003C\u002Fcode>、\u003Ccode>1h\u003C\u002Fcode>、\u003Ccode>1d\u003C\u002Fcode>、\u003Ccode>1mo\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>fill\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>否\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>null\u003C\u002Fcode>：依 \u003Ccode>by\u003C\u002Fcode> 把區間內\u003Cstrong>每一時間格\u003C\u002Fstrong>都回一筆，無採樣則值為 \u003Ccode>null\u003C\u002Fcode>（趨勢圖用）。省略時只回實際有寫入的格（稀疏，供主機同步）。缺口多為設備重啟或關機，\u003Cstrong>不要\u003C\u002Fstrong>用上一筆或內插填值\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch4 id=\"section-421\">by 欄位值\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>by\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003Cth>設備保存時間\u003C\u002Fth>\n\u003Cth>設備保存筆數\u003C\u002Fth>\n\u003Cth>單次回傳上限\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>1min\u003C\u002Ftd>\n\u003Ctd>1 分鐘\u003C\u002Ftd>\n\u003Ctd>25 小時\u003C\u002Ftd>\n\u003Ctd>1500 筆\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>120\u003C\u002Fstrong> 筆\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>1h\u003C\u002Ftd>\n\u003Ctd>1 小時\u003C\u002Ftd>\n\u003Ctd>80 天\u003C\u002Ftd>\n\u003Ctd>1920 筆\u003C\u002Ftd>\n\u003Ctd>—\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>1d\u003C\u002Ftd>\n\u003Ctd>1 天\u003C\u002Ftd>\n\u003Ctd>1125 天\u003C\u002Ftd>\n\u003Ctd>1125 筆\u003C\u002Ftd>\n\u003Ctd>—\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>1mo\u003C\u002Ftd>\n\u003Ctd>1 個月\u003C\u002Ftd>\n\u003Ctd>3650 天\u003C\u002Ftd>\n\u003Ctd>120 筆\u003C\u002Ftd>\n\u003Ctd>—\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>單次回傳筆數（\u003Ccode>by=1min\u003C\u002Fcode>）：\u003Ccode>min(符合區間之筆數, 120)\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Ch4 id=\"section-422\">回傳資料格式如下:\u003C\u002Fh4>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FTelemetryService\u002FOem\u002FPelx\u002FInterfaceRollup\u002FAI2101\",\n  \"@odata.type\": \"#PelxInterfaceRollup.v1_0_0.PelxInterfaceRollup\",\n  \"addr\": \"AI2101\",\n  \"by\": \"1min\",\n  \"startTime\": 1627453800,\n  \"endTime\": 1627461000,\n  \"count\": 3,\n  \"agg\": \"sum\",\n  \"positive\": true,\n  \"Interface\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FAI2101\"\n  },\n  \"data\": [\n    { \"time\": 1627453800, \"avg\": 50.0, \"max\": 51.2, \"min\": 49.8 },\n    { \"time\": 1627454100, \"avg\": 50.1, \"max\": 51.3, \"min\": 49.9 },\n    { \"time\": 1627454400, \"avg\": 50.2, \"max\": 51.4, \"min\": 50.0 }\n  ]\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-423\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>{addr}\u003C\u002Fstrong>（路徑參數）: 週邊介面位址\u003C\u002Fli>\n\u003Cli>\u003Cstrong>addr\u003C\u002Fstrong> \u002F \u003Cstrong>by\u003C\u002Fstrong> \u002F \u003Cstrong>startTime\u003C\u002Fstrong> \u002F \u003Cstrong>endTime\u003C\u002Fstrong>: 與請求參數一致（回顯）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>count\u003C\u002Fstrong>: 本批 \u003Ccode>data\u003C\u002Fcode> 筆數\u003C\u002Fli>\n\u003Cli>\u003Cstrong>agg\u003C\u002Fstrong>: 聚合方式，\u003Ccode>sum\u003C\u002Fcode>（加總）或 \u003Ccode>avg\u003C\u002Fcode>（平均）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>positive\u003C\u002Fstrong>: 是否為正數量測\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Interface\u003C\u002Fstrong>: 對應 \u003Ccode>Oem\u002FPelx\u002FInterfaces\u002F{addr}\u003C\u002Fcode> 連結\u003C\u002Fli>\n\u003Cli>\u003Cstrong>data\u003C\u002Fstrong>: 統計列陣列\u003Cul>\n\u003Cli>\u003Cstrong>time\u003C\u002Fstrong>: Unix \u003Cstrong>秒\u003C\u002Fstrong> 時間戳\u003C\u002Fli>\n\u003Cli>\u003Cstrong>avg\u003C\u002Fstrong> \u002F \u003Cstrong>max\u003C\u002Fstrong> \u002F \u003Cstrong>min\u003C\u002Fstrong>: 平均值、最大值、最小值（\u003Ccode>agg=sum\u003C\u002Fcode> 時語意同歷史服務彙總）；\u003Cstrong>\u003Ccode>fill=null\u003C\u002Fcode> 且該格無採樣時為 \u003Ccode>null\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>趨勢圖請帶 \u003Cstrong>\u003Ccode>fill=null\u003C\u002Fcode>\u003C\u002Fstrong>，前端遇 \u003Ccode>null\u003C\u002Fcode> \u003Cstrong>斷線\u003C\u002Fstrong>。主機補資料\u003Cstrong>不要\u003C\u002Fstrong>帶 \u003Ccode>fill\u003C\u002Fcode>，亦勿把 \u003Ccode>null\u003C\u002Fcode> 列寫入主機。\u003C\u002Fp>\n\u003Ch4 id=\"section-424\">主機補足缺失資料（建議流程）\u003C\u002Fh4>\n\u003Cp>設備平時每分鐘上送分鐘統計至主機。主機若缺少部分紀錄，可搭配 \u003Cstrong>\u003Ccode>RollupRange\u003C\u002Fcode>\u003C\u002Fstrong> 得知設備保存區間後，再以本 API 依時間區間自設備拉回 \u003Cstrong>\u003Ccode>by=1min\u003C\u002Fcode>\u003C\u002Fstrong> 資料併入主機。\u003C\u002Fp>\n\u003Col>\n\u003Cli>主機保存該設備（＋週邊 \u003Cstrong>addr\u003C\u002Fstrong>）已\u003Cstrong>連續\u003C\u002Fstrong>同步到的最後分鐘 \u003Cstrong>\u003Ccode>syncMinTime\u003C\u002Fcode>\u003C\u002Fstrong>（Unix \u003Cstrong>秒\u003C\u002Fstrong>，對齊整分鐘）。\u003C\u002Fli>\n\u003Cli>對需同步之 \u003Cstrong>addr\u003C\u002Fstrong> 呼叫 \u003Cstrong>\u003Ccode>GET ...\u002FRollupRange\u002F{addr}\u003C\u002Fcode>\u003C\u002Fstrong>，以設備 \u003Cstrong>\u003Ccode>latest.1min\u003C\u002Fcode>\u003C\u002Fstrong> 與主機尾端比對，找出缺口起訖。\u003C\u002Fli>\n\u003Cli>若主機尾端落後設備，以本 API 分批拉回，例如 \u003Cstrong>\u003Ccode>by=1min\u003C\u002Fcode>\u003C\u002Fstrong>、\u003Ccode>startTime = syncMinTime + 60\u003C\u002Fcode>、\u003Ccode>endTime = min(startTime + 7199, latest.1min)\u003C\u002Fcode>，直到追上 \u003Cstrong>\u003Ccode>latest.1min\u003C\u002Fcode>\u003C\u002Fstrong>。\u003Cstrong>一次只處理一個設備、一個 addr\u003C\u002Fstrong>。\u003Cstrong>不要\u003C\u002Fstrong>帶 \u003Ccode>fill=null\u003C\u002Fcode>。\u003C\u002Fli>\n\u003Cli>若主機 \u003Cstrong>time 中間不連續\u003C\u002Fstrong>，對該缺口區間另行指定 \u003Cstrong>\u003Ccode>startTime\u003C\u002Fcode>／\u003Ccode>endTime\u003C\u002Fcode>\u003C\u002Fstrong> 再查。\u003C\u002Fli>\n\u003Cli>將回傳 \u003Cstrong>\u003Ccode>data\u003C\u002Fcode>\u003C\u002Fstrong> 各列加上 \u003Cstrong>\u003Ccode>addr\u003C\u002Fcode>\u003C\u002Fstrong>、\u003Cstrong>\u003Ccode>type\u003C\u002Fcode>\u003C\u002Fstrong> 後，以與設備上送相同之合併邏輯寫入主機；寫入格式仍以 history \u003Cstrong>\u003Ccode>POST \u002Finterfaces\u002Fmin\u003C\u002Fcode>\u003C\u002Fstrong> 為準。\u003C\u002Fli>\n\u003Cli>寫入主機後更新 \u003Cstrong>\u003Ccode>syncMinTime\u003C\u002Fcode>\u003C\u002Fstrong>；補入近 \u003Cstrong>7 天\u003C\u002Fstrong>窗口內資料後，主機可重算 \u003Cstrong>\u003Ccode>1h\u003C\u002Fcode>／\u003Ccode>1d\u003C\u002Fcode>／\u003Ccode>1mo\u003C\u002Fcode>\u003C\u002Fstrong> rollup（若主機實作）。\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>保留限制\u003C\u002Fstrong>：設備端 \u003Cstrong>\u003Ccode>1min\u003C\u002Fcode>\u003C\u002Fstrong> 約保留 \u003Cstrong>25 小時\u003C\u002Fstrong>，超出此窗口之缺口\u003Cstrong>無法\u003C\u002Fstrong>自設備補回。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch4 id=\"section-425\">範例\u003C\u002Fh4>\n\u003Cpre>\u003Ccode>curl -sk -u dcim-read:'<password>' \\\n  'https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FTelemetryService\u002FOem\u002FPelx\u002FRollupRange\u002FAI2101'\n\ncurl -sk -u dcim-read:'<password>' \\\n  'https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FTelemetryService\u002FOem\u002FPelx\u002FInterfaceRollup\u002FAI2101?startTime=1627453800&endTime=1627461000&by=1min'\n\n# 趨勢圖：缺採樣的時間格回 null\ncurl -sk -u dcim-read:'<password>' \\\n  'https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FTelemetryService\u002FOem\u002FPelx\u002FInterfaceRollup\u002FAI2101?startTime=1627453800&endTime=1627457400&by=1min&fill=null'\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-426\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>參數缺漏、\u003Cstrong>by\u003C\u002Fstrong>／\u003Cstrong>fill\u003C\u002Fstrong> 不支援或時間區間不合法\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>addr\u003C\u002Fstrong> 不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Chr>\n\u003Ch1 id=\"section-427\">韌體與組態（UpdateService）\u003C\u002Fh1>\n\u003Cp>韌體更新與組態（cfg）管理 API 遵循 DMTF \u003Ccode>UpdateService\u003C\u002Fcode> 規範。本節包含\u003Cstrong>兩條獨立流程\u003C\u002Fstrong>，請勿混用：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>流程\u003C\u002Fth>\n\u003Cth>API\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>韌體更新\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>upload\u003C\u002Fcode>、\u003Ccode>SimpleUpdate\u003C\u002Fcode>、\u003Ccode>FirmwareInventory\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>替換整機設備映像（\u003Ccode>.bin\u003C\u002Fcode>），完成後重啟\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>組態更新\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Oem\u002FPelx\u002FConfiguration\u003C\u002Fcode> 的 Download／Upload\u003C\u002Ftd>\n\u003Ctd>單獨下載或還原組態檔（\u003Ccode>.cfg\u003C\u002Fcode>），與韌體更新無關\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>兩者分開儲存、分開操作：\u003Cstrong>更新韌體不會改動組態\u003C\u002Fstrong>；\u003Cstrong>上傳組態不會觸發韌體更新\u003C\u002Fstrong>。\u003C\u002Fp>\n\u003Ch3 id=\"section-428\">權限\u003C\u002Fh3>\n\u003Cp>韌體更新與組態 Download／Upload 對應 Web \u003Cstrong>工程模式 → 韌體更新\u003C\u002Fstrong>。\u003Cstrong>須 Administrator\u003C\u002Fstrong>（工程模式；\u003Ccode>403\u003C\u002Fcode> 若為 Operator／ReadOnly）：\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Ccode>POST ...\u002FUpdateService\u002Fupload\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Ccode>POST ...\u002FActions\u002FUpdateService.SimpleUpdate\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Ccode>POST ...\u002FOem\u002FPelx\u002FConfiguration\u002FActions\u002FPelxConfiguration.Upload\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Ccode>POST ...\u002FOem\u002FPelx\u002FConfiguration\u002FActions\u002FPelxConfiguration.Download\u003C\u002Fcode>（觸發匯出）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>\u003Ccode>GET\u003C\u002Fcode> 韌體版本、Task 狀態依預設（ReadOnly 以上）。詳見 認證「文件撰寫慣例」。\u003C\u002Fp>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>上傳格式\u003C\u002Fstrong>：\u003Ccode>UpdateService\u002Fupload\u003C\u002Fcode> 與 \u003Ccode>PelxConfiguration.Upload\u003C\u002Fcode> \u003Cstrong>僅支援\u003C\u002Fstrong> \u003Ccode>POST\u003C\u002Fcode> + \u003Ccode>Content-Type: application\u002Foctet-stream\u003C\u002Fcode>。\u003Cstrong>不支援\u003C\u002Fstrong> \u003Ccode>multipart\u002Fform-data\u003C\u002Fcode>（回 \u003Ccode>400\u003C\u002Fcode>）。\u003Ccode>MultipartHttpPushUri\u003C\u002Fcode> 為 Redfish Schema 欄位名稱，實際請求請用 octet-stream 本體。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch3 id=\"section-429\">韌體更新\u003C\u002Fh3>\n\u003Cp>\u003Cstrong>對象為整台設備映像（device image）\u003C\u002Fstrong>：上傳或遠端拉取的 \u003Ccode>.bin\u003C\u002Fcode> 為完整設備韌體包，更新後設備會重啟並以新映像運行。PDU 僅有一組可更新映像，無 BIOS／BMC 分離更新。映像版本對應 \u003Ccode>Managers\u002F1.FirmwareVersion\u003C\u002Fcode>（\u003Ccode>Managers\u002F1.FirmwareVersion\u003C\u002Fcode>）。\u003C\u002Fp>\n\u003Ch3 id=\"section-430\">組態更新\u003C\u002Fh3>\n\u003Cp>\u003Cstrong>組態以獨立檔案整包更新\u003C\u002Fstrong>：透過 \u003Ccode>PelxConfiguration.Download\u003C\u002Fcode> 匯出、\u003Ccode>PelxConfiguration.Upload\u003C\u002Fcode> 還原。還原後設備參數（插座名稱、閾值等）以檔案內容為準；此流程不替換設備映像。個別即時參數亦可透過各資源 \u003Ccode>PATCH\u003C\u002Fcode>（如 ATS \u003Ccode>Parameters\u003C\u002Fcode>），與整包 cfg 互補。\u003C\u002Fp>\n\u003Ch3 id=\"section-431\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>查詢更新服務能力與可用 Action。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FUpdateService\",\n  \"@odata.type\": \"#UpdateService.v1_14_0.UpdateService\",\n  \"Id\": \"UpdateService\",\n  \"Name\": \"Update Service\",\n  \"ServiceEnabled\": true,\n  \"FirmwareInventory\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FUpdateService\u002FFirmwareInventory\"\n  },\n  \"Actions\": {\n    \"#UpdateService.SimpleUpdate\": {\n      \"target\": \"\u002Fredfish\u002Fv1\u002FUpdateService\u002FActions\u002FUpdateService.SimpleUpdate\",\n      \"@Redfish.ActionInfo\": \"\u002Fredfish\u002Fv1\u002FUpdateService\u002FSimpleUpdateActionInfo\"\n    }\n  },\n  \"Oem\": {\n    \"Pelx\": {\n      \"Configuration\": {\n        \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FUpdateService\u002FOem\u002FPelx\u002FConfiguration\"\n      }\n    }\n  },\n  \"MultipartHttpPushUri\": \"\u002Fredfish\u002Fv1\u002FUpdateService\u002Fupload\",\n  \"HttpPushUriTargets\": [\n    \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\"\n  ]\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-432\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 更新服務 URI，固定 \u003Ccode>\u002Fredfish\u002Fv1\u002FUpdateService\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#UpdateService.v1_14_0.UpdateService\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 資源識別碼，固定 \u003Ccode>UpdateService\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 顯示名稱，固定 \u003Ccode>Update Service\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ServiceEnabled\u003C\u002Fstrong>: 是否允許韌體更新，\u003Ccode>true\u003C\u002Fcode> 表示可用\u003C\u002Fli>\n\u003Cli>\u003Cstrong>FirmwareInventory\u003C\u002Fstrong>: 韌體清單集合連結\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: \u003Ccode>\u002Fredfish\u002Fv1\u002FUpdateService\u002FFirmwareInventory\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Actions\u003C\u002Fstrong>: 可用操作\u003Cul>\n\u003Cli>\u003Cstrong>#UpdateService.SimpleUpdate\u003C\u002Fstrong>: 遠端 URI 簡易更新\u003Cul>\n\u003Cli>\u003Cstrong>target\u003C\u002Fstrong>: Action URI（\u003Ccode>...\u002FActions\u002FUpdateService.SimpleUpdate\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@Redfish.ActionInfo\u003C\u002Fstrong>: 參數說明資源 URI\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem\u003C\u002Fstrong>: 廠商擴充\u003Cul>\n\u003Cli>\u003Cstrong>Pelx\u003C\u002Fstrong>: Pelx OEM 命名空間\u003Cul>\n\u003Cli>\u003Cstrong>Configuration\u003C\u002Fstrong>: 組態單獨下載／上傳資源連結（與韌體 \u003Ccode>upload\u003C\u002Fcode> 無關）\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: \u003Ccode>\u002Fredfish\u002Fv1\u002FUpdateService\u002FOem\u002FPelx\u002FConfiguration\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>MultipartHttpPushUri\u003C\u002Fstrong>: 本地上傳 URI，固定 \u003Ccode>...\u002Fupload\u003C\u002Fcode>（Redfish Schema 欄位名；\u003Cstrong>僅接受\u003C\u002Fstrong> \u003Ccode>application\u002Foctet-stream\u003C\u002Fcode>，不支援 multipart）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>HttpPushUriTargets\u003C\u002Fstrong>: 允許的更新目標，整機映像固定 \u003Ccode>[\"\u002Fredfish\u002Fv1\u002FChassis\u002F1\"]\u003C\u002Fcode>（代表整台 PDU）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-433\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-434\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FUpdateService\u002FFirmwareInventory\",\n  \"@odata.type\": \"#SoftwareInventoryCollection.SoftwareInventoryCollection\",\n  \"Members\": [\n    {\n      \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FUpdateService\u002FFirmwareInventory\u002FImage\"\n    }\n  ],\n  \"Members@odata.count\": 1\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-435\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 韌體清單集合 URI\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Members\u003C\u002Fstrong>: 韌體／映像項目連結陣列\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 單一項目 URI（PDU 固定 \u003Ccode>Image\u003C\u002Fcode>，整機設備映像）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ca>Members@odata.count\u003C\u002Fa>\u003C\u002Fstrong>: 項目數，PDU 為 \u003Ccode>1\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-436\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-437\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>查詢目前安裝的整機設備映像版本（對應 \u003Ccode>Managers\u002F1.FirmwareVersion\u003C\u002Fcode>、\u003Ccode>Managers\u002F1.FirmwareVersion\u003C\u002Fcode>）。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FUpdateService\u002FFirmwareInventory\u002FImage\",\n  \"@odata.type\": \"#SoftwareInventory.v1_10_0.SoftwareInventory\",\n  \"Id\": \"Image\",\n  \"Name\": \"Device Firmware Image\",\n  \"Version\": \"1.60.3\",\n  \"Updateable\": true,\n  \"Status\": {\n    \"State\": \"Enabled\",\n    \"Health\": \"OK\"\n  },\n  \"RelatedItem\": [\n    {\n      \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\"\n    },\n    {\n      \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FManagers\u002F1\"\n    }\n  ]\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-438\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 設備映像項目 URI\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 固定 \u003Ccode>Image\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 顯示名稱，整機設備韌體映像\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Version\u003C\u002Fstrong>: 目前映像版本，與 \u003Ccode>Managers\u002F1.FirmwareVersion\u003C\u002Fcode> 相同\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Updateable\u003C\u002Fstrong>: 是否允許更新\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Status\u003C\u002Fstrong>: 狀態物件\u003Cul>\n\u003Cli>\u003Cstrong>State\u003C\u002Fstrong>: \u003Ccode>Enabled\u003C\u002Fcode> 表示正常\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Health\u003C\u002Fstrong>: \u003Ccode>OK\u003C\u002Fcode> 表示無異常\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>RelatedItem\u003C\u002Fstrong>: 關聯資源（整台設備）\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 機箱 URI（\u003Ccode>\u002Fredfish\u002Fv1\u002FChassis\u002F1\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 管理控制器 URI（\u003Ccode>\u002Fredfish\u002Fv1\u002FManagers\u002F1\u003C\u002Fcode>）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-439\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>資源不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-440\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>\u003Ccode>UpdateService.SimpleUpdate\u003C\u002Fcode> 的參數定義。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FUpdateService\u002FSimpleUpdateActionInfo\",\n  \"@odata.type\": \"#ActionInfo.v1_4_2.ActionInfo\",\n  \"Id\": \"SimpleUpdate\",\n  \"Name\": \"Simple Update Action Info\",\n  \"Parameters\": [\n    {\n      \"Name\": \"ImageURI\",\n      \"Required\": true,\n      \"DataType\": \"String\"\n    },\n    {\n      \"Name\": \"TransferProtocol\",\n      \"Required\": false,\n      \"DataType\": \"String\",\n      \"AllowableValues\": [\"HTTP\", \"HTTPS\", \"FTP\"]\n    },\n    {\n      \"Name\": \"Targets\",\n      \"Required\": false,\n      \"DataType\": \"StringArray\"\n    }\n  ]\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-441\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: ActionInfo 資源 URI，固定 \u003Ccode>\u002Fredfish\u002Fv1\u002FUpdateService\u002FSimpleUpdateActionInfo\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#ActionInfo.v1_4_2.ActionInfo\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: Action 識別碼，固定 \u003Ccode>SimpleUpdate\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 顯示名稱\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Parameters\u003C\u002Fstrong>: \u003Ccode>UpdateService.SimpleUpdate\u003C\u002Fcode> 可接受的參數定義陣列\u003Cul>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 參數名稱\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Required\u003C\u002Fstrong>: 是否必填（\u003Ccode>true\u003C\u002Fcode>／\u003Ccode>false\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>DataType\u003C\u002Fstrong>: 參數型別（\u003Ccode>String\u003C\u002Fcode>、\u003Ccode>StringArray\u003C\u002Fcode> 等）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>AllowableValues\u003C\u002Fstrong>: 允許值清單（僅部分參數有）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ImageURI\u003C\u002Fstrong>（必填）: 遠端設備映像完整 URL（含檔名）；\u003Ccode>POST ...\u002FSimpleUpdate\u003C\u002Fcode> \u003Cstrong>唯一實際讀取\u003C\u002Fstrong>的參數，下載至暫存後套用\u003C\u002Fli>\n\u003Cli>\u003Cstrong>TransferProtocol\u003C\u002Fstrong>（選填）: 傳輸協定提示，\u003Ccode>HTTP\u003C\u002Fcode>／\u003Ccode>HTTPS\u003C\u002Fcode>／\u003Ccode>FTP\u003C\u002Fcode>；PDU 整機映像，\u003Ccode>POST\u003C\u002Fcode> 時目前\u003Cstrong>未讀取\u003C\u002Fstrong>（固定更新整機）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-442\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-443\">POST https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>自遠端檔案伺服器（HTTP／HTTPS／FTP）拉取\u003Cstrong>整機設備映像\u003C\u002Fstrong>並更新（遠端 Simple Update）。更新為非同步作業，成功回 \u003Ccode>202\u003C\u002Fcode> 並建立 Task；完成後設備重啟。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"ImageURI\": \"https:\u002F\u002Ffileserver.example.com\u002Ffirmware\u002Fpdu-image-1.60.4.bin\",\n  \"TransferProtocol\": \"HTTPS\",\n  \"Targets\": [\n    \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\"\n  ],\n  \"@Redfish.OperationApplyTime\": \"Immediate\"\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-444\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>ImageURI\u003C\u002Fstrong>: 設備映像檔完整 URL（含檔名），為整機 \u003Ccode>.bin\u003C\u002Fcode> 韌體包\u003C\u002Fli>\n\u003Cli>\u003Cstrong>TransferProtocol\u003C\u002Fstrong>: 傳輸協定，\u003Ccode>HTTP\u003C\u002Fcode>、\u003Ccode>HTTPS\u003C\u002Fcode> 或 \u003Ccode>FTP\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Targets\u003C\u002Fstrong>: 更新目標；整機映像固定 \u003Ccode>[\"\u002Fredfish\u002Fv1\u002FChassis\u002F1\"]\u003C\u002Fcode>，亦可寫 \u003Ccode>[\"\u002Fredfish\u002Fv1\u002FUpdateService\u002FFirmwareInventory\u002FImage\"]\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@Redfish.OperationApplyTime\u003C\u002Fstrong>: 套用時機，PDU 支援 \u003Ccode>Immediate\u003C\u002Fcode>（立即開始）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cblockquote>\n\u003Cp>韌體更新僅替換設備映像，\u003Cstrong>不修改、不覆寫\u003C\u002Fstrong>使用者組態；無需也無 \u003Ccode>PreserveConfig\u003C\u002Fcode> 等參數。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch4 id=\"section-445\">回傳資料\u003C\u002Fh4>\n\u003Cp>成功時回 \u003Ccode>202 Accepted\u003C\u002Fcode>，\u003Ccode>Location\u003C\u002Fcode> 標頭指向 Task URI，例如 \u003Ccode>\u002Fredfish\u002Fv1\u002FTaskService\u002FTasks\u002F1\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Ch4 id=\"section-446\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>202\u003C\u002Ftd>\n\u003Ctd>已接受，更新進行中\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>參數錯誤（URI 無效、協定不支援）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>409\u003C\u002Ftd>\n\u003Ctd>已有更新進行中\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-447\">POST https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>從本機上傳\u003Cstrong>整機設備映像\u003C\u002Fstrong>更新。請使用**\u003Ccode>POST\u003C\u002Fcode> + \u003Ccode>application\u002Foctet-stream\u003C\u002Fcode> + 映像本體**。\u003C\u002Fp>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>注意\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cul>\n\u003Cli>必須使用 \u003Cstrong>POST\u003C\u002Fstrong>（不可用 GET；否則常見 \u003Ccode>write EPIPE\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>不支援\u003C\u002Fstrong> \u003Ccode>multipart\u002Fform-data\u003C\u002Fcode>（回 \u003Ccode>400\u003C\u002Fcode>）；請用 \u003Ccode>application\u002Foctet-stream\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fblockquote>\n\u003Cpre>\u003Ccode>curl -u admin:password -X POST \\\n  https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FUpdateService\u002Fupload \\\n  -H \"Content-Type: application\u002Foctet-stream\" \\\n  --data-binary @dph_1u-1.4.10.swu\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cblockquote>\n\u003Cp>\u003Ccode>SimpleUpdate\u003C\u002Fcode> 下載至同一暫存路徑後，亦走 \u003Ccode>upgrade\u002Fapply\u003C\u002Fcode>。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch4 id=\"section-448\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>Body\u003C\u002Fstrong>（Mandatory）: 整機 \u003Ccode>.swu\u003C\u002Fcode> 映像二進位內容（\u003Ccode>Content-Type: application\u002Foctet-stream\u003C\u002Fcode>）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-449\">回傳資料\u003C\u002Fh4>\n\u003Cp>成功時回 \u003Ccode>202 Accepted\u003C\u002Fcode>，\u003Ccode>Location\u003C\u002Fcode> 指向 Task；更新完成、設備重啟後可查 \u003Ccode>FirmwareInventory\u002FImage.Version\u003C\u002Fcode> 或 \u003Ccode>Managers\u002F1.FirmwareVersion\u003C\u002Fcode> 確認版本。\u003C\u002Fp>\n\u003Ch4 id=\"section-450\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>202\u003C\u002Ftd>\n\u003Ctd>已接受，更新進行中\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>Content-Type 非 octet-stream、使用 multipart、或映像驗證失敗\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>409\u003C\u002Ftd>\n\u003Ctd>已有更新進行中\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>413\u003C\u002Ftd>\n\u003Ctd>檔案過大\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-451\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>列出非同步任務（韌體更新等 \u003Ccode>202\u003C\u002Fcode> 回應所建立者）。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FTaskService\u002FTasks\",\n  \"@odata.type\": \"#TaskCollection.TaskCollection\",\n  \"Members\": [\n    { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FTaskService\u002FTasks\u002F1\" }\n  ],\n  \"Members@odata.count\": 1\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch3 id=\"section-452\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>查詢韌體更新等非同步任務進度（\u003Ccode>SimpleUpdate\u003C\u002Fcode>／\u003Ccode>upload\u003C\u002Fcode> 回 \u003Ccode>202\u003C\u002Fcode> 後使用）。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FTaskService\u002FTasks\u002F1\",\n  \"@odata.type\": \"#Task.v1_7_2.Task\",\n  \"Id\": \"1\",\n  \"Name\": \"Device Image Update\",\n  \"TaskState\": \"Running\",\n  \"TaskStatus\": \"OK\",\n  \"PercentComplete\": 45,\n  \"StartTime\": \"2026-06-15T10:00:00+08:00\",\n  \"Messages\": [\n    {\n      \"Message\": \"Writing device image\",\n      \"MessageSeverity\": \"OK\"\n    }\n  ]\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-453\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>{taskId}\u003C\u002Fstrong>（路徑參數）: 任務識別碼，由 \u003Ccode>202\u003C\u002Fcode> 回應 \u003Ccode>Location\u003C\u002Fcode> 取得\u003C\u002Fli>\n\u003Cli>\u003Cstrong>TaskState\u003C\u002Fstrong>: 任務狀態，\u003Ccode>New\u003C\u002Fcode>、\u003Ccode>Running\u003C\u002Fcode>、\u003Ccode>Completed\u003C\u002Fcode>、\u003Ccode>Exception\u003C\u002Fcode> 等\u003C\u002Fli>\n\u003Cli>\u003Cstrong>TaskStatus\u003C\u002Fstrong>: 整體狀態，\u003Ccode>OK\u003C\u002Fcode>、\u003Ccode>Warning\u003C\u002Fcode>、\u003Ccode>Critical\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PercentComplete\u003C\u002Fstrong>: 完成百分比（0–100）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>StartTime\u003C\u002Fstrong>: 開始時間（ISO 8601）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Messages\u003C\u002Fstrong>: 進度訊息陣列\u003Cul>\n\u003Cli>\u003Cstrong>Message\u003C\u002Fstrong>: 說明文字\u003C\u002Fli>\n\u003Cli>\u003Cstrong>MessageSeverity\u003C\u002Fstrong>: 嚴重程度\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-454\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>任務不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-455\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>組態\u003Cstrong>單獨\u003C\u002Fstrong>備份／還原能力與 Action 入口。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FUpdateService\u002FOem\u002FPelx\u002FConfiguration\",\n  \"@odata.type\": \"#PelxConfiguration.v1_0_0.PelxConfiguration\",\n  \"Id\": \"Configuration\",\n  \"Name\": \"Pelx Device Configuration\",\n  \"Actions\": {\n    \"#PelxConfiguration.Download\": {\n      \"target\": \"\u002Fredfish\u002Fv1\u002FUpdateService\u002FOem\u002FPelx\u002FConfiguration\u002FActions\u002FPelxConfiguration.Download\"\n    },\n    \"#PelxConfiguration.Upload\": {\n      \"target\": \"\u002Fredfish\u002Fv1\u002FUpdateService\u002FOem\u002FPelx\u002FConfiguration\u002FActions\u002FPelxConfiguration.Upload\"\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-456\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 組態資源 URI\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 固定 \u003Ccode>Configuration\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 顯示名稱\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Actions\u003C\u002Fstrong>: 可用操作\u003Cul>\n\u003Cli>\u003Cstrong>#PelxConfiguration.Download\u003C\u002Fstrong>: 下載組態備份檔（唯讀匯出）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>#PelxConfiguration.Upload\u003C\u002Fstrong>: 上傳組態檔、\u003Cstrong>單獨還原\u003C\u002Fstrong>（不更新韌體映像）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-457\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-458\">POST https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>下載設備組態備份檔。請求 body 可為空物件 \u003Ccode>{}\u003C\u002Fcode>，或指定檔名：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"FileName\": \"pdu-backup.cfg\"\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-459\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>FileName\u003C\u002Fstrong>: 建議檔名（可選）；未指定時伺服器以 \u003Ccode>backup-YYYYMMDD-HHMMSS.cfg\u003C\u002Fcode> 命名\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-460\">回傳資料\u003C\u002Fh4>\n\u003Cp>成功時回 \u003Ccode>200\u003C\u002Fcode>，\u003Ccode>Content-Type: application\u002Foctet-stream\u003C\u002Fcode>，\u003Ccode>Content-Disposition: attachment; filename=\"pdu-backup.cfg\"\u003C\u002Fcode>，body 為組態二進位檔。\u003C\u002Fp>\n\u003Ch4 id=\"section-461\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常，回傳備份檔\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>500\u003C\u002Ftd>\n\u003Ctd>備份失敗\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-462\">POST https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>\u003Cstrong>單獨上傳組態檔還原\u003C\u002Fstrong>。上傳後\u003Cstrong>立即回 202\u003C\u002Fstrong>，背景執行還原（不重傳本體）。僅覆寫設備參數，\u003Cstrong>不觸發韌體映像更新\u003C\u002Fstrong>。\u003C\u002Fp>\n\u003Cp>請求與韌體上傳相同：\u003Cstrong>\u003Ccode>POST\u003C\u002Fcode> + \u003Ccode>Content-Type: application\u002Foctet-stream\u003C\u002Fcode> + 組態檔本體\u003C\u002Fstrong>。\u003Cstrong>不支援\u003C\u002Fstrong> \u003Ccode>multipart\u002Fform-data\u003C\u002Fcode>。Postman 請在 Headers 手動加上 \u003Ccode>Content-Type: application\u002Foctet-stream\u003C\u002Fcode>（僅選 binary 可能缺此 header）。\u003C\u002Fp>\n\u003Ch4 id=\"section-463\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>202\u003C\u002Ftd>\n\u003Ctd>已接受，檔案已寫入暫存；還原於背景執行（重啟後生效）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>暫存檔缺失、Content-Type 非 octet-stream，或使用 multipart\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cblockquote>\n\u003Cp>還原為非同步作業，\u003Cstrong>先回 202\u003C\u002Fstrong> 再於背景完成；客戶端不應等待還原完成。檔案格式錯誤等問題不會在 202 階段回報。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch3 id=\"section-464\">操作範例（curl）\u003C\u002Fh3>\n\u003Cp>遠端 URI 更新設備映像：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>curl -u admin:password -X POST \\\n  https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FUpdateService\u002FActions\u002FUpdateService.SimpleUpdate \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"ImageURI\": \"https:\u002F\u002Ffileserver\u002Ffirmware\u002Fpdu-image-1.60.4.bin\",\n    \"TransferProtocol\": \"HTTPS\",\n    \"Targets\": [\"\u002Fredfish\u002Fv1\u002FChassis\u002F1\"]\n  }'\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>本地上傳設備映像（建議 octet-stream，）：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>curl -u admin:password -X POST \\\n  https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FUpdateService\u002Fupload \\\n  -H \"Content-Type: application\u002Foctet-stream\" \\\n  --data-binary @dph_1u-1.4.10.swu\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>下載組態備份：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>curl -u admin:password -X POST \\\n  https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FUpdateService\u002FOem\u002FPelx\u002FConfiguration\u002FActions\u002FPelxConfiguration.Download \\\n  -o pdu-backup.cfg\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>上傳組態還原：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>curl -u admin:password -X POST \\\n  https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FUpdateService\u002FOem\u002FPelx\u002FConfiguration\u002FActions\u002FPelxConfiguration.Upload \\\n  -H \"Content-Type: application\u002Foctet-stream\" \\\n  --data-binary \"@pdu-backup.cfg\"\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Chr>\n\u003Ch1 id=\"section-465\">讀取流程建議\u003C\u002Fh1>\n\u003Col>\n\u003Cli>\u003Ccode>POST \u002FSessionService\u002FSessions\u003C\u002Fcode> 建立 Session，保存 \u003Ccode>X-Auth-Token\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Ccode>GET \u002Fredfish\u002Fv1\u003C\u002Fcode> 探索資源連結（須含 \u003Ccode>PowerEquipment\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>讀取 \u003Ccode>PowerEquipment\u002FRackPDUs\u002F{id}\u003C\u002Fcode> → \u003Ccode>Metrics\u003C\u002Fcode> 取得彙總功率／能耗\u003C\u002Fli>\n\u003Cli>讀取 \u003Ccode>Mains\u003C\u002Fcode> → \u003Ccode>Outlets\u003C\u002Fcode> 取得配電狀態與插座控制\u003C\u002Fli>\n\u003Cli>批次控制：\u003Ccode>RackPDUs\u002F1\u002FOutletGroups\u002F{id}\u003C\u002Fcode>（見 插座群組）\u003C\u002Fli>\n\u003Cli>讀取 \u003Ccode>Chassis\u002F1\u003C\u002Fcode>（含 \u003Ccode>Links.PowerDistribution\u003C\u002Fcode>）與 \u003Ccode>Thermal\u003C\u002Fcode> 取得環境感測\u003C\u002Fli>\n\u003Cli>事件訂閱：\u003Ccode>EventService\u002FSubscriptions\u003C\u002Fcode>（OCP 標準）；目前告警快照見 \u003Ccode>EventService\u002FEvents\u003C\u002Fcode>（Pelx）\u003C\u002Fli>\n\u003Cli>事件／Log 歷史：\u003Ccode>Managers\u002F1\u002FLogServices\u003C\u002Fcode> → \u003Ccode>{logId}\u002FEntries\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>網路設定：\u003Ccode>Managers\u002F1\u002FEthernetInterfaces\u003C\u002Fcode>、\u003Ccode>NetworkProtocol\u003C\u002Fcode>（NTP、SNMP 見 網路協定）\u003C\u002Fli>\n\u003Cli>韌體／組態：\u003Ccode>UpdateService\u003C\u002Fcode>（韌體）與 \u003Ccode>Oem\u002FPelx\u002FConfiguration\u003C\u002Fcode>（組態，獨立流程）\u003C\u002Fli>\n\u003Cli>ATS：\u003Ccode>PowerEquipment\u002FTransferSwitches\u003C\u002Fcode> → \u003Ccode>Feeders\u003C\u002Fcode>（見 ATS 轉換開關；設備支援 ATS 時）\u003C\u002Fli>\n\u003Cli>歷史量測：\u003Ccode>TelemetryService\u003C\u002Fcode>（見 歷史趨勢）\u003C\u002Fli>\n\u003Cli>非標準週邊（單點）：\u003Ccode>Oem\u002FPelx\u002FInterfaces\u003C\u002Fcode>（見 OEM 介面）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>週邊結構盤點（一次取整樹）\u003C\u002Fstrong>：\u003Ccode>Oem\u002FPelx\u002FPeripheralTree\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>大量即時\u003C\u002Fstrong>：\u003Ccode>GET \u002Fredfish\u002Fv1\u003C\u002Fcode> 讀 \u003Ccode>Oem.Pelx.MqttEndpoint\u003C\u002Fcode> → MQTT 訂閱 \u003Ccode>\u002Fupdates\u002Flocal\u003C\u002Fcode>、\u003Ccode>\u002Fupdate\u002Flocal\u002F#\u003C\u002Fcode>（見 MQTT Discovery、第 11 章）\u003C\u002Fli>\n\u003Cli>工程組態（須 \u003Cstrong>Administrator\u003C\u002Fstrong>；依 \u003Ccode>devinfo\u003C\u002Fcode> 旗標出現）：\u003Ccode>Oem\u002FPelx\u002FSerialBuses\u003C\u002Fcode>、\u003Ccode>VNodes\u003C\u002Fcode>、\u003Ccode>HmiScreens\u003C\u002Fcode>（含樣版匯出／載入）、\u003Ccode>HmiImageLibraries\u003C\u002Fcode>、\u003Ccode>Automations\u003C\u002Fcode>（見 Pelx 擴充）\u003C\u002Fli>\n\u003Cli>完成後 \u003Ccode>DELETE \u002FSessionService\u002FSessions\u002F{id}\u003C\u002Fcode> 登出\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Ch3 id=\"section-466\">減少請求次數（一次回多筆）\u003C\u002Fh3>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>場景\u003C\u002Fth>\n\u003Cth>做法\u003C\u002Fth>\n\u003Cth>範例\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>整機功率／能耗／負載\u003C\u002Ftd>\n\u003Ctd>單一 \u003Cstrong>Metrics\u003C\u002Fstrong> 資源（OCP 必填）\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>GET ...\u002FRackPDUs\u002F1\u002FMetrics\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>所有插座完整狀態\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>\u003Ccode>$expand\u003C\u002Fcode>\u003C\u002Fstrong>（須 \u003Ccode>ExpandQuery\u003C\u002Fcode> 支援）\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>GET ...\u002FOutlets?$expand=.\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>歷史趨勢多筆讀值\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>\u003Ccode>MetricReports\u003C\u002Fcode>\u003C\u002Fstrong> 的 \u003Ccode>MetricValues[]\u003C\u002Fcode>（預設 \u003Cstrong>PT1M\u003C\u002Fstrong>、緩衝 \u003Cstrong>120\u003C\u002Fstrong> 筆）\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>GET ...\u002FMetricReports\u002FVoltageA\u003C\u002Fcode> 或 \u003Ccode>...?$filter=Timestamp ge ...\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>僅要成員 URI 列表\u003C\u002Ftd>\n\u003Ctd>Collection 或 \u003Cstrong>\u003Ccode>$only\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>GET ...\u002FOutlets\u003C\u002Fcode> 或 \u003Ccode>...\u002FOutlets?$only\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cpre>\u003Ccode># 整機彙總（一次回 PowerWatts + EnergykWh + PowerLoadPercent）\ncurl -sk -u admin:'<password>' \\\n  https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FMetrics\n\n# 展開所有插座（若服務支援 $expand）\ncurl -sk -u admin:'<password>' \\\n  'https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets?$expand=.'\n\n# 歷史量測陣列（PT1M；可選 $filter）\ncurl -sk -u admin:'<password>' \\\n  https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FTelemetryService\u002FMetricReports\u002FVoltageA\n\ncurl -sk -u admin:'<password>' \\\n  'https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FTelemetryService\u002FMetricReports\u002FVoltageA?$filter=Timestamp%20ge%202026-06-10T07:00:00Z'\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>詳見 「總覽與合規」章節 — 一次回應多筆資料。\u003C\u002Fp>\n\u003Ch3 id=\"section-467\">curl 範例\u003C\u002Fh3>\n\u003Cp>建立 Session：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>curl -u admin:password -X POST \\\n  https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FSessionService\u002FSessions\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>讀取插座 1（帶 Token）：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>curl -H \"X-Auth-Token: 7c3f8a2b9e1d4f6a8c0b2d4e6f8a0c2\" \\\n  https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets\u002F1\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>對外請使用 \u003Ccode>https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002F...\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Ch3 id=\"section-468\">redfishtool 測試\u003C\u002Fh3>\n\u003Cp>建議以 \u003Ca rel=\"noopener noreferrer\" href=\"https:\u002F\u002Fgithub.com\u002FDMTF\u002Fredfishtool\">DMTF redfishtool\u003C\u002Fa> 手動探查單一 API；合規與回歸測試請用 \u003Cstrong>OCP Interop Validator\u003C\u002Fstrong>（見下方）。\u003C\u002Fp>\n\u003Cp>\u003Cstrong>安裝\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cpre>\u003Ccode>brew install pipx && pipx install redfishtool\n# 或: pip install redfishtool\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>\u003Cstrong>手動查詢（HTTPS 443，對外設備）\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cpre>\u003Ccode># Service Root\nredfishtool.py -u admin -p 'admin123' -r 113.196.183.199:443 -S Always -A Basic \\\n  raw GET \u002Fredfish\u002Fv1\n\n# 插座 1\nredfishtool.py -u admin -p 'admin123' -r 113.196.183.199:443 -S Always -A Basic \\\n  raw GET \u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets\u002F1\n\n  raw GET \u002Fredfish\u002Fv1\n\n# 設備映像版本\nredfishtool.py -u admin -p 'admin123' -r 113.196.183.199:443 -S Always -A Basic \\\n  raw GET \u002Fredfish\u002Fv1\u002FUpdateService\u002FFirmwareInventory\u002FImage\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>\u003Cstrong>Session 生命週期\u003C\u002Fstrong>（加 \u003Ccode>-sssss\u003C\u002Fcode> 可印出回應標頭，取得 \u003Ccode>X-Auth-Token\u003C\u002Fcode>）\u003C\u002Fp>\n\u003Cpre>\u003Ccode>redfishtool.py -u admin -p 'admin123' -r 113.196.183.199:443 -S Always -A Basic -sssss \\\n  raw POST \u002Fredfish\u002Fv1\u002FSessionService\u002FSessions '{}'\n\nredfishtool.py -r 113.196.183.199:443 -S Always \\\n  -H '{\"X-Auth-Token\":\"<token>\"}' \\\n  raw GET \u002Fredfish\u002Fv1\u002FSessionService\u002FSessions\u002F<sessionId>\n\nredfishtool.py -r 113.196.183.199:443 -S Always \\\n  -H '{\"X-Auth-Token\":\"<token>\"}' \\\n  raw DELETE \u002Fredfish\u002Fv1\u002FSessionService\u002FSessions\u002F<sessionId>\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>\u003Cstrong>OCP Interop Validator（合規驗證，建議）\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cp>合規與回歸測試以 \u003Ca rel=\"noopener noreferrer\" href=\"https:\u002F\u002Fgithub.com\u002FDMTF\u002FRedfish-Interop-Validator\">DMTF Redfish Interop Validator\u003C\u002Fa> 搭配 OCP Profile JSON 為準（見上文「OCP Rack PDU Profile 對照」）。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>pipx install redfish-interop-validator\ngit clone https:\u002F\u002Fgithub.com\u002Fopencomputeproject\u002FHWMgmt-OCP-Profiles.git ~\u002FHWMgmt-OCP-Profiles\n\nrf_interop_validator \\\n  -r https:\u002F\u002F<host> \\\n  -u admin -p '<password>' \\\n  --authtype Session \\\n  --required_profiles_dir ~\u002FHWMgmt-OCP-Profiles \\\n  ~\u002FHWMgmt-OCP-Profiles\u002FRackAndPower\u002FOCPRackPDU.v1_0_0.json\n\n# OCP Baseline Hardware Management（Service Baseline 延伸）\nrf_interop_validator \\\n  -r https:\u002F\u002F<host> \\\n  -u admin -p '<password>' \\\n  --authtype Session \\\n  --required_profiles_dir ~\u002FHWMgmt-OCP-Profiles \\\n  ~\u002FHWMgmt-OCP-Profiles\u002FOCPBaselineHardwareManagement.v1_1_1.json\n\nopen logs\u002FInteropHtmlLog_*.html\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>RBAC 權限矩陣\u003C\u002Fstrong>：Interop Validator \u003Cstrong>不會\u003C\u002Fstrong>以 ReadOnly 帳號做 403 負向測試（僅驗 Role 資源結構）。請用 \u003Ccode>..\u002Fscripts\u002Fredfish-rbac-check.sh\u003C\u002Fcode>（對照 認證）做\u003Cstrong>分層負向\u003C\u002Fstrong>測試：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>區段\u003C\u002Fth>\n\u003Cth>測試帳號\u003C\u002Fth>\n\u003Cth>目標 API\u003C\u002Fth>\n\u003Cth>預期\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>[1]\u003C\u002Ftd>\n\u003Ctd>ReadOnly\u003C\u002Ftd>\n\u003Ctd>Operator+（控制、一般寫入、帳號清單等）\u003C\u002Ftd>\n\u003Ctd>403\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>[2]\u003C\u002Ftd>\n\u003Ctd>ReadOnly\u003C\u002Ftd>\n\u003Ctd>Administrator（工程模式）\u003C\u002Ftd>\n\u003Ctd>403\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>[3]\u003C\u002Ftd>\n\u003Ctd>Operator\u003C\u002Ftd>\n\u003Ctd>Administrator-only\u003C\u002Ftd>\n\u003Ctd>403\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>[4]\u003C\u002Ftd>\n\u003Ctd>各角色\u003C\u002Ftd>\n\u003Ctd>抽樣正向（應 200）\u003C\u002Ftd>\n\u003Ctd>200\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>腳本會自動建立 \u003Ccode>dcim-read-rbac\u003C\u002Fcode>（ReadOnly）與 \u003Ccode>dcim-ctrl-rbac\u003C\u002Fcode>（Operator）；可用 \u003Ccode>--no-create-accounts\u003C\u002Fcode> 略過。設備無 outlet／排程等資源時相關案例會 SKIP。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Cpre>\u003Ccode>chmod +x redfish\u002Fscripts\u002Fredfish-rbac-check.sh\n.\u002Fredfish\u002Fscripts\u002Fredfish-rbac-check.sh -r https:\u002F\u002F<host> -u admin -p '<password>'\n# 自簽 HTTPS 可加 -k；未加時腳本會自動重試一次\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Chr>\n\u003Ch1 id=\"section-469\">通用錯誤回應\u003C\u002Fh1>\n\u003Cp>角色與預設權限見 認證；\u003Ccode>403\u003C\u002Fcode> 表示呼叫者 \u003Ccode>RoleId\u003C\u002Fcode> 不足以執行該操作。\u003C\u002Fp>\n\u003Cp>未列於各 API 的錯誤，回傳 Redfish 標準 \u003Ccode>error\u003C\u002Fcode> 物件：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"error\": {\n    \"@Message.ExtendedInfo\": [\n      {\n        \"Message\": \"The resource at the URI was not found.\",\n        \"MessageId\": \"Base.1.16.ResourceNotFound\",\n        \"Severity\": \"Critical\",\n        \"Resolution\": \"Provide a valid resource URI.\"\n      }\n    ],\n    \"code\": \"Base.1.16.ResourceNotFound\",\n    \"message\": \"The resource at the URI was not found.\"\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-470\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>error\u003C\u002Fstrong>: 錯誤物件\u003Cul>\n\u003Cli>\u003Cstrong>code\u003C\u002Fstrong>: 錯誤代碼（如 \u003Ccode>Base.1.16.ResourceNotFound\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>message\u003C\u002Fstrong>: 錯誤訊息摘要\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@Message.ExtendedInfo\u003C\u002Fstrong>: 延伸錯誤資訊陣列\u003Cul>\n\u003Cli>\u003Cstrong>Message\u003C\u002Fstrong>: 詳細說明\u003C\u002Fli>\n\u003Cli>\u003Cstrong>MessageId\u003C\u002Fstrong>: 訊息識別碼\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Severity\u003C\u002Fstrong>: 嚴重程度\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Resolution\u003C\u002Fstrong>: 建議處理方式\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>無參數 Action\u003C\u002Fstrong>：對於不帶參數的 Action（如 \u003Ccode>ResetMetrics\u003C\u002Fcode>），請送 \u003Ccode>Content-Type: application\u002Fjson\u003C\u002Fcode> 且 body 為 \u003Ccode>{}\u003C\u002Fcode>；完全省略 body 可能回 \u003Ccode>400\u003C\u002Fcode>。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Cp>常見狀態碼：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>成功\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>201\u003C\u002Ftd>\n\u003Ctd>建立成功（Session）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>202\u003C\u002Ftd>\n\u003Ctd>已接受（非同步控制）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>請求格式錯誤\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>資源不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>409\u003C\u002Ftd>\n\u003Ctd>資源衝突（如插座操作中）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>500\u003C\u002Ftd>\n\u003Ctd>伺服器內部錯誤\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>503\u003C\u002Ftd>\n\u003Ctd>服務暫時不可用\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch1 id=\"section-471\">iLock 電子鎖主機\u003C\u002Fh1>\n\u003Cp>本章描述 \u003Cstrong>iLock 電子鎖主機\u003C\u002Fstrong>（\u003Ccode>ilock.cpp\u003C\u002Fcode>，iLock 電子鎖主機）的 Redfish API。\u003Cstrong>此為獨立產品線，不是 Rack PDU\u003C\u002Fstrong>，亦不適用 OCP Rack PDU Profile。\u003C\u002Fp>\n\u003Ch2 id=\"section-472\">產品與協議範圍\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>項目\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>主要產品\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>iLock\u003C\u002Fstrong>（電子鎖連接埠 ×12）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>與 PDU 關係\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>無\u003C\u002Fstrong>；量測／開關型 PDU（DPM、DPH、DPP 等）不提供本章 API\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>其他機型\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>iEnv\u003C\u002Fstrong> 環控主機可外接電子鎖（外接電子鎖功能時 時暴露相同 API）；主體仍為環控，非 PDU\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>OCP 合規\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>不跑\u003C\u002Fstrong> Rack PDU Profile；可沿用 OCP Service Baseline 之 Session、Account、LogService、EventService、UpdateService 等\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>門禁建模\u003C\u002Ftd>\n\u003Ctd>DMTF／OCP \u003Cstrong>無\u003C\u002Fstrong>統一 ElectronicLock 資源；Pelx 以 \u003Ccode>Oem\u002FPelx\u002FElectronicLocks\u003C\u002Fcode> 實作\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-473\">Service Root 差異（相對於 PDU）\u003C\u002Fh3>\n\u003Cp>iLock 裝置的 \u003Ccode>\u002Fredfish\u002Fv1\u003C\u002Fcode> \u003Cstrong>不含\u003C\u002Fstrong> \u003Ccode>PowerEquipment\u003C\u002Fcode>、\u003Ccode>RackPDUs\u003C\u002Fcode>、\u003Ccode>Outlets\u003C\u002Fcode> 等配電資源。典型連結如下：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\",\n  \"Chassis\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FChassis\" },\n  \"Managers\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FManagers\" },\n  \"SessionService\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FSessionService\" },\n  \"AccountService\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FAccountService\" },\n  \"EventService\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FEventService\" },\n  \"UpdateService\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FUpdateService\" },\n  \"Oem\": {\n    \"Pelx\": {\n      \"Interfaces\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\" },\n      \"ElectronicLocks\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FElectronicLocks\" },\n      \"ElectronicLockCards\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FElectronicLockCards\" }\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-474\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 本服務根資源的 URI（\u003Ccode>GET \u002Fredfish\u002Fv1\u003C\u002Fcode> 時為 \u003Ccode>\u002Fredfish\u002Fv1\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Chassis\u003C\u002Fstrong>: 機箱集合連結；iLock 通常僅 \u003Ccode>Chassis\u002F1\u003C\u002Fcode> 代表整機機櫃\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Managers\u003C\u002Fstrong>: 管理控制器集合連結；iLock 為 \u003Ccode>Managers\u002F1\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>SessionService\u003C\u002Fstrong>: 登入／Session 管理（見 認證）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>AccountService\u003C\u002Fstrong>: 帳號與角色管理\u003C\u002Fli>\n\u003Cli>\u003Cstrong>EventService\u003C\u002Fstrong>: 事件訂閱與推送\u003C\u002Fli>\n\u003Cli>\u003Cstrong>UpdateService\u003C\u002Fstrong>: 韌體更新\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem.Pelx.Interfaces\u003C\u002Fstrong>: Pelx 介面（DI／SI／CS 等）集合；可讀取底層即時點位\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem.Pelx.ElectronicLocks\u003C\u002Fstrong>: 電子鎖路數集合（本章主資源）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem.Pelx.ElectronicLockCards\u003C\u002Fstrong>: \u003Cstrong>主機驗證\u003C\u002Fstrong>授權卡集合（主機端授權資料庫\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cblockquote>\n\u003Cp>iLock \u003Cstrong>不含\u003C\u002Fstrong> \u003Ccode>PowerEquipment\u003C\u002Fcode>、\u003Ccode>Schedules\u003C\u002Fcode>（無 \u003Ccode>DO\u003C\u002Fcode> 輸出位址）、\u003Ccode>TelemetryService\u003C\u002Fcode>（若未外接 PDU 相關硬體）等 PDU 專用連結；完整 Service Root 尚含 \u003Ccode>CertificateService\u003C\u002Fcode>、\u003Ccode>TaskService\u003C\u002Fcode>、\u003Ccode>NetworkProtocol\u003C\u002Fcode> 等 Baseline 資源，見 總覽與合規。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Cp>認證、日誌、事件訂閱等共用章節見 認證、歷史訊息、告警與事件。\u003C\u002Fp>\n\u003Ch3 id=\"section-475\">與 Chassis 的關係\u003C\u002Fh3>\n\u003Cp>電子鎖\u003Cstrong>物理上\u003C\u002Fstrong>裝設於機櫃／機箱門（門把、磁簧、鎖舌等），由 iLock 主機透過 RS485 等匯流排管理；在 Redfish 裡，這些門所屬的「機箱」以 \u003Cstrong>\u003Ccode>\u002Fredfish\u002Fv1\u002FChassis\u002F1\u003C\u002Fcode>\u003C\u002Fstrong> 代表（設備識別、位置、整體健康彙整）。\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>層面\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>物理\u003C\u002Ftd>\n\u003Ctd>每路鎖對應一扇門／一個機櫃門禁點，裝在 Chassis 所代表的機櫃上\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>管理\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Managers\u002F1\u003C\u002Fcode> 管理 \u003Ccode>Chassis\u002F1\u003C\u002Fcode>；門禁業務由 \u003Ccode>Oem\u002FPelx\u002FElectronicLocks\u003C\u002Fcode> 建模\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>狀態讀取\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>不在\u003C\u002Fstrong> \u003Ccode>GET \u002FChassis\u002F1\u003C\u002Fcode> 回應內嵌各路鎖狀態；請讀 \u003Ccode>ElectronicLocks\u002F{id}\u003C\u002Fcode> 或 \u003Ccode>Interfaces\u002F{addr}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>探索路徑\u003C\u002Ftd>\n\u003Ctd>可自 Chassis 連結至門禁集合（實作建議於 \u003Ccode>Chassis\u002F1\u003C\u002Fcode> 的 \u003Ccode>Oem.Pelx.ElectronicLocks\u003C\u002Fcode> 或 \u003Ccode>Links\u003C\u002Fcode> 提供 \u003Ccode>@odata.id\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FChassis\u002F1\",\n  \"@odata.type\": \"#Chassis.v1_22_0.Chassis\",\n  \"Id\": \"1\",\n  \"Name\": \"Chassis\",\n  \"ChassisType\": \"RackMount\",\n  \"Status\": { \"State\": \"Enabled\", \"Health\": \"OK\" },\n  \"Links\": {\n    \"ManagedBy\": [{ \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FManagers\u002F1\" }]\n  },\n  \"Oem\": {\n    \"Pelx\": {\n      \"ElectronicLocks\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FElectronicLocks\" },\n      \"ElectronicLockCards\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FElectronicLockCards\" }\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-476\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 本 Chassis 資源 URI\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: Redfish 結構描述型別\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: Chassis 識別碼（固定 \u003Ccode>\"1\"\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 顯示名稱\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ChassisType\u003C\u002Fstrong>: 機箱類型；iLock 為 \u003Ccode>RackMount\u003C\u002Fcode>（機櫃掛載）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Status.State\u003C\u002Fstrong>: 資源狀態（\u003Ccode>Enabled\u003C\u002Fcode>／\u003Ccode>Disabled\u003C\u002Fcode> 等）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Status.Health\u003C\u002Fstrong>: 整體健康（\u003Ccode>OK\u003C\u002Fcode>／\u003Ccode>Warning\u003C\u002Fcode>／\u003Ccode>Critical\u003C\u002Fcode> 等）；\u003Cstrong>不含\u003C\u002Fstrong>各路電子鎖細項\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Links.ManagedBy\u003C\u002Fstrong>: 管理本 Chassis 的 Manager 連結陣列\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem.Pelx.ElectronicLocks\u003C\u002Fstrong>: 門禁業務入口；各路鎖狀態請讀此集合或其成員\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem.Pelx.ElectronicLockCards\u003C\u002Fstrong>: \u003Cstrong>主機驗證\u003C\u002Fstrong>授權卡管理入口（非本體白名單）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>與 PDU 文件之差異\u003C\u002Fstrong>：PDU 的 \u003Ccode>Chassis\u002F1\u003C\u002Fcode> 另含 \u003Ccode>PowerDistribution\u003C\u002Fcode>、\u003Ccode>Sensors\u003C\u002Fcode>（電氣量測）等；iLock 的 Chassis 以\u003Cstrong>機櫃本體＋門禁\u003C\u002Fstrong>為主，不配電樹。門磁／門把等\u003Cstrong>語意化狀態\u003C\u002Fstrong>仍由 \u003Ccode>ElectronicLocks\u003C\u002Fcode> 彙整，底層 DI／SI 可從 \u003Ccode>Interfaces\u003C\u002Fcode> 讀取。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Chr>\n\u003Ch2 id=\"section-477\">電子鎖資源（Oem\u002FPelx\u002FElectronicLocks）\u003C\u002Fh2>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>權限\u003C\u002Fstrong>：預設見 認證（\u003Ccode>GET\u003C\u002Fcode> ReadOnly 以上；\u003Cstrong>控制 Action\u003C\u002Fstrong> 與寫入至少 \u003Cstrong>Operator\u003C\u002Fstrong>）。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch4 id=\"section-478\">出現條件\u003C\u002Fh4>\n\u003Cp>僅當設備具電子鎖功能 時暴露。每路鎖對應機櫃上的一個門禁點（見上方「與 Chassis 的關係」）。即時狀態（連線、門把、磁簧、最後卡號等）亦可透過 OEM 介面 依位址查詢；本章提供\u003Cstrong>以鎖路數 \u003Ccode>{id}\u003C\u002Fcode> 為單位\u003C\u002Fstrong>的整合介面。\u003C\u002Fp>\n\u003Ch4 id=\"section-479\">介面連結\u003C\u002Fh4>\n\u003Cp>每把電子鎖以，Redfish 以 \u003Ccode>Links.Interfaces\u003C\u002Fcode> 連結至 \u003Ccode>Oem\u002FPelx\u002FInterfaces\u002F{addr}\u003C\u002Fcode>：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>語意\u003C\u002Fth>\n\u003Cth>別名\u003C\u002Fth>\n\u003Cth>位址類型\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>連線狀態\u003C\u002Ftd>\n\u003Ctd>CS\u003C\u002Ftd>\n\u003Ctd>CS\u003C\u002Ftd>\n\u003Ctd>週邊連線\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>開鎖狀態\u003C\u002Ftd>\n\u003Ctd>US\u003C\u002Ftd>\n\u003Ctd>DI\u003C\u002Ftd>\n\u003Ctd>是否處於開鎖\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>門把狀態\u003C\u002Ftd>\n\u003Ctd>HS\u003C\u002Ftd>\n\u003Ctd>DI\u003C\u002Ftd>\n\u003Ctd>門把位置\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>磁簧狀態\u003C\u002Ftd>\n\u003Ctd>MS\u003C\u002Ftd>\n\u003Ctd>DI\u003C\u002Ftd>\n\u003Ctd>門磁\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>最後卡號\u003C\u002Ftd>\n\u003Ctd>CARD\u003C\u002Ftd>\n\u003Ctd>SI\u003C\u002Ftd>\n\u003Ctd>最近一次刷卡卡號\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>開鎖結果\u003C\u002Ftd>\n\u003Ctd>UR\u003C\u002Ftd>\n\u003Ctd>SI\u003C\u002Ftd>\n\u003Ctd>最近一次開鎖結果代碼\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>位址格式為 \u003Ccode>{類型}{十六進制編碼}\u003C\u002Fcode>，路數 \u003Ccode>{id}\u003C\u002Fcode> 編入低位元組，例如路數 1 常見為 \u003Ccode>CSA101\u003C\u002Fcode>、\u003Ccode>DIA201\u003C\u002Fcode>…\u003Ccode>SIA601\u003C\u002Fcode>（實際值依韌體為準，以 \u003Ccode>GET ...\u002FInterfaces\u003C\u002Fcode> 為準）。\u003C\u002Fp>\n\u003Ch4 id=\"section-480\">路數與硬體埠對照\u003C\u002Fh4>\n\u003Cp>Redfish 資源 \u003Ccode>{id}\u003C\u002Fcode> 採\u003Cstrong>硬體埠標籤\u003C\u002Fstrong>（與面板 A\u002FB 列一致）：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Redfish \u003Ccode>{id}\u003C\u002Fcode>\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>1A\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>第 1 組 A 埠\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>1B\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>第 1 組 B 埠\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>2A\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>第 2 組 A 埠\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>…\u003C\u002Ftd>\n\u003Ctd>…\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>6A\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>第 6 組 A 埠\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>6B\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>第 6 組 B 埠\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>公式：路數 \u003Ccode>n\u003C\u002Fcode> → \u003Ccode>{ceil(n\u002F2)}{A|B}\u003C\u002Fcode>（奇數為 A、偶數為 B）。路徑亦接受舊式數字 \u003Ccode>11\u003C\u002Fcode>（等同 \u003Ccode>6A\u003C\u002Fcode>），建議客戶端改用埠標籤。\u003C\u002Fp>\n\u003Ch4 id=\"section-481\">卡號兩種資料源\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>類型\u003C\u002Fth>\n\u003Cth>Redfish\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>本體白名單\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>...\u002FElectronicLocks\u002F{id}\u002FCards\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>卡號寫入鎖模組，設備端驗證（如 \u003Ccode>12345678\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>主機驗證\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>...\u002FElectronicLockCards\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>主機資料庫，含持卡人、時段、適用路數（如 \u003Ccode>2543209217\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>兩者\u003Cstrong>互不取代\u003C\u002Fstrong>：同一張實體卡可同時存在於本體白名單與主機驗證庫，但卡號與管理路徑不同。\u003C\u002Fp>\n\u003Ch4 id=\"section-482\">未連線時的讀寫行為\u003C\u002Fh4>\n\u003Cp>\u003Ccode>Status.Connection\u003C\u002Fcode> 為 \u003Ccode>Disconnected\u003C\u002Fcode> 表示該路鎖模組目前無法透過 RS485 通訊（可能離線、拔除或逾時）。\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>操作\u003C\u002Fth>\n\u003Cth>未連線行為\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>GET ...\u002FElectronicLocks\u002F{id}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>允許\u003C\u002Fstrong>；回傳最後已知狀態，\u003Ccode>Connection\u003C\u002Fcode> 為 \u003Ccode>Disconnected\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>GET ...\u002FElectronicLocks\u002F{id}\u002FCards\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>允許\u003C\u002Fstrong> \u003Ccode>200\u003C\u002Fcode>；\u003Ccode>Members\u003C\u002Fcode> 為空，並於 \u003Ccode>Oem.Pelx.Connection\u003C\u002Fcode> 標示 \u003Ccode>Disconnected\u003C\u002Fcode>（\u003Cstrong>不代表\u003C\u002Fstrong>「尚未設定卡號」）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>PATCH ...\u002FElectronicLocks\u002F{id}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>拒絕\u003C\u002Fstrong> \u003Ccode>400\u003C\u002Fcode>，\u003Ccode>Base.1.16.ResourceNotReady\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>POST ...\u002FActions\u002FPelxElectronicLock.Control\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>拒絕\u003C\u002Fstrong> \u003Ccode>400\u003C\u002Fcode>，\u003Ccode>Base.1.16.ResourceNotReady\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>POST\u002FDELETE ...\u002FElectronicLocks\u002F{id}\u002FCards\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>拒絕\u003C\u002Fstrong> \u003Ccode>400\u003C\u002Fcode>，\u003Ccode>Base.1.16.ResourceNotReady\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>未連線時拒絕寫入的原因：參數修改、控制命令、本體卡號維護皆需寫入鎖模組；若仍回 \u003Ccode>200\u003C\u002Fcode>／\u003Ccode>201\u003C\u002Fcode>，客戶端會誤以為操作成功，但實際未生效。\u003C\u002Fp>\n\u003Cp>錯誤回應範例：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"error\": {\n    \"@Message.ExtendedInfo\": [\n      {\n        \"Message\": \"Electronic lock is not connected\",\n        \"MessageArgs\": [],\n        \"MessageId\": \"Base.1.16.ResourceNotReady\",\n        \"Severity\": \"Warning\"\n      }\n    ],\n    \"code\": \"Base.1.16.ResourceNotReady\",\n    \"message\": \"Electronic lock is not connected\"\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>建議客戶端在 \u003Ccode>PATCH\u003C\u002Fcode>／\u003Ccode>POST\u003C\u002Fcode> 前先讀 \u003Ccode>GET ...\u002FElectronicLocks\u002F{id}\u003C\u002Fcode> 確認 \u003Ccode>Status.Connection\u003C\u002Fcode> 為 \u003Ccode>Connected\u003C\u002Fcode>；若為 \u003Ccode>Disconnected\u003C\u002Fcode>，應提示使用者檢查配線或等待連線恢復後重試。\u003C\u002Fp>\n\u003Ch3 id=\"section-483\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>取得所有電子鎖（需認證）。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FElectronicLocks\",\n  \"@odata.type\": \"#PelxElectronicLockCollection.PelxElectronicLockCollection\",\n  \"Members\": [\n    {\n      \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FElectronicLocks\u002F1A\"\n    },\n    {\n      \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FElectronicLocks\u002F1B\"\n    }\n  ],\n  \"Members@odata.count\": 2,\n  \"AuthorizedCards\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FElectronicLockCards\"\n  },\n  \"Settings\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FElectronicLocks\u002FSettings\"\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-484\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 電子鎖集合資源 URI\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: Pelx 電子鎖集合型別\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Members\u003C\u002Fstrong>: 成員連結陣列；每項僅含 \u003Ccode>@odata.id\u003C\u002Fcode>，指向單路電子鎖\u003Cul>\n\u003Cli>\u003Cstrong>Members[]\u003Ca>.@odata.id\u003C\u002Fa>\u003C\u002Fstrong>: 單路資源 URI；\u003Ccode>{id}\u003C\u002Fcode> 為硬體埠標籤（\u003Ccode>1A\u003C\u002Fcode>…\u003Ccode>6B\u003C\u002Fcode>，見上路數對照表）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ca>Members@odata.count\u003C\u002Fa>\u003C\u002Fstrong>: \u003Ccode>Members\u003C\u002Fcode> 陣列長度（等於電子鎖路數）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>AuthorizedCards\u003C\u002Fstrong>: \u003Cstrong>主機驗證\u003C\u002Fstrong>授權卡集合連結（主機端授權資料庫；與本體白名單不同，見 \u003Ccode>ElectronicLockCards\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Settings\u003C\u002Fstrong>: 電子鎖全域設定資源連結（背景檢查間隔等）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-485\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-486\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>取得單一電子鎖狀態與參數。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FElectronicLocks\u002F6A\",\n  \"@odata.type\": \"#PelxElectronicLock.v1_0_0.PelxElectronicLock\",\n  \"Id\": \"6A\",\n  \"Name\": \"2F-L-21-前門\",\n  \"UnlockTimeSec\": 5,\n  \"Status\": {\n    \"Connection\": \"Connected\",\n    \"Unlock\": \"Locked\",\n    \"Handle\": \"Closed\",\n    \"Magnetic\": \"Closed\",\n    \"LastUnlockResult\": \"None\"\n  },\n  \"LastCardId\": \"1234567890\",\n  \"Links\": {\n    \"Interfaces\": {\n      \"Connection\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FCSA101\" },\n      \"Unlock\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FDIA201\" },\n      \"Handle\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FDIA301\" },\n      \"Magnetic\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FDIA401\" },\n      \"LastCardId\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FSIA501\" },\n      \"UnlockResult\": { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FSIA601\" }\n    }\n  },\n  \"Cards\": {\n    \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FElectronicLocks\u002F6A\u002FCards\"\n  },\n  \"Actions\": {\n    \"#PelxElectronicLock.Control\": {\n      \"target\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FElectronicLocks\u002F6A\u002FActions\u002FPelxElectronicLock.Control\"\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-487\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 本路電子鎖資源 URI（\u003Ccode>{id}\u003C\u002Fcode> 為埠標籤，如 \u003Ccode>6A\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: Pelx 單路電子鎖型別\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 資源識別碼（字串，與路徑 \u003Ccode>{id}\u003C\u002Fcode> 相同，如 \u003Ccode>6A\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 顯示名稱（ELOCK 元素之 \u003Ccode>caption\u003C\u002Fcode>，如 \u003Ccode>2F-L-21-前門\u003C\u002Fcode>；未設定時為 \u003Ccode>Elock6A\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>UnlockTimeSec\u003C\u002Fstrong>: 開鎖維持秒數（整數\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Status\u003C\u002Fstrong>: 語意化即時狀態（由底層 DI／SI／CS 彙整，非原始點位值）\u003Cul>\n\u003Cli>\u003Cstrong>Connection\u003C\u002Fstrong>: 週邊連線狀態，\u003Ccode>Connected\u003C\u002Fcode>／\u003Ccode>Disconnected\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Unlock\u003C\u002Fstrong>: 鎖舌／開鎖狀態，\u003Ccode>Open\u003C\u002Fcode>（已開鎖）／\u003Ccode>Locked\u003C\u002Fcode>（已閉鎖）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Handle\u003C\u002Fstrong>: 門把狀態，\u003Ccode>Open\u003C\u002Fcode>／\u003Ccode>Closed\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Magnetic\u003C\u002Fstrong>: 門磁狀態，\u003Ccode>Open\u003C\u002Fcode>／\u003Ccode>Closed\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>LastUnlockResult\u003C\u002Fstrong>: 最近一次開鎖結果代碼（字串枚舉），見下表\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>LastCardId\u003C\u002Fstrong>: 最近一次刷卡卡號（字串；無刷卡紀錄時為空字串）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Links.Interfaces\u003C\u002Fstrong>: 各狀態對應之 Pelx 介面資源連結（唯讀探索用）\u003Cul>\n\u003Cli>\u003Cstrong>Connection\u003C\u002Fstrong>: 連線狀態介面（CS 類型，如 \u003Ccode>CSA101\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Unlock\u003C\u002Fstrong>: 開鎖狀態介面（DI）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Handle\u003C\u002Fstrong>: 門把介面（DI）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Magnetic\u003C\u002Fstrong>: 門磁介面（DI）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>LastCardId\u003C\u002Fstrong>: 最後卡號介面（SI）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>UnlockResult\u003C\u002Fstrong>: 開鎖結果介面（SI）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Cards\u003C\u002Fstrong>: 本路電子鎖\u003Cstrong>本體白名單\u003C\u002Fstrong>連結（寫入鎖模組\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Actions\u003C\u002Fstrong>: 可執行動作\u003Cul>\n\u003Cli>\u003Cstrong>#PelxElectronicLock.Control\u003C\u002Fstrong>: 遠端控制（開鎖、閉鎖等）\u003Cul>\n\u003Cli>\u003Cstrong>target\u003C\u002Fstrong>: \u003Ccode>POST\u003C\u002Fcode> 控制動作的 URI\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-488\">LastUnlockResult 對照\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>代碼\u003C\u002Fth>\n\u003Cth>Redfish 值\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>0\u003C\u002Ftd>\n\u003Ctd>None\u003C\u002Ftd>\n\u003Ctd>無\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>1\u003C\u002Ftd>\n\u003Ctd>CardValid\u003C\u002Ftd>\n\u003Ctd>設備卡號驗證成功\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>2\u003C\u002Ftd>\n\u003Ctd>CardInvalid\u003C\u002Ftd>\n\u003Ctd>設備卡號驗證失敗\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>3\u003C\u002Ftd>\n\u003Ctd>CardByHost\u003C\u002Ftd>\n\u003Ctd>卡號由主機判斷\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>4\u003C\u002Ftd>\n\u003Ctd>HostCardValid\u003C\u002Ftd>\n\u003Ctd>主機卡號驗證成功\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>5\u003C\u002Ftd>\n\u003Ctd>HostCardInvalid\u003C\u002Ftd>\n\u003Ctd>主機卡號驗證失敗\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>6\u003C\u002Ftd>\n\u003Ctd>Rs485Unlock\u003C\u002Ftd>\n\u003Ctd>RS485 命令開鎖\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>7\u003C\u002Ftd>\n\u003Ctd>KeyUnlock\u003C\u002Ftd>\n\u003Ctd>鑰匙開鎖\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>8\u003C\u002Ftd>\n\u003Ctd>DiUnlock\u003C\u002Ftd>\n\u003Ctd>DI 開鎖\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>9\u003C\u002Ftd>\n\u003Ctd>HostCardNotFound\u003C\u002Ftd>\n\u003Ctd>主機卡號不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>10\u003C\u002Ftd>\n\u003Ctd>HostCardExpired\u003C\u002Ftd>\n\u003Ctd>主機卡號已過期\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>11\u003C\u002Ftd>\n\u003Ctd>HostCardNotInPeriod\u003C\u002Ftd>\n\u003Ctd>主機卡號不在有效期間\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch4 id=\"section-489\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>路數不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-490\">PATCH https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>修改電子鎖參數。\u003Cstrong>該路須為連線狀態\u003C\u002Fstrong>。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"UnlockTimeSec\": 8\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-491\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>UnlockTimeSec\u003C\u002Fstrong>（必填）: 開鎖維持秒數（正整數\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>成功時回 \u003Ccode>200\u003C\u002Fcode>，body 為更新後的完整電子鎖資源（結構同 \u003Ccode>GET ...\u002FElectronicLocks\u002F{id}\u003C\u002Fcode>）。\u003C\u002Fp>\n\u003Ch4 id=\"section-492\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常；body 為更新後資源\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>參數錯誤，或電子鎖未連線（\u003Ccode>ResourceNotReady\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>路數不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-493\">POST https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>控制電子鎖。\u003Cstrong>該路須為連線狀態\u003C\u002Fstrong>。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"ControlType\": \"Unlock\"\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-494\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>ControlType\u003C\u002Fstrong>（與 \u003Ccode>CtrlKind\u003C\u002Fcode> 擇一）: 控制類型字串，見下表\u003C\u002Fli>\n\u003Cli>\u003Cstrong>CtrlKind\u003C\u002Fstrong>（與 \u003Ccode>ControlType\u003C\u002Fcode> 擇一）: 控制類型數值 1–5，；兩者同時存在時以 \u003Ccode>ControlType\u003C\u002Fcode> 為準\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-495\">ControlType 對照\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>ControlType\u003C\u002Fth>\n\u003Cth>ctrlKind\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>Unlock\u003C\u002Ftd>\n\u003Ctd>1\u003C\u002Ftd>\n\u003Ctd>開鎖\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Lock\u003C\u002Ftd>\n\u003Ctd>2\u003C\u002Ftd>\n\u003Ctd>閉鎖\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>HostCardValid\u003C\u002Ftd>\n\u003Ctd>3\u003C\u002Ftd>\n\u003Ctd>主機卡號驗證成功\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>HostCardInvalid\u003C\u002Ftd>\n\u003Ctd>4\u003C\u002Ftd>\n\u003Ctd>主機卡號驗證失敗\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>ResetUnlockStatus\u003C\u002Ftd>\n\u003Ctd>5\u003C\u002Ftd>\n\u003Ctd>將開鎖狀態值重設為 0\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>亦可改送數值欄位 \u003Ccode>CtrlKind\u003C\u002Fcode>（1–5），；兩者擇一，同時存在時以 \u003Ccode>ControlType\u003C\u002Fcode> 為準。\u003C\u002Fp>\n\u003Cp>成功時回 \u003Ccode>200\u003C\u002Fcode>，body 為執行後的完整電子鎖資源（結構同 \u003Ccode>GET ...\u002FElectronicLocks\u002F{id}\u003C\u002Fcode>，可讀取更新後的 \u003Ccode>Status\u003C\u002Fcode>）。\u003C\u002Fp>\n\u003Ch4 id=\"section-496\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>控制失敗、參數錯誤，或電子鎖未連線（\u003Ccode>ResourceNotReady\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>路數不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-497\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>取得該路電子鎖\u003Cstrong>本體白名單\u003C\u002Fstrong>卡號集合（需認證。卡號寫入鎖模組，供\u003Cstrong>設備端\u003C\u002Fstrong>驗證刷卡；與主機驗證用的 \u003Ccode>ElectronicLockCards\u003C\u002Fcode>（auth）為不同資料源。未連線時仍回 \u003Ccode>200\u003C\u002Fcode>（供 Redfish 連結遍歷），但 \u003Ccode>Oem.Pelx.Connection\u003C\u002Fcode> 為 \u003Ccode>Disconnected\u003C\u002Fcode> 且 \u003Ccode>Members\u003C\u002Fcode> 為空；請勿將此情況解讀為「無卡號」。\u003C\u002Fp>\n\u003Cp>連線時範例：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FElectronicLocks\u002F6A\u002FCards\",\n  \"@odata.type\": \"#PelxElectronicLockCardCollection.PelxElectronicLockCardCollection\",\n  \"Members\": [\n    {\n      \"Id\": \"12345678\"\n    }\n  ],\n  \"Members@odata.count\": 1,\n  \"Oem\": {\n    \"Pelx\": {\n      \"Connection\": \"Connected\"\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>未連線時範例：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FElectronicLocks\u002F1A\u002FCards\",\n  \"@odata.type\": \"#PelxElectronicLockCardCollection.PelxElectronicLockCardCollection\",\n  \"Members\": [],\n  \"Members@odata.count\": 0,\n  \"Oem\": {\n    \"Pelx\": {\n      \"Connection\": \"Disconnected\"\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>本體卡僅有卡號字串，\u003Cstrong>不提供\u003C\u002Fstrong> \u003Ccode>GET ...\u002FCards\u002F{cardId}\u003C\u002Fcode> 單卡資源；請自 \u003Ccode>Members[].Id\u003C\u002Fcode> 讀取卡號，刪除時使用 \u003Ccode>DELETE ...\u002FCards\u002F{cardId}\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Ch4 id=\"section-498\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 本路本體卡號集合 URI（\u003Ccode>{id}\u003C\u002Fcode> 為埠標籤，如 \u003Ccode>6A\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: Pelx 卡號集合型別\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Members\u003C\u002Fstrong>: 寫入該路鎖模組的卡號陣列\u003Cul>\n\u003Cli>\u003Cstrong>Members[].Id\u003C\u002Fstrong>: 卡號字串（與鎖模組儲存值相同）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ca>Members@odata.count\u003C\u002Fa>\u003C\u002Fstrong>: \u003Ccode>Members\u003C\u002Fcode> 陣列長度\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem.Pelx.Connection\u003C\u002Fstrong>: 本路鎖模組連線狀態（\u003Ccode>Connected\u003C\u002Fcode>／\u003Ccode>Disconnected\u003C\u002Fcode>）；為 \u003Ccode>Disconnected\u003C\u002Fcode> 時 \u003Ccode>Members\u003C\u002Fcode> 不可信，請改讀父資源 \u003Ccode>GET ...\u002FElectronicLocks\u002F{id}\u003C\u002Fcode> 的 \u003Ccode>Status.Connection\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-499\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常（含未連線時之空集合）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>路數不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>503\u003C\u002Ftd>\n\u003Ctd>電子鎖服務不可用\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-500\">POST https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>新增本體白名單卡號。\u003Cstrong>該路電子鎖須為連線狀態\u003C\u002Fstrong>（\u003Ccode>GET ...\u002FElectronicLocks\u002F{id}\u003C\u002Fcode> 的 \u003Ccode>Status.Connection\u003C\u002Fcode> 為 \u003Ccode>Connected\u003C\u002Fcode>）；未連線時回 \u003Ccode>400\u003C\u002Fcode>，卡號不會寫入鎖模組。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"Id\": \"12345678\"\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>亦可使用欄位 \u003Ccode>CardId\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Ch4 id=\"section-501\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong> \u002F \u003Cstrong>CardId\u003C\u002Fstrong>（擇一，必填）: 卡號字串（寫入鎖模組）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>成功時回 \u003Ccode>201 Created\u003C\u002Fcode>，body 為：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"Id\": \"12345678\"\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-502\">回應欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 已寫入鎖模組的卡號\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-503\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>201\u003C\u002Ftd>\n\u003Ctd>建立成功\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>卡號格式錯誤，或電子鎖未連線（\u003Ccode>ResourceNotReady\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>路數不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-504\">DELETE https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>刪除本體白名單卡號。\u003Cstrong>該路電子鎖須為連線狀態\u003C\u002Fstrong>；未連線時回 \u003Ccode>400\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Cp>成功時回 \u003Ccode>200\u003C\u002Fcode>，body 為 \u003Ccode>{}\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Ch4 id=\"section-505\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>電子鎖未連線（\u003Ccode>ResourceNotReady\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>路數或卡號不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-506\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>取得\u003Cstrong>主機驗證\u003C\u002Fstrong>授權卡號集合（需認證。與 per-lock 本體白名單不同：此處含持卡人、到期日、適用路數、時段等，供\u003Cstrong>主機端\u003C\u002Fstrong>驗證刷卡。資料來源為主機授權服務，\u003Cstrong>不受\u003C\u002Fstrong>單路電子鎖連線狀態影響。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FElectronicLockCards\",\n  \"@odata.type\": \"#PelxElectronicLockCardCollection.PelxElectronicLockCardCollection\",\n  \"Members\": [\n    {\n      \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FElectronicLockCards\u002F2543209217\"\n    }\n  ],\n  \"Members@odata.count\": 1\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>集合亦可自 \u003Ccode>GET ...\u002FElectronicLocks\u003C\u002Fcode> 的 \u003Ccode>AuthorizedCards\u003C\u002Fcode> 連結進入。\u003C\u002Fp>\n\u003Ch4 id=\"section-507\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 全域授權卡號集合 URI\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: Pelx 授權卡號集合型別\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Members\u003C\u002Fstrong>: 全部授權卡連結陣列\u003Cul>\n\u003Cli>\u003Cstrong>Members[]\u003Ca>.@odata.id\u003C\u002Fa>\u003C\u002Fstrong>: 單張授權卡資源 URI；\u003Ccode>GET\u003C\u002Fcode> 該 URI 可取得完整卡資訊\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ca>Members@odata.count\u003C\u002Fa>\u003C\u002Fstrong>: \u003Ccode>Members\u003C\u002Fcode> 陣列長度\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-508\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>503\u003C\u002Ftd>\n\u003Ctd>主機授權服務不可用\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-509\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>取得單一授權卡號完整資訊。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FElectronicLockCards\u002F2543209217\",\n  \"@odata.type\": \"#PelxElectronicLockCard.v1_0_0.PelxElectronicLockCard\",\n  \"Id\": \"2543209217\",\n  \"Name\": \"張三\",\n  \"Username\": \"張三\",\n  \"ExpireTime\": 1735689600,\n  \"NeverExpires\": false,\n  \"PeriodIds\": [1, 2],\n  \"ElectronicLocks\": [\"6A\", \"6B\"]\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-510\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 本授權卡資源 URI（\u003Ccode>{cardId}\u003C\u002Fcode> 為實體卡號字串）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: Pelx 授權卡型別\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 卡號識別碼（字串；、刷卡機讀取之卡號）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 顯示名稱（通常與 \u003Ccode>Username\u003C\u002Fcode> 相同；未設定持卡人時回退為卡號）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Username\u003C\u002Fstrong>: 持卡人名稱\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ExpireTime\u003C\u002Fstrong>: 到期 Unix 時間戳（秒，UTC）；\u003Ccode>0\u003C\u002Fcode> 表示永不過期\u003C\u002Fli>\n\u003Cli>\u003Cstrong>NeverExpires\u003C\u002Fstrong>: 布林值；\u003Ccode>ExpireTime == 0\u003C\u002Fcode> 時為 \u003Ccode>true\u003C\u002Fcode>，否則 \u003Ccode>false\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PeriodIds\u003C\u002Fstrong>: 允許刷卡之時段規則 ID 陣列\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ElectronicLocks\u003C\u002Fstrong>: 本卡可開啟之電子鎖路數（埠標籤字串陣列，如 \u003Ccode>6A\u003C\u002Fcode>、\u003Ccode>6B\u003C\u002Fcode>； 經轉換）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem.Pelx\u003C\u002Fstrong>（選填）: 廠商擴充欄位；對應廠商擴充物件 物件，僅在 \u003Ccode>extra\u003C\u002Fcode> 非空時出現\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-511\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>卡號不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>503\u003C\u002Ftd>\n\u003Ctd>主機授權服務不可用\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-512\">POST https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>新增授權卡號。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"Id\": \"2543209217\",\n  \"Username\": \"張三\",\n  \"ExpireTime\": 0,\n  \"PeriodIds\": [1],\n  \"ElectronicLocks\": [\"6A\", \"6B\"]\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-513\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>（必填）: 卡號（字串；；不可與既有卡重複）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Username\u003C\u002Fstrong>（必填）: 持卡人名稱\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ExpireTime\u003C\u002Fstrong>（選填，預設 \u003Ccode>0\u003C\u002Fcode>）: 到期 Unix 時間戳（秒）；\u003Ccode>0\u003C\u002Fcode> 表示永不過期\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PeriodIds\u003C\u002Fstrong>（選填，預設 \u003Ccode>[]\u003C\u002Fcode>）: 時段規則 ID 陣列；空陣列表示不限制時段（依設備驗證邏輯）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ElectronicLocks\u003C\u002Fstrong>（必填）: 適用電子鎖埠標籤陣列（如 \u003Ccode>[\"6A\",\"6B\"]\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>elockIds\u003C\u002Fstrong>（可替代 \u003Ccode>ElectronicLocks\u003C\u002Fcode>）: 路數整數陣列（如 \u003Ccode>[11,12]\u003C\u002Fcode>），與埠標籤擇一語意\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem.Pelx\u003C\u002Fstrong>（選填）: 廠商擴充物件；對應廠商擴充物件（未提供時送空物件 \u003Ccode>{}\u003C\u002Fcode>）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>\u003Ccode>ExpireTime\u003C\u002Fcode> 為 \u003Ccode>0\u003C\u002Fcode> 或不填表示永不過期。\u003C\u002Fp>\n\u003Cp>成功時回 \u003Ccode>201 Created\u003C\u002Fcode>，\u003Ccode>Location\u003C\u002Fcode> 指向 \u003Ccode>\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FElectronicLockCards\u002F{cardId}\u003C\u002Fcode>，body 為建立後的完整卡資源（結構同 \u003Ccode>GET ...\u002FElectronicLockCards\u002F{cardId}\u003C\u002Fcode>）。\u003C\u002Fp>\n\u003Ch4 id=\"section-514\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>201\u003C\u002Ftd>\n\u003Ctd>建立成功\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>參數錯誤或建立失敗\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-515\">PATCH https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>修改授權卡號。\u003Cstrong>須提供完整欄位\u003C\u002Fstrong>（與資源完整欄位定義一致；未送出的欄位會被視為空值覆寫）。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"Username\": \"李四\",\n  \"ExpireTime\": 1735689600,\n  \"PeriodIds\": [1, 2],\n  \"ElectronicLocks\": [\"6A\"]\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-516\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>Username\u003C\u002Fstrong>（必填）: 持卡人名稱\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ExpireTime\u003C\u002Fstrong>（必填）: 到期 Unix 時間戳（秒）；\u003Ccode>0\u003C\u002Fcode> 表示永不過期\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PeriodIds\u003C\u002Fstrong>（必填）: 時段規則 ID 陣列（可為空陣列 \u003Ccode>[]\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ElectronicLocks\u003C\u002Fstrong>（必填）: 適用電子鎖埠標籤陣列；亦可改送 \u003Cstrong>elockIds\u003C\u002Fstrong> 整數陣列\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem.Pelx\u003C\u002Fstrong> \u002F \u003Cstrong>extra\u003C\u002Fstrong>（選填）: 廠商擴充物件；未提供時送 \u003Ccode>{}\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>成功時回 \u003Ccode>200\u003C\u002Fcode>，body 為更新後的完整卡資源（結構同 \u003Ccode>GET ...\u002FElectronicLockCards\u002F{cardId}\u003C\u002Fcode>）。\u003C\u002Fp>\n\u003Ch4 id=\"section-517\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>參數錯誤\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>卡號不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-518\">DELETE https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>刪除授權卡號。\u003C\u002Fp>\n\u003Cp>成功時回 \u003Ccode>200\u003C\u002Fcode>，body 為空 JSON 物件：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-519\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>無請求 body；回應 \u003Ccode>{}\u003C\u002Fcode> 表示刪除成功（Redfish 慣例空物件）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-520\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>卡號不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-521\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>取得電子鎖全域設定（需認證。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FElectronicLocks\u002FSettings\",\n  \"@odata.type\": \"#PelxElectronicLockSettings.v1_0_0.PelxElectronicLockSettings\",\n  \"Id\": \"Settings\",\n  \"Name\": \"Electronic Lock Settings\",\n  \"IntervalCheckMinutes\": 5\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-522\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 電子鎖全域設定資源 URI\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: Pelx 電子鎖設定型別\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 資源識別碼（固定 \u003Ccode>\"Settings\"\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 顯示名稱（固定 \u003Ccode>\"Electronic Lock Settings\"\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>IntervalCheckMinutes\u003C\u002Fstrong>: 背景檢查間隔（分鐘，整數\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-523\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-524\">PATCH https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>修改全域設定。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"IntervalCheckMinutes\": 10\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-525\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>IntervalCheckMinutes\u003C\u002Fstrong>（必填）: 背景檢查間隔（分鐘，正整數\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>成功時回 \u003Ccode>200\u003C\u002Fcode>，body 為更新後的完整設定資源（結構同 \u003Ccode>GET ...\u002FElectronicLocks\u002FSettings\u003C\u002Fcode>）。\u003C\u002Fp>\n\u003Ch4 id=\"section-526\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>參數錯誤\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch4 id=\"section-527\">事件與日誌\u003C\u002Fh4>\n\u003Cp>開鎖、刷卡、卡號維護等事件請讀 \u003Ccode>Managers\u002F1\u002FLogServices\u002FOperational\u003C\u002Fcode> 與 \u003Ccode>Audit\u003C\u002Fcode>（見 歷史訊息）；即時狀態可訂閱 MQTT 或輪詢 \u003Ccode>Oem\u002FPelx\u002FElectronicLocks\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Ch1 id=\"section-528\">Pelx 擴充（OEM）\u003C\u002Fh1>\n\u003Cp>下列為 \u003Cstrong>Pelx OEM 路徑\u003C\u002Fstrong>（\u003Ccode>Oem\u002FPelx\u002F*\u003C\u002Fcode>），非 DMTF 標準資源模型。整合方若僅需 OCP 合規可忽略本章節。\u003C\u002Fp>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>同一套入口\u003C\u002Fstrong>：RS485、VNode、圖控、自動化流程等工程組態，對外一律經 \u003Ccode>https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002F...\u003C\u002Fcode>；沿用 auth.md 既有 RBAC（工程寫入須 \u003Cstrong>Administrator\u003C\u002Fstrong>）。\u003Cstrong>不\u003C\u002Fstrong>另開對外 REST。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>模組\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003Cth>權限\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>OEM 介面\u003C\u002Ftd>\n\u003Ctd>完整介面列表（Oem\u002FPelx\u002FInterfaces）\u003C\u002Ftd>\n\u003Ctd>讀：ReadOnly；寫：見 auth\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>週邊樹\u003C\u002Ftd>\n\u003Ctd>週邊結構樹（Oem\u002FPelx\u002FPeripheralTree；設備週邊結構服務）\u003C\u002Ftd>\n\u003Ctd>讀：ReadOnly\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>MQTT Discovery\u003C\u002Ftd>\n\u003Ctd>MQTT 連線資訊（Oem.Pelx.MqttEndpoint）\u003C\u002Ftd>\n\u003Ctd>讀\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>排程\u003C\u002Ftd>\n\u003Ctd>排程管理（Oem\u002FPelx\u002FSchedules）\u003C\u002Ftd>\n\u003Ctd>寫：Operator\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>oem serial buses\u003C\u002Ftd>\n\u003Ctd>RS485 串列參數（Oem\u002FPelx\u002FSerialBuses）\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Administrator\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>oem vnodes\u003C\u002Ftd>\n\u003Ctd>VNode 組態（Oem\u002FPelx\u002FVNodes）\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Administrator\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>oem hmi screens\u003C\u002Ftd>\n\u003Ctd>圖控畫面與樣版匯出／載入（Oem\u002FPelx\u002FHmiScreens）\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Administrator\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>oem hmi image libraries\u003C\u002Ftd>\n\u003Ctd>圖控圖庫上傳／匯入（Oem\u002FPelx\u002FHmiImageLibraries）\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Administrator\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>oem automations\u003C\u002Ftd>\n\u003Ctd>自動化流程／Flow（Oem\u002FPelx\u002FAutomations）\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>Administrator\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>e ports\u003C\u002Ftd>\n\u003Ctd>E-Port 週邊名稱\u003C\u002Ftd>\n\u003Ctd>見 hwctrl\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cblockquote>\n\u003Cp>電子鎖為 \u003Cstrong>iLock 獨立產品\u003C\u002Fstrong>，規格見「iLock 電子鎖」章節，不列於 PDU 擴充目錄。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch2 id=\"section-529\">OEM 擴充：完整介面列表（Pelx 擴充）\u003C\u002Fh2>\n\u003Cp>標準 Chassis \u002F PowerEquipment 資源未涵蓋的 DI、SI、HR、VNode 等週邊，透過 OEM 資源輸出完整 \u003Ccode>interfaces\u003C\u002Fcode> 資料。\u003C\u002Fp>\n\u003Cp>\u003Cstrong>\u003Ccode>addr\u003C\u002Fcode> 以 \u003Ccode>DO\u003C\u002Fcode> 開頭\u003C\u002Fstrong>的介面為 Discrete Output，代表 PDU 上可輸出控制的外接設備（如 E-Port）；排程 \u003Ccode>command: out\u003C\u002Fcode> 的非 OCP 目標可引用此類介面，見 排程。電子鎖門禁請用「iLock 電子鎖」章節。\u003C\u002Fp>\n\u003Ch3 id=\"section-530\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\",\n  \"@odata.type\": \"#PelxInterfaceCollection.PelxInterfaceCollection\",\n  \"Members\": [\n    { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FAI2101\" }\n  ],\n  \"Members@odata.count\": 1\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>集合內 \u003Ccode>Members\u003C\u002Fcode> 為 Redfish 慣例的 \u003Ccode>@odata.id\u003C\u002Fcode> 連結；單筆詳情見 \u003Ccode>GET ...\u002FInterfaces\u002F{addr}\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>大量即時監控\u003C\u002Fstrong>：Pelx 多點即時看板請用 \u003Cstrong>MQTT\u003C\u002Fstrong> \u003Ccode>\u002Fupdate\u003C\u002Fcode>（第 11 章），\u003Cstrong>不需\u003C\u002Fstrong>擴充本集合為內嵌 \u003Ccode>value\u003C\u002Fcode>。本 API 供資源探索、單筆讀取、排程／連結對照。若需一次取得完整\u003Cstrong>週邊結構樹\u003C\u002Fstrong>（分類／路數／介面），請用 週邊樹（\u003Ccode>Oem\u002FPelx\u002FPeripheralTree\u003C\u002Fcode>）。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch4 id=\"section-531\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 介面集合資源 URI，固定 \u003Ccode>\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#PelxInterfaceCollection.PelxInterfaceCollection\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Members\u003C\u002Fstrong>: 介面資源連結陣列（元素為 \u003Ccode>{ \"@odata.id\": \"...\" }\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ca>Members@odata.count\u003C\u002Fa>\u003C\u002Fstrong>: 介面總數\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-532\">單筆介面欄位（\u003Ccode>GET ...\u002FInterfaces\u002F{addr}\u003C\u002Fcode>）\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>欄位\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>addr\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>介面位址，格式見 \u003Ccode>Oem\u002FPelx\u002FInterfaces\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>name\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>介面名稱，顯示名稱\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>alias\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>介面別名\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>peripheralAlias\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>週邊別名（如 \u003Ccode>INFEED\u003C\u002Fcode>、\u003Ccode>OUTLET\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>elementId\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>週邊路數\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>unit\u003C\u002Fstrong> \u002F \u003Cstrong>type\u003C\u002Fstrong> \u002F \u003Cstrong>value\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>單位、型別、即時讀值\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>status\u003C\u002Fstrong> \u002F \u003Cstrong>params\u003C\u002Fstrong> \u002F \u003Cstrong>health\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>狀態、閾值、Redfish Health\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch4 id=\"section-533\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-534\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>依介面位址查詢單筆，例如 \u003Ccode>AI2101\u003C\u002Fcode>。\u003Ccode>{addr}\u003C\u002Fcode> 為介面位址。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FAI2101\",\n  \"@odata.type\": \"#PelxInterface.v1_0_0.PelxInterface\",\n  \"Id\": \"AI2101\",\n  \"Name\": \"Infeed1 Voltage\",\n  \"addr\": \"AI2101\",\n  \"name\": \"Infeed1 Voltage\",\n  \"alias\": \"V\",\n  \"peripheralAlias\": \"INFEED\",\n  \"elementId\": 1,\n  \"unit\": \"V\",\n  \"type\": \"FLOAT\",\n  \"value\": 220.4,\n  \"status\": \"ok\",\n  \"params\": {\n    \"hc\": 250,\n    \"hw\": 240,\n    \"lc\": 190,\n    \"lw\": 200\n  },\n  \"health\": \"OK\"\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-535\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 資源型別，固定 \u003Ccode>#PelxInterface.v1_0_0.PelxInterface\u003C\u002Fcode>（\u003Cstrong>Mandatory\u003C\u002Fstrong>；缺此欄位 Validator 報錯）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 與 \u003Ccode>{addr}\u003C\u002Fcode> 相同\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 顯示名稱\u003C\u002Fli>\n\u003Cli>\u003Cstrong>addr\u003C\u002Fstrong>: 介面位址（body 欄位），與路徑參數相同\u003C\u002Fli>\n\u003Cli>\u003Cstrong>name\u003C\u002Fstrong>: 介面名稱，顯示名稱\u003C\u002Fli>\n\u003Cli>\u003Cstrong>alias\u003C\u002Fstrong>: 介面別名，別名\u003C\u002Fli>\n\u003Cli>\u003Cstrong>peripheralAlias\u003C\u002Fstrong>: 所屬週邊分類別名（如 \u003Ccode>INFEED\u003C\u002Fcode>、\u003Ccode>OUTLET\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>elementId\u003C\u002Fstrong>: 所屬週邊路數，週邊路數\u003C\u002Fli>\n\u003Cli>\u003Cstrong>unit\u003C\u002Fstrong>: 資料單位\u003C\u002Fli>\n\u003Cli>\u003Cstrong>type\u003C\u002Fstrong>: 資料型別，如 \u003Ccode>FLOAT\u003C\u002Fcode>、\u003Ccode>BOOL\u003C\u002Fcode>、\u003Ccode>STRING\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>value\u003C\u002Fstrong>: 即時讀值，對應 \u003Ccode>GET \u002Finterfaces\u003C\u002Fcode> 的 \u003Cstrong>value\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>status\u003C\u002Fstrong>: 介面狀態，相關說明請參考 介面狀態\u003C\u002Fli>\n\u003Cli>\u003Cstrong>params\u003C\u002Fstrong>: 閾值參數物件\u003Cul>\n\u003Cli>\u003Cstrong>hc\u003C\u002Fstrong>: 過高異常值\u003C\u002Fli>\n\u003Cli>\u003Cstrong>hw\u003C\u002Fstrong>: 過高警告值\u003C\u002Fli>\n\u003Cli>\u003Cstrong>lc\u003C\u002Fstrong>: 過低異常值\u003C\u002Fli>\n\u003Cli>\u003Cstrong>lw\u003C\u002Fstrong>: 過低警告值\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>health\u003C\u002Fstrong>: 已由 \u003Cstrong>status\u003C\u002Fstrong> 轉換的 Redfish Health（\u003Ccode>OK\u003C\u002Fcode> \u002F \u003Ccode>Warning\u003C\u002Fcode> \u002F \u003Ccode>Critical\u003C\u002Fcode>）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-536\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>介面位址不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-537\">Pelx CSDL 與 \u003Ccode>$metadata\u003C\u002Fcode>\u003C\u002Fh3>\n\u003Cp>其他資源上的 \u003Ccode>Oem.Pelx\u003C\u002Fcode> 欄位（\u003Ccode>Interface\u003C\u002Fcode>、\u003Ccode>Interfaces\u003C\u002Fcode>、\u003Ccode>InterfaceGroups\u003C\u002Fcode>）由 \u003Cstrong>Pelx.v1_0_0\u003C\u002Fstrong> schema 定義：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>端點\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>GET \u002Fredfish\u002Fv1\u002F$metadata\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>OData 中繼資料；\u003Cstrong>內嵌\u003C\u002Fstrong>完整 \u003Ccode>Pelx_v1.xml\u003C\u002Fcode> CSDL\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>GET \u002Fredfish\u002Fv1\u002Fschemas\u002FPelx_v1.xml\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>獨立 schema 文件（與源碼 \u003Ccode>hwctrl\u002Fredfish\u002Fschema\u002FPelx_v1.xml\u003C\u002Fcode> 同步）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>設備部署路徑：\u003Ccode>\u002Froot\u002Frpm6\u002Fshare\u002Frpm6\u002Fredfish\u002Fschemas\u002FPelx_v1.xml\u003C\u002Fcode>。執行 DMTF Service Validator 時，本機 \u003Ccode>Redfish-Publications\u002Fcsdl\u002FPelx_v1.xml\u003C\u002Fcode> 須與設備版本一致，否則 \u003Ccode>Oem.Pelx.Interface\u003C\u002Fcode> 等欄位會被判為 Unknown Property。\u003C\u002Fp>\n\u003Chr>\n\u003Ch2 id=\"section-538\">週邊樹（PeripheralTree，Pelx 擴充）\u003C\u002Fh2>\n\u003Cp>本章提供設備\u003Cstrong>週邊結構樹\u003C\u002Fstrong> API。一次回傳分類 → 路數（elements）→ 介面的完整結構，供 AI／規劃工具／整合方盤點週邊節點，無需對 \u003Ccode>Oem\u002FPelx\u002FInterfaces\u003C\u002Fcode> 逐筆組樹。\u003C\u002Fp>\n\u003Cp>此能力不屬 OCP Rack PDU Profile 必填。\u003C\u002Fp>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>入口原則\u003C\u002Fstrong>：對外只走 \u003Ccode>https:\u002F\u002F<host>\u002Fredfish\u002Fv1\u003C\u002Fcode>；閘道轉呼叫設備週邊結構，\u003Cstrong>不\u003C\u002Fstrong>另開對外 REST，亦\u003Cstrong>不\u003C\u002Fstrong>在路徑或資源名稱使用內部結構名稱。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>與 Interfaces 分工\u003C\u002Fstrong>：\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>\u003Ccode>PeripheralTree\u003C\u002Fcode>\u003C\u002Fstrong>：結構盤點（名稱、別名、路數、\u003Ccode>addr\u003C\u002Fcode>、單位、型別等）；\u003Cstrong>不含\u003C\u002Fstrong>即時 \u003Ccode>value\u003C\u002Fcode>／告警 \u003Ccode>status\u003C\u002Fcode>／閾值 \u003Ccode>params\u003C\u002Fcode>。\u003C\u002Fli>\n\u003Cli>\u003Cstrong>\u003Ccode>Oem\u002FPelx\u002FInterfaces\u002F{addr}\u003C\u002Fcode>\u003C\u002Fstrong>：單點即時值、狀態、閾值。\u003C\u002Fli>\n\u003Cli>大量即時看板仍用 \u003Cstrong>MQTT\u003C\u002Fstrong>（見 MQTT Discovery）。\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fblockquote>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>權限\u003C\u002Fstrong>：讀取 \u003Cstrong>ReadOnly\u003C\u002Fstrong> 即可（同 \u003Ccode>Oem\u002FPelx\u002FInterfaces\u003C\u002Fcode>）。本資源為唯讀；不提供 PATCH／POST／DELETE。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch3 id=\"section-539\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>取得整機週邊樹（單一路徑資源，非 Collection）。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FPeripheralTree\",\n  \"@odata.type\": \"#PelxPeripheralTree.v1_0_0.PelxPeripheralTree\",\n  \"Id\": \"PeripheralTree\",\n  \"Name\": \"Peripheral Tree\",\n  \"Timestamp\": 1733284850,\n  \"Peripherals\": [\n    {\n      \"Name\": \"Infeed\",\n      \"Alias\": \"INFEED\",\n      \"Elements\": [\n        {\n          \"Name\": \"Infeed1\",\n          \"Alias\": \"INFEED\",\n          \"ElementId\": 1,\n          \"Interfaces\": [\n            {\n              \"Name\": \"Voltage\",\n              \"Alias\": \"V\",\n              \"Addr\": \"AI2101\",\n              \"Unit\": \"V\",\n              \"Type\": \"FLOAT\",\n              \"DecimalPlaces\": 1,\n              \"Access\": \"RW\",\n              \"Interface\": {\n                \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FAI2101\"\n              }\n            },\n            {\n              \"Name\": \"Frequency\",\n              \"Alias\": \"FREQ\",\n              \"Addr\": \"AI2102\",\n              \"Unit\": \"Hz\",\n              \"Type\": \"FLOAT\",\n              \"DecimalPlaces\": 1,\n              \"Access\": \"RW\",\n              \"Interface\": {\n                \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FAI2102\"\n              }\n            }\n          ]\n        }\n      ]\n    },\n    {\n      \"Name\": \"Input\",\n      \"Alias\": \"INPUT\",\n      \"Elements\": [],\n      \"Interfaces\": [\n        {\n          \"Name\": \"DI1\",\n          \"Alias\": \"DI1\",\n          \"Addr\": \"DI6101\",\n          \"Type\": \"BOOL\",\n          \"Access\": \"RO\",\n          \"Interface\": {\n            \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FDI6101\"\n          }\n        }\n      ]\n    }\n  ],\n  \"Languages\": {\n    \"zh-TW\": {\n      \"INFEED\": \"電源進線\",\n      \"V\": \"電壓\",\n      \"FREQ\": \"頻率\"\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-540\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>@odata.id\u003C\u002Fstrong>: 固定 \u003Ccode>\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FPeripheralTree\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>@odata.type\u003C\u002Fstrong>: 固定 \u003Ccode>#PelxPeripheralTree.v1_0_0.PelxPeripheralTree\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong> \u002F \u003Cstrong>Name\u003C\u002Fstrong>: 資源識別與顯示名稱\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Timestamp\u003C\u002Fstrong>: Unix 時間戳（秒）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Peripherals\u003C\u002Fstrong>: 週邊分類陣列\u003Cul>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 分類名稱\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Alias\u003C\u002Fstrong>: 分類別名（如 \u003Ccode>INFEED\u003C\u002Fcode>、\u003Ccode>OUTLET\u003C\u002Fcode>、\u003Ccode>TEMPRH\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Elements\u003C\u002Fstrong>: 週邊路數列表；內建乾接點等可為空陣列\u003Cul>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong> \u002F \u003Cstrong>Alias\u003C\u002Fstrong> \u002F \u003Cstrong>ElementId\u003C\u002Fstrong>: 路數名稱、別名、序號\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Interfaces\u003C\u002Fstrong>: 該路下之介面列表\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Interfaces\u003C\u002Fstrong>:（選用）分類層級介面（無 \u003Ccode>ElementId\u003C\u002Fcode> 時，如內建 \u003Ccode>INPUT\u003C\u002Fcode> 的 DI）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>介面物件\u003C\u002Fstrong>（出現於 \u003Ccode>Elements[].Interfaces\u003C\u002Fcode> 或 \u003Ccode>Peripherals[].Interfaces\u003C\u002Fcode>）:\u003Cul>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong> \u002F \u003Cstrong>Alias\u003C\u002Fstrong>: 介面名稱／別名\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Addr\u003C\u002Fstrong>: 介面位址字串（與 \u003Ccode>Oem\u002FPelx\u002FInterfaces\u002F{addr}\u003C\u002Fcode> 相同）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Unit\u003C\u002Fstrong> \u002F \u003Cstrong>Type\u003C\u002Fstrong> \u002F \u003Cstrong>DecimalPlaces\u003C\u002Fstrong> \u002F \u003Cstrong>Size\u003C\u002Fstrong> \u002F \u003Cstrong>Access\u003C\u002Fstrong>: 單位、型別（\u003Ccode>BOOL\u003C\u002Fcode>／\u003Ccode>INT\u003C\u002Fcode>／\u003Ccode>FLOAT\u003C\u002Fcode>／\u003Ccode>STRING\u003C\u002Fcode>）、小數位、字串長度、存取（\u003Ccode>RW\u003C\u002Fcode>／\u003Ccode>RO\u003C\u002Fcode>／\u003Ccode>WO\u003C\u002Fcode>）；無則省略\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Interface\u003C\u002Fstrong>: 指向即時介面資源的連結 \u003Ccode>{ \"@odata.id\": \"...\u002FInterfaces\u002F{Addr}\" }\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Languages\u003C\u002Fstrong>: 語言包；無則省略或為空物件\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-541\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-542\">Service Root 連結\u003C\u002Fh3>\n\u003Cp>\u003Ccode>GET \u002Fredfish\u002Fv1\u003C\u002Fcode> 的 \u003Ccode>Oem.Pelx\u003C\u002Fcode> 應提供：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>\"PeripheralTree\": {\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FPeripheralTree\"\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch3 id=\"section-543\">使用建議（AI／整合）\u003C\u002Fh3>\n\u003Col>\n\u003Cli>啟動或組態變更後：\u003Cstrong>一次\u003C\u002Fstrong> \u003Ccode>GET PeripheralTree\u003C\u002Fcode> 建立週邊／點位對照並快取。\u003C\u002Fli>\n\u003Cli>需要即時值時：依樹中的 \u003Ccode>Addr\u003C\u002Fcode> 或 \u003Ccode>Interface.@odata.id\u003C\u002Fcode> 讀 \u003Ccode>Oem\u002FPelx\u002FInterfaces\u002F{addr}\u003C\u002Fcode>，或改訂 MQTT。\u003C\u002Fli>\n\u003Cli>勿高頻輪詢本資源；結構變動遠少於量測值。\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Ch2 id=\"section-544\">OEM 擴充：MQTT 連線資訊（Pelx 擴充）\u003C\u002Fh2>\n\u003Cp>大量即時監控使用 \u003Cstrong>MQTT over WebSocket\u003C\u002Fstrong>（非 Redfish 協議）。本節定義如何透過 \u003Cstrong>Redfish OEM\u003C\u002Fstrong> 提供 MQTT 連線資訊，供整合方 Discovery 後建立 MQTT Client。\u003C\u002Fp>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>僅 Discovery／連線入口\u003C\u002Fstrong>：Redfish 回傳 URL 與認證提示；即時 \u003Ccode>value\u003C\u002Fcode>／\u003Ccode>status\u003C\u002Fcode> 仍經 MQTT 訂閱 \u003Cstrong>\u003Ccode>local\u003C\u002Fcode>\u003C\u002Fstrong> topic，\u003Cstrong>不\u003C\u002Fstrong>經 Redfish 輪詢或代理。整合指南見 第 11 章。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch3 id=\"section-545\">暴露位置\u003C\u002Fh3>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>資源\u003C\u002Fth>\n\u003Cth>路徑\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>OEM 資源\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>GET \u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FMqtt\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>建議；完整 OEM JSON，含 \u003Ccode>Endpoint\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Service Root\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>GET \u002Fredfish\u002Fv1\u003C\u002Fcode> → \u003Ccode>Oem.Pelx\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>可含 \u003Ccode>MqttEndpoint\u003C\u002Fcode> 連結或字串\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Manager\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>GET \u002Fredfish\u002Fv1\u002FManagers\u002F1\u003C\u002Fcode> → \u003Ccode>Oem.Pelx\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>可選；可含 \u003Ccode>MqttEndpoint\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>屬 \u003Cstrong>Pelx OEM 擴充\u003C\u002Fstrong>，\u003Cstrong>非 OCP 必填\u003C\u002Fstrong>；不影響 Interop Validator。\u003C\u002Fp>\n\u003Ch3 id=\"section-546\">GET \u003Ccode>\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FMqtt\u003C\u002Fcode> 範例\u003C\u002Fh3>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FMqtt\",\n  \"@odata.type\": \"#Pelx.MqttConnection.v1_0_0.MqttConnection\",\n  \"Id\": \"Mqtt\",\n  \"Name\": \"Pelx MQTT WebSocket\",\n  \"Endpoint\": \"wss:\u002F\u002Fpdu.example.com\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FMqtt\",\n  \"Protocol\": \"MQTT\",\n  \"Transport\": \"WebSocket\",\n  \"MqttAuth\": \"RedfishSession\",\n  \"Description\": \"Connect with X-Auth-Token or Basic Auth; subscribe to \u002Fupdates\u002Flocal and \u002Fupdate\u002Flocal\u002F#\"\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>WebSocket 連線 URL 與 \u003Cstrong>Endpoint\u003C\u002Fstrong> 相同（\u003Ccode>wss:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FMqtt\u003C\u002Fcode>），\u003C\u002Fp>\n\u003Ch3 id=\"section-547\">Service Root 範例（精簡）\u003C\u002Fh3>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\",\n  ...\n  \"Oem\": {\n    \"Pelx\": {\n      \"Interfaces\": {\n        \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\"\n      },\n      \"TelemetryService\": {\n        \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FTelemetryService\"\n      },\n      \"Mqtt\": {\n        \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FMqtt\"\n      },\n      \"MqttEndpoint\": \"wss:\u002F\u002Fpdu.example.com\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FMqtt\",\n      \"MqttAuth\": \"RedfishSession\"\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch3 id=\"section-548\">MQTT Topic\u003C\u002Fh3>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Topic\u003C\u002Fth>\n\u003Cth>方向\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>\u003Ccode>\u002Fupdates\u002Flocal\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>設備 → 客戶端\u003C\u002Ftd>\n\u003Ctd>每秒批量 \u003Ccode>value\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>\u003Ccode>\u002Fupdate\u002Flocal\u002F{addr}\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>設備 → 客戶端\u003C\u002Ftd>\n\u003Ctd>單一介面變更（value／status）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>\u003Ccode>\u002Fupdates\u002FePort\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>設備 → 客戶端\u003C\u002Ftd>\n\u003Ctd>E-Port 相關批量（若有）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-549\">欄位說明\u003C\u002Fh3>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>欄位\u003C\u002Fth>\n\u003Cth>類型\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>Endpoint\u003C\u002Fstrong> \u002F \u003Cstrong>MqttEndpoint\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>字串（URI）\u003C\u002Ftd>\n\u003Ctd>MQTT over WebSocket 對外 URL；Redfish 整合為 \u003Ccode>wss:\u002F\u002F<host>\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FMqtt\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>\u003Cstrong>Redfish 整合認證\u003C\u002Fstrong>（\u003Ccode>\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FMqtt\u003C\u002Fcode>）：\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Header：\u003Ccode>X-Auth-Token: <session token>\u003C\u002Fcode>（\u003Ccode>POST \u002Fredfish\u002Fv1\u002FSessionService\u002FSessions\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>Header：\u003Ccode>Authorization: Basic <base64(user:pass)>\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>MQTT broker 不接受 CONNECT 層帳密作為 Redfish 認證 帳密作為 Redfish 認證；Postman 等工具請在 \u003Cstrong>HTTP Headers\u003C\u002Fstrong> 帶 token，\u003Cstrong>勿\u003C\u002Fstrong>使用 Authorization 分頁的 Basic Auth（會變成 MQTT 帳密）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3 id=\"section-550\">串接 Slave\u003C\u002Fh3>\n\u003Cp>Primary 串接時 endpoint 可能為：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>wss:\u002F\u002F<Primary>\u002Fslave\u002F<id>\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FMqtt\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>\u003Ccode>MqttEndpoint\u003C\u002Fcode>／\u003Ccode>Endpoint\u003C\u002Fcode> 應反映\u003Cstrong>目前請求所見\u003C\u002Fstrong>的對外 URL（對外 URL）。\u003C\u002Fp>\n\u003Ch3 id=\"section-551\">整合流程\u003C\u002Fh3>\n\u003Cpre>\u003Ccode>GET \u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FMqtt   → 讀 Endpoint、MqttAuth\nPOST SessionService\u002FSessions         → 取得 X-Auth-Token（或 Basic Auth）\nWebSocket connect Endpoint           → 帶 X-Auth-Token 或 Authorization\n訂閱 \u002Fupdates\u002Flocal、\u002Fupdate\u002Flocal\u002F#\n控制／告警                             → 仍用 Redfish REST\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch3 id=\"section-552\">手動測試\u003C\u002Fh3>\n\u003Cp>\u003Cstrong>curl（HTTP／WebSocket 握手）\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cpre>\u003Ccode>HOST=113.196.183.194   # 替換為設備 IP\n\n# GET 無 auth → 401\ncurl -sk -o \u002Fdev\u002Fnull -w \"%{http_code}\\n\" \"https:\u002F\u002F${HOST}\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FMqtt\"\n\n# GET + Basic → 200\ncurl -sk -u admin:admin123 -o \u002Fdev\u002Fnull -w \"%{http_code}\\n\" \"https:\u002F\u002F${HOST}\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FMqtt\"\n\n# WebSocket 無 auth → 401\ncurl -sk --max-time 5 -o \u002Fdev\u002Fnull -w \"%{http_code}\\n\" \\\n  -H \"Connection: Upgrade\" -H \"Upgrade: websocket\" \\\n  -H \"Sec-WebSocket-Version: 13\" -H \"Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==\" \\\n  \"https:\u002F\u002F${HOST}\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FMqtt\"\n\n# WebSocket + Basic → 101\ncurl -sk --max-time 5 -o \u002Fdev\u002Fnull -w \"%{http_code}\\n\" \\\n  -u admin:admin123 \\\n  -H \"Connection: Upgrade\" -H \"Upgrade: websocket\" \\\n  -H \"Sec-WebSocket-Version: 13\" -H \"Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==\" \\\n  \"https:\u002F\u002F${HOST}\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FMqtt\"\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>\u003Cstrong>MQTTX CLI（訂閱 MQTT，需 ≥ 1.11，支援 \u003Ccode>-wh\u003C\u002Fcode> WebSocket Header）\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cp>MQTTX \u003Cstrong>Desktop 無法\u003C\u002Fstrong>自訂 WebSocket HTTP Header，Redfish 路徑請用 \u003Cstrong>CLI\u003C\u002Fstrong> 或 \u003Cstrong>mqtt.js\u003C\u002Fstrong>（\u003Ccode>wsOptions.headers\u003C\u002Fcode>）。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>npm install -g mqttx-cli@1.12.1\n\nmqttx sub \\\n  -h <HOST> -p 443 -l wss \\\n  --path \u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FMqtt \\\n  -t '\u002Fupdates\u002Flocal' \\\n  -wh \"Authorization: Basic $(printf 'admin:admin123' | base64)\" \\\n  --insecure\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>設備使用自簽 TLS 憑證時加 \u003Cstrong>\u003Ccode>--insecure\u003C\u002Fcode>\u003C\u002Fstrong>。認證亦可改 \u003Ccode>-wh \"X-Auth-Token: <token>\"\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Cp>\u003Cstrong>Postman\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>類型\u003C\u002Fth>\n\u003Cth>用途\u003C\u002Fth>\n\u003Cth>Headers\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Cstrong>HTTP\u003C\u002Fstrong> Request\u003C\u002Ftd>\n\u003Ctd>GET \u003Ccode>\u002FOem\u002FPelx\u002FMqtt\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>手動加 \u003Ccode>Authorization\u003C\u002Fcode> 或 \u003Ccode>X-Auth-Token\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>WebSocket\u003C\u002Fstrong> Request\u003C\u002Ftd>\n\u003Ctd>驗證握手 401／101\u003C\u002Ftd>\n\u003Ctd>同上\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cstrong>MQTT\u003C\u002Fstrong> Request\u003C\u002Ftd>\n\u003Ctd>❌ 不適用\u003C\u002Ftd>\n\u003Ctd>無 Headers 分頁；Authorization 分頁變 MQTT 帳密\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cul>\n\u003Cli>第 11 章\u003C\u002Fli>\n\u003Cli>串接.md §4.5\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"section-553\">排程（Schedules，Pelx 擴充）\u003C\u002Fh2>\n\u003Cp>本章提供 Pelx 排程管理 Redfish API（\u003Ccode>Oem\u002FPelx\u002FSchedules\u003C\u002Fcode>）。此能力不屬 OCP Rack PDU Profile 必填。\u003C\u002Fp>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>權限\u003C\u002Fstrong>：預設見「認證」章節（控制 Action 與寫入至少 \u003Cstrong>Operator\u003C\u002Fstrong>）。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch4 id=\"section-554\">出現條件\u003C\u002Fh4>\n\u003Cp>僅當裝置具備可排程之\u003Cstrong>輸出點\u003C\u002Fstrong>時，\u003Ccode>GET \u002Fredfish\u002Fv1\u003C\u002Fcode> 的 \u003Ccode>Oem.Pelx.Schedules\u003C\u002Fcode> 連結與本章 API 才會出現；否則回 \u003Ccode>404\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>條件\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>OCP 插座\u003C\u002Ftd>\n\u003Ctd>具可控插座時（\u003Ccode>Links.Outlets\u003C\u002Fcode>；底層為 \u003Ccode>DO\u003C\u002Fcode> 位址）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>DO 介面\u003C\u002Ftd>\n\u003Ctd>至少一個 \u003Ccode>Oem\u002FPelx\u002FInterfaces\u002F{addr}\u003C\u002Fcode> 且 \u003Ccode>{addr}\u003C\u002Fcode> \u003Cstrong>以 \u003Ccode>DO\u003C\u002Fcode> 開頭\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>僅 \u003Cstrong>Outlet\u003C\u002Fstrong> 與 \u003Cstrong>\u003Ccode>DO\u003C\u002Fcode> 開頭位址\u003C\u002Fstrong>可為排程目標；僅有 infeed／ATS／AI／DI／SI 等讀取或量測點位\u003Cstrong>不會\u003C\u002Fstrong>出現 Schedules。\u003C\u002Fp>\n\u003Cp>\u003Cstrong>iLock 純電子鎖主機\u003C\u002Fstrong>（僅 CS／DI／SI 等讀取或門禁點位，無 \u003Ccode>DO\u003C\u002Fcode> 輸出）\u003Cstrong>不提供\u003C\u002Fstrong> Schedules。電子鎖門禁請用 \u003Ccode>Oem\u002FPelx\u002FElectronicLocks\u003C\u002Fcode>（見「iLock 電子鎖」章節）。\u003C\u002Fp>\n\u003Cp>排程的\u003Cstrong>控制目標\u003C\u002Fstrong>以 Redfish 資源連結（\u003Ccode>@odata.id\u003C\u002Fcode>）表示，以 \u003Ccode>@odata.id\u003C\u002Fcode> 表示：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>目標類型\u003C\u002Fth>\n\u003Cth>Redfish 欄位\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>OCP 插座\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Links.Outlets[]\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>標準 \u003Ccode>PowerEquipment\u002FRackPDUs\u002F1\u002FOutlets\u002F{id}\u003C\u002Fcode>；底層仍對應 DO 位址\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>可輸出控制設備\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Links.Interfaces[]\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Oem\u002FPelx\u002FInterfaces\u002F{addr}\u003C\u002Fcode>，\u003Cstrong>\u003Ccode>addr\u003C\u002Fcode> 須以 \u003Ccode>DO\u003C\u002Fcode> 開頭\u003C\u002Fstrong>（見下方）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>串接設備（從機）\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Oem.Pelx.SlaveTargets[]\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Cstrong>僅雙網卡且設為主機時\u003C\u002Fstrong>出現；各項含 \u003Ccode>DeviceId\u003C\u002Fcode> 與 \u003Ccode>Interfaces[]\u003C\u002Fcode>（\u003Ccode>DO\u003C\u002Fcode> 開頭位址）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch4 id=\"section-555\">SlaveTargets 出現條件\u003C\u002Fh4>\n\u003Cp>僅當裝置為\u003Cstrong>雙網卡\u003C\u002Fstrong>且網路模式設為\u003Cstrong>主機\u003C\u002Fstrong>時，回應才會包含 \u003Ccode>Oem.Pelx.SlaveTargets\u003C\u002Fcode>。單網卡或從機模式不會出現此欄位；\u003Ccode>POST\u003C\u002Fcode>／\u003Ccode>PATCH\u003C\u002Fcode> 帶入 \u003Ccode>SlaveTargets\u003C\u002Fcode> 將回 \u003Ccode>400\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Ch4 id=\"section-556\">DO 位址語意\u003C\u002Fh4>\n\u003Cp>\u003Cstrong>\u003Ccode>DO\u003C\u002Fcode> 代表所有透過輸出點操作的設備\u003C\u002Fstrong>，不限單一週邊種類，例如：\u003C\u002Fp>\n\u003Cul>\n\u003Cli>插座繼電器（\u003Ccode>peripheralAlias: OUTLET\u003C\u002Fcode>）\u003C\u002Fli>\n\u003Cli>E-Port 等乾接點輸出週邊\u003C\u002Fli>\n\u003Cli>其他僅在 Pelx 介面列表出現、未映射至 OCP \u003Ccode>Outlets\u003C\u002Fcode> 的輸出點\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>\u003Ccode>AI\u003C\u002Fcode>、\u003Ccode>DI\u003C\u002Fcode>、\u003Ccode>SI\u003C\u002Fcode> 等為讀取或輸入類介面，\u003Cstrong>不可\u003C\u002Fstrong>作為 \u003Ccode>command: out\u003C\u002Fcode> 的排程目標。位址格式見 \u003Ccode>Oem\u002FPelx\u002FInterfaces\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Cp>\u003Ccode>command: out\u003C\u002Fcode> 時，\u003Cstrong>插座與其他 DO 設備可混用\u003C\u002Fstrong>於同一排程。。\u003C\u002Fp>\n\u003Ch3 id=\"section-557\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>取得所有排程。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FSchedules\",\n  \"@odata.type\": \"#PelxScheduleCollection.PelxScheduleCollection\",\n  \"Members\": [\n    {\n      \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FSchedules\u002F1\"\n    }\n  ],\n  \"Members@odata.count\": 1\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch3 id=\"section-558\">GET https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>取得單一排程。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FSchedules\u002F1\",\n  \"@odata.type\": \"#PelxSchedule.v1_0_0.PelxSchedule\",\n  \"Id\": \"1\",\n  \"Name\": \"Task 1\",\n  \"Enabled\": true,\n  \"Type\": 1,\n  \"Month\": 1,\n  \"Day\": 1,\n  \"Weekday\": 1,\n  \"Hour\": 1,\n  \"Minute\": 1,\n  \"SkipHoliday\": true,\n  \"ExecuteOnBoot\": true,\n  \"Command\": \"out\",\n  \"Links\": {\n    \"Outlets\": [\n      { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets\u002F1\" }\n    ],\n    \"Interfaces\": [\n      { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FDO0101\" },\n      { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FDO0102\" }\n    ]\n  },\n  \"Arg\": {\n    \"Action\": 1\n  },\n  \"Actions\": {\n    \"#PelxSchedule.SetEnabled\": {\n      \"target\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FSchedules\u002F1\u002FActions\u002FPelxSchedule.SetEnabled\"\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-559\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>Id\u003C\u002Fstrong>: 排程唯一識別碼\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 排程名稱\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Enabled\u003C\u002Fstrong>: 是否啟用\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Type\u003C\u002Fstrong>: 週期類型（1: 特定日期, 2: 每月, 3: 每週, 4: 每日, 5: 每小時）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Month\u003C\u002Fstrong>: 月份（1-12）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Day\u003C\u002Fstrong>: 日期（1-31）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Weekday\u003C\u002Fstrong>: 星期（1-7，1=星期日）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Hour\u003C\u002Fstrong>: 小時（0-23）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Minute\u003C\u002Fstrong>: 分鐘（0-59）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>SkipHoliday\u003C\u002Fstrong>: 是否跳過假日\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ExecuteOnBoot\u003C\u002Fstrong>: 開機補執行\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Command\u003C\u002Fstrong>: 指令類型（目前 \u003Ccode>out\u003C\u002Fcode>；之後可擴充其他指令）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Links.Outlets\u003C\u002Fstrong>: OCP 插座資源連結（選填）；解析為對應的 \u003Ccode>DO…\u003C\u002Fcode> 位址\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Links.Interfaces\u003C\u002Fstrong>: 可輸出控制之 Pelx 介面連結，\u003Cstrong>路徑 \u003Ccode>{addr}\u003C\u002Fcode> 須以 \u003Ccode>DO\u003C\u002Fcode> 開頭\u003C\u002Fstrong>（選填；與 \u003Ccode>Links.Outlets\u003C\u002Fcode> 至少擇一非空）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Arg.Action\u003C\u002Fstrong>: 指令動作（1: ON, 2: OFF, 3: RESTART, 4: MOMENTARY）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem.Pelx.SlaveTargets\u003C\u002Fstrong>: 串接從機目標（\u003Cstrong>僅雙網卡主機模式\u003C\u002Fstrong>；否則省略）\u003Cul>\n\u003Cli>\u003Cstrong>DeviceId\u003C\u002Fstrong>: 串接裝置識別碼\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Interfaces\u003C\u002Fstrong>: 該裝置上的介面資源連結\u003C\u002Fli>\n\u003C\u002Ful>\n\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>主機模式範例（\u003Ccode>Oem.Pelx\u003C\u002Fcode> 僅在此條件下出現）：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"Oem\": {\n    \"Pelx\": {\n      \"SlaveTargets\": [\n        {\n          \"DeviceId\": 1,\n          \"Interfaces\": [\n            { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FDO0103\" }\n          ]\n        }\n      ]\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-560\">task ↔ Redfish 欄位對照\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>task (\u003Ccode>\u002Fschedules\u003C\u002Fcode>)\u003C\u002Fth>\n\u003Cth>Redfish (\u003Ccode>Oem\u002FPelx\u002FSchedules\u003C\u002Fcode>)\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>uId\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>name\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Name\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>run\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Enabled\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>type\u003C\u002Fcode> … \u003Ccode>minute\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Type\u003C\u002Fcode> … \u003Ccode>Minute\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>skipHoliday\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>SkipHoliday\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>executeOnBoot\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>ExecuteOnBoot\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>command\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Command\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>arg.action\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Arg.Action\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>arg.targets\u003C\u002Fcode>（本機 \u003Ccode>DO…\u003C\u002Fcode> 位址）\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Links.Outlets\u003C\u002Fcode>（→ \u003Ccode>DO…\u003C\u002Fcode>）+ \u003Ccode>Links.Interfaces\u003C\u002Fcode>（\u003Ccode>DO…\u003C\u002Fcode>）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>arg.slaveTargets[].id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Oem.Pelx.SlaveTargets[].DeviceId\u003C\u002Fcode>（僅雙網卡主機）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>arg.slaveTargets[].targets\u003C\u002Fcode>（\u003Ccode>DO…\u003C\u002Fcode> 位址）\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Oem.Pelx.SlaveTargets[].Interfaces[]\u003C\u002Fcode>（僅雙網卡主機）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cblockquote>\n\u003Cp>\u003Cstrong>Outlets 與 Interfaces 的選擇\u003C\u002Fstrong>：已在 OCP \u003Ccode>Outlets\u003C\u002Fcode> 曝光的插座，建議用 \u003Ccode>Links.Outlets\u003C\u002Fcode>；其餘僅能透過 \u003Ccode>DO…\u003C\u002Fcode> 位址操作的外接輸出設備（如 E-Port），用 \u003Ccode>Links.Interfaces\u003C\u002Fcode>。同一實體勿重複列入兩邊。查詢可用目標：\u003Ccode>GET Oem\u002FPelx\u002FInterfaces\u003C\u002Fcode>，篩選 \u003Ccode>addr\u003C\u002Fcode> 以 \u003Ccode>DO\u003C\u002Fcode> 開頭者。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch3 id=\"section-561\">POST https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>新增排程。request body 欄位同 \u003Ccode>GET ...\u002FSchedules\u002F{id}\u003C\u002Fcode>，但可省略 \u003Ccode>Id\u003C\u002Fcode>、\u003Ccode>Enabled\u003C\u002Fcode>（新建時 task 預設啟用）與 \u003Ccode>Actions\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Cp>一般範例（每日排程，控制本機插座與 DO 介面）：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"Name\": \"Outlet daily on\",\n  \"Type\": 4,\n  \"Month\": 1,\n  \"Day\": 1,\n  \"Weekday\": 1,\n  \"Hour\": 8,\n  \"Minute\": 30,\n  \"SkipHoliday\": true,\n  \"ExecuteOnBoot\": false,\n  \"Command\": \"out\",\n  \"Links\": {\n    \"Outlets\": [\n      { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets\u002F1\" }\n    ],\n    \"Interfaces\": [\n      { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FDO0101\" }\n    ]\n  },\n  \"Arg\": {\n    \"Action\": 1\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>雙網卡主機模式可另加 \u003Ccode>Oem.Pelx.SlaveTargets\u003C\u002Fcode>（見上方「SlaveTargets 出現條件」）：\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"Name\": \"Host schedule with slaves\",\n  \"Type\": 4,\n  \"Month\": 1,\n  \"Day\": 1,\n  \"Weekday\": 1,\n  \"Hour\": 2,\n  \"Minute\": 0,\n  \"SkipHoliday\": false,\n  \"ExecuteOnBoot\": true,\n  \"Command\": \"out\",\n  \"Links\": {\n    \"Outlets\": [\n      { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets\u002F1\" }\n    ]\n  },\n  \"Arg\": {\n    \"Action\": 2\n  },\n  \"Oem\": {\n    \"Pelx\": {\n      \"SlaveTargets\": [\n        {\n          \"DeviceId\": 1,\n          \"Interfaces\": [\n            { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FDO0103\" },\n            { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FDO0104\" }\n          ]\n        },\n        {\n          \"DeviceId\": 2,\n          \"Interfaces\": [\n            { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FInterfaces\u002FDO0105\" }\n          ]\n        }\n      ]\n    }\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-562\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>Name\u003C\u002Fstrong>: 排程名稱（\u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Type\u003C\u002Fstrong>: 週期類型（\u003Cstrong>Mandatory\u003C\u002Fstrong>）；1 特定日期、2 每月、3 每週、4 每日、5 每小時\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Month\u003C\u002Fstrong>: 月份 1–12；\u003Ccode>Type\u003C\u002Fcode> 為 1 時必填\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Day\u003C\u002Fstrong>: 日期 1–31；\u003Ccode>Type\u003C\u002Fcode> 為 1 或 2 時必填\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Weekday\u003C\u002Fstrong>: 星期 1–7（1=星期日）；\u003Ccode>Type\u003C\u002Fcode> 為 3 時必填\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Hour\u003C\u002Fstrong>: 小時 0–23（\u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Minute\u003C\u002Fstrong>: 分鐘 0–59（\u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>SkipHoliday\u003C\u002Fstrong>: 是否跳過假日（\u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>ExecuteOnBoot\u003C\u002Fstrong>: 開機補執行（\u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Command\u003C\u002Fstrong>: 指令類型，目前固定 \u003Ccode>out\u003C\u002Fcode>（\u003Cstrong>Mandatory\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Links.Outlets\u003C\u002Fstrong>: OCP 插座連結（選填）；與 \u003Ccode>Links.Interfaces\u003C\u002Fcode> 至少擇一非空\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Links.Interfaces\u003C\u002Fstrong>: \u003Ccode>DO\u003C\u002Fcode> 開頭之 Pelx 介面連結（選填）\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Arg.Action\u003C\u002Fstrong>: 指令動作（\u003Cstrong>Mandatory\u003C\u002Fstrong>）；1 ON、2 OFF、3 RESTART、4 MOMENTARY\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Oem.Pelx.SlaveTargets\u003C\u002Fstrong>: 從機目標（選填；\u003Cstrong>僅雙網卡主機\u003C\u002Fstrong>）\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>成功時回 \u003Ccode>201 Created\u003C\u002Fcode>，\u003Ccode>Location\u003C\u002Fcode> 指向 \u003Ccode>\u002Fredfish\u002Fv1\u002FOem\u002FPelx\u002FSchedules\u002F{id}\u003C\u002Fcode>，body 為建立後的排程資源。\u003C\u002Fp>\n\u003Ch4 id=\"section-563\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>201\u003C\u002Ftd>\n\u003Ctd>建立成功\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>參數錯誤（含非主機模式帶 \u003Ccode>SlaveTargets\u003C\u002Fcode>、無效連結 URI）\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-564\">PATCH https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>修改排程。，須送出\u003Cstrong>完整\u003C\u002Fstrong>排程內容（與 \u003Ccode>POST\u003C\u002Fcode> 相同欄位集合），不可僅送部分欄位。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"Name\": \"Outlet daily on (updated)\",\n  \"Type\": 4,\n  \"Month\": 1,\n  \"Day\": 1,\n  \"Weekday\": 1,\n  \"Hour\": 9,\n  \"Minute\": 0,\n  \"SkipHoliday\": true,\n  \"ExecuteOnBoot\": false,\n  \"Command\": \"out\",\n  \"Links\": {\n    \"Outlets\": [\n      { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets\u002F1\" },\n      { \"@odata.id\": \"\u002Fredfish\u002Fv1\u002FPowerEquipment\u002FRackPDUs\u002F1\u002FOutlets\u002F2\" }\n    ],\n    \"Interfaces\": []\n  },\n  \"Arg\": {\n    \"Action\": 1\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>僅變更啟用狀態時，請使用 \u003Ccode>POST ...\u002FActions\u002FPelxSchedule.SetEnabled\u003C\u002Fcode>，勿僅 PATCH \u003Ccode>Enabled\u003C\u002Fcode> 單一欄位。\u003C\u002Fp>\n\u003Ch4 id=\"section-565\">欄位說明如下:\u003C\u002Fh4>\n\u003Cul>\n\u003Cli>\u003Cstrong>id\u003C\u002Fstrong>（路徑參數）: 排程識別碼\u003C\u002Fli>\n\u003Cli>其餘欄位同 \u003Ccode>POST\u003C\u002Fcode>；主機模式下可含 \u003Ccode>Oem.Pelx.SlaveTargets\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch4 id=\"section-566\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常；body 為更新後的排程資源\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>參數錯誤\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>排程不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-567\">DELETE https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>刪除排程。\u003C\u002Fp>\n\u003Ch4 id=\"section-568\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>排程不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch3 id=\"section-569\">POST https:\u002F\u002F\u003C\u002Fh3>\n\u003Cp>啟用或停用排程。\u003C\u002Fp>\n\u003Cpre>\u003Ccode>{\n  \"Enabled\": true\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch4 id=\"section-570\">回傳資料狀態\u003C\u002Fh4>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>狀態碼\u003C\u002Fth>\n\u003Cth>說明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>200\u003C\u002Ftd>\n\u003Ctd>正常\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>未認證\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>權限不足\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>排程不存在\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n","\u002Fmanual\u002FRedfish\u002FRedfish-zh.md","\u002Fmanual\u002FRedfish\u002FRedfish-zh.pdf",1790240695061]