PowerStore：如何使用 PowerStore Rest API

複寫狀態：
curl -H “Accept： application/json” -u “admin：********” -X GET -k https://xx.xx.xx.xx/api/rest/replication_session?select=id,role,state,last_sync_timestamp,local_resource_id

輸出範例：

{“id”：“047e38ee-9aeb-4761-8ca5-393204fe6584”，“role”：“Metro_Preferred”，“state”：“OK”，“last_sync_timestamp”：“2026-07-16T15： 48：05.628263+00：00”，“local_resource_id”：“d34bd80e-1d43-4692-ab37-e307bc92eb73”}，
{“id”：“26dd4105-a24f-4d82-b40b-20dcefbfe5df”，“role”：“Source”，“state”：“OK”，“last_sync_timestamp”：“2026-07-16T15：31：54.64127+00：00”，“local_resource_id”：“82c40277-dee4-46de-8559-920fe5f942cc”}，
{“id”：“414dba20-08b1-4d5e-a521-517a3b37473a”，“role”：“Metro_Preferred”，“state”：“OK”，“last_sync_timestamp”：“2026-07-16T15：51：05.525764+00：00”，“local_resource_id”：“eb970724-cc3e-4661-8d71-bec7f44baf10”}

系統警示：
curl -H “Accept： application/json” -u “admin：********” -X GET -k https://xx.xx.xx.xx/api/rest/alert?select=id,event_code,severity,resource_type,generated_timestamp,state,description_l10n

輸出範例：

{“id”：“008abb47-e72d-4608-b915-b8c01328b64e”，“event_code”：“0x01700304”，“嚴重性”：“主要”，“resource_type”：“remote_system”，“generated_timestamp”：“2026-05-11T01：51：01.280627+00：00”，“state”：“ACTIVE”，“description_l10n”：“來自遠端系統 Ghost 的所有資料連線都已中斷連線。”}，
{“id”：“01114811-82a9-484e-8cf9-3da50c0e3d7b”，“event_code”：“0x01701801”，“嚴重性”：“Info”，“resource_type”：“volume”，“generated_timestamp”：“2026-07-14T02：15：34.764524+00：00“，”state“：”CLEARED“，”description_l10n“：已啟用為資源 HyperV-Node1 設定的 Metro 見證。「}

稽核事件：
curl -H “Accept： application/json” -u “admin：********” -X GET -k https://xx.xx.xx.xx/api/rest/audit_event?select=id,type,timestamp,username,resource_type,resource_action,message_l10n,client_address

輸出可能很大，需要濾波器。例如，查看與使用者管理相關的事件。try：
curl -h “Accept： application/json” -u “admin：********” -X GET -k https://xx.xx.xx.xx/api/rest/audit_event?select=id,type,timestamp,username,resource_type,resource_action,message_l10n,client_address?username=eq.admin

輸出範例：

{“id”：“111540”，“類型”：“Config”，“時間戳記”：“2026-03-11T20：25：57.267124+00：00”，“使用者名”：“admin”，“resource_type”：“主機”，“resource_action”：“刪除”，“message_l10n”：“已成功刪除以下主機：Thors 183.24 （iSCSI） 和 ID：c698f28b-49ac-4268-a9c7-c6da66bdfbc8.”，“client_address”：“10.158.49.47”}，
{“id”：“111541”，“類型”：“Config”，“timestamp”：“2026-03-11T20：25：57.337655+00：00”，“使用者名”：“admin”，“resource_type”：“host”，“resource_action”：“刪除”，”message_l10n“：”已成功刪除中繼資料，其中有鍵：[] 與類型為：主機和 ID：c698f28b-49ac-4268-a9c7-c6da66bdfbc8.“，”client_address“：”10.158.49.47“}

快照清單：
curl -H “Accept： application/json” -u “admin：********” -X GET -k https://xx.xx.xx.xx/api/rest/volume_snap_list_cma_view?select=id,name,source_timestamp,description,creation_timestamp

輸出範例：
{“id”：“24d7856d-d389-4f05-9752-ebb1de61a6d6”，“name”：“Walid Snaps.PowerTriage-RHEL （Walid DO NOT DELETE）。2026-07-15T00：00：00Z 189403910”，“source_timestamp”：“2026-07-15T00：03：16.096762+00：00”，“描述”：“：”creation_timestamp 2026-07-15T00：03：16.096762+00：00“}，
{”id“：”2cfd727f-b09c-4895-8fd5-93850fd63698“，”name“：”Daily-File.7DSL0M2-1-001.2026-07-14T00：08：08Z 281536767“，”source_timestamp“：”2026-07-14T00：08：08.618343+00：00“，”描述“：空，”creation_timestamp“：”2026-07-14T00：08：08.618343+00：00“}

效能指標：
curl -H “Accept： application/json” -H “Content-Type： application/json” -u “admin：********” -X POST -k https://xx.xx.xx.xx/api/rest/metrics/generate -d '{ “entity”： “performance_metrics_by_appliance”， “entity_id”： “A1”，“interval”： “One_Day” }'|jq '.”

輸出範例：

{ “appliance_id”： “A1”，
“時間戳”： “2026-07-15T00：00：00Z”，
“avg_read_latency”： 172.76094，
“avg_write_latency”： 404.14536，
“avg_mirror_write_latency”： 924.59375，
“avg_mirror_overhead_latency”： 364.82297，
“avg_latency”： 273.2135，
“avg_read_size”： 91601.2，
“avg_write_size”： 6204.5635，
“avg_io_size”： 54527.355，
“avg_read_iops”： 9.996701，
“avg_write_iops”： 7.669595，
“avg_mirror_write_iops”： 0.024386574，
“avg_total_iops”： 17.666296，
“avg_read_bandwidth”： 915709.9，
“avg_write_bandwidth”： 47586.49，
“avg_mirror_write_bandwidth”： 190.67259，
“avg_total_bandwidth”： 963296.4，
“avg_io_workload_cpu_utilization”： 0.00399437453597784，
“max_avg_read_latency”： 401.14688，
“max_avg_write_latency”： 1679.9584，
“max_avg_latency”： 652.1067，
“max_avg_mirror_write_latency”： 3842，
“max_avg_mirror_overhead_latency”： 3319，
“max_avg_read_size”： 99656.45，
“max_avg_write_size”： 30189.037，
“max_avg_io_size”： 85726.97，
“max_read_iops”： 161.2，
“max_write_iops”： 680.6，
“max_mirror_write_iops”： 3.8，
“max_total_iops”： 834，
“max_read_bandwidth”： 8509440，
“max_write_bandwidth”： 8792986，
“max_mirror_write_bandwidth”： 22732.8，
“max_total_bandwidth”： 17252044，
“max_io_workload_cpu_utilization”： 0.2170485556125641，
“repeat_count”： 1,

  ...

  “response_definition”： “performance_metrics_by_appliance_rollup”，
“實體”： “performance_metrics_by_appliance”
}

Rest API 的常見錯誤：

將「-v」新增到 curl 命令以顯示錯誤。 

範例 1：錯誤的憑據。

curl -H “Accept： application/json” -u “admin：wrong_password” -k https://10.241.219.160/api/rest/hardware?select=id,name,type,lifecycle_state?type=eq.Node

* 要求已完全傳送*
TLSv1.3 （IN）、TLS 握手、Newsession 工單 （4）：<
HTTP/1.1 401 未經授權
<的 WWW-Authenticate： SSOCustom realm=“Cyclone Realm”
< 內容類型： application/json
< content-length： 0

範例 2：HTTPd 未執行。

curl -v -h “Accept： application/json” -u “admin：********” -k https://xx.xx.xx.xx/api/rest/hardware?select=id,name,type,lifecycle_state?type=eq.Node
* 正在嘗試 xx.xx.xx.xx：443...
* 從 xx.xx.xx.xx 連接埠 59124 連線至 xx.xx.xx.xx 連接埠 443 失敗：連線逾時
* 無法在 31939 毫秒後連線至 xx.xx.xx.xx 連接埠 443：無法連線至伺服器
* 正在關閉連線 #0
curl： （28） 無法在 31939 毫秒後連線至 xx.xx.xx.xx 連接埠 443：無法連線至伺服器

範例 3：沒有內容類型的語法錯誤。

curl -v -H “Accept： application/json” -u “admin：********” -X POST -k https://xx.xx.xx.xx/api/rest/metrics/generate -d '{ “entity”： “performance_metrics_by_appliance”， “entity_id”： “A1”，“interval”： “One_Day” }'
{“messages”：[{“severity”：“Error”，“code”：“0xE04040030001”，“message_l10n”：“驗證失敗： 要求內容類型標頭”[application/x-www-form-urlencoded]“與任何允許的類型不匹配。必須是以下之一： [application/json].， 要求正文為必填，但未找到..“，”參數“：[{”分隔符“：”， “，”messages“：[{”severity“：”Error“，”code“：”validation.request.contentType.notAllowed“，”message_l10n“：”Request Content-Type 標頭 '[application/x-www-form-urlencoded]' 與任何允許的類型不相符。必須是以下之一： [application/json].“，”arguments“：[”[application/x-www-form-urlencoded]“，”[application/json]“]}，{”severity“：”Error“，”code“：”validation.request.body.missing“，”message_l10n“：”需要請求正文，但未找到。“}]}]}]}

實用連結：

https://dl.dell.com/content/manual55475248-dell-powerstore-rest-api-developers-guide.pdf?language=en-us

https://< PWST_CLUSTER_IP>/大搖大擺/