노드 정보 가져오기

아티클
08/05/2023

Microsoft Azure Service Fabric 클러스터에서 특정 노드에 관한 정보를 가져옵니다.

응답에는 이름, 상태, ID, 상태, 작동 `시간 및 노드에 대한 기타 세부 정보가 포함됩니다.

요청

메서드	요청 URI
GET	`/Nodes/{nodeName}?api-version=6.0&timeout={timeout}`

매개 변수

속성	형식	필수	위치
`nodeName`	문자열	예	경로
`api-version`	문자열	예	쿼리
`timeout`	정수(int64)	아니요	쿼리

`nodeName`

형식: 문자열
필수: 예

노드의 이름입니다.

`api-version`

형식: 문자열
필수: 예
기본: 6.0

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`

형식: 정수(int64)
필수: 아니요
기본: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 요청된 작업이 완료될 때까지 클라이언트가 기다릴 시간을 지정합니다. 이 매개 변수의 기본값은 60초입니다.

응답

HTTP 상태 코드	설명	응답 스키마
200(확인)	작업이 성공하면 지정된 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 응답

본문

응답 본문은 비어 있습니다.

Share via