Compartilhar via

RestoreContext.RestoreAsync Método

  • Referência

Definição

Namespace:
Microsoft.ServiceFabric.Data
Assembly:
Microsoft.ServiceFabric.Data.Interfaces.dll
Pacote:
Microsoft.ServiceFabric.Data.Interfaces v6.1.1583

Sobrecargas

RestoreAsync(RestoreDescription)

Restaura um backup descrito por RestoreDescription.
RestoreAsync(RestoreDescription, CancellationToken)

Restaure um backup descrito por RestoreDescription.

RestoreAsync(RestoreDescription)

Restaura um backup descrito por RestoreDescription.

public System.Threading.Tasks.Task RestoreAsync (Microsoft.ServiceFabric.Data.RestoreDescription restoreDescription);
member this.RestoreAsync : Microsoft.ServiceFabric.Data.RestoreDescription -> System.Threading.Tasks.Task
Public Function RestoreAsync (restoreDescription As RestoreDescription) As Task

Parâmetros

restoreDescription
RestoreDescription

Descrição da solicitação de restauração.

Retornos

Task

Tarefa que representa a operação de restauração assíncrona.

Exceções

FabricMissingFullBackupException

Indica que a pasta de backup de entrada não contém um backup completo. Para que uma pasta de backup seja restaurável, ela deve conter exatamente um backup completo e qualquer número de backups incrementais.

ArgumentException

Indica que um dos argumentos não é válido. Por exemplo, ao restaurar um Reliable Service se RestorePolicy estiver definido como Seguro, mas a pasta de backup de entrada contiver uma versão do estado anterior ao estado mantido no réplica atual.

Ao restaurar um Serviço de Ator, essa exceção será gerada se especificado BackupFolderPath estiver vazio.

DirectoryNotFoundException

Indica que o diretório de restauração fornecido não existe.

FabricObjectClosedException

Indica que o réplica está fechando.

InvalidOperationException

Indica que a operação de restauração atual não é válida. Por exemplo, o ServicePartitionKind da partição de onde o backup foi feito é diferente do da partição atual que está sendo restaurada.

FileNotFoundException

Indica que os arquivos de backup esperados no diretório de restauração fornecido não foram encontrados.

FabricException

Indica que a operação de restauração encontrou um erro inesperado ou os arquivos de backup no diretório de restauração não são válidos. A ErrorCode propriedade indica o tipo de erro que ocorreu.

  • InvalidBackup Indica que os arquivos de backup fornecidos no diretório de restauração estão faltando arquivos ou têm arquivos inesperados extras.
  • InvalidRestoreData Indica que os arquivos de metadados (restore.dat) presentes no diretório de restauração estão corrompidos ou contêm informações inválidas.
  • InvalidBackupChain Indica que a cadeia de backup (ou seja, um backup completo e zero ou mais backups incrementais contíguos que foram feitos após ele) fornecidos no diretório de restauração está desfeito.
  • DuplicateBackups Indica que a cadeia de backup (ou seja, um backup completo e zero ou mais backups incrementais contíguos que foram feitos após ele) fornecidos no diretório de restauração contém backups duplicados.
  • RestoreSafeCheckFailed Se Safe for especificado como parte do RestoreDescription, isso indicará que o backup fornecido para restauração tem dados mais antigos do que o atualmente presente no serviço.

Comentários

Essa API deve ser chamada do método OnDataLossAsync. Somente uma API RestoreAsync pode ser fornecida por réplica em um determinado momento.

Observe que as exceções geradas por essa API diferem dependendo do provedor de estado subjacente. As exceções atualmente documentadas para essa API se aplicam somente a provedores de estado prontos para uso fornecidos pelo Service Fabric para Reliable Services e Reliable Actors.

As seguintes exceções são geradas por essa API quando invocadas no Reliable Service:

As seguintes exceções são geradas por essa API quando invocadas no Serviço de Ator com KvsActorStateProvider como seu provedor de estado (que é o provedor de estado padrão para Reliable Actors):

Aplica-se a

RestoreAsync(RestoreDescription, CancellationToken)

Restaure um backup descrito por RestoreDescription.

public System.Threading.Tasks.Task RestoreAsync (Microsoft.ServiceFabric.Data.RestoreDescription restoreDescription, System.Threading.CancellationToken cancellationToken);
member this.RestoreAsync : Microsoft.ServiceFabric.Data.RestoreDescription * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function RestoreAsync (restoreDescription As RestoreDescription, cancellationToken As CancellationToken) As Task

Parâmetros

restoreDescription
RestoreDescription

Descrição da solicitação de restauração.

cancellationToken
CancellationToken

O token a se monitorar para solicitações de cancelamento.

Retornos

Task

Tarefa que representa a operação de restauração assíncrona.

Exceções

FabricMissingFullBackupException

Indica que a pasta de backup de entrada não contém um backup completo. Para que uma pasta de backup seja restaurável, ela deve conter exatamente um backup completo e qualquer número de backups incrementais.

ArgumentException

Indica que um dos argumentos não é válido. Por exemplo, ao restaurar um Reliable Service se RestorePolicy estiver definido como Seguro, mas a pasta de backup de entrada contiver uma versão do estado anterior ao estado mantido no réplica atual.

Ao restaurar um Serviço de Ator, essa exceção será gerada se especificado BackupFolderPath estiver vazio.

DirectoryNotFoundException

Indica que o diretório de restauração fornecido não existe.

FabricObjectClosedException

Indica que o réplica está fechando.

InvalidOperationException

Indica que a operação de restauração atual não é válida. Por exemplo, o ServicePartitionKind da partição de onde o backup foi feito é diferente do da partição atual que está sendo restaurada.

FileNotFoundException

Indica que os arquivos de backup esperados no diretório de restauração fornecido não foram encontrados.

FabricException

Indica que a operação de restauração encontrou um erro inesperado ou os arquivos de backup no diretório de restauração não são válidos. A ErrorCode propriedade indica o tipo de erro que ocorreu.

  • InvalidBackup Indica que os arquivos de backup fornecidos no diretório de restauração estão faltando arquivos ou têm arquivos inesperados extras.
  • InvalidRestoreData Indica que os arquivos de metadados (restore.dat) presentes no diretório de restauração estão corrompidos ou contêm informações inválidas.
  • InvalidBackupChain Indica que a cadeia de backup (ou seja, um backup completo e zero ou mais backups incrementais contíguos que foram feitos após ele) fornecidos no diretório de restauração está desfeito.
  • DuplicateBackups Indica que a cadeia de backup (ou seja, um backup completo e zero ou mais backups incrementais contíguos que foram feitos após ele) fornecidos no diretório de restauração contém backups duplicados.
  • RestoreSafeCheckFailed Se Safe for especificado como parte do RestoreDescription, isso indicará que o backup fornecido para restauração tem dados mais antigos do que o atualmente presente no serviço.

Comentários

Essa API deve ser chamada do método OnDataLossAsync. Somente uma API RestoreAsync pode ser fornecida por réplica em um determinado momento.

Observe que as exceções geradas por essa API diferem dependendo do provedor de estado subjacente. As exceções atualmente documentadas para essa API se aplicam somente a provedores de estado prontos para uso fornecidos pelo Service Fabric para Reliable Services e Reliable Actors.

As seguintes exceções são geradas por essa API quando invocadas no Reliable Service:

As seguintes exceções são geradas por essa API quando invocadas no Serviço de Ator com KvsActorStateProvider como seu provedor de estado (que é o provedor de estado padrão para Reliable Actors):

Aplica-se a