Share via

Restaurar Partição

  • Artigo

Dispara a restauração do estado da partição usando a descrição da partição de restauração especificada.

Restaura o estado de uma partição persistente com estado usando o ponto de backup especificado. Caso a partição já esteja sendo copiada em backup periodicamente, por padrão, o ponto de backup é procurado no armazenamento especificado na política de backup. Também é possível substituir o mesmo especificando os detalhes do armazenamento de backup como parte da descrição da partição de restauração no corpo. Depois que a restauração for iniciada, seu progresso poderá ser acompanhado usando a operação GetRestoreProgress. No caso, a operação atinge o tempo limite, especifique um valor de tempo limite de restauração maior no parâmetro de consulta.

Solicitação

Método URI da solicitação
POST /Partitions/{partitionId}/$/Restore?RestoreTimeout={RestoreTimeout}&api-version=6.4&timeout={timeout}

Parâmetros

Nome Type Obrigatório Location
partitionId string (uuid) Sim Caminho
RestoreTimeout inteiro Não Consulta
api-version string Sim Consulta
timeout inteiro (int64) Não Consulta
RestorePartitionDescription RestorePartitionDescription Sim Corpo

partitionId

Tipo: cadeia de caracteres (uuid)
Obrigatório: sim

A identidade da partição.

RestoreTimeout

Tipo: inteiro
Obrigatório: não
Padrão: 10

Especifica a quantidade máxima de tempo de espera, em minutos, para que a operação de restauração seja concluída. Após isso, a operação retorna com erro de tempo limite. No entanto, em determinados casos de canto, pode ser que a operação de restauração passe mesmo que seja concluída com o tempo limite. Em caso de erro de tempo limite, é recomendável invocar essa operação novamente com um valor de tempo limite maior. o valor padrão para o mesmo é 10 minutos.

api-version

Tipo: string
Obrigatório: sim
Padrão: 6.4

A versão da API. Esse parâmetro é necessário e seu valor deve ser '6.4'.

A versão da API REST do Service Fabric baseia-se na versão de runtime na qual a API foi introduzida ou foi alterada. O runtime do Service Fabric dá suporte a mais de uma versão da API. Esta versão é a versão mais recente com suporte da API. Se uma versão inferior da API for passada, a resposta retornada poderá ser diferente daquela documentada nesta especificação.

Além disso, o runtime aceita qualquer versão que seja maior do que a versão mais recente com suporte até a versão atual do runtime. Portanto, se a versão mais recente da API for 6.0 e o runtime for 6.1, o runtime aceitará a versão 6.1 para essa API. No entanto, o comportamento da API será de acordo com a versão documentada 6.0.

timeout

Tipo: inteiro (int64)
Obrigatório: não
Padrão: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

Tempo limite do servidor para executar a operação em segundos. Especifica o tempo que o cliente está disposto a esperar para que operação solicitada seja concluída. O valor padrão desse parâmetro é 60 segundos.

RestorePartitionDescription

Tipo: RestorePartitionDescription
Obrigatório: sim

Descreve os parâmetros para restaurar a partição.

Respostas

Código de status HTTP Descrição Esquema de Resposta
202 (Aceito) Um código de status 202 indica que a solicitação de operação foi aceita e a restauração será iniciada. Use a operação GetPartitionRestoreProgress para obter o status da operação de restauração.
Todos os outros códigos de status A resposta de erro detalhada.
 FabricError

Exemplos

Disparar restauração de partição

Este exemplo mostra como disparar a restauração de uma partição agora especificando o backup a ser usado para restaurar.

Solicitação

POST http://localhost:19080/Partitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/Restore?api-version=6.4
Corpo
{
  "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"
}

Resposta 202

Corpo

O corpo da resposta está vazio.