Partilhar via

Restaurar Partição

  • Artigo

Aciona o restauro do estado da partição com a descrição da partição de restauro especificada.

Restaura o estado de uma partição persistente com estado com o ponto de cópia de segurança especificado. Caso a partição já esteja a ser feita uma cópia de segurança periódica, o ponto de cópia de segurança é pesquisado por predefinição no armazenamento especificado na política de cópia de segurança. Também pode substituir o mesmo ao especificar os detalhes do armazenamento de cópias de segurança como parte da descrição da partição de restauro no corpo. Assim que o restauro for iniciado, o respetivo progresso pode ser monitorizado com a operação GetRestoreProgress. No caso de a operação exceder o limite de tempo, especifique um valor de tempo limite de restauro maior no parâmetro de consulta.

Pedir

Método URI do pedido
POST /Partitions/{partitionId}/$/Restore?RestoreTimeout={RestoreTimeout}&api-version=6.4&timeout={timeout}

Parâmetros

Nome Tipo Necessário Localização
partitionId cadeia (uuid) Yes Caminho
RestoreTimeout número inteiro No Consulta
api-version string Yes Consulta
timeout número inteiro (int64) No Consulta
RestorePartitionDescription RestorePartitionDescription Yes Corpo

partitionId

Tipo: cadeia (uuid)
Obrigatório: Sim

A identidade da partição.

RestoreTimeout

Tipo: número inteiro
Obrigatório: Não
Predefinição: 10

Especifica a quantidade máxima de tempo a aguardar, em minutos, para que a operação de restauro seja concluída. Depois disso, a operação regressa com o erro de tempo limite excedido. No entanto, em determinados casos de canto, pode ser que a operação de restauro seja concluída, mesmo que seja concluída com tempo limite. Em caso de erro de tempo limite, recomendamos que invoque esta operação novamente com um valor de tempo limite superior. o valor predefinido para o mesmo é 10 minutos.

api-version

Tipo: cadeia
Obrigatório: Sim
Predefinição: 6.4

A versão da API. Este parâmetro é obrigatório e o respetivo valor tem de 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 suporta mais do que uma versão da API. Esta versão é a versão suportada mais recente da API. Se for transmitida uma versão da API inferior, a resposta devolvida poderá ser diferente da documentada nesta especificação.

Além disso, o runtime aceita qualquer versão superior à versão suportada mais recente até à versão atual do runtime. Por isso, 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 dessa API. No entanto, o comportamento da API será conforme a versão documentada 6.0.

timeout

Tipo: número inteiro (int64)
Obrigatório: Não
Predefinição: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

O tempo limite do servidor para executar a operação em segundos. Este tempo limite especifica a duração de tempo que o cliente está disposto a aguardar pela conclusão da operação pedida. O valor predefinido para este parâmetro é 60 segundos.

RestorePartitionDescription

Tipo: RestorePartitionDescription
Obrigatório: Sim

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

Respostas

Código de Estado HTTP Description Esquema de Resposta
202 (Aceite) Um código de estado 202 indica que o pedido de operação foi aceite e o restauro será iniciado. Utilize a operação GetPartitionRestoreProgress para obter o estado da operação de restauro.
Todos os outros códigos de estado A resposta detalhada ao erro.
 FabricError

Exemplos

Acionar o restauro da partição

Este exemplo mostra como acionar o restauro de uma partição agora ao especificar a cópia de segurança a ser utilizada para restaurar.

Pedir

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.