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=2021-08-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 dell'archiviazione del backup copiato

Risposte

Name Type Description
200 OK

È stato aggiornato correttamente il backup.

202 Accepted

L'aggiornamento del backup è in corso.

Other Status Codes

Risposte agli errori: **

  • 400 InvalidLongTermRetentionBackupId - Identificatore di backup di conservazione a lungo termine non valido per SQL DBS.

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

  • 400 LongTermRetentionMismatchingSubscriptionId - L'ID sottoscrizione specificato non corrispondeva all'ID nell'altro input

  • 400 LongTermRetentionMismatchingResourceGroupName - Il nome del gruppo di risorse specificato non corrispondeva 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 la funzionalità di migrazione del backup LTR.

  • 400 LongTermRetentionMigrationCrossClusterRequestNotSupported - Le sottoscrizioni di origine e di destinazione non possono comunicare per la funzionalità di copia di backup LTR.

  • 400 LongTermRetentionMigrationParameterMissing - Parametro obbligatorio mancante per l'operazione.

  • 400 LongTermRetentionMigrationSameServerNotSupported - Funzionalità di copia LTR non è supportata per copiare i backup LTR nello stesso server.

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

  • 400 LongTermRetentionMigrationTargetDatabaseNotFound - Database di destinazione non esiste nel server.

  • 400 LongTermRetentionMigrationStorageTypeNotSupported - La ridondanza specificata Backup Archiviazione non è supportata nell'area di destinazione.

  • 400 LongTermRetentionMigrationStorageMismatch- La ridondanza del database attiva non corrisponde alla ridondanza del backup richiesta dal cliente.

  • 400 LongTermRetentionMigrationDatabaseTypeNotSupported - La migrazione LTR è supportata solo per le istanze gestite e Azure SQL backup LTR del database.

  • 400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed - La modifica della ridondanza dell'archiviazione di backup non è consentita per le operazioni di copia LTR.

  • 400 LongTermRetentionMigrationSubscriptionNotFound - Impossibile trovare la sottoscrizione.

  • 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 LTR specificato non esiste.

  • 409 LongTermRetentionMigrationRequestConflict - Un'operazione di conflitto in questo backup LTR è ancora in corso.

  • 409 LongTermRetentionMigrationBackupConflict - Esiste un altro backup LTR con lo stesso tempo di backup per il database di destinazione.

  • 500 LongTermRetentionMigrationRequestFailedToStartOnTarget - Impossibile avviare la richiesta di copia di backup LTR nell'area di destinazione.

  • 500 LongTermRetentionMigrationRequestCopyFailed - Operazione di copia non riuscita per i BLOB di backup LTR.

  • 500 LongTermRetentionMigrationRestoreVerExceeded - Verifica di ripristino non riuscita dopo che sono stati raggiunti i tentativi massimi.

  • 500 LongTermRetentionMigrationRestoreVerFailed - Verifica di 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=2021-08-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 dell'archiviazione del backup copiato

LongTermRetentionBackupOperationResult

Risorsa risultato dell'operazione LongTermRetentionBackup.

UpdateLongTermRetentionBackupParameters

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

BackupStorageRedundancy

Tipo di ridondanza dell'archiviazione del backup copiato

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

LongTermRetentionBackupOperationResult

Risorsa risultato dell'operazione LongTermRetentionBackup.

Name Type Description
id
  • string

ID risorsa.

name
  • string

Nome 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 dell'archiviazione del backup copiato

properties.toBackupResourceId
  • string

ID risorsa di backup di destinazione

type
  • string

Tipo di risorsa.

UpdateLongTermRetentionBackupParameters

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

Name Type Description
properties.requestedBackupStorageRedundancy

Tipo di ridondanza dell'archiviazione del backup copiato