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.