Share via

Partição de Backup

  • Artigo

Dispara o backup do estado da partição.

Cria um backup do estado da partição persistente com estado. Caso a partição já esteja sendo copiada periodicamente em backup, por padrão, o novo backup é criado no mesmo armazenamento de backup. Também é possível substituir o mesmo especificando os detalhes do armazenamento de backup como parte do corpo da solicitação. Depois que o backup é iniciado, seu progresso pode ser acompanhado usando a operação GetBackupProgress. No caso, a operação atinge o tempo limite, especifique um valor de tempo limite de backup maior no parâmetro de consulta.

Solicitação

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

Parâmetros

Nome Tipo Obrigatório Location
partitionId string (uuid) Sim Caminho
BackupTimeout Número inteiro Não Consulta
api-version string Sim Consulta
timeout inteiro (int64) Não Consulta
BackupPartitionDescription BackupPartitionDescription Não Corpo

partitionId

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

A identidade da partição.

BackupTimeout

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

Especifica a quantidade máxima de tempo, em minutos, para aguardar a conclusão da operação de backup. Após isso, a operação é concluída com erro de tempo limite. No entanto, em determinados casos de canto, pode ser que, embora a operação retorne o tempo limite, o backup realmente passa. 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.

BackupPartitionDescription

Tipo: BackupPartitionDescription
Obrigatório: não

Descreve os parâmetros para fazer backup da partição agora. Se não estiver presente, a operação de backup usará parâmetros padrão da política de backup atual associada a essa 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 o backup será iniciado. Use a operação GetPartitionBackupProgress para obter o status da operação de backup.
Todos os outros códigos de status A resposta de erro detalhada.
 FabricError

Exemplos

Partição de backup

Este exemplo mostra como disparar o backup de uma partição agora, que já está configurada para backups periódicos. O backup recém-criado será salvo no mesmo local em que os backups periódicos estão sendo salvos.

Solicitação

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

Resposta 202

Corpo

O corpo da resposta está vazio.

Fazer backup da partição em uma conta de armazenamento do Azure específica

Este exemplo mostra como disparar o backup de uma partição agora e salvar o backup em uma conta de armazenamento de blobs do Azure específica.

Solicitação

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

Resposta 202

Corpo

O corpo da resposta está vazio.

Partição de backup para um local de armazenamento do Azure específico acessado usando a identidade gerenciada

Este exemplo mostra como disparar o backup de uma partição agora e salvar o backup em uma conta de armazenamento de blobs do Azure específica usando a identidade gerenciada.

Solicitação

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

Resposta 202

Corpo

O corpo da resposta está vazio.

Partição de backup para um compartilhamento de arquivos local específico

Este exemplo mostra como disparar o backup de uma partição agora e salvar o backup em um compartilhamento de arquivo específico acessível de todos os nós de cluster.

Solicitação

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

Resposta 202

Corpo

O corpo da resposta está vazio.

Partição de backup para um local de armazenamento específico do Dsms do Azure

Este exemplo mostra como disparar o backup de uma partição agora e salvar o backup em um local específico de armazenamento de blobs do Azure do Dsms.

Solicitação

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

Resposta 202

Corpo

O corpo da resposta está vazio.