Backup Short Term Retention Policies - Update

  • Odwołanie
Service:
SQL Database
API Version:
2021-11-01

Aktualizacje zasad przechowywania krótkoterminowego bazy danych.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
databaseName
 path True

string

Nazwa bazy danych.
policyName
 path True

ShortTermRetentionPolicyName

Nazwa zasad. Zawsze powinna mieć wartość "domyślną".
resourceGroupName
 path True

string

Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API usługi Azure Resource Manager lub portalu.
serverName
 path True

string

Nazwa serwera.
subscriptionId
 path True

string

Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.
api-version
 query True

string

Wersja interfejsu API do użycia dla żądania.

Treść żądania

Nazwa Typ Opis
properties.diffBackupIntervalInHours

DiffBackupIntervalInHours

Różnicowy interwał tworzenia kopii zapasowych w godzinach. Jest to liczba godzin interwału między poszczególnymi różnicowymi kopiami zapasowymi. Dotyczy to tylko dynamicznych baz danych, ale nie porzuconych baz danych.
properties.retentionDays

integer

Okres przechowywania kopii zapasowych w dniach. Jest to liczba dni, przez które będzie obsługiwane przywracanie do punktu w czasie.

Odpowiedzi

Nazwa Typ Opis
200 OK

BackupShortTermRetentionPolicy

Pomyślnie zaktualizowano zasady.
202 Accepted

Zaakceptowano
Other Status Codes

Odpowiedzi na błędy: ***

  • 400 InvalidParameterValue — podano nieprawidłową wartość dla parametru.

  • 400 InvalidBackupRetentionPeriod — dni {0} przechowywania elementu nie są prawidłową konfiguracją. Prawidłowe przechowywanie kopii zapasowej w dniach musi być między {1} i {2}

  • 400 InvalidDiffBackupIntervalHours — różnicowe godziny {0} interwału tworzenia kopii zapasowej nie są prawidłową konfiguracją. Prawidłowy różnicowy interwał kopii zapasowej musi być {1} godzinami.

  • 400 FeatureDisabledOnSelectedEdition — użytkownik próbował użyć funkcji wyłączonej w bieżącej wersji bazy danych.

  • 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera

  • 404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji.

  • 404 ResourceNotFound — żądany zasób nie został znaleziony.

  • 404 SourceDatabaseNotFound — źródłowa baza danych nie istnieje.

  • 404 CannotFindObject — nie można odnaleźć obiektu, ponieważ nie istnieje lub nie masz uprawnień

  • 409 ConflictingDatabaseOperation — istnieje już pewna operacja w bazie danych, a bieżąca operacja powinna czekać, aż zostanie wykonana.

  • 409 ConflictingSystemOperationInProgress — trwa operacja konserwacji systemu w bazie danych i dalsze operacje muszą czekać, aż zostanie ukończona.

  • 429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalną liczbę żądań, które mogą być przetwarzane przez dostępne zasoby.

  • 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

  • 504 RequestTimeout — żądanie usługi przekroczyło dozwolony limit czasu.

Przykłady

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

Definicje

Nazwa Opis
BackupShortTermRetentionPolicy

Zasady przechowywania krótkoterminowego.
DiffBackupIntervalInHours

Różnicowy interwał tworzenia kopii zapasowych w godzinach. Jest to liczba godzin interwału między poszczególnymi różnicowymi kopiami zapasowymi. Dotyczy to tylko dynamicznych baz danych, ale nie porzuconych baz danych.
ShortTermRetentionPolicyName

Nazwa zasad. Zawsze powinna mieć wartość "domyślną".

BackupShortTermRetentionPolicy

Zasady przechowywania krótkoterminowego.

Nazwa Typ Opis
id

string

Identyfikator zasobu.
name

string

Nazwa zasobu.
properties.diffBackupIntervalInHours

DiffBackupIntervalInHours

Różnicowy interwał tworzenia kopii zapasowych w godzinach. Jest to liczba godzin interwału między poszczególnymi różnicowymi kopiami zapasowymi. Dotyczy to tylko dynamicznych baz danych, ale nie porzuconych baz danych.
properties.retentionDays

integer

Okres przechowywania kopii zapasowych w dniach. Jest to liczba dni, przez które będzie obsługiwane przywracanie do punktu w czasie.
type

string

Typ zasobu.

DiffBackupIntervalInHours

Różnicowy interwał tworzenia kopii zapasowych w godzinach. Jest to liczba godzin interwału między poszczególnymi różnicowymi kopiami zapasowymi. Dotyczy to tylko dynamicznych baz danych, ale nie porzuconych baz danych.

Nazwa Typ Opis
12

string

24

string

ShortTermRetentionPolicyName

Nazwa zasad. Zawsze powinna mieć wartość "domyślną".

Nazwa Typ Opis
default

string