Créer la stratégie de sauvegarde

Crée une stratégie de sauvegarde.

Crée une stratégie de sauvegarde qui peut être associée ultérieurement à une application, un service ou une partition Service Fabric pour une sauvegarde périodique.

Requête

Méthode	URI de demande
POST	/BackupRestore/BackupPolicies/$/Create?api-version=6.4&timeout={timeout}&ValidateConnection={ValidateConnection}

Paramètres

Nom	Type	Obligatoire	Emplacement
api-version	string	Oui	Requête
timeout	integer (int64)	Non	Requête
ValidateConnection	boolean	Non	Requête
BackupPolicyDescription	BackupPolicyDescription	Oui	body

---

api-version

Type : chaîne
Obligatoire : Oui
Par défaut : 6.4

Version de l’API. Ce paramètre est obligatoire et sa valeur doit être « 6.4 ».

La version de l’API REST Service Fabric est basée sur la version du runtime dans laquelle l’API a été introduite ou a été modifiée. Le runtime Service Fabric prend en charge plusieurs versions de l’API. Cette version est la dernière version prise en charge de l’API. Si une version inférieure de l’API est passée, la réponse retournée peut être différente de celle documentée dans cette spécification.

En outre, le runtime accepte toute version supérieure à la dernière version prise en charge jusqu’à la version actuelle du runtime. Par conséquent, si la dernière version de l’API est 6.0 et que le runtime est 6.1, le runtime accepte la version 6.1 pour cette API. Toutefois, le comportement de l’API sera conformément à la version 6.0 documentée.

---

timeout

Type : integer (int64)
Obligatoire : Non
Par défaut : 60
InclusiveMaximum : 4294967295
InclusiveMinimum : 1

Délai d’attente du serveur pour l’exécution de l’opération en secondes. Il spécifie la durée pendant laquelle le client attend la fin de l’opération demandée. La valeur par défaut de ce paramètre est de 60 secondes.

---

ValidateConnection

Type : booléen
Obligatoire : Non
Par défaut : false

Spécifie s’il faut valider la connexion de stockage et les informations d’identification avant de créer ou de mettre à jour les stratégies de sauvegarde.

---

BackupPolicyDescription

Type : BackupPolicyDescription
Obligatoire : Oui

Décrit la stratégie de sauvegarde.

Réponses

Code d’état HTTP	Description	Schéma de réponse
201 (créé)	Une opération réussie retourne le code 201 status et crée une stratégie de sauvegarde.
Tous les autres codes status	Réponse d’erreur détaillée.	FabricError

Exemples

Créer une stratégie de sauvegarde basée sur le temps avec Azure comme emplacement de sauvegarde

Cet exemple montre comment créer une stratégie de sauvegarde qui effectue une sauvegarde deux fois par jour à 9 h et 17 h UTC, qui sera supprimée au bout de 3 mois, avec le magasin d’objets blob Azure comme emplacement de sauvegarde.

Requête

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

Corps

{
  "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"
  }
}

Réponse 201

Corps

Le corps de la réponse est vide.

Créer une stratégie de sauvegarde basée sur le temps avec Azure comme emplacement de sauvegarde accessible à l’aide d’une identité managée

Cet exemple montre comment créer une stratégie de sauvegarde qui effectue une sauvegarde deux fois par jour à 9 h et 17 h UTC, qui sera supprimée au bout de 3 mois, avec le magasin d’objets blob Azure comme emplacement de sauvegarde à l’aide de l’identité managée.

Requête

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

Corps

{
  "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"
  }
}

Réponse 201

Corps

Le corps de la réponse est vide.

Créer une stratégie de sauvegarde basée sur la fréquence avec le partage de fichiers comme emplacement de sauvegarde

Cet exemple montre comment créer une stratégie de sauvegarde qui effectue une sauvegarde toutes les 10 minutes, qui sera supprimée au bout de 20 jours, avec le partage de fichiers comme emplacement de sauvegarde.

Requête

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

Corps

{
  "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"
  }
}

Réponse 201

Corps

Le corps de la réponse est vide.

Créer une stratégie de sauvegarde basée sur le temps avec Dsms Azure comme emplacement de sauvegarde

Cet exemple montre comment créer une stratégie de sauvegarde qui effectue une sauvegarde deux fois par jour à 9 h et 17 h UTC, qui sera supprimée au bout de 3 mois, avec le magasin d’objets blob Azure Dsms comme emplacement de sauvegarde.

Requête

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

Corps

{
  "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"
  }
}

Réponse 201

Corps

Le corps de la réponse est vide.