Partilhar via

Partição de Cópia de Segurança

  • Artigo

Aciona a cópia de segurança do estado da partição.

Cria uma cópia de segurança do estado da partição persistente com monitorização de estado. Caso a partição já esteja a ser efetuada periodicamente uma cópia de segurança, a nova cópia de segurança é criada por predefinição no mesmo armazenamento de cópias de segurança. Também pode substituir o mesmo ao especificar os detalhes do armazenamento de cópias de segurança como parte do corpo do pedido. Assim que a cópia de segurança for iniciada, o respetivo progresso pode ser controlado com a operação GetBackupProgress. No caso de a operação exceder o limite de tempo, especifique um valor de tempo limite de cópia de segurança maior no parâmetro de consulta.

Pedir

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

Parâmetros

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

partitionId

Tipo: cadeia (uuid)
Obrigatório: Sim

A identidade da partição.

BackupTimeout

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

Especifica o período máximo de tempo, em minutos, para aguardar a conclusão da operação de cópia de segurança. Depois disso, a operação é concluída com um erro de tempo limite excedido. No entanto, em certos casos de canto, pode ser que, embora a operação devolva o tempo limite, a cópia de segurança realmente passa. Em caso de erro de tempo limite, é recomendado invocar 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 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 inferior da API, 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 a 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 6.0 documentada.

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 que a operação pedida seja concluída. O valor predefinido para este parâmetro é 60 segundos.

BackupPartitionDescription

Tipo: BackupPartitionDescription
Obrigatório: Não

Descreve os parâmetros para fazer a cópia de segurança da partição agora. Se não estiver presente, a operação de cópia de segurança utiliza parâmetros predefinidos da política de cópia de segurança associada a esta 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 a cópia de segurança será iniciada. Utilize a operação GetPartitionBackupProgress para obter o estado da operação de cópia de segurança.
Todos os outros códigos de estado A resposta detalhada ao erro.
 FabricError

Exemplos

Partição de cópia de segurança

Este exemplo mostra como acionar a cópia de segurança de uma partição agora, que já está configurada para cópias de segurança periódicas. A cópia de segurança criada recentemente será guardada na mesma localização onde as cópias de segurança periódicas estão a ser guardadas.

Pedir

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.

Criar cópias de segurança de partições para uma conta de armazenamento do Azure específica

Este exemplo mostra como acionar a cópia de segurança de uma partição agora e guardar a cópia de segurança numa conta de armazenamento de blobs do Azure específica.

Pedir

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.

Cópia de segurança da partição para uma localização de armazenamento do Azure específica acedida com a identidade gerida

Este exemplo mostra como acionar a cópia de segurança de uma partição agora e guardar a cópia de segurança numa conta de armazenamento de blobs do Azure específica com a identidade gerida.

Pedir

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.

Criar cópias de segurança para uma partilha de ficheiros no local específica

Este exemplo mostra como acionar a cópia de segurança de uma partição agora e guardar a cópia de segurança numa partilha de ficheiros específica acessível a partir de todos os nós de cluster.

Pedir

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.

Cópia de segurança da partição para uma localização de armazenamento do Azure Dsms específica

Este exemplo mostra como acionar a cópia de segurança de uma partição agora e guardar a cópia de segurança numa localização de armazenamento de blobs do Azure Dsms específica.

Pedir

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.