백업 파티션

파티션 상태의 백업을 트리거합니다.

상태 저장 지속 파티션 상태의 백업을 만듭니다. 파티션이 이미 주기적으로 백업되는 경우 기본적으로 동일한 백업 스토리지에 새 백업이 만들어집니다. 백업 스토리지 세부 정보를 요청 본문의 일부로 지정하여 동일한 를 재정의할 수도 있습니다. 백업이 시작되면 GetBackupProgress 작업을 사용하여 진행률을 추적할 수 있습니다. 작업이 시간 초과되는 경우 쿼리 매개 변수에 더 큰 백업 시간 제한 값을 지정합니다.

요청

메서드	요청 URI
POST	/Partitions/{partitionId}/$/Backup?BackupTimeout={BackupTimeout}&api-version=6.4&timeout={timeout}

매개 변수

속성	형식	필수	위치
partitionId	string(uuid)	예	경로
BackupTimeout	integer	아니요	쿼리
api-version	문자열	예	쿼리
timeout	정수(int64)	아니요	쿼리
BackupPartitionDescription	BackupPartitionDescription	예	본문

---

partitionId

형식: string(uuid)
필수: 예

파티션의 id입니다.

---

BackupTimeout

형식: 정수
필수: 아니요
기본: 10

백업 작업이 완료되기를 기다리는 최대 시간(분)을 지정합니다. 게시하면 시간 제한 오류로 작업이 완료됩니다. 그러나 특정 코너의 경우 작업이 시간 제한을 다시 반환하지만 백업이 실제로 진행될 수 있습니다. 시간 제한 오류의 경우 이 작업을 더 큰 시간 제한 값으로 다시 호출하는 것이 좋습니다. 동일한 의 기본값은 10분입니다.

---

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

---

BackupPartitionDescription

형식: BackupPartitionDescription
필수: 아니요

지금 파티션을 백업하는 매개 변수에 대해 설명합니다. 없는 경우 백업 작업은 이 파티션과 연결된 백업 정책의 기본 매개 변수를 사용합니다.

응답

HTTP 상태 코드	설명	응답 스키마
202(수락됨)	202 상태 코드는 작업 요청이 수락되고 백업이 시작됨을 나타냅니다. GetPartitionBackupProgress 작업을 사용하여 백업 작업의 상태 가져옵니다.
다른 모든 상태 코드	자세한 오류 응답입니다.	FabricError

예제

백업 파티션

이 예제에서는 정기적인 백업에 대해 이미 구성된 파티션의 백업을 트리거하는 방법을 보여 줍니다. 새로 만든 백업은 주기적 백업이 저장되는 동일한 위치에 저장됩니다.

요청

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4

본문

{}

202 응답

본문

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

특정 Azure Storage 계정에 파티션 백업

이 예제에서는 지금 파티션의 백업을 트리거하고 특정 Azure Blob Storage 계정에 백업을 저장하는 방법을 보여 줍니다.

요청

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4

본문

{
  "BackupStorage": {
    "StorageKind": "AzureBlobStore",
    "ConnectionString": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<PutYourAccountKeyHere>",
    "ContainerName": "BackupContainer"
  }
}

202 응답

본문

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

관리 ID를 사용하여 액세스한 특정 Azure Storage 위치에 파티션 백업

이 예제에서는 지금 파티션의 백업을 트리거하고 관리 ID를 사용하여 특정 Azure Blob Storage 계정에 백업을 저장하는 방법을 보여 줍니다.

요청

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4

본문

{
  "BackupStorage": {
    "StorageKind": "ManagedIdentityAzureBlobStore",
    "BlobServiceUri": "https://managedidentitytest.blob.core.windows.net/",
    "ContainerName": "BackupContainer",
    "ManagedIdentityType": "Cluster"
  }
}

202 응답

본문

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

특정 온-프레미스 파일 공유에 파티션 백업

이 예제에서는 지금 파티션의 백업을 트리거하고 모든 클러스터 노드에서 액세스할 수 있는 특정 파일 공유에 백업을 저장하는 방법을 보여 줍니다.

요청

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4

본문

{
  "BackupStorage": {
    "StorageKind": "FileShare",
    "Path": "\\\\myshare\\backupshare",
    "PrimaryUserName": "mydomain\\backupaccount",
    "PrimaryPassword": "abcd1234"
  }
}

202 응답

본문

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

특정 Dsms Azure 스토리지 위치에 파티션 백업

이 예제에서는 지금 파티션의 백업을 트리거하고 특정 Dsms Azure Blob Storage 위치에 백업을 저장하는 방법을 보여 줍니다.

요청

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4

본문

{
  "BackupStorage": {
    "StorageKind": "DsmsAzureBlobStore",
    "StorageCredentialsSourceLocation": "https://sample-dsms.dsms.core.winows.net/dsms/samplecredentiallocation/storageaccounts/samplestorageac/servicefabricbackup/samplebackup",
    "ContainerName": "BackupContainer"
  }
}

202 응답

본문

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