Backup Short Term Retention Policies - Update

  • Referência
Service:
SQL Database
API Version:
2021-11-01

Atualizações a política de retenção de curto prazo de um banco de dados.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/backupShortTermRetentionPolicies/default?api-version=2021-11-01

Parâmetros de URI

Nome Em Obrigatório Tipo Description
databaseName
 path True

string

O nome do banco de dados.
policyName
 path True

ShortTermRetentionPolicyName

O nome da política. Deve ser sempre "padrão".
resourceGroupName
 path True

string

O nome do grupo de recursos que contém o recurso. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal.
serverName
 path True

string

O nome do servidor.
subscriptionId
 path True

string

A ID de assinatura que identifica uma assinatura do Azure.
api-version
 query True

string

A versão da API a ser usada para a solicitação.

Corpo da solicitação

Nome Tipo Description
properties.diffBackupIntervalInHours

DiffBackupIntervalInHours

O intervalo de backup diferencial em horas. Este é o número de horas de intervalo entre cada backup diferencial que terá suporte. Isso só é aplicável a bancos de dados dinâmicos, mas não a bancos de dados descartados.
properties.retentionDays

integer

O período de retenção de backup em dias. Este é o número de dias que a Restauração Pontual terá suporte.

Respostas

Nome Tipo Description
200 OK

BackupShortTermRetentionPolicy

A política foi atualizada com êxito.
202 Accepted

Aceito
Other Status Codes

Respostas de erro: ***

  • 400 InvalidParameterValue - Um valor inválido foi dado a um parâmetro.

  • 400 InvalidBackupRetentionPeriod - Os dias de retenção de {0} não são uma configuração válida. A retenção de backup válida em dias deve estar entre {1} e {2}

  • 400 InvalidDiffBackupIntervalHours – as horas de intervalo de backup diferencial de {0} não são uma configuração válida. O intervalo de backup diferencial válido deve ser {1} horas.

  • 400 FeatureDisabledOnSelectedEdition - O usuário tentou usar um recurso que está desabilitado na edição atual do banco de dados.

  • 404 SubscriptionDoesNotHaveServer - O servidor solicitado não foi encontrado

  • 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na assinatura especificados.

  • 404 ResourceNotFound - O recurso solicitado não foi encontrado.

  • 404 SourceDatabaseNotFound - O banco de dados de origem não existe.

  • 404 CannotFindObject - Não é possível localizar o objeto porque ele não existe ou você não tem permissões

  • 409 ConflictingDatabaseOperation - Já existe alguma operação no banco de dados e a operação atual deve aguardar até que ela seja concluída.

  • 409 ConflictingSystemOperationInProgress - Uma operação de manutenção do sistema está em andamento no banco de dados e outras operações precisam aguardar até que ele seja concluído.

  • 429 SubscriptionTooManyCreateUpdateRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis.

  • 429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis.

  • 503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis.

  • 504 RequestTimeout – A solicitação de serviço excedeu o tempo limite permitido.

Exemplos

Update the short term retention policy for the database.

Sample Request

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup/providers/Microsoft.Sql/servers/testsvr/databases/testdb/backupShortTermRetentionPolicies/default?api-version=2021-11-01

{
  "properties": {
    "retentionDays": 7,
    "diffBackupIntervalInHours": 24
  }
}

Sample Response

Status code:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/resourceGroups/resourceGroup/servers/testsvr/databases/testdb/backupShortTermRetentionPolicies/default",
  "name": "default",
  "type": "Microsoft.Sql/servers/databases/backupShortTermRetentionPolicies",
  "properties": {
    "retentionDays": 7,
    "diffBackupIntervalInHours": 24
  }
}
Status code:
202

Definições

Nome Description
BackupShortTermRetentionPolicy

Uma política de retenção de curto prazo.
DiffBackupIntervalInHours

O intervalo de backup diferencial em horas. Este é o número de horas de intervalo entre cada backup diferencial que terá suporte. Isso só é aplicável a bancos de dados dinâmicos, mas não a bancos de dados descartados.
ShortTermRetentionPolicyName

O nome da política. Deve ser sempre "padrão".

BackupShortTermRetentionPolicy

Uma política de retenção de curto prazo.

Nome Tipo Description
id

string

ID do recurso.
name

string

Nome do recurso.
properties.diffBackupIntervalInHours

DiffBackupIntervalInHours

O intervalo de backup diferencial em horas. Este é o número de horas de intervalo entre cada backup diferencial que terá suporte. Isso só é aplicável a bancos de dados dinâmicos, mas não a bancos de dados descartados.
properties.retentionDays

integer

O período de retenção de backup em dias. Este é o número de dias que a Restauração Pontual terá suporte.
type

string

Tipo de recurso.

DiffBackupIntervalInHours

O intervalo de backup diferencial em horas. Este é o número de horas de intervalo entre cada backup diferencial que terá suporte. Isso só é aplicável a bancos de dados dinâmicos, mas não a bancos de dados descartados.

Nome Tipo Description
12

string

24

string

ShortTermRetentionPolicyName

O nome da política. Deve ser sempre "padrão".

Nome Tipo Description
default

string