Udostępnij za pośrednictwem

Backup Short Term Retention Policies - Update

  • Odwołanie
Usługa:
SQL Database
Wersja interfejsu API:
2021-11-01

Aktualizuje zasady 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 być "domyślna".
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 (int32)

Interwał różnicowej kopii zapasowej w godzinach. Jest to liczba godzin interwału między poszczególnymi różnicowych kopii zapasowych. Dotyczy to tylko dynamicznych baz danych, ale nie porzuconych baz danych.
properties.retentionDays

integer (int32)

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

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ść parametrowi.

  • 400 InvalidBackupRetentionPeriod — dni przechowywania {0} nie są prawidłową konfiguracją. Prawidłowe przechowywanie kopii zapasowych w dniach musi należeć do przedziału od {1} do {2}

  • 400 InvalidDiffBackupIntervalHours — różnicowa liczba godzin wykonywania kopii zapasowych {0} nie jest prawidłową konfiguracją. Prawidłowy interwał różnicowej kopii zapasowej musi być {1} godzin.

  • 400 FeatureDisabledOnSelectedEdition — użytkownik próbował użyć funkcji, która jest wyłączona 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, a 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 obsługi przekroczyło dozwolony limit czasu.

Przykłady

Update the short term retention policy for the database.

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:
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
  }
}
Kod stanu:
202

Definicje

Nazwa Opis
BackupShortTermRetentionPolicy

Zasady przechowywania krótkoterminowego.
DiffBackupIntervalInHours

Interwał różnicowej kopii zapasowej w godzinach. Jest to liczba godzin interwału między poszczególnymi różnicowych kopii zapasowych. Dotyczy to tylko dynamicznych baz danych, ale nie porzuconych baz danych.
ShortTermRetentionPolicyName

Nazwa zasad. Zawsze powinna być "domyślna".

BackupShortTermRetentionPolicy

Objekt

Zasady przechowywania krótkoterminowego.

Nazwa Typ Opis
id

string

Identyfikator zasobu.
name

string

Nazwa zasobu.
properties.diffBackupIntervalInHours

DiffBackupIntervalInHours (int32)

Interwał różnicowej kopii zapasowej w godzinach. Jest to liczba godzin interwału między poszczególnymi różnicowych kopii zapasowych. Dotyczy to tylko dynamicznych baz danych, ale nie porzuconych baz danych.
properties.retentionDays

integer (int32)

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

string

Typ zasobu.

DiffBackupIntervalInHours

Wyliczanie

Interwał różnicowej kopii zapasowej w godzinach. Jest to liczba godzin interwału między poszczególnymi różnicowych kopii zapasowych. Dotyczy to tylko dynamicznych baz danych, ale nie porzuconych baz danych.

Wartość Opis
12
24

ShortTermRetentionPolicyName

Wyliczanie

Nazwa zasad. Zawsze powinna być "domyślna".

Wartość Opis
default