비정상 상황 이벤트 가져오기

아티클
08/05/2023

연속 토큰 또는 시간 범위를 기반으로 Chaos 이벤트의 다음 세그먼트를 가져옵니다.

Chaos 이벤트의 다음 세그먼트를 가져오기 위해 ContinuationToken을 지정할 수 있습니다. Chaos 이벤트의 새 세그먼트의 시작 부분을 가져오기 위해 StartTimeUtc 및 EndTimeUtc를 통해 시간 범위를 지정할 수 있습니다. 동일한 호출에서는 ContinuationToken과 시간 범위를 모두 지정할 수 없습니다. 100개 이상의 Chaos 이벤트가 있는 경우 Chaos 이벤트는 세그먼트가 100개 이하의 Chaos 이벤트를 포함하는 여러 세그먼트에서 반환되며, 다음 세그먼트를 가져오기 위해 연속 토큰을 사용하여 이 API에 대한 호출을 만듭니다.

요청

메서드	요청 URI
GET	`/Tools/Chaos/Events?api-version=6.2&ContinuationToken={ContinuationToken}&StartTimeUtc={StartTimeUtc}&EndTimeUtc={EndTimeUtc}&MaxResults={MaxResults}&timeout={timeout}`

매개 변수

속성	형식	필수	위치
`api-version`	문자열	예	쿼리
`ContinuationToken`	문자열	예	쿼리
`StartTimeUtc`	문자열	예	쿼리
`EndTimeUtc`	문자열	예	쿼리
`MaxResults`	정수(int64)	아니요	쿼리
`timeout`	정수(int64)	아니요	쿼리

`api-version`

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

API 버전입니다. 이 매개 변수는 필수이며 해당 값은 '6.2'여야 합니다.

Service Fabric REST API 버전은 API가 도입되었거나 변경된 런타임 버전을 기반으로 합니다. Service Fabric 런타임은 둘 이상의 API 버전을 지원합니다. 이 버전은 지원되는 최신 버전의 API입니다. 더 낮은 API 버전이 전달되면 반환된 응답이 이 사양에 설명된 응답과 다를 수 있습니다.

또한 런타임은 현재 버전의 런타임까지 지원되는 최신 버전보다 높은 모든 버전을 허용합니다. 따라서 최신 API 버전이 6.0이고 런타임이 6.1인 경우 런타임은 해당 API에 대해 버전 6.1을 수락합니다. 그러나 API의 동작은 문서화된 6.0 버전에 따라 다릅니다.

`ContinuationToken`

형식: 문자열
필수: 아니요

연속 토큰 매개 변수는 다음 결과 집합을 얻는 데 사용됩니다. 공백 값이 아닌 연속 토큰은 시스템의 결과가 단일 응답에 맞지 않는 경우 API의 응답에 포함됩니다. 이 값이 다음 API 호출에 전달되면 API는 다음 결과 집합을 반환합니다. 결과가 더 이상 없으면 연속 토큰에 값이 포함되지 않습니다. 이 매개 변수의 값은 URL 인코딩이 되지 말아야 합니다.

`StartTimeUtc`

형식: 문자열
필수: 아니요

Chaos 보고서가 생성될 시간 범위의 시작 시간을 나타내는 Windows 파일 시간입니다. 자세한 내용은 DateTime.ToFileTimeUtc 메서드를 참조하세요.

`EndTimeUtc`

형식: 문자열
필수: 아니요

Chaos 보고서가 생성될 시간 범위의 종료 시간을 나타내는 Windows 파일 시간입니다. 자세한 내용은 DateTime.ToFileTimeUtc 메서드를 참조하세요.

`MaxResults`

형식: 정수(int64)
필수: 아니요
기본: 0
InclusiveMinimum: 0

페이징된 쿼리의 일부로 반환될 결과의 최대 수입니다. 이 매개 변수는 반환되는 결과 수에 상한값을 정의합니다. 반환되는 결과는 구성에 정의된 최대 메시지 크기 제한에 따라 메시지에 맞지 않는 경우 지정된 최대의 결과보다 작을 수 있습니다. 이 매개 변수가 0이거나 지정되지 않은 경우 페이징된 쿼리는 반환 메시지에 맞는 가능한 많은 결과를 포함합니다.

`timeout`

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

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

응답

HTTP 상태 코드	설명	응답 스키마
200(확인)	Chaos 이벤트의 다음 세그먼트입니다.	ChaosEventsSegment
다른 모든 상태 코드	자세한 오류 응답입니다.	FabricError

예제

시간 범위가 지정된 비정상 상황 이벤트 가져오기

이 예제에서는 ContinuationToken 매개 변수를 통해 페이징할 필요 없이 단일 응답 메시지에서 Chaos 이벤트를 가져오는 방법을 보여 줍니다.

요청

GET http://localhost:19080/Tools/Chaos/Events?api-version=6.2&StartTimeUtc=0&EndTimeUtc=3155378975999999999

200 응답

본문

{
  "ContinuationToken": "",
  "History": [
    {
      "ChaosEvent": {
        "Kind": "Started",
        "TimeStampUtc": "2017-04-14T04:27:19.049Z",
        "ChaosParameters": {
          "MaxClusterStabilizationTimeoutInSeconds": "30",
          "MaxConcurrentFaults": "3",
          "WaitTimeBetweenIterationsInSeconds": "10",
          "WaitTimeBetweenFaultsInSeconds": "1",
          "TimeToRunInSeconds": "3600",
          "EnableMoveReplicaFaults": true,
          "ClusterHealthPolicy": {
            "ConsiderWarningAsError": true,
            "MaxPercentUnhealthyNodes": "0",
            "MaxPercentUnhealthyApplications": "10",
            "ApplicationTypeHealthPolicyMap": [
              {
                "Key": "myapp",
                "Value": "3"
              }
            ]
          },
          "Context": {
            "Map": {
              "k1": "v1",
              "k2": "v2",
              "k3": "v5"
            }
          }
        }
      }
    },
    {
      "ChaosEvent": {
        "Kind": "ExecutingFaults",
        "TimeStampUtc": "2017-04-14T04:27:20.667Z",
        "Faults": [
          "ActionType: RestartReplica, ServiceUri: fabric:/TestApp1/PersistServ_6R_1, PartitionId: 6a91b09a-bd76-45da-afaa-ed0fd9bfe7d2, ReplicaId: 131366172775684622",
          "ActionType: CodePackageRestart, NodeName: N0050, ApplicationName: fabric:/TestApp1, ServiceManifestName: SP1, ServiceManifestName: , CodePackageName: CP1.",
          "ActionType: RestartReplica, ServiceUri: fabric:/TestApp1/PersistServ_6R_3, PartitionId: baa3a51e-5c42-435e-89d3-6e97b2164661, ReplicaId: 131366172988968762"
        ]
      }
    }
  ]
}

Share via