Long Term Retention Backups - Update By Resource Group

Aktualizuje stávající dlouhodobé uchovávání záloh.

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

Parametry identifikátoru URI

Name In Required Type 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

resourceGroupName
path True
  • string

Název skupiny prostředků, která prostředek obsahuje. Tuto hodnotu můžete získat z rozhraní API azure Resource Manager nebo portálu.

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 Type Description
properties.requestedBackupStorageRedundancy

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

Odpovědi

Name Type Description
200 OK

Zálohování bylo úspěšně aktualizováno.

202 Accepted

Probíhá aktualizace zálohy.

Other Status Codes

Chybové odpovědi: ***

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

  • 400 InvalidParameterValue – parametr dostal neplatnou hodnotu.

  • 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 druhé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á nemají povoleno komunikovat pro funkci kopírování záloh LTR.

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

  • 400 LongTermRetentionMigrationSameServerNotSupported – Funkce kopírování LTR není podporována při 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ý Backup Storage Redundance není v cílové oblasti podporován.

  • 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 spravované instance a zálohování LTR databáze Azure SQL.

  • 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álohování LTR neexistuje.

  • 409 LongTermRetentionMigrationRequestConflict – stále probíhá konfliktní operace pro tuto zálohu LTR.

  • 409 LongTermRetentionMigrationBackupConflict – Existuje další záloha LTR se stejnou dobou zálohování cílové databáze.

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

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

  • 500 LongTermRetentionMigrationRestoreVerExceeded – Ověření obnovení selhalo po dosažení maximálního počtu pokusů.

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

Příklady

Update the long term retention backup.

Sample Request

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

{
  "properties": {
    "requestedBackupStorageRedundancy": "Geo"
  }
}

Sample Response

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/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/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japanEast/longTermRetentionServers/testserver/longterRetentionDatabases/testDatabase/longTermRetentionBackups/55555555-6666-7777-8888-999999999999;131637960820000000",
    "operationType": "UpdateBackup",
    "status": "Succeeded",
    "targetBackupStorageRedundancy": "Geo"
  }
}

Definice

BackupStorageRedundancy

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

LongTermRetentionBackupOperationResult

Prostředek výsledku operace LongTermRetentionBackup

RequestedBackupStorageRedundancy

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

UpdateLongTermRetentionBackupParameters

Obsahuje informace potřebné k provedení dlouhodobé operace aktualizace zálohování uchovávání informací.

BackupStorageRedundancy

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

Name Type Description
Geo
  • string
Local
  • string
Zone
  • string

LongTermRetentionBackupOperationResult

Prostředek výsledku operace LongTermRetentionBackup

Name Type 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

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

properties.toBackupResourceId
  • string

ID cílového prostředku zálohování

type
  • string

Typ prostředku.

RequestedBackupStorageRedundancy

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

Name Type Description
Geo
  • string
Local
  • string
Zone
  • string

UpdateLongTermRetentionBackupParameters

Obsahuje informace potřebné k provedení dlouhodobé operace aktualizace zálohování uchovávání informací.

Name Type Description
properties.requestedBackupStorageRedundancy

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