Backup 정책 만들기

백업 정책을 만듭니다.

나중에 주기적 백업을 위해 Service Fabric 애플리케이션, 서비스 또는 파티션과 연결할 수 있는 백업 정책을 만듭니다.

요청

메서드	요청 URI
POST	/BackupRestore/BackupPolicies/$/Create?api-version=6.4&timeout={timeout}&ValidateConnection={ValidateConnection}

매개 변수

속성	형식	필수	위치
api-version	문자열	예	쿼리
timeout	정수(int64)	아니요	쿼리
ValidateConnection	boolean	예	쿼리
BackupPolicyDescription	BackupPolicyDescription	yes	본문

---

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

---

ValidateConnection

형식: 부울
필수: 아니요
기본: false

백업 정책을 만들거나 업데이트하기 전에 스토리지 연결 및 자격 증명의 유효성을 검사할지 여부를 지정합니다.

---

BackupPolicyDescription

형식: BackupPolicyDescription
필수: 예

백업 정책에 대해 설명합니다.

응답

HTTP 상태 코드	설명	응답 스키마
201(만들어짐)	성공적인 작업은 201 상태 코드를 반환하고 새 백업 정책을 만듭니다.
다른 모든 상태 코드	자세한 오류 응답입니다.	FabricError

예제

Azure를 백업 위치로 사용하여 시간 기반 백업 정책 만들기

이 예제에서는 Azure Blob 저장소를 백업 위치로 사용하여 3개월 후에 삭제되는 매일 오전 9시 및 오후 5시 UTC에 백업을 수행하는 백업 정책을 만드는 방법을 보여줍니다.

요청

POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4

본문

{
  "Name": "DailyAzureBackupPolicy",
  "AutoRestoreOnDataLoss": false,
  "MaxIncrementalBackups": "3",
  "Schedule": {
    "ScheduleKind": "TimeBased",
    "ScheduleFrequencyType": "Daily",
    "RunTimes": [
      "0001-01-01T09:00:00Z",
      "0001-01-01T17:00:00Z"
    ]
  },
  "Storage": {
    "StorageKind": "AzureBlobStore",
    "FriendlyName": "Azure_storagesample",
    "ConnectionString": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<PutYourAccountKeyHere>",
    "ContainerName": "BackupContainer"
  },
  "RetentionPolicy": {
    "RetentionPolicyType": "Basic",
    "MinimumNumberOfBackups": "20",
    "RetentionDuration": "P3M"
  }
}

201 응답

본문

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

관리 ID를 사용하여 액세스하는 백업 위치로 Azure를 사용하여 시간 기반 백업 정책 만들기

이 예제에서는 관리 ID를 사용하여 Azure Blob 저장소를 백업 위치로 사용하여 3개월 후에 삭제되는 매일 오전 9시 및 오후 5시 UTC에 매일 두 번 백업을 수행하는 백업 정책을 만드는 방법을 보여줍니다.

요청

POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4

본문

{
  "Name": "DailyAzureMIBackupPolicy",
  "AutoRestoreOnDataLoss": false,
  "MaxIncrementalBackups": "3",
  "Schedule": {
    "ScheduleKind": "TimeBased",
    "ScheduleFrequencyType": "Daily",
    "RunTimes": [
      "0001-01-01T09:00:00Z",
      "0001-01-01T17:00:00Z"
    ]
  },
  "Storage": {
    "StorageKind": "ManagedIdentityAzureBlobStore",
    "FriendlyName": "AzureMI_storagesample",
    "BlobServiceUri": "https://managedidentitytest.blob.core.windows.net/",
    "ContainerName": "BackupContainer",
    "ManagedIdentityType": "Cluster"
  },
  "RetentionPolicy": {
    "RetentionPolicyType": "Basic",
    "MinimumNumberOfBackups": "20",
    "RetentionDuration": "P3M"
  }
}

201 응답

본문

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

파일 공유를 백업 위치로 사용하여 빈도 기반 백업 정책 만들기

이 예제에서는 백업 위치로 파일 공유를 사용하여 20일 후에 삭제되는 10분마다 백업을 수행하는 백업 정책을 만드는 방법을 보여 줍니다.

요청

POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4

본문

{
  "Name": "FileShare10MinBackupPolicy",
  "AutoRestoreOnDataLoss": false,
  "MaxIncrementalBackups": "3",
  "Schedule": {
    "ScheduleKind": "FrequencyBased",
    "Interval": "PT10M"
  },
  "Storage": {
    "StorageKind": "FileShare",
    "FriendlyName": "FileShare_myshare",
    "Path": "\\\\myshare\\backupshare",
    "PrimaryUserName": "backupaccount",
    "PrimaryPassword": "abcd1234"
  },
  "RetentionPolicy": {
    "RetentionPolicyType": "Basic",
    "MinimumNumberOfBackups": "20",
    "RetentionDuration": "P20D"
  }
}

201 응답

본문

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

Dsms Azure를 백업 위치로 사용하여 시간 기반 백업 정책 만들기

이 예제에서는 Dsms Azure Blob 저장소를 백업 위치로 사용하여 3개월 후에 삭제되는 매일 오전 9시 및 오후 5시 UTC에 두 번 백업을 수행하는 백업 정책을 만드는 방법을 보여 줍니다.

요청

POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4

본문

{
  "Name": "SampleDsmsBackupPolicy",
  "AutoRestoreOnDataLoss": false,
  "MaxIncrementalBackups": "3",
  "Schedule": {
    "ScheduleKind": "TimeBased",
    "ScheduleFrequencyType": "Daily",
    "RunTimes": [
      "0001-01-01T09:00:00Z",
      "0001-01-01T17:00:00Z"
    ]
  },
  "Storage": {
    "StorageKind": "DsmsAzureBlobStore",
    "FriendlyName": "DsmsAzure_storagesample",
    "StorageCredentialsSourceLocation": "https://sample-dsms.dsms.core.winows.net/dsms/samplecredentiallocation/storageaccounts/samplestorageac/servicefabricbackup/samplebackup",
    "ContainerName": "BackupContainer"
  },
  "RetentionPolicy": {
    "RetentionPolicyType": "Basic",
    "MinimumNumberOfBackups": "20",
    "RetentionDuration": "P3M"
  }
}

201 응답

본문

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