Criar Política de Backup
Cria uma política de backup.
Cria uma política de backup que pode ser associada posteriormente a um aplicativo, serviço ou partição do Service Fabric para backup periódico.
Solicitação
Método | URI da solicitação |
---|---|
POST | /BackupRestore/BackupPolicies/$/Create?api-version=6.4&timeout={timeout}&ValidateConnection={ValidateConnection} |
Parâmetros
Nome | Tipo | Obrigatório | Location |
---|---|---|---|
api-version |
string | Sim | Consulta |
timeout |
inteiro (int64) | Não | Consulta |
ValidateConnection |
booleano | Não | Consulta |
BackupPolicyDescription |
BackupPolicyDescription | Sim | Corpo |
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.
ValidateConnection
Tipo: booliano
Obrigatório: não
Padrão: false
Especifica se é necessário validar a conexão de armazenamento e as credenciais antes de criar ou atualizar as políticas de backup.
BackupPolicyDescription
Tipo: BackupPolicyDescription
Obrigatório: sim
Descreve a política de backup.
Respostas
Código de status HTTP | Descrição | Esquema de Resposta |
---|---|---|
201 (Criado) | Uma operação bem-sucedida retorna 201 status código e cria uma nova política de backup. |
|
Todos os outros códigos de status | A resposta de erro detalhada. |
FabricError |
Exemplos
Criar uma política de backup baseada em tempo com o Azure como local de backup
Este exemplo mostra como criar uma política de backup que faz backup duas vezes por dia às 9h e às 17h UTC, que deve ser excluída após 3 meses, com o repositório de blobs do Azure como o local de backup.
Solicitação
POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4
Corpo
{
"Name": "DailyAzureBackupPolicy",
"AutoRestoreOnDataLoss": false,
"MaxIncrementalBackups": "3",
"Schedule": {
"ScheduleKind": "TimeBased",
"ScheduleFrequencyType": "Daily",
"RunTimes": [
"0001-01-01T09:00:00Z",
"0001-01-01T17:00:00Z"
]
},
"Storage": {
"StorageKind": "AzureBlobStore",
"FriendlyName": "Azure_storagesample",
"ConnectionString": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<PutYourAccountKeyHere>",
"ContainerName": "BackupContainer"
},
"RetentionPolicy": {
"RetentionPolicyType": "Basic",
"MinimumNumberOfBackups": "20",
"RetentionDuration": "P3M"
}
}
Resposta 201
Corpo
O corpo da resposta está vazio.
Criar uma política de backup baseada em tempo com o Azure como local de backup acessado usando a identidade gerenciada
Este exemplo mostra como criar uma política de backup que faz backup duas vezes por dia às 9h e às 17h UTC, que deverá ser excluída após 3 meses, com o repositório de blobs do Azure como o local de backup usando a identidade gerenciada.
Solicitação
POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4
Corpo
{
"Name": "DailyAzureMIBackupPolicy",
"AutoRestoreOnDataLoss": false,
"MaxIncrementalBackups": "3",
"Schedule": {
"ScheduleKind": "TimeBased",
"ScheduleFrequencyType": "Daily",
"RunTimes": [
"0001-01-01T09:00:00Z",
"0001-01-01T17:00:00Z"
]
},
"Storage": {
"StorageKind": "ManagedIdentityAzureBlobStore",
"FriendlyName": "AzureMI_storagesample",
"BlobServiceUri": "https://managedidentitytest.blob.core.windows.net/",
"ContainerName": "BackupContainer",
"ManagedIdentityType": "Cluster"
},
"RetentionPolicy": {
"RetentionPolicyType": "Basic",
"MinimumNumberOfBackups": "20",
"RetentionDuration": "P3M"
}
}
Resposta 201
Corpo
O corpo da resposta está vazio.
Criar uma política de backup baseada em frequência com o compartilhamento de arquivos como local de backup
Este exemplo mostra como criar uma política de backup que faz backup a cada 10 minutos, que deve ser excluída após 20 dias, com o compartilhamento de arquivos como o local de backup.
Solicitação
POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4
Corpo
{
"Name": "FileShare10MinBackupPolicy",
"AutoRestoreOnDataLoss": false,
"MaxIncrementalBackups": "3",
"Schedule": {
"ScheduleKind": "FrequencyBased",
"Interval": "PT10M"
},
"Storage": {
"StorageKind": "FileShare",
"FriendlyName": "FileShare_myshare",
"Path": "\\\\myshare\\backupshare",
"PrimaryUserName": "backupaccount",
"PrimaryPassword": "abcd1234"
},
"RetentionPolicy": {
"RetentionPolicyType": "Basic",
"MinimumNumberOfBackups": "20",
"RetentionDuration": "P20D"
}
}
Resposta 201
Corpo
O corpo da resposta está vazio.
Criar uma política de backup baseada em tempo com o Dsms Azure como local de backup
Este exemplo mostra como criar uma política de backup que faz backup duas vezes por dia às 9h e às 17h UTC, que deverá ser excluída após 3 meses, com o armazenamento de blobs do Azure do Dsms como o local de backup.
Solicitação
POST http://localhost:19080/BackupRestore/BackupPolicies/$/Create?api-version=6.4
Corpo
{
"Name": "SampleDsmsBackupPolicy",
"AutoRestoreOnDataLoss": false,
"MaxIncrementalBackups": "3",
"Schedule": {
"ScheduleKind": "TimeBased",
"ScheduleFrequencyType": "Daily",
"RunTimes": [
"0001-01-01T09:00:00Z",
"0001-01-01T17:00:00Z"
]
},
"Storage": {
"StorageKind": "DsmsAzureBlobStore",
"FriendlyName": "DsmsAzure_storagesample",
"StorageCredentialsSourceLocation": "https://sample-dsms.dsms.core.winows.net/dsms/samplecredentiallocation/storageaccounts/samplestorageac/servicefabricbackup/samplebackup",
"ContainerName": "BackupContainer"
},
"RetentionPolicy": {
"RetentionPolicyType": "Basic",
"MinimumNumberOfBackups": "20",
"RetentionDuration": "P3M"
}
}
Resposta 201
Corpo
O corpo da resposta está vazio.