Long Term Retention Backups - Update By Resource Group

Service:

SQL Database

API Version:

2021-11-01

Aggiornamenti 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-11-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
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

Nome	Tipo	Descrizione
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Tipo di ridondanza dell'archiviazione del backup copiato

Risposte

Nome	Tipo	Descrizione
200 OK	LongTermRetentionBackupOperationResult	È 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 i database SQL. 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 - La 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 dell'archiviazione di backup specificata 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. 404 OperationIdNotFound: l'operazione con ID 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. 409 OperationCancelled: l'operazione è stata annullata dall'utente. 409 Operazione interrotta: impossibile completare l'operazione sulla risorsa perché è stata interrotta da un'altra operazione sulla stessa risorsa. 429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili. 429 SubscriptionTooManyRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili. 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. 500 OperationTimedOut: l'operazione viene timeout e viene eseguito automaticamente il rollback. Ripetere l'operazione. 503 TooManyRequests : richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

Esempio

Update the long term retention backup.

Sample Request

HTTP

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

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

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.models.BackupStorageRedundancy;
import com.azure.resourcemanager.sql.models.UpdateLongTermRetentionBackupParameters;

/** Samples for LongTermRetentionBackups UpdateByResourceGroup. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ResourceGroupBasedLongTermRetentionBackupUpdate.json
     */
    /**
     * Sample code: Update the long term retention backup.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateTheLongTermRetentionBackup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionBackups().updateByResourceGroup(
            "testResourceGroup", "japaneast", "testserver", "testDatabase",
            "55555555-6666-7777-8888-999999999999;131637960820000000", new UpdateLongTermRetentionBackupParameters()
                .withRequestedBackupStorageRedundancy(BackupStorageRedundancy.GEO),
            Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

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

Status code:

202

Definizioni

Nome	Descrizione
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

Nome	Tipo	Descrizione
Geo	string
GeoZone	string
Local	string
Zone	string

LongTermRetentionBackupOperationResult

Risorsa risultato dell'operazione LongTermRetentionBackup.

Nome	Tipo	Descrizione
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	BackupStorageRedundancy	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.

Nome	Tipo	Descrizione
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Tipo di ridondanza dell'archiviazione del backup copiato