Partager via


Activer la sauvegarde de service

Active la sauvegarde périodique des partitions avec état sous ce service Service Fabric.

Active la sauvegarde périodique des partitions avec état qui font partie de ce service Service Fabric. Chaque partition est sauvegardée individuellement conformément à la description de la stratégie de sauvegarde spécifiée. Si l’application, dont le service fait partie, est déjà activée pour la sauvegarde, cette opération remplace la stratégie utilisée pour effectuer la sauvegarde périodique de ce service et de ses partitions (sauf si elle est explicitement remplacée au niveau de la partition). Notez que seuls les services Reliable Actor et Reliable Stateful basés sur C# sont actuellement pris en charge pour la sauvegarde périodique.

Requête

Méthode URI de demande
POST /Services/{serviceId}/$/EnableBackup?api-version=6.4&timeout={timeout}

Paramètres

Nom Type Obligatoire Emplacement
serviceId string Oui Chemin d’accès
api-version string Oui Requête
timeout integer (int64) Non Requête
EnableBackupDescription EnableBackupDescription Oui body

serviceId

Type : chaîne
Obligatoire : Oui

Identité du service. Cet ID est généralement le nom complet du service sans le schéma d’URI « fabric: ». Depuis la version 6.0, les noms hiérarchiques sont séparés par le caractère « ~ ». Par exemple, si un service est nommé « fabric:/myapp/app1/svc1 », son identité de service est « myapp~app1~svc1 » dans les versions 6.0 et ultérieures et « myapp/app1/svc1 » dans les versions antérieures.


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.


EnableBackupDescription

Type : EnableBackupDescription
Obligatoire : Oui

Spécifie les paramètres d’activation de la sauvegarde.

Réponses

Code d’état HTTP Description Schéma de réponse
202 (accepté) Un code status 202 indique que la demande d’activation de la sauvegarde de service a été acceptée.
Tous les autres codes status Réponse d’erreur détaillée.
FabricError

Exemples

Activer la sauvegarde de service

Cet exemple montre comment activer la sauvegarde périodique pour un service avec état.

Requête

POST http://localhost:19080/Services/CalcApp/CalcService/$/EnableBackup?api-version=6.4
Corps
{
  "BackupPolicyName": "DailyAzureBackupPolicy"
}

Réponse 202

Corps

Le corps de la réponse est vide.