---
title: "Gets the information about a specific node in the Service Fabric cluster."
method: GET
path: "/Nodes/{nodeName}"
tags: ["Node"]
---

# Gets the information about a specific node in the Service Fabric cluster.

`GET /Nodes/{nodeName}`

The response includes the name, status, ID, health, uptime, and other details about the node.

## Path parameters

- `nodeName` string, required

## Query parameters

- `api-version` '6.0', required
- `timeout` integer

## Response `200`

A successful operation will return information about the node with the specified nodeName.

- NodeInfo — Information about a node in Service Fabric cluster.
  - `Name` string — The name of a Service Fabric node.
  - `IpAddressOrFQDN` string — The IP address or fully qualified domain name of the node.
  - `Type` string — The type of the node.
  - `CodeVersion` string — The version of Service Fabric binaries that the node is running.
  - `ConfigVersion` string — The version of Service Fabric cluster manifest that the node is using.
  - `NodeStatus` 'Invalid' | 'Up' | 'Down' | 'Enabling' | 'Disabling' | 'Disabled' | 'Unknown' | 'Removed' — The status of the node.
  - `NodeUpTimeInSeconds` string — Time in seconds since the node has been in NodeStatus Up. Value zero indicates that the node is not Up.
  - `HealthState` 'Invalid' | 'Ok' | 'Warning' | 'Error' | 'Unknown' — The health state of a Service Fabric entity such as Cluster, Node, Application, Service, Partition, Replica etc.
  - `IsSeedNode` boolean — Indicates if the node is a seed node or not. Returns true if the node is a seed node, otherwise false. A quorum of seed nodes are required for proper operation of Service Fabric cluster.
  - `UpgradeDomain` string — The upgrade domain of the node.
  - `FaultDomain` string — The fault domain of the node.
  - `Id` NodeId — An internal ID used by Service Fabric to uniquely identify a node. Node Id is deterministically generated from node name.
    - `Id` string — Value of the node Id. This is a 128 bit integer.
  - `InstanceId` string — The ID representing the node instance. While the ID of the node is deterministically generated from the node name and remains same across restarts, the InstanceId changes every time node restarts.
  - `NodeDeactivationInfo` NodeDeactivationInfo — Information about the node deactivation. This information is valid for a node that is undergoing deactivation or has already been deactivated.
    - `NodeDeactivationIntent` 'Invalid' | 'Pause' | 'Restart' | 'RemoveData' | 'RemoveNode' — The intent or the reason for deactivating the node. Following are the possible values for it.
    - `NodeDeactivationStatus` 'None' | 'SafetyCheckInProgress' | 'SafetyCheckComplete' | 'Completed' — The status of node deactivation operation. Following are the possible values.
    - `NodeDeactivationTask` NodeDeactivationTask[] — List of tasks representing the deactivation operation on the node.
      - `NodeDeactivationTaskId` NodeDeactivationTaskId — Identity of the task related to deactivation operation on the node.
        - `Id` string — Value of the task id.
        - `NodeDeactivationTaskType` 'Invalid' | 'Infrastructure' | 'Repair' | 'Client' — The type of the task that performed the node deactivation. Following are the possible values.
      - `NodeDeactivationIntent` 'Invalid' | 'Pause' | 'Restart' | 'RemoveData' | 'RemoveNode' — The intent or the reason for deactivating the node. Following are the possible values for it.
    - `PendingSafetyChecks` SafetyCheckWrapper[] — List of pending safety checks
      - `SafetyCheck` SafetyCheck — Represents a safety check performed by service fabric before continuing with the operations. These checks ensure the availability of the service and the reliability of the state.
        - `Kind` 'Invalid' | 'EnsureSeedNodeQuorum' | 'EnsurePartitionQuorum' | 'WaitForPrimaryPlacement' | 'WaitForPrimarySwap' | 'WaitForReconfiguration' | 'WaitForInbuildReplica' | 'EnsureAvailability', required — The kind of safety check performed by service fabric before continuing with the operations. These checks ensure the availability of the service and the reliability of the state. Following are the kinds of safety checks.
  - `IsStopped` boolean — Indicates if the node is stopped by calling stop node API or not. Returns true if the node is stopped, otherwise false.
  - `NodeDownTimeInSeconds` string — Time in seconds since the node has been in NodeStatus Down. Value zero indicates node is not NodeStatus Down.
  - `NodeUpAt` string, date-time — Date time in UTC when the node came up. If the node has never been up then this value will be zero date time.
  - `NodeDownAt` string, date-time — Date time in UTC when the node went down. If node has never been down then this value will be zero date time.

## Other responses

- `204` — An empty response is returned if the specified nodeName is not found.
- `default` — The detailed error response.

---

[API](https://skmtc.net/azure/apis/service-fabric-client-apis.md) · [All operations](https://skmtc.net/azure/apis/service-fabric-client-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/service-fabric-client-apis/versions/6df9f2f4d542/schema)