Long Term Retention Policies - Create Or Update

Legt die langfristige Aufbewahrungsrichtlinie einer Datenbank fest.

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

URI-Parameter

Name In Required Type Description
databaseName
path True
  • string

Der Name der Datenbank.

policyName
path True

Der Richtlinienname. Sollte immer Standard sein.

resourceGroupName
path True
  • string

Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.

serverName
path True
  • string

Name des Servers

subscriptionId
path True
  • string

Abonnement-ID für ein Azure-Abonnement.

api-version
query True
  • string

API-Version, die für die Anforderung verwendet werden soll.

Anforderungstext

Name Type Description
properties.monthlyRetention
  • string

Die monatliche Aufbewahrungsrichtlinie für eine LTR-Sicherung im ISO 8601-Format.

properties.weekOfYear
  • integer

Die Woche des Jahres, um die jährliche Sicherung in einem ISO 8601-Format zu übernehmen.

properties.weeklyRetention
  • string

Die wöchentliche Aufbewahrungsrichtlinie für eine LTR-Sicherung im ISO 8601-Format.

properties.yearlyRetention
  • string

Die jährliche Aufbewahrungsrichtlinie für eine LTR-Sicherung im ISO 8601-Format.

Antworten

Name Type Description
200 OK

Die Richtlinie wurde erfolgreich festgelegt.

202 Accepted

Akzeptiert

Other Status Codes

Fehlerantworten: ***

  • 400 InvalidResourceRequestBody – Die Ressourcen- oder Ressourceneigenschaften im Anforderungstext sind leer oder ungültig.

  • 400 InvalidParameterValue – Ein ungültiger Wert wurde einem Parameter zugewiesen.

  • 400 LongTermRetentionMissingWeekOfYear - WeekOfYear muss zwischen 1 und 52 festgelegt werden, um die jährliche Aufbewahrung festzulegen.

  • 400 LongTermRetentionPolicyNotSupported – Langfristige Aufbewahrung wird in dieser Datenbank nicht unterstützt.

  • 400 LongTermRetentionPolicyInvalid – Langfristige Aufbewahrungsrichtlinie ist ungültig.

  • 404 SubscriptionDoesNotHaveServer – Der angeforderte Server wurde nicht gefunden.

  • 404 ServerNotInSubscriptionResourceGroup – Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden.

  • 404 ResourceNotFound – Die angeforderte Ressource wurde nicht gefunden.

Beispiele

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

Definitionen

LongTermRetentionPolicy

Eine langfristige Aufbewahrungsrichtlinie.

LongTermRetentionPolicyName

Der Richtlinienname. Sollte immer Standard sein.

LongTermRetentionPolicy

Eine langfristige Aufbewahrungsrichtlinie.

Name Type Description
id
  • string

Ressourcen-ID

name
  • string

Name der Ressource.

properties.monthlyRetention
  • string

Die monatliche Aufbewahrungsrichtlinie für eine LTR-Sicherung im ISO 8601-Format.

properties.weekOfYear
  • integer

Die Woche des Jahres, um die jährliche Sicherung in einem ISO 8601-Format zu übernehmen.

properties.weeklyRetention
  • string

Die wöchentliche Aufbewahrungsrichtlinie für eine LTR-Sicherung im ISO 8601-Format.

properties.yearlyRetention
  • string

Die jährliche Aufbewahrungsrichtlinie für eine LTR-Sicherung im ISO 8601-Format.

type
  • string

Der Ressourcentyp.

LongTermRetentionPolicyName

Der Richtlinienname. Sollte immer Standard sein.

Name Type Description
default
  • string