Share via

업데이트 서비스

  • 아티클

지정된 업데이트 설명을 사용하여 Service Fabric 서비스를 업데이트.

이 API를 사용하면 실행 중인 Service Fabric 서비스의 속성을 업데이트할 수 있습니다. 업데이트할 수 있는 속성 집합은 서비스를 만들 때 지정된 속성의 하위 집합입니다. API를 사용하여 GetServiceDescription 현재 속성 집합을 가져올 수 있습니다. 실행 중인 서비스의 속성을 업데이트하는 것은 API를 사용하여 StartApplicationUpgrade 애플리케이션을 업그레이드하는 것과 다릅니다. 업그레이드는 애플리케이션을 한 번에 한 버전에서 다른 업그레이드 도메인으로 이동하는 것을 포함하는 장기 실행 백그라운드 작업인 반면 업데이트는 새 속성을 서비스에 즉시 적용합니다.

요청

메서드 요청 URI
POST /Services/{serviceId}/$/Update?api-version=6.0&timeout={timeout}

매개 변수

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

serviceId

형식: 문자열
필수: 예

서비스 id입니다. 이 ID는 일반적으로 'fabric:' URI 스키마가 없는 서비스의 전체 이름입니다. 버전 6.0에서 시작하며, 계층적 이름이 "~" 문자로 구분됩니다. 예를 들어 서비스 이름이 "fabric:/myapp/app1/svc1"이면 서비스 ID는 6.0 이상에서는 "myapp~app1~svc1"이고 이전 버전에서는 "myapp/app1/svc1"입니다.

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초입니다.

ServiceUpdateDescription

형식: ServiceUpdateDescription
필수: 예

서비스를 업데이트하는 데 필요한 정보입니다.

응답

HTTP 상태 코드 설명 응답 스키마
200(확인) 작업이 성공하면 202 상태 코드가 반환됩니다.
다른 모든 상태 코드 자세한 오류 응답입니다.
 FabricError

예제

상태 비저장 서비스

이 예제에서는 상태 비정상 Service Fabric 서비스의 배치 및 부하 분산 관련 설정을 업데이트하는 방법을 보여 줍니다.

요청

POST http://localhost:19080/Services/test~test1/$/Update?api-version=6.0
본문
{
  "ServiceKind": "Stateless",
  "Flags": "1568",
  "PlacementConstraints": "Color==Red",
  "DefaultMoveCost": "High",
  "ScalingPolicies": [
    {
      "ScalingTrigger": {
        "Kind": "AveragePartitionLoad",
        "MetricName": "servicefabric:/_CpuCores",
        "LowerLoadThreshold": "0.500000",
        "UpperLoadThreshold": "0.800000",
        "ScaleIntervalInSeconds": "900"
      },
      "ScalingMechanism": {
        "Kind": "PartitionInstanceCount",
        "MinInstanceCount": "4",
        "MaxInstanceCount": "6",
        "ScaleIncrement": "2"
      }
    }
  ]
}

200 응답

본문

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

상태 저장 서비스

이 예제에서는 상태 저장 Service Fabric 서비스의 배치 및 부하 분산 관련 설정을 업데이트하는 방법을 보여 줍니다.

요청

POST http://localhost:19080/Services/test~test2/$/Update?api-version=6.0
본문
{
  "ServiceKind": "Stateful",
  "Flags": "40",
  "PlacementConstraints": "Color==Green",
  "StandByReplicaKeepDurationSeconds": "1000"
}

200 응답

본문

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