Long Term Retention Policies - Create Or Update

Ustawia zasady długoterminowego przechowywania bazy danych.

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

Parametry identyfikatora URI

Name In Required Type Description
databaseName
path True
  • string

Nazwa bazy danych.

policyName
path True

Nazwa zasad. Zawsze powinna mieć wartość 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

Name Type Description
properties.monthlyRetention
  • string

Zasady przechowywania miesięcznego kopii zapasowej LTR w formacie ISO 8601.

properties.weekOfYear
  • integer

Tydzień roku do wykonania rocznej kopii zapasowej w formacie ISO 8601.

properties.weeklyRetention
  • string

Zasady przechowywania tygodniowego kopii zapasowej LTR w formacie ISO 8601.

properties.yearlyRetention
  • string

Roczne zasady przechowywania kopii zapasowej LTR w formacie ISO 8601.

Odpowiedzi

Name Type Description
200 OK

Pomyślnie ustawiono zasady.

202 Accepted

Zaakceptowano

Other Status Codes

Odpowiedzi na błędy: ***

  • 400 InvalidResourceRequestBody — właściwości zasobu lub zasobu w treści żądania są puste lub nieprawidłowe.

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

  • 400 LongTermRetentionMissingWeekOfYear — WeekOfYear jest wymagany do ustawienia między 1 a 52, aby ustawić przechowywanie roczne.

  • 400 LongTermRetentionPolicyNotSupported — długoterminowe przechowywanie nie jest obsługiwane w tej bazie danych.

  • 400 LongTermRetentionPolicyInvalid — zasady przechowywania długoterminowego są nieprawidłowe.

  • 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.

Przykłady

Create or update the long term retention policy for the database.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup/providers/Microsoft.Sql/servers/testserver/databases/testDatabase/backupLongTermRetentionPolicies/default?api-version=2021-08-01-preview

{
  "properties": {
    "weeklyRetention": "P1M",
    "monthlyRetention": "P1Y",
    "yearlyRetention": "P5Y",
    "weekOfYear": 5
  }
}

Sample Response

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/resourceGroups/resourceGroup/servers/testserver/databases/testDatabase/backupLongTermRetentionPolicies/default",
  "name": "default",
  "type": "Microsoft.Sql/resourceGroups/servers/databases/backupLongTermRetentionPolicies",
  "properties": {
    "weeklyRetention": "P1M",
    "monthlyRetention": "P1Y",
    "yearlyRetention": "P5Y",
    "weekOfYear": 5
  }
}

Definicje

LongTermRetentionPolicy

Zasady przechowywania długoterminowego.

LongTermRetentionPolicyName

Nazwa zasad. Zawsze powinna mieć wartość Domyślna.

LongTermRetentionPolicy

Zasady przechowywania długoterminowego.

Name Type Description
id
  • string

Identyfikator zasobu.

name
  • string

Nazwa zasobu.

properties.monthlyRetention
  • string

Zasady przechowywania miesięcznego kopii zapasowej LTR w formacie ISO 8601.

properties.weekOfYear
  • integer

Tydzień roku do wykonania rocznej kopii zapasowej w formacie ISO 8601.

properties.weeklyRetention
  • string

Zasady przechowywania tygodniowego kopii zapasowej LTR w formacie ISO 8601.

properties.yearlyRetention
  • string

Roczne zasady przechowywania kopii zapasowej LTR w formacie ISO 8601.

type
  • string

Typ zasobu.

LongTermRetentionPolicyName

Nazwa zasad. Zawsze powinna mieć wartość Domyślna.

Name Type Description
default
  • string