共用方式為

取得叢集事件清單

  • 發行項

取得所有與叢集相關的事件。

回應為 ClusterEvent 物件的清單。

要求

方法 要求 URI
GET /EventsStore/Cluster/Events?api-version=6.4&timeout={timeout}&StartTimeUtc={StartTimeUtc}&EndTimeUtc={EndTimeUtc}&EventsTypesFilter={EventsTypesFilter}&ExcludeAnalysisEvents={ExcludeAnalysisEvents}&SkipCorrelationLookup={SkipCorrelationLookup}

參數

名稱 類型 必要 Location
api-version 字串 是 查詢
timeout 整數 (int64) No 查詢
StartTimeUtc string 是 查詢
EndTimeUtc string 是 查詢
EventsTypesFilter 字串 No 查詢
ExcludeAnalysisEvents boolean No 查詢
SkipCorrelationLookup boolean No 查詢

api-version

類型：字串
必要：是
預設：6.4

API 的版本。 這是必要參數，其值必須是 '6.4'。

Service Fabric REST API 版本是以導入或變更 API 的執行時間版本為基礎。 Service Fabric 執行時間支援多個版本的 API。 此版本是 API 的最新支援版本。 如果傳遞較低的 API 版本，傳回的回應可能與此規格中所述的回應不同。

此外，執行時間會接受高於最新支援版本的任何版本，最高到目前版本的執行時間。 因此，如果最新的 API 版本為 6.0，且執行時間為 6.1，則執行時間將會接受該 API 的版本 6.1。 不過，API 的行為會根據記載的 6.0 版本。

timeout

類型：整數 (int64)
必要：否
預設：60
InclusiveMaximum： 4294967295
InclusiveMinimum： 1

用來執行作業的伺服器逾時 (以秒為單位)。 此逾時指定了用戶端願意等候要求作業完成的持續時間。 這個參數的預設值是 60 秒。

StartTimeUtc

類型：字串
必要：是

查閱查詢的開始時間，格式為 ISO UTC yyyy-MM-ddTHH:mm:ssZ。

EndTimeUtc

類型：字串
必要：是

查閱查詢的結束時間，格式為 ISO UTC yyyy-MM-ddTHH:mm:ssZ。

EventsTypesFilter

類型：字串
必要：否

這是以逗號分隔的字串，指定回應中只應包含的 FabricEvents 類型。

ExcludeAnalysisEvents

類型：布林值
必要：否

如果傳遞 true，此參數會停用 AnalysisEvents 的擷取。

SkipCorrelationLookup

類型：布林值
必要：否

如果傳遞 true，此參數會停用 CorrelatedEvents 資訊的搜尋。 若非上述情況，則會處理 CorrelationEvents，並填入每個 FabricEvent 的 HasCorrelatedEvents 欄位。

回應

HTTP 狀態碼 描述 回應結構描述
200 (確定) 基底類型為 ClusterEvent 的事件物件清單。
 ClusterEvent的陣列
所有其他狀態碼 詳細的錯誤回應。
 FabricError

範例

此範例示範如何在特定時間範圍中取得所有叢集相關事件。

要求

GET http://localhost:19080/EventsStore/Cluster/Events?api-version=6.4&StartTimeUtc=2018-04-03T18:00:00Z&EndTimeUtc=2018-04-04T18:00:00Z

200 回應

主體
[
  {
    "Kind": "ClusterUpgradeStarted",
    "CurrentClusterVersion": "0.0.0.0:",
    "TargetClusterVersion": "6.2:1.0",
    "UpgradeType": "Rolling",
    "RollingUpgradeMode": "UnmonitoredAuto",
    "FailureAction": "Manual",
    "EventInstanceId": "090add3c-8f56-4d35-8d57-a855745b6064",
    "TimeStamp": "2018-04-03T20:18:59.4313064Z",
    "HasCorrelatedEvents": false
  },
  {
    "Kind": "ClusterUpgradeDomainCompleted",
    "TargetClusterVersion": "6.2:1.0",
    "UpgradeState": "RollingForward",
    "UpgradeDomains": "(0 1 2)",
    "UpgradeDomainElapsedTimeInMs": "78.5288",
    "EventInstanceId": "090add3c-8f56-4d35-8d57-a855745b6064",
    "TimeStamp": "2018-04-03T20:19:59.5729953Z",
    "HasCorrelatedEvents": false
  },
  {
    "Kind": "ClusterUpgradeDomainCompleted",
    "TargetClusterVersion": "6.2:1.0",
    "UpgradeState": "RollingForward",
    "UpgradeDomains": "(3 4)",
    "UpgradeDomainElapsedTimeInMs": "0",
    "EventInstanceId": "090add3c-8f56-4d35-8d57-a855745b6064",
    "TimeStamp": "2018-04-03T20:20:59.6271949Z",
    "HasCorrelatedEvents": false
  },
  {
    "Kind": "ClusterUpgradeCompleted",
    "TargetClusterVersion": "6.2:1.0",
    "OverallUpgradeElapsedTimeInMs": "120196.5212",
    "EventInstanceId": "090add3c-8f56-4d35-8d57-a855745b6064",
    "TimeStamp": "2018-04-03T20:20:59.8134457Z",
    "HasCorrelatedEvents": false
  }
]