Long Term Retention Backups - Copy

Dienst:

SQL Database

API-Version:

2025-01-01

Kopieren Einer vorhandenen langfristigen Aufbewahrungssicherung.

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionServers/{longTermRetentionServerName}/longTermRetentionDatabases/{longTermRetentionDatabaseName}/longTermRetentionBackups/{backupName}/copy?api-version=2025-01-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
backupName	path	True	string	Der Sicherungsname.
locationName	path	True	string	Der Speicherort der Datenbank.
longTermRetentionDatabaseName	path	True	string	den Namen der Datenbank
longTermRetentionServerName	path	True	string	Der Name des Servers
subscriptionId	path	True	string	Die Abonnement-ID, die ein Azure-Abonnement identifiziert.
api-version	query	True	string	Die API-Version, die für die Anforderung verwendet werden soll.

Anforderungstext

Name	Typ	Beschreibung
properties.targetBackupStorageRedundancy	BackupStorageRedundancy	Der Speicherredundanztyp der kopierten Sicherung
properties.targetDatabaseName	string	Der Name der Datenbank besitzt die kopierte Sicherung.
properties.targetResourceGroup	string	Die Ressourcengruppe, die den Zielserver besitzt
properties.targetServerFullyQualifiedDomainName	string	Der vollqualifizierte Domänenname des Zielservers
properties.targetServerResourceId	string	Die Ressourcen-ID des Zielservers, der die Datenbank besitzt
properties.targetSubscriptionId	string	Das Abonnement, das den Zielserver besitzt

Antworten

Name	Typ	Beschreibung
200 OK	LongTermRetentionBackupOperationResult	Die Sicherung wurde erfolgreich kopiert.
202 Accepted		Das Kopieren der Sicherung wird ausgeführt. Header Location: string
Other Status Codes	ErrorResponse	Fehlerantworten: *** 400 ManagedInstanceStoppingOrStopped – Konfliktierender Vorgang, der während der Instanz beendet/beendet wird 400 ManagedInstanceStarting – Konfliktierender Vorgang, der während der Instanz im Startzustand liegt 400 InvalidLongTermRetentionBackupId – Ungültiger Langfristiger Aufbewahrungssicherungsbezeichner für SQL-DBs. 400 InvalidParameterValue – Ein ungültiger Wert wurde einem Parameter zugewiesen. 400 LongTermRetentionMismatchingSubscriptionId – Die angegebene Abonnement-ID entspricht nicht der ID in der anderen Eingabe. 400 LongTermRetentionMismatchingResourceGroupName – Der angegebene Ressourcengruppenname entspricht nicht dem Namen in der anderen Eingabe. 400 LongTermRetentionMismatchingServerName – Der angegebene Servername entspricht nicht dem Namen in der anderen Eingabe. 400 DeleteLtrSubscriptionMissing – Die Abonnement-ID ist erforderlich, um eine langfristige Aufbewahrungssicherung zu löschen. 400 DeleteLtrServerMissing – Der Servername ist erforderlich, um eine langfristige Aufbewahrungssicherung zu löschen. 400 DeleteLtrDatabaseMissing – Der Datenbankname ist erforderlich, um eine langfristige Aufbewahrungssicherung zu löschen. 400 LtrBackupResourceIdIncorrect – Die bereitgestellte langfristige Aufbewahrungssicherungsressourcen-ID oder der Sicherungsname ist falsch. 400 UpdateBackupStorageAccessTierLTRFailedOnZoneRedundantBackupStorage – Archivierung langfristiger Aufbewahrungssicherungen auf zonenredundanten Sicherungsspeicher wird nicht unterstützt. Verwenden Sie stattdessen lokal redundante oder georedundante Speichertypen. 400 UpdateBackupStorageAccessTierLtrSubscriptionMissing – Die Abonnement-ID ist erforderlich, um die langfristige Aufbewahrungssicherung zu aktualisieren. 400 UpdateBackupStorageAccessTierLtrServerMissing – Der Servername ist erforderlich, um die langfristige Aufbewahrungssicherung zu aktualisieren. 400 UpdateBackupStorageAccessTierLtrDatabaseMissing – Der Datenbankname ist erforderlich, um die langfristige Aufbewahrungssicherung zu aktualisieren. 400 UpdateBackupStorageAccessTierLtrBackupResourceIdIncorrect – Die bereitgestellte langfristige Aufbewahrungssicherungsressourcen-ID oder der Sicherungsname ist falsch. 400 LTRBackupNotExists: Der Vorgang konnte nicht abgeschlossen werden, da die Sicherung nicht vorhanden ist. 400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed – Das Ändern der Sicherungsspeicherredundanz ist für LTR-Kopiervorgänge nicht zulässig. 400 LtrRestoreFailedArchiveStorageTier – Das Wiederherstellen archivierter langfristiger Aufbewahrungssicherungen wird nicht unterstützt. Die Wiederherstellung kann nur bei rehydratierten oder regelmäßigen Langzeitaufbewahrungssicherungen durchgeführt werden. 400 LtrArchiveStorageTierNotEnabled – Die Archivierung langfristiger Aufbewahrungssicherungen ist nicht aktiviert. 400 LtrArchiveWrongParameters - ChangeLongTermRetentionBackupAccessTier wird für die gewünschte Kombination (backupStorageAccessTier, operationMode) nicht unterstützt. Nur (Archiv, Verschieben) und (Hot, Copy) sind zulässig. 400 LTRArchiveRedundancyChangeFailed – Das Aktualisieren des Redundanztyps des Sicherungsspeichers auf zonenredundanten Speicher wird nicht unterstützt, wenn eine langfristige Aufbewahrungsrichtlinie mit der Sicherungsspeicherebene "Archiv" festgelegt ist. 400 LongTermRetentionMigrationSubscriptionNotFound – Das Abonnement konnte nicht gefunden werden. 400 LtrOperationFailedBackupImmutable – Fehler beim Löschen der Sicherung für die langfristige Aufbewahrung, da die Sicherung unveränderlich ist. 400 DeleteLtrBackupWithLegalHold – Die Sicherung kann nicht gelöscht werden, da sie mit einer gesetzlichen Aufbewahrungspflicht belegt ist. Entfernen Sie die gesetzliche Aufbewahrungspflicht, und wiederholen Sie den Vorgang. 400 LTRBackupImmutableNotSet: Der Vorgang konnte nicht abgeschlossen werden, da die Sicherung nicht für die Unveränderlichkeit konfiguriert ist. 400 LTRBackupImmutabilityLocked: Der Vorgang konnte nicht abgeschlossen werden, da die Sicherung unveränderlich und gesperrt ist. 400 LongTermRetentionMigrationRequestNotSupported – Abonnement ist kein LTR-Sicherungsmigrationsfeature zulässig. 400 LongTermRetentionMigrationCrossClusterRequestNotSupported – Quell- und Zielabonnements dürfen nicht für die LTR-Sicherungskopienfunktion kommunizieren. 400 LongTermRetentionMigrationParameterMissing – Erforderlicher Parameter, der für den Vorgang fehlt. 400 LongTermRetentionMigrationSameServerNotSupported – LTR Copy-Feature wird nicht unterstützt, um LTR-Sicherungen auf demselben Server zu kopieren. 400 LongTermRetentionMigrationTargetServerNotFound – Der Zielserver ist nicht vorhanden oder ist nicht für den LTR-Sicherungskopievorgang bereit. 400 LongTermRetentionMigrationTargetDatabaseNotFound – Zieldatenbank ist auf dem Server nicht vorhanden. 400 LongTermRetentionMigrationStorageTypeNotSupported – Angegebene Sicherungsspeicherredundanz wird im Zielbereich nicht unterstützt. 400 LongTermRetentionMigrationStorageMismatch – Aktive Sicherungsredundanz der Datenbank stimmt nicht mit der vom Kunden angeforderten Sicherungsredundanz überein. 400 LongTermRetentionMigrationDatabaseTypeNotSupported – LTR-Migration wird nur für verwaltete Instanzen und Azure SQL DB LTR-Sicherungen unterstützt. 404 ServerNotInSubscriptionResourceGroup – Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden. 404 SubscriptionDoesNotHaveServer – Der angeforderte Server wurde nicht gefunden. 404 ResourceNotFound – Die angeforderte Ressource wurde nicht gefunden. 404 LongTermRetentionMigrationBackupNotFound - LTR-Sicherung angegeben ist nicht vorhanden. 404 OperationIdNotFound – Der Vorgang mit der ID ist nicht vorhanden. 409 LongTermRetentionMigrationRequestConflict – Ein Konfliktvorgang für diese LTR-Sicherung wird noch ausgeführt. 409 LongTermRetentionMigrationBackupConflict – Eine weitere LTR-Sicherung mit derselben Sicherungszeit für die Zieldatenbank ist vorhanden. 409 CannotCancelOperation – Der Verwaltungsvorgang befindet sich in einem Zustand, der nicht abgebrochen werden kann. 409 OperationCancelled – Der Vorgang wurde vom Benutzer abgebrochen. 409 OperationInterrupted – Der Vorgang für die Ressource konnte nicht abgeschlossen werden, weil er durch einen anderen Vorgang in derselben Ressource unterbrochen wurde. 429 SubscriptionTooManyCreateUpdateRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können. 429 SubscriptionTooManyRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können. 500 LongTermRetentionMigrationRequestCopyFailed – Kopiervorgang für LTR-Sicherungsblobs fehlgeschlagen. 500 LongTermRetentionMigrationRestoreVerExceeded – Fehler bei der Wiederherstellungsüberprüfung, nachdem maximale Versuche erreicht wurden. 500 LongTermRetentionMigrationRestoreVerFailed – Wiederherstellungsfehler. 500 LongTermRetentionMigrationRequestFailedToStartOnTarget – Fehler beim Starten der LTR-Sicherungskopieanforderung in Zielbereich. 500 OperationTimedOut – Timeout des Vorgangs und automatisches Zurücksetzen. Versuchen Sie den Vorgang erneut. 503 TooManyRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können.

Beispiele

Copy the long term retention backup.

Beispielanforderung

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionServers/testserver/longTermRetentionDatabases/testDatabase/longTermRetentionBackups/55555555-6666-7777-8888-999999999999;131637960820000000/copy?api-version=2025-01-01

{
  "properties": {
    "targetServerResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/resourceGroups/resourceGroup/servers/testserver2",
    "targetDatabaseName": "testDatabase2",
    "targetBackupStorageRedundancy": "Geo"
  }
}

Beispiel für eine Antwort

Statuscode:

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japanEast/longTermRetentionBackupOperationResults/a1aa7c77-961b-4fbb-bcd6-aa9acfcd1706",
  "name": "a1aa7c77-961b-4fbb-bcd6-aa9acfcd1706",
  "type": "Microsoft.Sql/locations/longTermRetentionBackupOperationResults",
  "properties": {
    "requestId": "a1aa7c77-961b-4fbb-bcd6-aa9acfcd1706",
    "fromBackupResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japanEast/longTermRetentionServers/testserver/longterRetentionDatabases/testDatabase/longTermRetentionBackups/55555555-6666-7777-8888-999999999999;131637960820000000",
    "operationType": "CopyBackup",
    "status": "Succeeded",
    "toBackupResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup/providers/Microsoft.Sql/locations/japanEast/longTermRetentionServers/testserver2/longterRetentionDatabases/testDatabase2/longTermRetentionBackups/55555555-6666-7777-8888-111111111111;131637960820000000",
    "targetBackupStorageRedundancy": "Geo"
  }
}

Statuscode:

202

Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japanEast/longTermRetentionBackupOperationResults/a1aa7c77-961b-4fbb-bcd6-aa9acfcd1706?api-version=2021-05-01

Definitionen

Name	Beschreibung
BackupStorageRedundancy	Der Speicherredundanztyp der kopierten Sicherung
CopyLongTermRetentionBackupParameters	Enthält die informationen, die zum Ausführen eines langfristigen Aufbewahrungssicherungskopievorgangs erforderlich sind.
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
LongTermRetentionBackupOperationResult	Eine Ergebnisressource des LongTermRetentionBackup-Vorgangs.

BackupStorageRedundancy

Enumeration

Der Speicherredundanztyp der kopierten Sicherung

Wert	Beschreibung
Geo
Local
Zone
GeoZone

CopyLongTermRetentionBackupParameters

Objekt

Enthält die informationen, die zum Ausführen eines langfristigen Aufbewahrungssicherungskopievorgangs erforderlich sind.

Name	Typ	Beschreibung
properties.targetBackupStorageRedundancy	BackupStorageRedundancy	Der Speicherredundanztyp der kopierten Sicherung
properties.targetDatabaseName	string	Der Name der Datenbank besitzt die kopierte Sicherung.
properties.targetResourceGroup	string	Die Ressourcengruppe, die den Zielserver besitzt
properties.targetServerFullyQualifiedDomainName	string	Der vollqualifizierte Domänenname des Zielservers
properties.targetServerResourceId	string	Die Ressourcen-ID des Zielservers, der die Datenbank besitzt
properties.targetSubscriptionId	string	Das Abonnement, das den Zielserver besitzt

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

LongTermRetentionBackupOperationResult

Objekt

Eine Ergebnisressource des LongTermRetentionBackup-Vorgangs.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
name	string	Ressourcenname.
properties.fromBackupResourceId	string	Quellsicherungsressourcen-ID
properties.message	string	Statusmeldung
properties.operationType	string	Vorgangstyp.
properties.requestId	string (uuid)	Anforderungs-ID.
properties.status	string	Vorgangsstatus
properties.targetBackupStorageRedundancy	BackupStorageRedundancy	Der Speicherredundanztyp der kopierten Sicherung
properties.toBackupResourceId	string	Zielsicherungsressourcen-ID
type	string	Ressourcentyp.