クラスター イベント リストの取得

  • [アーティクル]

すべてのクラスター関連のイベントを取得します。

応答は ClusterEvent オブジェクトの一覧です。

Request

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

パラメーター

名前 Type 必須 場所
api-version string はい クエリ
timeout integer (int64) いいえ クエリ
StartTimeUtc string はい クエリ
EndTimeUtc string はい クエリ
EventsTypesFilter string いいえ クエリ
ExcludeAnalysisEvents boolean いいえ クエリ
SkipCorrelationLookup boolean いいえ クエリ

api-version

型: string
必須: はい
既定値:

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

型: integer (int64)
必須: いいえ
既定値:
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

操作を実行するためのサーバー タイムアウト (秒単位)。 このタイムアウトは、要求した操作が完了するまでクライアントが待機できる期間を指定します。 このパラメーターの既定値は 60 秒です。

StartTimeUtc

型: string
必須: はい

参照クエリの開始時刻 (ISO UTC yyyy-MM-ddTHH:mm:ssZ 形式)。

EndTimeUtc

型: string
必須: はい

参照クエリの終了時刻 (ISO UTC yyyy-MM-ddTHH:mm:ssZ 形式)。

EventsTypesFilter

型: string
必須: いいえ

これは、応答にのみ含める FabricEvents の種類を指定するコンマ区切りの文字列です。

ExcludeAnalysisEvents

型: boolean
必須: いいえ

このパラメーターを指定すると、true が渡された場合に AnalysisEvents の取得が無効になります。

SkipCorrelationLookup

型: boolean
必須: いいえ

このパラメーターを指定すると、true が渡された場合に CorrelatedEvents 情報の検索が無効になります。 それ以外の場合、CorrelationEvents が処理され、すべての FabricEvent の HasCorrelatedEvents フィールドに値が設定されます。

応答

HTTP 状態コード 説明 応答スキーマ
200 (OK) 基本型 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
  }
]