Long Term Retention Backups - Copy

Service:: SQL Database

API-versie:: 2025-01-01

Kopieer een bestaande back-up voor langetermijnretentie.

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

Name	In	Vereist	Type	Description
backupName	path	True	string	De naam van de back-up.
locationName	path	True	string	De locatie van de database.
longTermRetentionDatabaseName	path	True	string	De naam van de database
longTermRetentionServerName	path	True	string	De naam van de server
subscriptionId	path	True	string	De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd.
api-version	query	True	string	De API-versie die moet worden gebruikt voor de aanvraag.

Aanvraagbody

Name	Type	Description
properties.targetBackupStorageRedundancy	BackupStorageRedundancy	Het type opslagredundantie van de gekopieerde back-up
properties.targetDatabaseName	string	De naam van de database is eigenaar van de gekopieerde back-up.
properties.targetResourceGroup	string	De resourcegroep die eigenaar is van de doelserver
properties.targetServerFullyQualifiedDomainName	string	De volledig gekwalificeerde domeinnaam van de doelserver
properties.targetServerResourceId	string	De resource-id van de doelserver die eigenaar is van de database
properties.targetSubscriptionId	string	Het abonnement dat eigenaar is van de doelserver

Antwoorden

Name	Type	Description
200 OK	LongTermRetentionBackupOperationResult	De back-up is gekopieerd.
202 Accepted		Het kopiëren van de back-up wordt uitgevoerd. Kopteksten Location: string
Other Status Codes	ErrorResponse	Foutreacties: *** 400 ManagedInstanceStoppingOrStopped - Conflicterende bewerking verzonden terwijl het exemplaar de status gestopt/gestopt heeft 400 ManagedInstanceStarting - Conflicterende bewerking verzonden terwijl het exemplaar de beginstatus heeft 400 InvalidLongTermRetentionBackupId - Ongeldige back-up-id voor langetermijnretentie voor SQL DB's. 400 InvalidParameterValue - Er is een ongeldige waarde aan een parameter gegeven. 400 LongTermRetentionMismatchingSubscriptionId - De opgegeven abonnements-id komt niet overeen met de id in de andere invoer 400 LongTermRetentionMismatchingResourceGroupName - De opgegeven resourcegroepnaam komt niet overeen met de naam in de andere invoer 400 LongTermRetentionMismatchingServerName - De opgegeven servernaam komt niet overeen met de naam in de andere invoer 400 DeleteLtrSubscriptionMissing : de abonnements-id is vereist om een langetermijnretentieback-up te verwijderen. 400 DeleteLtrServerMissing : de servernaam is vereist om een back-up voor langetermijnretentie te verwijderen. 400 DeleteLtrDatabaseMissing : de databasenaam is vereist om een langetermijnretentieback-up te verwijderen. 400 LtrBackupResourceIdIncorrect: de opgegeven langetermijnretentieresource-id of back-upnaam is onjuist. 400 UpdateBackupStorageAccessTierLTRFailedOnZoneRedundantBackupStorage - Langetermijnretentieback-ups archiveren op zone-redundante back-upopslag wordt niet ondersteund. Gebruik in plaats daarvan lokaal redundante of geografisch redundante opslagtypen. 400 UpdateBackupStorageAccessTierLtrSubscriptionMissing : de abonnements-id is vereist om de langetermijnretentieback-up bij te werken. 400 UpdateBackupStorageAccessTierLtrServerMissing: de servernaam is vereist om de langetermijnretentieback-up bij te werken. 400 UpdateBackupStorageAccessTierLtrDatabaseMissing: de databasenaam is vereist om de langetermijnretentieback-up bij te werken. 400 UpdateBackupStorageAccessTierLtrBackupResourceIdIncorrect: de opgegeven resource-id of back-upnaam voor langetermijnretentie is onjuist. 400 LTRBackupNotExists: de bewerking kan niet worden voltooid omdat de back-up niet bestaat. 400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed - Het wijzigen van redundantie van back-upopslag is niet toegestaan voor LTR-kopieerbewerkingen. 400 LtrRestoreFailedArchiveStorageTier : het herstellen van gearchiveerde langetermijnretentieback-up wordt niet ondersteund. Herstel kan alleen worden uitgevoerd op gerehydrateerde of regelmatige langetermijnretentieback-ups. 400 LtrArchiveStorageTierNotEnabled - Back-ups voor langetermijnretentie archiveren is niet ingeschakeld. 400 LtrArchiveWrongParameters - ChangeLongTermRetentionBackupAccessTier wordt niet ondersteund voor de gewenste combinatie (backupStorageAccessTier, operationMode). Alleen (Archiveren, Verplaatsen) en (Dynamisch, Kopiëren) zijn toegestaan. 400 LTRArchiveRedundancyChangeFailed : het type redundantie van back-upopslag bijwerken naar zone-redundante opslag wordt niet ondersteund wanneer een langetermijnretentiebeleid met de toegangslaag archiefopslag voor back-upopslag is ingesteld 400 LongTermRetentionMigrationSubscriptionNotFound - Het abonnement is niet gevonden. 400 LtrOperationFailedBackupImmutable - Het verwijderen van langetermijnretentieback-up is mislukt omdat de back-up onveranderbaar is. 400 DeleteLtrBackupWithLegalHold - De back-up kan niet worden verwijderd omdat er een wettelijke bewaarplicht op is geplaatst. Verwijder de wettelijke bewaarplicht en probeer het opnieuw. 400 LTRBackupImmutableNotSet - De bewerking kan niet worden voltooid omdat de back-up niet is geconfigureerd voor onveranderlijkheid. 400 LTRBackupImmutabilityLocked - De bewerking kon niet worden voltooid omdat de back-up onveranderlijk en vergrendeld is. 400 LongTermRetentionMigrationRequestNotSupported - Abonnement is niet toegestaan LTR-back-up Migratiefunctie. 400 LongTermRetentionMigrationCrossClusterRequestNotSupported - Bron- en doelabonnementen mogen niet communiceren voor de functie LTR-back-up kopiëren. 400 LongTermRetentionMigrationParameterMissing - Vereiste parameter ontbreekt voor de bewerking. 400 LongTermRetentionMigrationSameServerNotSupported - LTR Copy-functie wordt niet ondersteund voor het kopiëren van LTR-back-ups binnen dezelfde server. 400 LongTermRetentionMigrationTargetServerNotFound - Doelserver bestaat niet of is niet gereed voor het LTR-back-up kopiëren. 400 LongTermRetentionMigrationTargetDatabaseNotFound - Doeldatabase bestaat niet op de server. 400 LongTermRetentionMigrationStorageTypeNotSupported - Opgegeven back-upopslagredundantie wordt niet ondersteund in de doelregio. 400 LongTermRetentionMigrationStorageMismatch - Actieve back-upredundantie van de database komt niet overeen met de door de klant aangevraagde back-upredundantie. 400 LongTermRetentionMigrationDatabaseTypeNotSupported - LTR-migratie wordt alleen ondersteund voor beheerde exemplaren en Azure SQL DB LTR-back-ups. 404 ServerNotInSubscriptionResourceGroup - Opgegeven server bestaat niet in de opgegeven resourcegroep en het opgegeven abonnement. 404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden 404 ResourceNotFound : de aangevraagde resource is niet gevonden. 404 LongTermRetentionMigrationBackupNotFound - OPGEGEVEN LTR-back-up bestaat niet. 404 OperationIdNotFound - De bewerking met id bestaat niet. 409 LongTermRetentionMigrationRequestConflict - Er wordt nog steeds een conflictbewerking uitgevoerd op deze LTR-back-up. 409 LongTermRetentionMigrationBackupConflict : er bestaat een andere LTR-back-up met dezelfde back-uptijd voor de doeldatabase. 409 CannotCancelOperation - De beheerbewerking heeft een status die niet kan worden geannuleerd. 409 OperationCancelled - De bewerking is geannuleerd door de gebruiker. 409 Bewerking onderbroken: de bewerking op de resource kan niet worden voltooid omdat deze is onderbroken door een andere bewerking op dezelfde resource. 429 SubscriptionTooManyCreateUpdateRequests - Aanvragen buiten het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources. 429 SubscriptionTooManyRequests : aanvragen buiten het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources. 500 LongTermRetentionMigrationRequestCopyFailed - Kopieerbewerking is mislukt voor LTR-back-upblobs. 500 LongTermRetentionMigrationRestoreVerExceeded - Herstelverificatie is mislukt nadat het maximum aantal pogingen is bereikt. 500 LongTermRetentionMigrationRestoreVerFailed - Herstelverificatie is mislukt. 500 LongTermRetentionMigrationRequestFailedToStartOnTarget - Kan de LTR-aanvraag voor het kopiëren van back-ups niet starten in de doelregio. 500 OperationTimedOut: er is een time-out opgetreden voor de bewerking en wordt automatisch teruggedraaid. Probeer de bewerking opnieuw uit te voeren. 503 TooManyRequests : aanvragen die buiten het maximum aantal aanvragen kunnen worden verwerkt door beschikbare resources.

Name

Type

Description

200 OK

LongTermRetentionBackupOperationResult

De back-up is gekopieerd.

202 Accepted

Het kopiëren van de back-up wordt uitgevoerd.

Kopteksten

Location: string

Other Status Codes

ErrorResponse

Foutreacties: ***

400 ManagedInstanceStoppingOrStopped - Conflicterende bewerking verzonden terwijl het exemplaar de status gestopt/gestopt heeft
400 ManagedInstanceStarting - Conflicterende bewerking verzonden terwijl het exemplaar de beginstatus heeft
400 InvalidLongTermRetentionBackupId - Ongeldige back-up-id voor langetermijnretentie voor SQL DB's.
400 InvalidParameterValue - Er is een ongeldige waarde aan een parameter gegeven.
400 LongTermRetentionMismatchingSubscriptionId - De opgegeven abonnements-id komt niet overeen met de id in de andere invoer
400 LongTermRetentionMismatchingResourceGroupName - De opgegeven resourcegroepnaam komt niet overeen met de naam in de andere invoer
400 LongTermRetentionMismatchingServerName - De opgegeven servernaam komt niet overeen met de naam in de andere invoer
400 DeleteLtrSubscriptionMissing : de abonnements-id is vereist om een langetermijnretentieback-up te verwijderen.
400 DeleteLtrServerMissing : de servernaam is vereist om een back-up voor langetermijnretentie te verwijderen.
400 DeleteLtrDatabaseMissing : de databasenaam is vereist om een langetermijnretentieback-up te verwijderen.
400 LtrBackupResourceIdIncorrect: de opgegeven langetermijnretentieresource-id of back-upnaam is onjuist.
400 UpdateBackupStorageAccessTierLTRFailedOnZoneRedundantBackupStorage - Langetermijnretentieback-ups archiveren op zone-redundante back-upopslag wordt niet ondersteund. Gebruik in plaats daarvan lokaal redundante of geografisch redundante opslagtypen.
400 UpdateBackupStorageAccessTierLtrSubscriptionMissing : de abonnements-id is vereist om de langetermijnretentieback-up bij te werken.
400 UpdateBackupStorageAccessTierLtrServerMissing: de servernaam is vereist om de langetermijnretentieback-up bij te werken.
400 UpdateBackupStorageAccessTierLtrDatabaseMissing: de databasenaam is vereist om de langetermijnretentieback-up bij te werken.
400 UpdateBackupStorageAccessTierLtrBackupResourceIdIncorrect: de opgegeven resource-id of back-upnaam voor langetermijnretentie is onjuist.
400 LTRBackupNotExists: de bewerking kan niet worden voltooid omdat de back-up niet bestaat.
400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed - Het wijzigen van redundantie van back-upopslag is niet toegestaan voor LTR-kopieerbewerkingen.
400 LtrRestoreFailedArchiveStorageTier : het herstellen van gearchiveerde langetermijnretentieback-up wordt niet ondersteund. Herstel kan alleen worden uitgevoerd op gerehydrateerde of regelmatige langetermijnretentieback-ups.
400 LtrArchiveStorageTierNotEnabled - Back-ups voor langetermijnretentie archiveren is niet ingeschakeld.
400 LtrArchiveWrongParameters - ChangeLongTermRetentionBackupAccessTier wordt niet ondersteund voor de gewenste combinatie (backupStorageAccessTier, operationMode). Alleen (Archiveren, Verplaatsen) en (Dynamisch, Kopiëren) zijn toegestaan.
400 LTRArchiveRedundancyChangeFailed : het type redundantie van back-upopslag bijwerken naar zone-redundante opslag wordt niet ondersteund wanneer een langetermijnretentiebeleid met de toegangslaag archiefopslag voor back-upopslag is ingesteld
400 LongTermRetentionMigrationSubscriptionNotFound - Het abonnement is niet gevonden.
400 LtrOperationFailedBackupImmutable - Het verwijderen van langetermijnretentieback-up is mislukt omdat de back-up onveranderbaar is.
400 DeleteLtrBackupWithLegalHold - De back-up kan niet worden verwijderd omdat er een wettelijke bewaarplicht op is geplaatst. Verwijder de wettelijke bewaarplicht en probeer het opnieuw.
400 LTRBackupImmutableNotSet - De bewerking kan niet worden voltooid omdat de back-up niet is geconfigureerd voor onveranderlijkheid.
400 LTRBackupImmutabilityLocked - De bewerking kon niet worden voltooid omdat de back-up onveranderlijk en vergrendeld is.
400 LongTermRetentionMigrationRequestNotSupported - Abonnement is niet toegestaan LTR-back-up Migratiefunctie.
400 LongTermRetentionMigrationCrossClusterRequestNotSupported - Bron- en doelabonnementen mogen niet communiceren voor de functie LTR-back-up kopiëren.
400 LongTermRetentionMigrationParameterMissing - Vereiste parameter ontbreekt voor de bewerking.
400 LongTermRetentionMigrationSameServerNotSupported - LTR Copy-functie wordt niet ondersteund voor het kopiëren van LTR-back-ups binnen dezelfde server.
400 LongTermRetentionMigrationTargetServerNotFound - Doelserver bestaat niet of is niet gereed voor het LTR-back-up kopiëren.
400 LongTermRetentionMigrationTargetDatabaseNotFound - Doeldatabase bestaat niet op de server.
400 LongTermRetentionMigrationStorageTypeNotSupported - Opgegeven back-upopslagredundantie wordt niet ondersteund in de doelregio.
400 LongTermRetentionMigrationStorageMismatch - Actieve back-upredundantie van de database komt niet overeen met de door de klant aangevraagde back-upredundantie.
400 LongTermRetentionMigrationDatabaseTypeNotSupported - LTR-migratie wordt alleen ondersteund voor beheerde exemplaren en Azure SQL DB LTR-back-ups.
404 ServerNotInSubscriptionResourceGroup - Opgegeven server bestaat niet in de opgegeven resourcegroep en het opgegeven abonnement.
404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden
404 ResourceNotFound : de aangevraagde resource is niet gevonden.
404 LongTermRetentionMigrationBackupNotFound - OPGEGEVEN LTR-back-up bestaat niet.
404 OperationIdNotFound - De bewerking met id bestaat niet.
409 LongTermRetentionMigrationRequestConflict - Er wordt nog steeds een conflictbewerking uitgevoerd op deze LTR-back-up.
409 LongTermRetentionMigrationBackupConflict : er bestaat een andere LTR-back-up met dezelfde back-uptijd voor de doeldatabase.
409 CannotCancelOperation - De beheerbewerking heeft een status die niet kan worden geannuleerd.
409 OperationCancelled - De bewerking is geannuleerd door de gebruiker.
409 Bewerking onderbroken: de bewerking op de resource kan niet worden voltooid omdat deze is onderbroken door een andere bewerking op dezelfde resource.
429 SubscriptionTooManyCreateUpdateRequests - Aanvragen buiten het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.
429 SubscriptionTooManyRequests : aanvragen buiten het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.
500 LongTermRetentionMigrationRequestCopyFailed - Kopieerbewerking is mislukt voor LTR-back-upblobs.
500 LongTermRetentionMigrationRestoreVerExceeded - Herstelverificatie is mislukt nadat het maximum aantal pogingen is bereikt.
500 LongTermRetentionMigrationRestoreVerFailed - Herstelverificatie is mislukt.
500 LongTermRetentionMigrationRequestFailedToStartOnTarget - Kan de LTR-aanvraag voor het kopiëren van back-ups niet starten in de doelregio.
500 OperationTimedOut: er is een time-out opgetreden voor de bewerking en wordt automatisch teruggedraaid. Probeer de bewerking opnieuw uit te voeren.
503 TooManyRequests : aanvragen die buiten het maximum aantal aanvragen kunnen worden verwerkt door beschikbare resources.

Voorbeelden

Copy the long term retention backup.

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name	Description
BackupStorageRedundancy	Het type opslagredundantie van de gekopieerde back-up
CopyLongTermRetentionBackupParameters	Bevat de informatie die nodig is voor het uitvoeren van back-upkopiebewerkingen voor langetermijnretentie.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
LongTermRetentionBackupOperationResult	Een longTermRetentionBackup-bewerkingsresource.

BackupStorageRedundancy

Opsomming

Het type opslagredundantie van de gekopieerde back-up

Waarde	Description
Geo
Local
Zone
GeoZone

CopyLongTermRetentionBackupParameters

Object

Bevat de informatie die nodig is voor het uitvoeren van back-upkopiebewerkingen voor langetermijnretentie.

Name	Type	Description
properties.targetBackupStorageRedundancy	BackupStorageRedundancy	Het type opslagredundantie van de gekopieerde back-up
properties.targetDatabaseName	string	De naam van de database is eigenaar van de gekopieerde back-up.
properties.targetResourceGroup	string	De resourcegroep die eigenaar is van de doelserver
properties.targetServerFullyQualifiedDomainName	string	De volledig gekwalificeerde domeinnaam van de doelserver
properties.targetServerResourceId	string	De resource-id van de doelserver die eigenaar is van de database
properties.targetSubscriptionId	string	Het abonnement dat eigenaar is van de doelserver

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoelwit.

ErrorResponse

Object

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

LongTermRetentionBackupOperationResult

Object

Een longTermRetentionBackup-bewerkingsresource.

Name	Type	Description
id	string	Resource-ID.
name	string	Resourcenaam.
properties.fromBackupResourceId	string	Bronback-upresource-id
properties.message	string	Voortgangsbericht
properties.operationType	string	Bewerkingstype.
properties.requestId	string (uuid)	Aanvraag-id.
properties.status	string	Operatiestatus
properties.targetBackupStorageRedundancy	BackupStorageRedundancy	Het type opslagredundantie van de gekopieerde back-up
properties.toBackupResourceId	string	Resource-id van doelback-up
type	string	Type bron

Delen via

Long Term Retention Backups - Copy

URI-parameters

Aanvraagbody

Antwoorden

Voorbeelden

Copy the long term retention backup.

Voorbeeldaanvraag

Voorbeeldrespons

Definities

BackupStorageRedundancy

CopyLongTermRetentionBackupParameters

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

LongTermRetentionBackupOperationResult