Long Term Retention Backups - Update

Usługa:

SQL Database

Wersja interfejsu API:

2021-11-01

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

POST https://management.azure.com/subscriptions/{subscriptionId}/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
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 skopiowanej

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 — nieprawidłowa wartość została nadana parametrowi. 400 LongTermRetentionMismatchingSubscriptionId — podany identyfikator subskrypcji nie jest zgodny 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 jest zgodna z nazwą w innych danych wejściowych 400 LongTermRetentionMigrationRequestNotSupported — subskrypcja nie jest dozwolona funkcja migracji kopii zapasowych LTR. 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 nie odpowiada nadmiarowości kopii zapasowej żądanej przez klienta. 400 LongTermRetentionMigrationDatabaseTypeNotSupported — migracja LTR jest obsługiwana tylko w przypadku wystąpienia zarządzanego i kopii zapasowych LTR bazy danych Azure SQL. 400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed — zmiana nadmiarowości magazynu kopii zapasowej nie jest dozwolona dla 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 konfliktu na 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 OperationInterrupted — 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 maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby. 500 LongTermRetentionMigrationRequestFailedToStartOnTarget — nie można uruchomić żądania kopiowania 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 został automatycznie wycofany. 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.

Przykładowe żądanie

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/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.resourcemanager.sql.models.BackupStorageRedundancy;
import com.azure.resourcemanager.sql.models.UpdateLongTermRetentionBackupParameters;

/**
 * Samples for LongTermRetentionBackups Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/LongTermRetentionBackupUpdate.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()
            .update("japaneast", "testserver", "testDatabase",
                "55555555-6666-7777-8888-999999999999;131637960820000000", new UpdateLongTermRetentionBackupParameters()
                    .withRequestedBackupStorageRedundancy(BackupStorageRedundancy.GEO),
                com.azure.core.util.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

Przykładowa odpowiedź

Kod stanu:

200

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

Kod stanu:

202

Definicje

Nazwa	Opis
BackupStorageRedundancy	Typ nadmiarowości magazynu kopii zapasowej skopiowanej
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 skopiowanej

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 skopiowanej
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 skopiowanej