Partilhar via

Backup Short Term Retention Policies - Update

  • Referência
Serviço:
SQL Database
Versão da API:
2021-11-01

Atualizações a política de retenção de curto prazo de uma base 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 do URI

Name Em Necessário Tipo Description
databaseName
 path True

string

O nome da base de dados.
policyName
 path True

ShortTermRetentionPolicyName

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

string

O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API do Azure Resource Manager ou do portal.
serverName
 path True

string

O nome do servidor.
subscriptionId
 path True

string

O ID da subscrição que identifica uma subscrição do Azure.
api-version
 query True

string

A versão da API a utilizar para o pedido.

Corpo do Pedido

Name Tipo Description
properties.diffBackupIntervalInHours

DiffBackupIntervalInHours

O intervalo de cópia de segurança diferencial em horas. Esta é a quantidade de horas de intervalo entre cada cópia de segurança diferencial será suportada. Isto aplica-se apenas a bases de dados dinâmicas, mas não a bases de dados removidas.
properties.retentionDays

integer

O período de retenção da cópia de segurança em dias. Este é o número de dias em que o Restauro para Um Ponto Anterior no Tempo será suportado.

Respostas

Name Tipo Description
200 OK

BackupShortTermRetentionPolicy

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

Aceite
Other Status Codes

Respostas de Erro: ***

  • 400 InvalidParameterValue – foi atribuído um valor inválido 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 cópia de segurança válida em dias tem de estar entre {1} e {2}

  • 400 InvalidDiffBackupIntervalHours – as horas de intervalo de cópia de segurança diferencial de {0} não são uma configuração válida. O intervalo de cópia de segurança diferencial válido tem de ser {1} horas.

  • 400 FeatureDisabledOnSelectedEdition – o utilizador tentou utilizar uma funcionalidade que está desativada na edição atual da base de dados.

  • 404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado

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

  • 404 ResourceNotFound – o recurso pedido não foi encontrado.

  • 404 SourceDatabaseNotFound – a base de dados de origem não existe.

  • 404 CannotFindObject – não é possível localizar o objeto porque não existe ou não tem permissões

  • 409 ConflictingDatabaseOperation – já existe alguma operação na base de dados e a operação atual deve aguardar até estar concluída.

  • 409 ConflictingSystemOperationInProgress – uma operação de manutenção do sistema está em curso na base de dados e as operações adicionais têm de aguardar até que seja concluída.

  • 429 SubscriptionTooManyCreateUpdateRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis.

  • 429 SubscriptionTooManyRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis.

  • 503 TooManyRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis.

  • 504 RequestTimeout – o pedido de serviço excedeu o tempo limite permitido.

Exemplos

Update the short term retention policy for the database.

Pedido de amostra

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
  }
}

Resposta da amostra

Código de estado:
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
  }
}
Código de estado:
202

Definições

Name Description
BackupShortTermRetentionPolicy

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

O intervalo de cópia de segurança diferencial em horas. Esta é a quantidade de horas de intervalo entre cada cópia de segurança diferencial será suportada. Isto aplica-se apenas a bases de dados dinâmicas, mas não a bases de dados removidas.
ShortTermRetentionPolicyName

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

BackupShortTermRetentionPolicy

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

Name Tipo Description
id

string

ID do Recurso.
name

string

Nome do recurso.
properties.diffBackupIntervalInHours

DiffBackupIntervalInHours

O intervalo de cópia de segurança diferencial em horas. Esta é a quantidade de horas de intervalo entre cada cópia de segurança diferencial será suportada. Isto aplica-se apenas a bases de dados dinâmicas, mas não a bases de dados removidas.
properties.retentionDays

integer

O período de retenção da cópia de segurança em dias. Este é o número de dias em que o Restauro para Um Ponto Anterior no Tempo será suportado.
type

string

Tipo de recurso.

DiffBackupIntervalInHours

O intervalo de cópia de segurança diferencial em horas. Esta é a quantidade de horas de intervalo entre cada cópia de segurança diferencial será suportada. Isto aplica-se apenas a bases de dados dinâmicas, mas não a bases de dados removidas.

Name Tipo Description
12

string

24

string

ShortTermRetentionPolicyName

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

Name Tipo Description
default

string