서비스 백업 사용
이 Service Fabric 서비스에서 상태 저장 파티션을 정기적으로 백업할 수 있습니다.
이 Service Fabric 서비스의 일부인 상태 저장 파티션을 정기적으로 백업할 수 있습니다. 각 파티션은 지정된 백업 정책 설명에 따라 개별적으로 백업됩니다. 서비스의 일부인 애플리케이션이 이미 백업에 사용하도록 설정된 경우 이 작업은 파티션 수준에서 명시적으로 재정의되지 않는 한 이 서비스와 해당 파티션에 대해 주기적인 백업을 수행하는 데 사용되는 정책을 재정의합니다. C# 기반 Reliable Actor 및 Reliable Stateful 서비스만 현재 주기적 백업에 대해 지원됩니다.
요청
메서드 | 요청 URI |
---|---|
POST | /Services/{serviceId}/$/EnableBackup?api-version=6.4&timeout={timeout} |
매개 변수
속성 | 형식 | 필수 | 위치 |
---|---|---|---|
serviceId |
문자열 | 예 | 경로 |
api-version |
문자열 | 예 | 쿼리 |
timeout |
정수(int64) | 아니요 | 쿼리 |
EnableBackupDescription |
EnableBackupDescription | yes | 본문 |
serviceId
형식: 문자열
필수: 예
서비스 id입니다. 이 ID는 일반적으로 'fabric:' URI 스키마가 없는 서비스의 전체 이름입니다.
버전 6.0에서 시작하며, 계층적 이름이 "~" 문자로 구분됩니다.
예를 들어 서비스 이름이 "fabric:/myapp/app1/svc1"이면 서비스 ID는 6.0 이상에서는 "myapp~app1~svc1"이고 이전 버전에서는 "myapp/app1/svc1"입니다.
api-version
형식: 문자열
필수: 예
기본: 6.4
API 버전입니다. 이 매개 변수는 필수이며 해당 값은 '6.4'여야 합니다.
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초입니다.
EnableBackupDescription
형식: EnableBackupDescription
필수: 예
백업을 사용하도록 설정하기 위한 매개 변수를 지정합니다.
응답
HTTP 상태 코드 | 설명 | 응답 스키마 |
---|---|---|
202(수락됨) | 202 상태 코드는 서비스 백업을 사용하도록 설정하는 요청이 수락되었음을 나타냅니다. |
|
다른 모든 상태 코드 | 자세한 오류 응답입니다. |
FabricError |
예제
서비스 백업 사용
이 예제에서는 상태 저장 서비스에 대해 주기적인 백업을 사용하도록 설정하는 방법을 보여 줍니다.
요청
POST http://localhost:19080/Services/CalcApp/CalcService/$/EnableBackup?api-version=6.4
본문
{
"BackupPolicyName": "DailyAzureBackupPolicy"
}
202 응답
본문
응답 본문은 비어 있습니다.