Sdílet prostřednictvím


Long Term Retention Backups - Copy

Zkopírujte existující zálohu dlouhodobého uchovávání.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
backupName
path True

string

Název zálohy.

locationName
path True

string

Umístění databáze.

longTermRetentionDatabaseName
path True

string

Název databáze

longTermRetentionServerName
path True

string

Název serveru

subscriptionId
path True

string

ID předplatného, které identifikuje předplatné Azure.

api-version
query True

string

Verze rozhraní API, která se má použít pro požadavek.

Text požadavku

Name Typ Description
properties.targetBackupStorageRedundancy

BackupStorageRedundancy

Typ redundance úložiště zkopírované zálohy

properties.targetDatabaseName

string

Název databáze vlastní zkopírovanou zálohu.

properties.targetResourceGroup

string

Skupina prostředků, která vlastní cílový server

properties.targetServerFullyQualifiedDomainName

string

Plně kvalifikovaný název domény cílového serveru

properties.targetServerResourceId

string

ID prostředku cílového serveru, který vlastní databázi

properties.targetSubscriptionId

string

Předplatné, které vlastní cílový server

Odpovědi

Name Typ Description
200 OK

LongTermRetentionBackupOperationResult

Zálohování se úspěšně zkopírovalo.

202 Accepted

Probíhá kopírování zálohování.

Other Status Codes

Chybové odpovědi: ***

  • 400 InvalidLongTermRetentionBackupId – neplatný identifikátor zálohy dlouhodobého uchovávání pro databáze SQL.

  • 400 InvalidParameterValue – parametru byla přiřazena neplatná hodnota.

  • 400 LongTermRetentionMismatchingSubscriptionId – zadané ID předplatného neodpovídá ID v jiném vstupu.

  • 400 LongTermRetentionMismatchingResourceGroupName – zadaný název skupiny prostředků neodpovídá názvu v jiném vstupu.

  • 400 LongTermRetentionMismatchingServerName – zadaný název serveru neodpovídá názvu v jiném vstupu.

  • 400 LongTermRetentionMigrationRequestNotSupported – Předplatná není povolená funkce migrace zálohování LTR.

  • 400 LongTermRetentionMigrationCrossClusterRequestNotSupported – Zdrojová a cílová předplatná nesmí komunikovat o funkci kopírování zálohování LTR.

  • 400 LongTermRetentionMigrationParameterMissing – chybí požadovaný parametr pro operaci.

  • 400 LongTermRetentionMigrationSameServerNotSupported – Funkce LTR Copy není podporována pro kopírování záloh LTR na stejném serveru.

  • 400 LongTermRetentionMigrationTargetServerNotFound – Cílový server neexistuje nebo není připravený pro operaci kopírování zálohování LTR.

  • 400 LongTermRetentionMigrationTargetDatabaseNotFound – Cílová databáze na serveru neexistuje.

  • 400 LongTermRetentionMigrationStorageTypeNotSupported – Zadaná redundance úložiště zálohování se v cílové oblasti nepodporuje.

  • 400 LongTermRetentionMigrationStorageMismatch – aktivní redundance zálohování databáze neodpovídá redundanci zálohování požadované zákazníkem.

  • 400 LongTermRetentionMigrationDatabaseTypeNotSupported – Migrace LTR se podporuje pouze pro zálohy LTR spravované instance a Azure SQL DB.

  • 400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed – Změna redundance úložiště zálohování není pro operace kopírování LTR povolená.

  • 400 LongTermRetentionMigrationSubscriptionNotFound – předplatné nebylo nalezeno.

  • 404 SubscriptionDoesNotHaveServer – požadovaný server nebyl nalezen.

  • 404 ServerNotInSubscriptionResourceGroup – zadaný server neexistuje v zadané skupině prostředků a předplatném.

  • 404 ResourceNotFound – požadovaný prostředek nebyl nalezen.

  • 404 LongTermRetentionMigrationBackupNotFound – zadaná záloha LTR neexistuje.

  • 404 OperationIdNotFound – operace s ID neexistuje.

  • 409 LongTermRetentionMigrationRequestConflict – konfliktní operace pro toto zálohování LTR stále probíhá.

  • 409 LongTermRetentionMigrationBackupConflict – existuje další záloha LTR se stejnou dobou zálohování pro cílovou databázi.

  • 409 OperationCancelled – operace byla zrušena uživatelem.

  • 409 OperationInterrupted – Operaci s prostředkem nebylo možné dokončit, protože byla přerušena jinou operací se stejným prostředkem.

  • 429 SubscriptionTooManyCreateUpdateRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky.

  • 429 SubscriptionTooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky.

  • 500 LongTermRetentionMigrationRequestFailedToStartOnTarget – Nepodařilo se spustit žádost o záložní kopírování LTR v cílové oblasti.

  • 500 LongTermRetentionMigrationRequestCopyFailed – Operace kopírování pro objekty blob zálohování LTR selhala.

  • 500 LongTermRetentionMigrationRestoreVerExceeded – ověření obnovení se po dosažení maximálního počtu pokusů nezdařilo.

  • 500 LongTermRetentionMigrationRestoreVerFailed – Ověření obnovení se nezdařilo.

  • 500 OperationTimedOut – časový limit operace vypršel a automaticky se vrátila zpět. Opakujte operaci.

  • 503 TooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky.

Příklady

Copy the long term retention backup.

Ukázkový požadavek

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=2021-11-01

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

Ukázková odpověď

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

Definice

Name Description
BackupStorageRedundancy

Typ redundance úložiště zkopírované zálohy

CopyLongTermRetentionBackupParameters

Obsahuje informace potřebné k provedení operace kopírování dlouhodobého uchovávání záloh.

LongTermRetentionBackupOperationResult

Prostředek výsledku operace LongTermRetentionBackup.

BackupStorageRedundancy

Typ redundance úložiště zkopírované zálohy

Name Typ Description
Geo

string

GeoZone

string

Local

string

Zone

string

CopyLongTermRetentionBackupParameters

Obsahuje informace potřebné k provedení operace kopírování dlouhodobého uchovávání záloh.

Name Typ Description
properties.targetBackupStorageRedundancy

BackupStorageRedundancy

Typ redundance úložiště zkopírované zálohy

properties.targetDatabaseName

string

Název databáze vlastní zkopírovanou zálohu.

properties.targetResourceGroup

string

Skupina prostředků, která vlastní cílový server

properties.targetServerFullyQualifiedDomainName

string

Plně kvalifikovaný název domény cílového serveru

properties.targetServerResourceId

string

ID prostředku cílového serveru, který vlastní databázi

properties.targetSubscriptionId

string

Předplatné, které vlastní cílový server

LongTermRetentionBackupOperationResult

Prostředek výsledku operace LongTermRetentionBackup.

Name Typ Description
id

string

ID prostředku.

name

string

Název prostředku.

properties.fromBackupResourceId

string

ID prostředku zálohování zdroje

properties.message

string

Zpráva o průběhu

properties.operationType

string

Typ operace.

properties.requestId

string

ID požadavku.

properties.status

string

Stav operace

properties.targetBackupStorageRedundancy

BackupStorageRedundancy

Typ redundance úložiště zkopírované zálohy

properties.toBackupResourceId

string

ID prostředku cílové zálohy

type

string

Typ prostředku.