ノード情報の取得

[アーティクル]
08/05/2023

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 応答

本文

応答本文は空です。

次の方法で共有