Managed Backup Short Term Retention Policies - Create Or Update

Aktualisiert die kurzfristige Aufbewahrungsrichtlinie einer verwalteten Datenbank.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}/backupShortTermRetentionPolicies/default?api-version=2020-11-01-preview

URI-Parameter

Name In Required Type Description
databaseName
path True
  • string

Der Name der Datenbank.

managedInstanceName
path True
  • string

Der Name der verwalteten Instanz.

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.

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

Die Beibehaltungsdauer für Sicherungen in Tagen. Dies ist, wie viele Tage Point-in-Time-Wiederherstellung unterstützt werden.

Antworten

Name Type Description
200 OK

Die Richtlinie wurde erfolgreich aktualisiert.

202 Accepted

Akzeptiert

Other Status Codes

Fehlerantworten: ***

  • 400 InvalidBackupRetentionDays – Die Aufbewahrungstage {0} sind keine gültige Konfiguration. Gültige Sicherungsaufbewahrung muss sich in 7-tägigen Schritten (7, 14, 21 usw.)

  • 400 InvalidRestorableDroppedDatabaseDeletionDate – Das zurückgegebene Datenbanklöschdatum ist ungültig.

  • 400 InvalidRestorableDroppedDatabaseId - Ungültige Wiederherstellungsdatenbankbezeichner

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

  • 400 InvalidBackupRetentionPeriod – Die Aufbewahrungstage {0} sind keine gültige Konfiguration. Gültige Sicherungsaufbewahrung in Tagen muss zwischen {1} und {2}

  • 404 SubscriptionDoesNotHaveServer – Der angeforderte Server wurde nicht gefunden.

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

  • 404 ResourceNotFound – Die angeforderte Ressource wurde nicht gefunden.

  • 404 SourceDatabaseNotFound – Die Quelldatenbank ist nicht vorhanden.

  • 404 CannotFindObject - Das Objekt kann nicht gefunden werden, weil es nicht vorhanden ist oder Sie keine Berechtigungen haben

  • 429 SubscriptionTooManyCreateUpdateRequests – Anforderungen über maximale Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können.

  • 429 SubscriptionTooManyRequests – Anforderungen über maximale Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können.

  • 503 TooManyRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können.

  • 504 RequestTimeout - Dienstanforderung überschreitet das zulässige Timeout.

Beispiele

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/managedInstances/testsvr/databases/testdb/backupShortTermRetentionPolicies/default?api-version=2020-11-01-preview

{
  "properties": {
    "retentionDays": 14
  }
}

Sample Response

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb/backupShortTermRetentionPolicies/default",
  "name": "default",
  "type": "Microsoft.Sql/managedInstances/databases/backupShortTermRetentionPolicies",
  "properties": {
    "retentionDays": 14
  }
}

Definitionen

ManagedBackupShortTermRetentionPolicy

Eine kurze Aufbewahrungsrichtlinie.

ManagedShortTermRetentionPolicyName

Der Richtlinienname. Sollte immer "standard" sein.

ManagedBackupShortTermRetentionPolicy

Eine kurze Aufbewahrungsrichtlinie.

Name Type Description
id
  • string

Ressourcen-ID

name
  • string

Name der Ressource.

properties.retentionDays
  • integer

Die Beibehaltungsdauer für Sicherungen in Tagen. Dies ist, wie viele Tage Point-in-Time-Wiederherstellung unterstützt werden.

type
  • string

Der Ressourcentyp.

ManagedShortTermRetentionPolicyName

Der Richtlinienname. Sollte immer "standard" sein.

Name Type Description
default
  • string