Partager via

Partition de sauvegarde

  • Article

Déclenche la sauvegarde de l’état de la partition.

Crée une sauvegarde de l’état de la partition persistante avec état. Si la partition est déjà sauvegardée régulièrement, la nouvelle sauvegarde est créée par défaut dans le même stockage de sauvegarde. Vous pouvez également remplacer le même en spécifiant les détails du stockage de sauvegarde dans le corps de la demande. Une fois la sauvegarde lancée, sa progression peut être suivie à l’aide de l’opération GetBackupProgress. Si l’opération expire, spécifiez une valeur de délai d’expiration de sauvegarde plus élevée dans le paramètre de requête.

Requête

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

Paramètres

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

partitionId

Type : chaîne (uuid)
Obligatoire : Oui

Identité de la partition.

BackupTimeout

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

Spécifie la durée maximale, en minutes, d’attente de la fin de l’opération de sauvegarde. Après cela, l’opération se termine avec une erreur de délai d’expiration. Toutefois, dans certains cas de coin, il se peut que même si l’opération retourne un délai d’expiration, la sauvegarde se déroule réellement. 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 du 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 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.

BackupPartitionDescription

Type : BackupPartitionDescription
Obligatoire : Non

Décrit les paramètres pour sauvegarder la partition maintenant. Si elle n’est pas présente, l’opération de sauvegarde utilise les paramètres par défaut de la stratégie de sauvegarde actuelle associée à cette partition.

Réponses

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

Exemples

Partition de sauvegarde

Cet exemple montre comment déclencher la sauvegarde d’une partition maintenant, qui est déjà configurée pour les sauvegardes périodiques. La sauvegarde nouvellement créée est enregistrée à l’emplacement où les sauvegardes périodiques sont enregistrées.

Requête

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4
Corps
{}

Réponse 202

Corps

Le corps de la réponse est vide.

Sauvegarder une partition sur un compte de stockage Azure spécifique

Cet exemple montre comment déclencher la sauvegarde d’une partition maintenant et enregistrer la sauvegarde dans un compte de stockage d’objets blob Azure spécifique.

Requête

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4
Corps
{
  "BackupStorage": {
    "StorageKind": "AzureBlobStore",
    "ConnectionString": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<PutYourAccountKeyHere>",
    "ContainerName": "BackupContainer"
  }
}

Réponse 202

Corps

Le corps de la réponse est vide.

Partition de sauvegarde dans un emplacement de stockage Azure spécifique accessible à l’aide d’une identité managée

Cet exemple montre comment déclencher la sauvegarde d’une partition maintenant et enregistrer la sauvegarde dans un compte de stockage Blob Azure spécifique à l’aide d’une identité managée.

Requête

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4
Corps
{
  "BackupStorage": {
    "StorageKind": "ManagedIdentityAzureBlobStore",
    "BlobServiceUri": "https://managedidentitytest.blob.core.windows.net/",
    "ContainerName": "BackupContainer",
    "ManagedIdentityType": "Cluster"
  }
}

Réponse 202

Corps

Le corps de la réponse est vide.

Partition de sauvegarde sur un partage de fichiers local spécifique

Cet exemple montre comment déclencher la sauvegarde d’une partition maintenant et enregistrer la sauvegarde dans un partage de fichiers spécifique accessible à partir de tous les nœuds de cluster.

Requête

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4
Corps
{
  "BackupStorage": {
    "StorageKind": "FileShare",
    "Path": "\\\\myshare\\backupshare",
    "PrimaryUserName": "mydomain\\backupaccount",
    "PrimaryPassword": "abcd1234"
  }
}

Réponse 202

Corps

Le corps de la réponse est vide.

Partition de sauvegarde vers un emplacement de stockage Azure Dsms spécifique

Cet exemple montre comment déclencher la sauvegarde d’une partition maintenant et enregistrer la sauvegarde dans un emplacement de stockage d’objets blob Azure Dsms spécifique.

Requête

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Backup?api-version=6.4
Corps
{
  "BackupStorage": {
    "StorageKind": "DsmsAzureBlobStore",
    "StorageCredentialsSourceLocation": "https://sample-dsms.dsms.core.winows.net/dsms/samplecredentiallocation/storageaccounts/samplestorageac/servicefabricbackup/samplebackup",
    "ContainerName": "BackupContainer"
  }
}

Réponse 202

Corps

Le corps de la réponse est vide.