Long Term Retention Backups - Update By Resource Group

Service:

SQL Database

API Version:

2021-11-01

Updates cadangan retensi jangka panjang yang ada.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
backupName	path	True	string	Nama cadangan.
locationName	path	True	string	Lokasi database.
longTermRetentionDatabaseName	path	True	string	Nama database
longTermRetentionServerName	path	True	string	Nama server
resourceGroupName	path	True	string	Nama grup sumber daya yang berisi sumber daya. Anda dapat memperoleh nilai ini dari Azure Resource Manager API atau portal.
subscriptionId	path	True	string	ID langganan yang mengidentifikasi langganan Azure.
api-version	query	True	string	Versi API yang digunakan untuk permintaan.

Isi Permintaan

Nama	Jenis	Deskripsi
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Jenis redundansi penyimpanan dari cadangan yang disalin

Respons

Nama	Jenis	Deskripsi
200 OK	LongTermRetentionBackupOperationResult	Berhasil memperbarui cadangan.
202 Accepted		Memperbarui cadangan sedang berlangsung.
Other Status Codes		Respons Kesalahan: *** 400 InvalidLongTermRetentionBackupId - Pengidentifikasi cadangan retensi jangka panjang tidak valid untuk SQL DB. 400 InvalidParameterValue - Nilai yang tidak valid diberikan ke parameter. 400 LongTermRetentionMismatchingSubscriptionId - Id langganan yang disediakan tidak cocok dengan id di input lain 400 LongTermRetentionMismatchingResourceGroupName - Nama grup sumber daya yang disediakan tidak cocok dengan nama di input lain 400 LongTermRetentionMismatchingServerName - Nama server yang disediakan tidak cocok dengan nama di input lain 400 LongTermRetentionMigrationRequestNotSupported - Langganan tidak diizinkan fitur Migrasi cadangan LTR. 400 LongTermRetentionMigrationCrossClusterRequestNotSupported - Langganan sumber dan target tidak diizinkan untuk berkomunikasi untuk fitur salinan cadangan LTR. 400 LongTermRetentionMigrationParameterMissing - Parameter yang diperlukan hilang untuk operasi. Fitur 400 LongTermRetentionMigrationSameServerNotSupported - LTR Copy tidak didukung untuk menyalin cadangan LTR dalam server yang sama. 400 LongTermRetentionMigrationTargetServerNotFound - Server target tidak ada atau tidak siap untuk operasi salinan cadangan LTR. 400 LongTermRetentionMigrationTargetDatabaseNotFound - Database Target tidak ada di server. 400 LongTermRetentionMigrationStorageTypeNotSupported - Redundansi Penyimpanan Cadangan yang Ditentukan tidak didukung di wilayah target. 400 LongTermRetentionMigrationStorageMismatch - Redundansi cadangan database aktif tidak cocok dengan redundansi cadangan yang diminta oleh pelanggan. 400 LongTermRetentionMigrationDatabaseTypeNotSupported - Migrasi LTR hanya didukung untuk instans terkelola dan Azure SQL cadangan DB LTR. 400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed - Mengubah redundansi penyimpanan cadangan tidak diizinkan untuk operasi Salinan LTR. 400 LongTermRetentionMigrationSubscriptionNotFound - Langganan tidak dapat ditemukan. 404 SubscriptionDoesNotHaveServer - Server yang diminta tidak ditemukan 404 ServerNotInSubscriptionResourceGroup - Server yang ditentukan tidak ada di grup sumber daya dan langganan yang ditentukan. 404 ResourceNotFound - Sumber daya yang diminta tidak ditemukan. 404 LongTermRetentionMigrationBackupNotFound - Pencadangan LTR yang ditentukan tidak ada. 404 OperationIdNotFound - Operasi dengan Id tidak ada. 409 LongTermRetentionMigrationRequestConflict - Operasi konflik pada pencadangan LTR ini masih berlangsung. 409 LongTermRetentionMigrationBackupConflict - Pencadangan LTR lain dengan waktu pencadangan yang sama untuk database target ada. 409 OperationCancelled - Operasi telah dibatalkan oleh pengguna. 409 OperationInterrupted - Operasi pada sumber daya tidak dapat diselesaikan karena terganggu oleh operasi lain pada sumber daya yang sama. 429 SubscriptionTooManyCreateUpdateRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 429 SubscriptionTooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 500 LongTermRetentionMigrationRequestFailedToStartOnTarget - Gagal memulai permintaan salinan cadangan LTR di wilayah target. 500 LongTermRetentionMigrationRequestCopyFailed - Operasi salin gagal untuk blob cadangan LTR. 500 LongTermRetentionMigrationRestoreVerExceeded - Verifikasi pemulihan gagal setelah upaya maksimal tercapai. 500 LongTermRetentionMigrationRestoreVerFailed - Verifikasi pemulihan gagal. 500 OperationTimedOut - Waktu operasi habis dan secara otomatis digulung balik. Silakan coba lagi operasi ini. 503 TooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia.

Contoh

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

Definisi

Nama	Deskripsi
BackupStorageRedundancy	Jenis redundansi penyimpanan dari cadangan yang disalin
LongTermRetentionBackupOperationResult	Sumber daya hasil operasi LongTermRetentionBackup.
UpdateLongTermRetentionBackupParameters	Berisi informasi yang diperlukan untuk melakukan operasi pembaruan cadangan retensi jangka panjang.

BackupStorageRedundancy

Jenis redundansi penyimpanan dari cadangan yang disalin

Nama	Jenis	Deskripsi
Geo	string
GeoZone	string
Local	string
Zone	string

LongTermRetentionBackupOperationResult

Sumber daya hasil operasi LongTermRetentionBackup.

Nama	Jenis	Deskripsi
id	string	ID Sumber Daya.
name	string	Nama sumber daya.
properties.fromBackupResourceId	string	Id sumber daya cadangan sumber
properties.message	string	Pesan kemajuan
properties.operationType	string	Jenis operasi.
properties.requestId	string	Id Permintaan.
properties.status	string	Status operasi
properties.targetBackupStorageRedundancy	BackupStorageRedundancy	Jenis redundansi penyimpanan dari cadangan yang disalin
properties.toBackupResourceId	string	Id sumber daya cadangan target
type	string	Jenis sumber daya

UpdateLongTermRetentionBackupParameters

Berisi informasi yang diperlukan untuk melakukan operasi pembaruan cadangan retensi jangka panjang.

Nama	Jenis	Deskripsi
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Jenis redundansi penyimpanan dari cadangan yang disalin