Long Term Retention Backups - Update By Resource Group

Service:

SQL Database

API Version:

2021-11-01

Aktualizace existující zálohu dlouhodobého uchovávání.

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 identifikátoru URI

Name	V	Vyžadováno	Typ	Description
backupName	path	True	string	Název zálohy.
locationName	path	True	string	Umístění databáze.
longTermRetentionDatabaseName	path	True	string	Název databáze
longTermRetentionServerName	path	True	string	Název serveru
resourceGroupName	path	True	string	Název skupiny prostředků, která obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API azure Resource Manager nebo z portálu.
subscriptionId	path	True	string	ID předplatného, které identifikuje předplatné Azure.
api-version	query	True	string	Verze rozhraní API, která se má použít pro požadavek.

Text požadavku

Name	Typ	Description
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Typ redundance úložiště zkopírované zálohy

Odpovědi

Name	Typ	Description
200 OK	LongTermRetentionBackupOperationResult	Zálohování se úspěšně aktualizovalo.
202 Accepted		Probíhá aktualizace zálohování.
Other Status Codes		Chybové odpovědi: *** 400 InvalidLongTermRetentionBackupId – neplatný identifikátor zálohy dlouhodobého uchovávání pro databáze SQL. 400 InvalidParameterValue – parametru byla přiřazena neplatná hodnota. 400 LongTermRetentionMismatchingSubscriptionId – zadané ID předplatného neodpovídá ID v jiném vstupu. 400 LongTermRetentionMismatchingResourceGroupName – zadaný název skupiny prostředků neodpovídá názvu v jiném vstupu. 400 LongTermRetentionMismatchingServerName – zadaný název serveru neodpovídá názvu v jiném vstupu. 400 LongTermRetentionMigrationRequestNotSupported – Předplatná není povolená funkce migrace zálohování LTR. 400 LongTermRetentionMigrationCrossClusterRequestNotSupported – Zdrojová a cílová předplatná nesmí komunikovat o funkci kopírování zálohování LTR. 400 LongTermRetentionMigrationParameterMissing – chybí požadovaný parametr pro operaci. 400 LongTermRetentionMigrationSameServerNotSupported – Funkce LTR Copy není podporována pro kopírování záloh LTR na stejném serveru. 400 LongTermRetentionMigrationTargetServerNotFound – Cílový server neexistuje nebo není připravený pro operaci kopírování zálohování LTR. 400 LongTermRetentionMigrationTargetDatabaseNotFound – Cílová databáze na serveru neexistuje. 400 LongTermRetentionMigrationStorageTypeNotSupported – Zadaná redundance úložiště zálohování se v cílové oblasti nepodporuje. 400 LongTermRetentionMigrationStorageMismatch – aktivní redundance zálohování databáze neodpovídá redundanci zálohování požadované zákazníkem. 400 LongTermRetentionMigrationDatabaseTypeNotSupported – Migrace LTR se podporuje pouze pro zálohy LTR spravované instance a Azure SQL DB. 400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed – Změna redundance úložiště zálohování není pro operace kopírování LTR povolená. 400 LongTermRetentionMigrationSubscriptionNotFound – předplatné nebylo nalezeno. 404 SubscriptionDoesNotHaveServer – požadovaný server nebyl nalezen. 404 ServerNotInSubscriptionResourceGroup – zadaný server neexistuje v zadané skupině prostředků a předplatném. 404 ResourceNotFound – požadovaný prostředek nebyl nalezen. 404 LongTermRetentionMigrationBackupNotFound – zadaná záloha LTR neexistuje. 404 OperationIdNotFound – operace s ID neexistuje. 409 LongTermRetentionMigrationRequestConflict – konfliktní operace pro toto zálohování LTR stále probíhá. 409 LongTermRetentionMigrationBackupConflict – existuje další záloha LTR se stejnou dobou zálohování pro cílovou databázi. 409 OperationCancelled – operace byla zrušena uživatelem. 409 OperationInterrupted – Operaci s prostředkem nebylo možné dokončit, protože byla přerušena jinou operací se stejným prostředkem. 429 SubscriptionTooManyCreateUpdateRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 500 LongTermRetentionMigrationRequestFailedToStartOnTarget – Nepodařilo se spustit žádost o záložní kopírování LTR v cílové oblasti. 500 LongTermRetentionMigrationRequestCopyFailed – Operace kopírování pro objekty blob zálohování LTR selhala. 500 LongTermRetentionMigrationRestoreVerExceeded – ověření obnovení se po dosažení maximálního počtu pokusů nezdařilo. 500 LongTermRetentionMigrationRestoreVerFailed – Ověření obnovení se nezdařilo. 500 OperationTimedOut – časový limit operace vypršel a automaticky se vrátila zpět. Opakujte operaci. 503 TooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky.

Příklady

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

Definice

Name	Description
BackupStorageRedundancy	Typ redundance úložiště zkopírované zálohy
LongTermRetentionBackupOperationResult	Prostředek výsledku operace LongTermRetentionBackup.
UpdateLongTermRetentionBackupParameters	Obsahuje informace potřebné k provedení operace aktualizace dlouhodobého uchovávání záloh.

BackupStorageRedundancy

Typ redundance úložiště zkopírované zálohy

Name	Typ	Description
Geo	string
GeoZone	string
Local	string
Zone	string

LongTermRetentionBackupOperationResult

Prostředek výsledku operace LongTermRetentionBackup.

Name	Typ	Description
id	string	ID prostředku.
name	string	Název prostředku.
properties.fromBackupResourceId	string	ID prostředku zálohování zdroje
properties.message	string	Zpráva o průběhu
properties.operationType	string	Typ operace.
properties.requestId	string	ID požadavku.
properties.status	string	Stav operace
properties.targetBackupStorageRedundancy	BackupStorageRedundancy	Typ redundance úložiště zkopírované zálohy
properties.toBackupResourceId	string	ID prostředku cílové zálohy
type	string	Typ prostředku.

UpdateLongTermRetentionBackupParameters

Obsahuje informace potřebné k provedení operace aktualizace dlouhodobého uchovávání záloh.

Name	Typ	Description
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Typ redundance úložiště zkopírované zálohy