Long Term Retention Policies - List By Database

Ruft die langfristige Aufbewahrungsrichtlinie einer Datenbank ab.

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

URI-Parameter

Name In Required Type Description
databaseName
path True
  • string

Der Name der Datenbank.

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.

Antworten

Name Type Description
200 OK

Die Richtlinie wurde erfolgreich abgerufen.

Other Status Codes

Fehlerantworten: ***

  • 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

Get the long term retention policy for the database.

Sample Request

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

Sample Response

{
  "value": [
    {
      "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.

LongTermRetentionPolicyListResult

Eine Liste der langfristigen Aufbewahrungsrichtlinien.

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.

LongTermRetentionPolicyListResult

Eine Liste der langfristigen Aufbewahrungsrichtlinien.

Name Type Description
nextLink
  • string

Link zum Abrufen der nächsten Seite der Ergebnisse.

value

Array von Ergebnissen.