ノード情報の取得

Service Fabric クラスター内の特定のノードに関する情報を取得します。

応答には、名前、状態、ID、正常性、アップタイム、およびノードに関するその他の詳細が含まれます。

Request

Method	要求 URI
GET	/Nodes/{nodeName}?api-version=6.0&timeout={timeout}

パラメーター

名前	Type	必須	場所
nodeName	string	はい	パス
api-version	string	はい	クエリ
timeout	integer (int64)	いいえ	クエリ

---

nodeName

型: string
必須: はい

ノード名。

---

api-version

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

API のバージョン。 このパラメーターは必須であり、その値は '6.0' である必要があります。

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 秒です。

応答

HTTP 状態コード	説明	応答スキーマ
200 (OK)	正常に実行されると、指定した nodeName を持つノードに関する情報が返されます。	NodeInfo
204 (NoContent)	指定した nodeName が見つからない場合は、空の応答が返されます。
その他のすべての状態コード	詳細なエラー応答。	FabricError

使用例

ノード名で特定のノードを取得する

この例では、識別子を使用してノードに関する情報を取得する方法を示します。 ノードが見つかった場合は、そのノードに関する情報が 200 の状態コードで返されます。 ノードが見つからない場合は、空のコンテンツが 204 状態コードで返されます。

要求

GET http://localhost:19080/Nodes/_Node_1?api-version=6.0

200 応答

本文

{
  "Name": "_testnode_0",
  "IpAddressOrFQDN": "10.0.0.4",
  "Type": "testnode",
  "CodeVersion": "6.3.139.9494",
  "ConfigVersion": "5",
  "NodeStatus": "Up",
  "NodeUpTimeInSeconds": "18688",
  "HealthState": "Ok",
  "IsSeedNode": true,
  "UpgradeDomain": "0",
  "FaultDomain": "fd:/0",
  "Id": {
    "Id": "2acb9f55540659b1c95f27cc128ab326"
  },
  "InstanceId": "131738240209152398",
  "NodeDeactivationInfo": {
    "NodeDeactivationIntent": "Invalid",
    "NodeDeactivationStatus": "None",
    "NodeDeactivationTask": [],
    "PendingSafetyChecks": []
  },
  "IsStopped": false,
  "NodeDownTimeInSeconds": "0",
  "NodeUpAt": "2018-06-18T19:33:52.944Z",
  "NodeDownAt": "2018-06-18T19:33:39.514Z"
}

204 応答

本文

応答本文は空です。