Long Term Retention Backups - Update By Resource Group

Service:

SQL Database

API Version:

2021-11-01

Aktualizacje istniejącą kopię zapasową długoterminowego przechowywania.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
backupName	path	True	string	Nazwa kopii zapasowej.
locationName	path	True	string	Lokalizacja bazy danych.
longTermRetentionDatabaseName	path	True	string	Nazwa bazy danych
longTermRetentionServerName	path	True	string	Nazwa serwera
resourceGroupName	path	True	string	Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API usługi Azure Resource Manager lub portalu.
subscriptionId	path	True	string	Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.
api-version	query	True	string	Wersja interfejsu API do użycia dla żądania.

Treść żądania

Nazwa	Typ	Opis
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Typ nadmiarowości magazynu kopii zapasowej kopii zapasowej

Odpowiedzi

Nazwa	Typ	Opis
200 OK	LongTermRetentionBackupOperationResult	Pomyślnie zaktualizowano kopię zapasową.
202 Accepted		Trwa aktualizowanie kopii zapasowej.
Other Status Codes		Odpowiedzi na błędy: *** 400 InvalidLongTermRetentionBackupId — nieprawidłowy identyfikator kopii zapasowej przechowywania długoterminowego dla baz danych SQL. 400 InvalidParameterValue — podano nieprawidłową wartość dla parametru. 400 LongTermRetentionMismatchingSubscriptionId — podany identyfikator subskrypcji jest niezgodny z identyfikatorem w innych danych wejściowych 400 LongTermRetentionMismatchingResourceGroupName — podana nazwa grupy zasobów nie jest zgodna z nazwą w innych danych wejściowych 400 LongTermRetentionMismatchingServerName — podana nazwa serwera nie pasuje do nazwy w innych danych wejściowych 400 LongTermRetentionMigrationRequestNotSupported — funkcja migracji kopii zapasowych LTR nie jest dozwolona. 400 LongTermRetentionMigrationCrossClusterRequestNotSupported — subskrypcje źródłowe i docelowe nie mogą komunikować się z funkcją kopiowania kopii zapasowej LTR. 400 LongTermRetentionMigrationParameterMissing — brak wymaganego parametru dla operacji. 400 LongTermRetentionMigrationSameServerNotSupported — funkcja kopiowania LTR nie jest obsługiwana do kopiowania kopii zapasowych LTR na tym samym serwerze. 400 LongTermRetentionMigrationTargetServerNotFound — serwer docelowy nie istnieje lub nie jest gotowy do operacji kopiowania kopii zapasowej LTR. 400 LongTermRetentionMigrationTargetDatabaseNotFound — docelowa baza danych nie istnieje na serwerze. 400 LongTermRetentionMigrationStorageTypeNotSupported — określona nadmiarowość magazynu kopii zapasowych nie jest obsługiwana w regionie docelowym. 400 LongTermRetentionMigrationStorageMismatch — aktywna nadmiarowość kopii zapasowej bazy danych jest niezgodna z nadmiarowością kopii zapasowych żądaną przez klienta. 400 LongTermRetentionMigrationDatabaseTypeNotSupported — migracja LTR jest obsługiwana tylko w przypadku wystąpień zarządzanych i Azure SQL kopii zapasowych LTR bazy danych. 400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed — zmiana nadmiarowości magazynu kopii zapasowej nie jest dozwolona w przypadku operacji kopiowania LTR. 400 LongTermRetentionMigrationSubscriptionNotFound — nie można odnaleźć subskrypcji. 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera 404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji. 404 ResourceNotFound — żądany zasób nie został znaleziony. 404 LongTermRetentionMigrationBackupNotFound — określona kopia zapasowa LTR nie istnieje. 404 OperationIdNotFound — operacja o identyfikatorze nie istnieje. 409 LongTermRetentionMigrationRequestConflict — operacja powodująca konflikt dla tej kopii zapasowej LTR jest nadal w toku. 409 LongTermRetentionMigrationBackupConflict — istnieje inna kopia zapasowa LTR z tym samym czasem tworzenia kopii zapasowej docelowej bazy danych. 409 OperationCancelled — operacja została anulowana przez użytkownika. 409 Operacja przerwana — nie można ukończyć operacji na zasobie, ponieważ została przerwana przez inną operację na tym samym zasobie. 429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby. 429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalną liczbę żądań, które mogą być przetwarzane przez dostępne zasoby. 500 LongTermRetentionMigrationRequestFailedToStartOnTarget — nie można uruchomić żądania kopii zapasowej LTR w regionie docelowym. 500 LongTermRetentionMigrationRequestCopyFailed — operacja kopiowania nie powiodła się dla obiektów blob kopii zapasowej LTR. 500 LongTermRetentionMigrationRestoreVerExceeded — weryfikacja przywracania nie powiodła się po osiągnięciu maksymalnej liczby prób. 500 LongTermRetentionMigrationRestoreVerFailed — weryfikacja przywracania nie powiodła się. 500 OperationTimedOut — upłynął limit czasu operacji i automatycznie wycofano. Ponów próbę wykonania operacji. 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

Przykłady

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

Definicje

Nazwa	Opis
BackupStorageRedundancy	Typ nadmiarowości magazynu kopii zapasowej kopii zapasowej
LongTermRetentionBackupOperationResult	Zasób wyniku operacji LongTermRetentionBackup.
UpdateLongTermRetentionBackupParameters	Zawiera informacje niezbędne do wykonania operacji aktualizacji kopii zapasowej przechowywania długoterminowego.

BackupStorageRedundancy

Typ nadmiarowości magazynu kopii zapasowej kopii zapasowej

Nazwa	Typ	Opis
Geo	string
GeoZone	string
Local	string
Zone	string

LongTermRetentionBackupOperationResult

Zasób wyniku operacji LongTermRetentionBackup.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
name	string	Nazwa zasobu.
properties.fromBackupResourceId	string	Identyfikator zasobu kopii zapasowej źródła
properties.message	string	Komunikat o postępie
properties.operationType	string	Typ operacji.
properties.requestId	string	Identyfikator żądania.
properties.status	string	Stan operacji
properties.targetBackupStorageRedundancy	BackupStorageRedundancy	Typ nadmiarowości magazynu kopii zapasowej kopii zapasowej
properties.toBackupResourceId	string	Identyfikator zasobu docelowej kopii zapasowej
type	string	Typ zasobu.

UpdateLongTermRetentionBackupParameters

Zawiera informacje niezbędne do wykonania operacji aktualizacji kopii zapasowej przechowywania długoterminowego.

Nazwa	Typ	Opis
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Typ nadmiarowości magazynu kopii zapasowej kopii zapasowej