Long Term Retention Backups - Update By Resource Group

Aggiorna un backup di conservazione a lungo termine esistente.

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

Parametri dell'URI

Name In Required Type Description
backupName
path True
  • string

Nome del backup.

locationName
path True
  • string

Posizione del database.

longTermRetentionDatabaseName
path True
  • string

Il nome del database.

longTermRetentionServerName
path True
  • string

Nome host del server.

resourceGroupName
path True
  • string

Nome del gruppo di risorse contenente la risorsa. È possibile ottenere questo valore dall'API di Gestione risorse di Azure o dal portale.

subscriptionId
path True
  • string

ID sottoscrizione che identifica una sottoscrizione di Azure.

api-version
query True
  • string

Versione dell'API da usare per la richiesta.

Corpo della richiesta

Name Type Description
properties.requestedBackupStorageRedundancy

Tipo di ridondanza di archiviazione del backup copiato

Risposte

Name Type Description
200 OK

Aggiornamento del backup completato.

202 Accepted

È in corso l'aggiornamento del backup.

Other Status Codes

Risposte di errore: ***

  • 400 InvalidLongTermRetentionBackupId: identificatore di backup di conservazione a lungo termine non valido per i database SQL.

  • 400 InvalidParameterValue: è stato assegnato un valore non valido a un parametro.

  • 400 LongTermRetentionMismatchingSubscriptionId: l'ID sottoscrizione specificato non corrisponde all'ID nell'altro input

  • 400 LongTermRetentionMismatchingResourceGroupName: il nome del gruppo di risorse specificato non corrisponde al nome nell'altro input

  • 400 LongTermRetentionMismatchingServerName: il nome del server specificato non corrisponde al nome nell'altro input

  • 400 LongTermRetentionMigrationRequestNotSupported: la sottoscrizione non è consentita per la funzionalità di migrazione del backup con durata (LTR).

  • 400 LongTermRetentionMigrationCrossClusterRequestNotSupported: le sottoscrizioni di origine e di destinazione non sono autorizzate a comunicare per la funzionalità di copia di backup con durata (LTR).

  • 400 LongTermRetentionMigrationParameterMissing: parametro obbligatorio mancante per l'operazione.

  • 400 LongTermRetentionMigrationSameServerNotSupported : la funzionalità di copia della durata (LTR) non è supportata per copiare i backup di durata (LTR) all'interno dello stesso server.

  • 400 LongTermRetentionMigrationTargetServerNotFound : il server di destinazione non esiste o non è pronto per l'operazione di copia di backup con durata (LTR).

  • 400 LongTermRetentionMigrationTargetDatabaseNotFound : il database di destinazione non esiste nel server.

  • 400 LongTermRetentionMigrationStorageTypeNotSupported: la ridondanza dell'archiviazione di backup specificata non è supportata nell'area di destinazione.

  • 400 LongTermRetentionMigrationStorageMismatch: la ridondanza del backup attivo del database non corrisponde alla ridondanza del backup richiesta dal cliente.

  • 400 LongTermRetentionMigrationDatabaseTypeNotSupported: la migrazione della durata (LTR) è supportata solo per i backup di istanza gestita e di Azure SQL di ripristino a lungo termine del database.

  • 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato

  • 404 ServerNotInSubscriptionResourceGroup: il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati.

  • 404 ResourceNotFound: la risorsa richiesta non è stata trovata.

  • 404 LongTermRetentionMigrationBackupNotFound - Il backup di durata (LTR) specificato non esiste.

  • 409 LongTermRetentionMigrationRequestConflict: è ancora in corso un'operazione di conflitto su questo backup di durata(LTR).

  • 409 LongTermRetentionMigrationBackupConflict: esiste un altro backup di durata (LTR) con lo stesso tempo di backup per il database di destinazione.

  • 500 LongTermRetentionMigrationRequestFailedToStartOnTarget : non è stato possibile avviare la richiesta di copia di backup con durata (LTR) nell'area di destinazione.

  • 500 LongTermRetentionMigrationRequestCopyFailed - Operazione di copia non riuscita per i BLOB di backup con durata (LTR).

  • 500 LongTermRetentionMigrationRestoreVerExceeded: la verifica del ripristino non è riuscita dopo che è stato raggiunto il numero massimo di tentativi.

  • 500 LongTermRetentionMigrationRestoreVerFailed : la verifica del ripristino non è riuscita.

Esempio

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

Definizioni

BackupStorageRedundancy

Tipo di ridondanza di archiviazione del backup copiato

LongTermRetentionBackupOperationResult

Risorsa risultato dell'operazione LongTermRetentionBackup.

RequestedBackupStorageRedundancy

Tipo di ridondanza di archiviazione del backup copiato

UpdateLongTermRetentionBackupParameters

Contiene le informazioni necessarie per eseguire l'operazione di aggiornamento del backup con conservazione a lungo termine.

BackupStorageRedundancy

Tipo di ridondanza di archiviazione del backup copiato

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

LongTermRetentionBackupOperationResult

Risorsa risultato dell'operazione LongTermRetentionBackup.

Name Type Description
id
  • string

ID risorsa.

name
  • string

Nome della risorsa.

properties.fromBackupResourceId
  • string

ID risorsa di backup di origine

properties.message
  • string

Messaggio di stato

properties.operationType
  • string

Tipo di operazione.

properties.requestId
  • string

ID richiesta.

properties.status
  • string

Stato dell'operazione

properties.targetBackupStorageRedundancy

Tipo di ridondanza di archiviazione del backup copiato

properties.toBackupResourceId
  • string

ID risorsa di backup di destinazione

type
  • string

Tipo di risorsa.

RequestedBackupStorageRedundancy

Tipo di ridondanza di archiviazione del backup copiato

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

UpdateLongTermRetentionBackupParameters

Contiene le informazioni necessarie per eseguire l'operazione di aggiornamento del backup con conservazione a lungo termine.

Name Type Description
properties.requestedBackupStorageRedundancy

Tipo di ridondanza di archiviazione del backup copiato