Share via

Restaurer la partition

  • Article

Déclenche la restauration de l’état de la partition à l’aide de la description de la partition de restauration spécifiée.

Restaure l’état d’un de la partition persistante avec état à l’aide du point de sauvegarde spécifié. Si la partition est déjà sauvegardée régulièrement, le point de sauvegarde est recherché par défaut dans le stockage spécifié dans la stratégie de sauvegarde. Vous pouvez également remplacer la même chose en spécifiant les détails du stockage de sauvegarde dans le cadre de la description de la partition de restauration dans le corps. Une fois la restauration lancée, sa progression peut être suivie à l’aide de l’opération GetRestoreProgress. Au cas où l’opération expire, spécifiez une valeur de délai d’expiration de restauration supérieure dans le paramètre de requête.

Requête

Méthode URI de demande
POST /Partitions/{partitionId}/$/Restore?RestoreTimeout={RestoreTimeout}&api-version=6.4&timeout={timeout}

Paramètres

Nom Type Obligatoire Emplacement
partitionId string (uuid) Oui Chemin d’accès
RestoreTimeout entier Non Requête
api-version string Oui Requête
timeout entier (int64) Non Requête
RestorePartitionDescription RestorePartitionDescription Oui body

partitionId

Type : string (uuid)
Obligatoire : Oui

Identité de la partition.

RestoreTimeout

Type : entier
Obligatoire : Non
Par défaut : 10

Spécifie la durée maximale d’attente, en minutes, pour que l’opération de restauration se termine. Après cela, l’opération retourne avec une erreur de délai d’expiration. Toutefois, dans certains cas de coin, il se peut que l’opération de restauration soit effectuée même si elle se termine avec un délai d’expiration. En cas d’erreur de délai d’expiration, il est recommandé d’appeler à nouveau cette opération avec une valeur de délai d’expiration supérieure. la valeur par défaut pour la même est 10 minutes.

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 d’API inférieure est transmise, 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 en fonction de 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.

RestorePartitionDescription

Type : RestorePartitionDescription
Obligatoire : Oui

Décrit les paramètres pour restaurer la partition.

Réponses

Code d’état HTTP Description Schéma de réponse
202 (accepté) Un code status 202 indique que la demande d’opération a été acceptée et que la restauration sera lancée. Utilisez l’opération GetPartitionRestoreProgress pour obtenir la status de l’opération de restauration.
Tous les autres codes status Réponse d’erreur détaillée.
 FabricError

Exemples

Déclencher la restauration de partition

Cet exemple montre comment déclencher la restauration d’une partition maintenant en spécifiant la sauvegarde à utiliser pour la restauration.

Requête

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Restore?api-version=6.4
Corps
{
  "BackupId": "3a056ac9-7206-43c3-8424-6f6103003eba",
  "BackupStorage": {
    "StorageKind": "AzureBlobStore",
    "ConnectionString": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<PutYourAccountKeyHere>",
    "ContainerName": "BackupContainer"
  },
  "BackupLocation": "CalcApp\\CalcService\\1daae3f5-7fd6-42e9-b1ba-8c05f873994d\\2018-01-01 09.00.55.zip"
}

Réponse 202

Corps

Le corps de la réponse est vide.