Criar Política de Cópia de Segurança

  • Artigo

Cria uma política de cópia de segurança.

Cria uma política de cópia de segurança que pode ser associada mais tarde a uma aplicação, serviço ou partição do Service Fabric para cópia de segurança periódica.

Pedir

Método URI do pedido
POST /BackupRestore/BackupPolicies/$/Create?api-version=6.4&timeout={timeout}&ValidateConnection={ValidateConnection}

Parâmetros

Nome Tipo Necessário Localização
api-version string Yes Consulta
timeout número inteiro (int64) No Consulta
ValidateConnection boolean No Consulta
BackupPolicyDescription BackupPolicyDescription Yes Corpo

api-version

Tipo: cadeia
Obrigatório: Sim
Predefinição: 6.4

A versão da API. Este parâmetro é obrigatório e o respetivo valor tem de 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 suporta mais do que uma versão da API. Esta versão é a versão suportada mais recente da API. Se for transmitida uma versão da API inferior, a resposta devolvida poderá ser diferente da documentada nesta especificação.

Além disso, o runtime aceita qualquer versão superior à versão suportada mais recente até à versão atual do runtime. Por isso, 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 dessa API. No entanto, o comportamento da API será conforme a versão documentada 6.0.

timeout

Tipo: número inteiro (int64)
Obrigatório: Não
Predefinição: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

O tempo limite do servidor para executar a operação em segundos. Este tempo limite especifica a duração de tempo que o cliente está disposto a aguardar pela conclusão da operação pedida. O valor predefinido para este parâmetro é 60 segundos.

ValidateConnection

Tipo: booleano
Obrigatório: Não
Predefinição: false

Especifica se pretende validar a ligação de armazenamento e as credenciais antes de criar ou atualizar as políticas de cópia de segurança.

BackupPolicyDescription

Tipo: BackupPolicyDescription
Obrigatório: Sim

Descreve a política de cópia de segurança.

Respostas

Código de Estado HTTP Description Esquema de Resposta
201 (Criado) Uma operação com êxito devolve o código de estado 201 e cria uma nova política de cópia de segurança.
Todos os outros códigos de estado A resposta detalhada ao erro.
 FabricError

Exemplos

Criar uma política de cópia de segurança baseada no tempo com o Azure como localização de cópia de segurança

Este exemplo mostra como criar uma política de cópia de segurança que faz cópias de segurança duas vezes por dia às 9:00 e às 17:00 UTC, que será eliminada após 3 meses, com o arquivo de blobs do Azure como a localização da cópia de segurança.

Pedir

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 cópia de segurança baseada no tempo com o Azure como localização de cópia de segurança acedida com a identidade gerida

Este exemplo mostra como criar uma política de cópia de segurança que faz cópias de segurança duas vezes por dia às 9:00 e às 17:00 UTC, que será eliminada após 3 meses, com o arquivo de blobs do Azure como a localização de cópia de segurança com a identidade gerida.

Pedir

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 cópia de segurança baseada em frequência com a partilha de ficheiros como localização de cópia de segurança

Este exemplo mostra como criar uma política de cópia de segurança que efetua uma cópia de segurança a cada 10 minutos, que será eliminada após 20 dias, com a partilha de ficheiros como a localização da cópia de segurança.

Pedir

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 cópia de segurança baseada no tempo com o Azure Dsms como localização de cópia de segurança

Este exemplo mostra como criar uma política de cópia de segurança que faz cópias de segurança duas vezes por dia às 9:00 e às 17:00 UTC, que será eliminada após 3 meses, com o arquivo de blobs do Azure Dsms como a localização da cópia de segurança.

Pedir

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.