Criar Política de Backup

Cria uma política de backup.

Cria uma política de backup que pode ser associada posteriormente a um aplicativo, serviço ou partição do Service Fabric para backup periódico.

Solicitação

Método URI da solicitação
POST /BackupRestore/BackupPolicies/$/Create?api-version=6.4&timeout={timeout}&ValidateConnection={ValidateConnection}

Parâmetros

Nome Tipo Obrigatório Location
api-version string Sim Consulta
timeout inteiro (int64) Não Consulta
ValidateConnection booleano Não Consulta
BackupPolicyDescription BackupPolicyDescription Sim Corpo

api-version

Tipo: string
Obrigatório: sim
Padrão: 6.4

A versão da API. Esse parâmetro é necessário e seu valor deve ser '6.4'.

A versão da API REST do Service Fabric baseia-se na versão de runtime na qual a API foi introduzida ou foi alterada. O runtime do Service Fabric dá suporte a mais de uma versão da API. Esta versão é a versão mais recente com suporte da API. Se uma versão inferior da API for passada, a resposta retornada poderá ser diferente daquela documentada nesta especificação.

Além disso, o runtime aceita qualquer versão que seja maior do que a versão mais recente com suporte até a versão atual do runtime. Portanto, se a versão mais recente da API for 6.0 e o runtime for 6.1, o runtime aceitará a versão 6.1 para essa API. No entanto, o comportamento da API será de acordo com a versão documentada 6.0.


timeout

Tipo: inteiro (int64)
Obrigatório: não
Padrão: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

Tempo limite do servidor para executar a operação em segundos. Especifica o tempo que o cliente está disposto a esperar para que operação solicitada seja concluída. O valor padrão desse parâmetro é 60 segundos.


ValidateConnection

Tipo: booliano
Obrigatório: não
Padrão: false

Especifica se é necessário validar a conexão de armazenamento e as credenciais antes de criar ou atualizar as políticas de backup.


BackupPolicyDescription

Tipo: BackupPolicyDescription
Obrigatório: sim

Descreve a política de backup.

Respostas

Código de status HTTP Descrição Esquema de Resposta
201 (Criado) Uma operação bem-sucedida retorna 201 status código e cria uma nova política de backup.
Todos os outros códigos de status A resposta de erro detalhada.
FabricError

Exemplos

Criar uma política de backup baseada em tempo com o Azure como local de backup

Este exemplo mostra como criar uma política de backup que faz backup duas vezes por dia às 9h e às 17h UTC, que deve ser excluída após 3 meses, com o repositório de blobs do Azure como o local de backup.

Solicitação

POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4
Corpo
{
  "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"
  }
}

Resposta 201

Corpo

O corpo da resposta está vazio.

Criar uma política de backup baseada em tempo com o Azure como local de backup acessado usando a identidade gerenciada

Este exemplo mostra como criar uma política de backup que faz backup duas vezes por dia às 9h e às 17h UTC, que deverá ser excluída após 3 meses, com o repositório de blobs do Azure como o local de backup usando a identidade gerenciada.

Solicitação

POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4
Corpo
{
  "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"
  }
}

Resposta 201

Corpo

O corpo da resposta está vazio.

Criar uma política de backup baseada em frequência com o compartilhamento de arquivos como local de backup

Este exemplo mostra como criar uma política de backup que faz backup a cada 10 minutos, que deve ser excluída após 20 dias, com o compartilhamento de arquivos como o local de backup.

Solicitação

POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4
Corpo
{
  "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"
  }
}

Resposta 201

Corpo

O corpo da resposta está vazio.

Criar uma política de backup baseada em tempo com o Dsms Azure como local de backup

Este exemplo mostra como criar uma política de backup que faz backup duas vezes por dia às 9h e às 17h UTC, que deverá ser excluída após 3 meses, com o armazenamento de blobs do Azure do Dsms como o local de backup.

Solicitação

POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4
Corpo
{
  "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"
  }
}

Resposta 201

Corpo

O corpo da resposta está vazio.